# Дейл (Deal)

SaaS-мониторинг Telegram: реальные заказы и клиенты вместо рекламы и дубликатов.

## Документация (актуальное)

- **ТЗ**: `docs/spec/ТЗ-дейл-новая-архитектура.md`
- **Инструкция пользователя**: `docs/user-guide/Инструкция-пользователя-Дейл.md`
- **Техническая документация** (стек, развёртывание, эксплуатация): `docs/technical/Техническая-документация-Дейл.md`
- **Карта API**: `docs/api/api-map.md`
- **Статус и борд состояния**: `docs/superpowers/STATUS.md`
- **Бэклог (техдолг и отложенное)**: `docs/superpowers/backlog.md`
- **Код-стайл (полный свод правил)**: `docs/spec/Код-стайл-Дейл.md`

Исходники: `src/` (`core`, `frontend`, `ai-service`, `ml-service`, `telegram-service`, `contracts`, `grpc-hosting`).
Планы и ledgers этапов: `docs/superpowers/plans/`, `.superpowers/sdd/`.
Легаси-прототип 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`.
Служебные скрипты в репозиторий не входят — живут только локально, вне кода.