aura-crm/core

Service Center — core

Это core-сервис модульной платформы сервисного центра: ремонт и продажа техники, заправка картриджей, физ/юр лица. Core владеет только тем, что обязано быть общим — staff-идентичностью (JWT) и реестром модулей. Бизнес-логика (приём в ремонт, склад, заказы) живёт в отдельных модулях-сервисах, которые регистрируются здесь.

Модули (каждый — отдельный репозиторий/рантайм):

Модуль	Статус	Репозиторий
core (этот репозиторий)	✅ Фаза 0	service-center
production (приём в ремонт, Kanban, гарантия)	✅ первая версия зарегистрирована	production
site (публичный лендинг)	✅ зарегистрирован, heartbeat здоровый	site
online-store (продажа техники)	✅ уже в проде, не подключён к реестру	online-store

Название/домен всей платформы ещё не выбраны — репозиторий и internal-хосты временно называются service-center.

Стек core

• Go + Fiber, PostgreSQL (pgx/v5 + goose), MinIO
• Auth: JWT (роли owner/manager/master), без публичной регистрации — первый owner бутстрапится из OWNER_* env при пустой staff_users

Контракт модуля

Модуль — независимый сервис (свой рантайм, своя БД). Чтобы подключиться к core:

1. Owner создаёт запись модуля: POST /api/modules (JWT owner) с телом {"name", "base_url", "health_path"?, "metadata"?}. Ответ отдаёт token один раз — сохранить в MODULE_TOKEN модуля, core хранит только его hash.
2. Модуль периодически шлёт POST /api/modules/:name/heartbeat с заголовком X-Module-Token: <token> и телом {"status": "healthy"|"unhealthy"}. Core не ходит к модулям сам — статус только push (модули могут жить в разных сетях/хостингах, core не обязан до них достучаться).
3. Для проверки staff-токена модуль верифицирует JWT тем же JWT_SECRET (HS256, общий секрет, см. .env.example) — своего auth-сервиса у модуля нет.
4. Управление: GET /api/modules (список+статус), DELETE /api/modules/:name (отозвать) — оба owner-only.

Разработка

docker network create platform_net   # once — shared with module repos, see Контракт модуля
cp .env.example .env   # заполнить секреты + OWNER_* для первого владельца
docker compose up -d --build
curl http://127.0.0.1:18090/api/health

На хосте с несколькими проектами backend слушает только 127.0.0.1:18090 — наружу отдаёт хостовый системный Caddy (/etc/caddy/Caddyfile), когда появится домен. Caddyfile в корне репо — для отдельного standalone-VPS деплоя, где у этого проекта есть весь хост (порты 80/443) для себя.

Дорожная карта

0 — Инфраструктура + реестр модулей ✅ (этот коммит) → 1 — модуль production (MVP приём в ремонт) → 2 — Документы юрлиц → 3 — Заправка картриджей → 4 — online-store регистрируется как модуль → 5 — Склад → 6 — AI-приёмка → 7 — Касса → 8 — Telegram-бот → 9 — Аналитика → 10 — доп.