stepan
45065d3202
Ревью rust: перенос в вики не должен удалять из репозитория то, что нужно агенту для работы (бэклог, статус, планы, код-стайл, спеки). Дублирование вики и репы разрешено и обязательно: вики — актуальные версии для людей, docs/ — зеркало для контекста агентов. README разведён по ролям.
42 lines
3.3 KiB
Markdown
42 lines
3.3 KiB
Markdown
# Дейл (Deal)
|
|
|
|
SaaS-мониторинг Telegram: реальные заказы и клиенты вместо рекламы и дубликатов.
|
|
|
|
## Документация
|
|
|
|
Актуальные версии для людей — в [вики проекта](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Home);
|
|
в `docs/` — зеркала для работы агентов (дублирование разрешено и нужно).
|
|
|
|
- **ТЗ**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/ТЗ](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/ТЗ)
|
|
- **Инструкция пользователя**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Инструкция-пользователя](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Инструкция-пользователя)
|
|
- **Техническая документация** (стек, развёртывание, эксплуатация): [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Техническая-документация](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Техническая-документация)
|
|
- **Карта API**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/API-карта](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/API-карта)
|
|
- **Статус и борд состояния**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Статус-разработки](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Статус-разработки)
|
|
- **Бэклог (техдолг и отложенное)**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Бэклог](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Бэклог)
|
|
- **Код-стайл (полный свод правил)**: [https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Код-стайл](https://gitea.khomegeneric.keenetic.pro/rust/Deal/wiki/Код-стайл)
|
|
|
|
Исходники: `src/` (`core`, `frontend`, `ai-service`, `ml-service`, `telegram-service`, `contracts`, `grpc-hosting`).
|
|
Планы и ledgers этапов — в вики (раздел «Историческое» в Sidebar).
|
|
Легаси-прототип LeadRadar и служебные скрипты в репозиторий не входят — живут локально, вне кода.
|
|
|
|
## Запуск dev-окружения
|
|
|
|
Полный стек (postgres + minio + сервисы + core):
|
|
|
|
```sh
|
|
docker compose -f deploy/compose.dev.yml up -d --build
|
|
```
|
|
|
|
Фронтенд (dev-сервер, проксирует `/api` на core :5080):
|
|
|
|
```sh
|
|
cd src/frontend && npm run dev
|
|
```
|
|
|
|
Вход: `admin` / `admin`. Оператор-консоль: `http://localhost:5173/#/operator` (`operator` / `operator`).
|
|
|
|
Сборка: `dotnet build src/core/Deal.sln` (и аналогично для sln в `src/telegram-service`, `src/ai-service`,
|
|
`src/ml-service`, `src/storage-service`). Тесты: `dotnet test src/core/tests/Deal.Tests.Unit`.
|
|
Полный CI-прогон (сборка 5 решений + тесты + скан уязвимостей + фронт) — `.gitea/workflows/ci.yml`.
|
|
Служебные скрипты в репозиторий не входят — живут только локально, вне кода.
|