# Дейл (Deal)

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

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

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

Исходники: `src/` (`core`, `frontend`, `ai-service`, `ml-service`, `telegram-service`, `contracts`, `grpc-hosting`).
Планы и ledgers этапов: `docs/superpowers/plans/`, `.superpowers/sdd/`.
Архив: `archive/leadradar-legacy/` (прототип), `archive/style-guide-original/` (исходный `Стиль_кода.docx`).

## Запуск 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`).
Сквозная проверка стека: `sh scripts/dev-smoke.sh`. Сборка: `sh scripts/build.sh`; тесты: `sh scripts/test.sh`;
полный CI-прогон (сборка + тесты + скан уязвимостей + фронт): `sh scripts/ci.sh`.