Deal — единая кодовая база

SaaS-мониторинг Telegram: ядро (модули Cards/Kanban/Pipeline/Tenants/Settings/
Discovery, Api, Infrastructure), сервисы telegram/ai/ml/storage, фронт Vue,
контракты и grpc-hosting, деплой-конфиги (dev/prod/observability/CI-раннер),
Gitea Actions CI, документация (ТЗ, техдок, api-map, код-стайл, планы, бэклог).

Текущее состояние: все этапы роадмапа 0–12 закрыты, сборка 5 sln 0/0,
тесты 1340/130/52/38/9 зелёные.

README.md

@@ -0,0 +1,38 @@
+# Дейл (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`.
+Служебные скрипты в репозиторий не входят — живут только локально, вне кода.