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 зелёные.

.superpowers/sdd/deal-scaffold/progress.md

@@ -0,0 +1,53 @@
+# SDD ledger — plan: docs/superpowers/plans/2026-09-05-deal-scaffold.md
+
+Проект НЕ git: вместо коммитов — отчёты задач (task-N-report.md) и этот ledger.
+Ревью выполняется по фактическим файлам дерева (пакеты diff недоступны без git).
+
+## Todos
+- [x] Task 1: Структура src/ и перенос фронтенда
+- [x] Task 2: Стандарты кода — .editorconfig, Directory.Build.props
+- [x] Task 3: Решение Deal.sln и пустые проекты core
+- [x] Task 4: Тесты — xUnit-каркас
+- [x] Task 5: Dev-Postgres в docker compose (схема на тенанта)
+- [x] Task 6: Tenant-контекст и подключение к Postgres
+- [x] Task 7: EF Core + миграции (public)
+- [x] Task 8: Применение миграций ко всем схемам тенантов
+- [x] Task 9: CI-скрипты и финальная проверка этапа
+
+## Pre-flight scan (таблица пар задач и внутренней согласованности)
+
+| Пара | Производит / потребляет | Результат |
+|---|---|---|
+| T1 → T5 | T1 создаёт корневой README.md; T5 его дополняет | Чисто |
+| T1 → T2 | T1 создаёт src/core; T2 кладёт Directory.Build.props в src/core | Чисто |
+| T2 → T3..T9 | props применяется ко всем csproj под src/core (вкл. тесты, Api) | Внутреннее расхождение: пакет-анализатор 9.0.0 против SDK 10 — см. Ruling 1 |
+| T3 → T4 | T4 ссылается на проекты модулей из T3 | Чисто |
+| T4 → T6/T7/T8 | T4 создаёт тестовый проект; T6 добавляет TenantIdTests, T7 TenantEntityTests, T8 TenantSchemaMigratorTests | T7/T8 тестам нужен reference на Deal.Infrastructure, которого нет в T4 — см. Ruling 3 |
+| T4/T6 | счётчики тестов: T4=1 (MarkerTests), +T6=2 → 3 PASS | Чисто (внутренне согласовано в T6 Step 3) |
+| T6 → T7 | ConnectionStringProvider в Infrastructure зависит от IConfiguration | Внутреннее расхождение: в плане нет пакета конфигурации для Infrastructure — см. Ruling 4 |
+| T6 → T6 | ITenantContext/AsyncLocal, SqlSchema search_path | Чисто |
+| T7 → T8 | T8 консьюмит TenantId; отдельно SQL | Чисто |
+| T7 | dotnet-ef миграция требует tool | Ruling 5 (локальный tool-manifest вместо --global) |
+| T7 | IDesignTimeDbContextFactory в Infrastructure; API как startup | Чисто |
+| T2 → T3 | warnings-as-errors на новых шаблонах .NET 10 | Риск: неожиданные NETSDK-предупреждения; при необходимости ослабить severity в .editorconfig (записано в Ruling 1) |
+| T1 | `cp -r frontend/*` тянет node_modules/dist | Приемлемо (без git всё хранится в дереве); проверить копию ДО rm (Ruling 2) |
+
+## Rulings (pre-flight)
+
+- **Ruling 1** — план (T2) включает `Microsoft.CodeAnalysis.NetAnalyzers 9.0.0`; SDK 10.0.400 уже поставляет совместимые анализаторы (AnalysisLevel=latest + EnforceCodeStyleInBuild). Явный пакет 9.0.0 рискует версионным рассинхроном с net10 и ошибками сборки при warnings-as-errors. Решение: явный PackageReference НЕ добавляем, полагаемся на встроенные анализаторы SDK. Стоимость при ошибке: вернуть пакет позже одной строкой.
+- **Ruling 2** — перенос фронтенда (T1) разрушителен (`rm -rf frontend`): сначала полная проверка `src/frontend` (ключевые файлы + count), только потом удаление. Стоимость при ошибке: потеря node_modules (переустанавливаемо), исходники Vue восстанавливаются из src/frontend.
+- **Ruling 3** — тесты T7 (TenantEntityTests) и T8 (TenantSchemaMigratorTests) импортируют `Deal.Infrastructure.*`, но T4 подключает к тестам только модули + SharedKernel. Решение: при T7 добавить `dotnet add tests/Deal.Tests.Unit reference Deal.Infrastructure`. Стоимость при ошибке: нет.
+- **Ruling 4** — ConnectionStringProvider принимает IConfiguration; у classlib Infrastructure нет ссылки на конфигурацию. Решение: в T6 добавить пакет `Microsoft.Extensions.Configuration.Abstractions` в Deal.Infrastructure. Стоимость при ошибке: нет.
+- **Ruling 5** — план требует `dotnet tool install --global dotnet-ef` (изменение вне дерева). Решение: проверить глобальный список; если нет — локальный tool-manifest в `src/core/.config` (`dotnet new tool-manifest` + `dotnet tool install dotnet-ef`). Стоимость при ошибке: лишний файл манифеста.
+
+## Task status
+- Task 1: complete (review clean). Отчёт: task-1-report.md. Minor deferred: файл `src/frontend/nul` (резервированное имя Windows, переехал из LeadRadar) — удалить, если нативные инструменты начнут спотыкаться.
+- Task 2: complete (review clean). Отчёт: task-2-report.md.
+- Task 3: complete (review clean). Отчёт: task-3-report.md.
+- Task 4: complete (review clean). Отчёт: task-4-report.md.
+- Task 5: complete (review clean). Отчёт: task-5-report.md.
+- Task 6: complete (review clean; единственное отклонение — явный `public` на членах ITenantContext из-за IDE0040:error, семантика не изменена). Отчёт: task-6-report.md. Note для следующих задач: сниппеты интерфейсов из плана могут требовать явных модификаторов доступа.
+- Task 7: complete (review clean; 3 отклонения — все задокументированы и одобрены ревью: Relational-пин в Infrastructure против MSB3277; Design PrivateAssets=all в Api для dotnet-ef; тест TenantEntity переписан на реальные дефолты — план сам разрешил «скорректировать»). Отчёт: task-7-report.md.
+- Task 8: complete (review clean; производственный код verbatim; тест EscapesQuotes заменён на осмысленный — исходное утверждение плана падало на верном коде и проходило на баге). Отчёт: task-8-report.md.
+- Task 9: complete (review clean). Отчёт: task-9-report.md.
+- **Этап 0 завершён**: все 9 задач complete; финальное whole-scope ревью ✅ (0 warnings/0 errors, 6/6 PASS, deal-postgres healthy, /api/health ок). Deferred minors: `src/frontend/nul` (не блокирует; решить в этапе 1), остальные — заметки процесса.

.superpowers/sdd/deal-scaffold/task-1-report.md

@@ -0,0 +1,68 @@
+# Task 1 — «Структура src/ и перенос фронтенда» — отчёт
+
+Дата: 2026-09-05. План: `docs/superpowers/plans/2026-09-05-deal-scaffold.md` (Task 1, строки 27–88).
+
+## Что сделано
+
+**Step 1. Структура каталогов** — создано:
+```
+src/core  src/ml-service  src/ai-service  src/telegram-service  src/contracts
+```
+(5 пустых каталогов, плюс `src/frontend` создан на шаге 2 — итого 6.)
+
+**Step 2. Перенос фронтенда** — `frontend/` → `src/frontend/`.
+- Скопировано содержимое старого `frontend/` включая скрытые файлы (`.gitignore`):
+  `mkdir -p src/frontend && cp -r frontend/. src/frontend/`.
+- Затем (после верификации копии) старый `frontend/` удалён: `rm -rf frontend`.
+
+**Step 3.** Создан `src/README.md` — содержимое 1-в-1 из плана (строки 55–66).
+**Step 4.** Создан корневой `README.md` — содержимое 1-в-1 из плана (строки 71–79).
+
+**Не создано ничего сверх списка**: ни `Directory.Build.props`, ни csproj, ни иных файлов.
+LeadRadar-код (`backend/`, `mlservice/`, `docker-compose.yml`, `docs/`) не тронут.
+
+## Проверки (выводы команд)
+
+- Счёт файлов старого `frontend` ДО переноса: `find frontend -type f | wc -l` → **1085**.
+- Счёт файлов `src/frontend` ПОСЛЕ переноса (до удаления старого): → **1085** — равно.
+- Полное сравнение списков файлов (относительные пути, отсортированы):
+  `diff` списков `frontend/` и `src/frontend/` → **IDENTICAL**.
+- `ls src/` → 6 папок: `ai-service contracts core frontend ml-service telegram-service` (+ `README.md`).
+- `ls src/frontend/` → `package.json`, `index.html`, `src/`, `vite.config.js`, `dist/`,
+  `node_modules/`, `package-lock.json`, `.gitignore`, `nul`, логи vite.
+- `test -f README.md && echo ok` → `ok`; `test -f src/README.md` → `ok`.
+- После удаления: `find src/frontend -type f | wc -l` → **1085**; `frontend/` отсутствует.
+
+## Отклонение от буквы плана (обоснованное)
+
+1. План: `cp -r frontend/* src/frontend/`. Использовано `cp -r frontend/. src/frontend/`:
+   glob `*` не захватывает dot-файлы (`.gitignore`), что нарушило бы требование равенства
+   счётчиков файлов (guard) — 1085 до vs 1084 после. `frontend/.` копирует и скрытые файлы,
+   результат проверен: списки файлов идентичны.
+2. План: `cp -r ... && rm -rf frontend` одной командой. Деструктивный шаг выполнен отдельно,
+   только после верификации копии, как требует guard.
+
+## Инцидент: запущенный vite dev server в старом frontend/
+
+`rm -rf frontend` частично не удался: файлы `frontend/vite-dev.log`, `frontend/vite-dev.err.log`
+и пересозданный кэш `frontend/.vite/deps/*` были заблокированы (Device or resource busy).
+Причина установлена: с 2026-09-02 работал живой процесс vite dev server
+(`node C:\telbase\frontend\node_modules\.bin\..\vite\bin\vite.js`, Windows PID 395892, родитель cmd 392284),
+державший дескрипторы на логи в старом каталоге. Его `node_modules/`, `src/`, `dist/` уже были удалены
+шагом 2, т.е. сервер был неработоспособен независимо от наших действий.
+Выполнено: `taskkill //PID 395892 //T //F` (только дерево этого vite-процесса), после чего
+`rm -rf frontend` успешен. Остальные node-процессы не трогались.
+
+## Опасения / Concerns
+
+- Был принудительно завершён зависший vite dev server старого `frontend/` (см. инцидент).
+  При необходимости dev-сервер нужно запускать заново из `src/frontend/`.
+- В `src/frontend/` переехал файл с именем `nul` (215 байт, существовал в исходном `frontend/`
+  до переноса) — перенос выполнен как есть, файл сохранён.
+- Служебные логи `vite-dev.log`/`vite-dev.err.log` и каталог `dist/`, `node_modules/` перенесены
+  как есть (план: «фронтенд переезжает как есть»).
+- Проект не git-репозиторий: коммитов нет, изменения зафиксированы настоящим отчётом.
+
+## Статус задачи
+
+DONE_WITH_CONCERNS (все шаги 1–6 выполнены и проверены; concern — завершённый vite-процесс).

.superpowers/sdd/deal-scaffold/task-2-report.md

@@ -0,0 +1,50 @@
+# Task 2 — «Стандарты кода — .editorconfig, Directory.Build.props» — отчёт
+
+Дата: 2026-09-05. План: `docs/superpowers/plans/2026-09-05-deal-scaffold.md` (Task 2, строки 90–167).
+
+## Что сделано
+
+**Step 1.** Создан корневой `.editorconfig` (`C:\telbase\.editorconfig`) — содержимое 1-в-1
+из плана (строки 102–139 внутри fence, 38 строк): `root = true`, базовые настройки (`[*]`),
+`[*.{cs,vb}]`, секция стиля фигурных скобок (Allman), using-директивы, явные модификаторы
+доступа, отключение квалификации `this.`, правила `var`, секция `[*.cs]` с
+`dotnet_diagnostic.IDE0290.severity = none`.
+
+**Step 2.** Создан `src/core/Directory.Build.props` — PropertyGroup из плана (строки 146–154)
+1-в-1: `TargetFramework net10.0`, `LangVersion latest`, `Nullable enable`,
+`ImplicitUsings enable`, `TreatWarningsAsErrors true`, `AnalysisLevel latest`,
+`EnforceCodeStyleInBuild true`.
+
+**Step 3.** Зафиксирован настоящий отчёт.
+
+**Не создано ничего сверх списка**: задача ограничена двумя файлами. `src/core/` пуст
+(кроме нового props), код LeadRadar не тронут. Сборка не выполнялась (запрошено задачей;
+проектов под `src/core` ещё нет — проверка в Task 3+).
+
+## Рeшение контроллера (применено)
+
+`<PackageReference Include="Microsoft.CodeAnalysis.NetAnalyzers" Version="9.0.0" ...>`
+(план, строки 156–161) **полностью опущен**: SDK .NET 10 (10.0.400) уже включает
+встроенные analyzers той же версии; явная ссылка не нужна. Остальные элементы props
+совпадают с планом без изменений.
+
+## Проверки
+
+- Оба файла существуют: чтение `.editorconfig` (38 строк) и `Directory.Build.props` (11 строк).
+- `.editorconfig` сверен построчно с планом (строки 102–139) — идентичен, включая пустые
+  строки и русские комментарии.
+- `Directory.Build.props` сверен с планом (строки 145–154) — идентичен; ItemGroup
+  отсутствует; наличие `PackageReference` в файле не подтверждается (grep-проверка не нужна —
+  содержимое прочитано целиком).
+- `ls src/core/` → содержит только `Directory.Build.props`.
+
+## Опасения / Concerns
+
+- Нет. Правило `EnforceCodeStyleInBuild` + `TreatWarningsAsErrors` начнёт действовать после
+  создания проектов (Task 3) — тогда же и проверка сборки.
+- Проект не git-репозиторий: коммитов нет, изменения зафиксированы настоящим отчётом.
+
+## Статус задачи
+
+DONE (все шаги 1–3 выполнены и проверены; отклонений от плана нет, кроме предписанного
+контроллером исключения PackageReference).

.superpowers/sdd/deal-scaffold/task-3-report.md

@@ -0,0 +1,75 @@
+# Task 3 — «Решение Deal.sln и пустые проекты core» — отчёт
+
+Дата: 2026-09-05. План: `docs/superpowers/plans/2026-09-05-deal-scaffold.md` (Task 3, строки 169–258).
+Рабочая директория: `C:\telbase\src\core`.
+
+## Что сделано
+
+**Step 1.** Созданы решение и проекты (`dotnet new`, шаблоны SDK .NET 10.0.400):
+`Deal.sln`; `Deal.Api` (`web --no-https`); 6 модулей `Deal.Modules.{Pipeline,Kanban,Projects,Discovery,Settings,Tenants}`;
+`Deal.SharedKernel`, `Deal.Infrastructure`, `Deal.Contracts` (все — `classlib`).
+
+**Step 2.** Все 10 проектов добавлены в решение (`dotnet sln Deal.sln add ...` — 10/10 подтверждено выводом).
+
+**Step 3.** Удалён сгенерированный `Class1.cs` из всех 9 classlib-проектов. Созданы публичные
+sealed-маркеры (1 тип = 1 файл, имя файла = имени типа, XML-doc, содержимое по плану):
+`PipelineModuleMarker`, `KanbanModuleMarker`, `ProjectsModuleMarker`, `DiscoveryModuleMarker`,
+`SettingsModuleMarker`, `TenantsModuleMarker`, `InfrastructureMarker`, `SharedKernelMarker`,
+`ContractsMarker`.
+
+**Step 4.** Project references (минимальные, по плану): `Deal.Api` → SharedKernel/Contracts/Infrastructure;
+каждый модуль и `Deal.Infrastructure` → SharedKernel/Contracts. `Deal.SharedKernel`/`Deal.Contracts` — без ссылок.
+
+**Step 5.** `Deal.Api/Program.cs` заменён 1-в-1 на содержимое плана (строки 233–245): health-endpoint
+`GET /api/health` + `public partial class Program`.
+
+**Step 6.** `dotnet build Deal.sln` → успешно, 0 предупреждений, 0 ошибок (строгий режим
+TreatWarningsAsErrors + EnforceCodeStyleInBuild соблюдён).
+
+**Step 7.** Health-проверка: приложение поднято в фоне на `http://localhost:5080`, `curl`
+вернул ожидаемый JSON, процесс остановлен, порт освобождён (netstat: слушателей нет).
+
+**Step 8.** Зафиксирован настоящий отчёт.
+
+## Созданные файлы
+
+- `src/core/Deal.sln`
+- `src/core/Deal.Api/Deal.Api.csproj`, `Deal.Api/Program.cs`, `Deal.Api/Properties/launchSettings.json` (шаблон)
+- `src/core/Deal.Api/Program.cs` — health-версия по плану
+- 9 classlib-проектов: `Deal.Modules.Pipeline/…Tenants`, `Deal.SharedKernel`, `Deal.Infrastructure`, `Deal.Contracts` (csproj + маркер)
+- Маркеры: `PipelineModuleMarker.cs`, `KanbanModuleMarker.cs`, `ProjectsModuleMarker.cs`, `DiscoveryModuleMarker.cs`,
+  `SettingsModuleMarker.cs`, `TenantsModuleMarker.cs`, `InfrastructureMarker.cs`, `SharedKernelMarker.cs`, `ContractsMarker.cs`
+- `ProjectReference` во всех csproj по плану (см. Step 4)
+- `.superpowers/sdd/deal-scaffold/task-3-report.md`
+
+## Проверки
+
+**Сборка** (`dotnet build Deal.sln`, Debug): 10/10 проектов `успешно`, «Сборка успешно выполнено через 7,4 с»;
+вывод без предупреждений и ошибок (при TreatWarningsAsErrors любое предупреждение уронило бы сборку).
+
+**Health** (Step 7):
+
+```
+=== GET http://localhost:5080/api/health ===
+{"ok":true,"service":"deal"}      ← curl exit 0, ожидаемый ответ
+=== app log ===
+Now listening on: http://localhost:5080
+Hosting environment: Development
+=== stopping app: kill <pid> ===
+=== no leftover listener on 5080 ===   ← процесс остановлен, порт свободен
+```
+
+## Опасения / Concerns
+
+- `.NET 10 default slnx`: `dotnet new sln` в SDK 10.0.400 создаёт `Deal.slnx`, а не `Deal.sln`.
+  План требует именно `Deal.sln` (имя используется в командах `sln add`/`build`). Решение:
+  `Deal.slnx` удалён, решение пересоздано как классическое: `dotnet new sln -n Deal --format sln`.
+  Итог — `Deal.sln` (классический формат), артефактов slnx не осталось.
+- Health-скрипт: в финальной строке проверки «после остановки» код возврата `curl` выведен неверно
+  (`$?` после `echo`), но факт остановки подтверждён авторитетно: тело ответа пустое (сервер не отвечает)
+  и `netstat` не показывает слушателей на порту 5080.
+- Проект не git-репозиторий: коммитов нет, изменения зафиксированы настоящим отчётом.
+
+## Статус задачи
+
+DONE (все шаги 1–8 выполнены; сборка 0/0; health-ответ совпал с ожидаемым; процесс остановлен).

.superpowers/sdd/deal-scaffold/task-4-report.md

@@ -0,0 +1,67 @@
+# Task 4 — «Тесты — xUnit-каркас» — отчёт
+
+Дата: 2026-09-05. План: `docs/superpowers/plans/2026-09-05-deal-scaffold.md` (Task 4, строки 261–306).
+Рабочая директория: `C:\telbase\src\core`.
+
+## Что сделано
+
+**Step 1.** Создан тестовый проект:
+
+```
+dotnet new xunit -n Deal.Tests.Unit -o tests/Deal.Tests.Unit
+dotnet sln Deal.sln add tests/Deal.Tests.Unit
+dotnet add tests/Deal.Tests.Unit reference Deal.SharedKernel Deal.Modules.Pipeline Deal.Modules.Kanban Deal.Modules.Projects Deal.Modules.Discovery Deal.Modules.Settings Deal.Modules.Tenants
+```
+
+- Шаблон .NET 10 SDK сгенерировал классический набор xunit v2.9.3 + `Microsoft.NET.Test.Sdk` 17.14.1 +
+  `xunit.runner.visualstudio` 3.1.4 + `coverlet.collector` 6.0.4 (VSTest, НЕ xunit v3 / Microsoft.Testing.Platform),
+  поэтому `dotnet test` работает штатно, адаптация не потребовалась.
+- Проект добавлен в `Deal.sln` (11-й проект).
+- Добавлены 7 ProjectReference строго по плану: `Deal.SharedKernel` + 6 модулей
+  (`Pipeline`, `Kanban`, `Projects`, `Discovery`, `Settings`, `Tenants`). `Deal.Infrastructure` НЕ добавлен
+  (добавляется более поздней задачей).
+
+**Step 2.** Удалён шаблонный `UnitTest1.cs`. Создан единственный тестовый файл
+`tests/Deal.Tests.Unit/MarkerTests.cs` — содержимое 1-в-1 из плана (строки 284–298):
+`MarkerTests` (public sealed) с единственным `[Fact] PipelineModuleMarker_IsPublicAndSealed`,
+проверяющим `IsPublic`/`IsSealed` у `Deal.Modules.Pipeline.PipelineModuleMarker`.
+
+**Step 3.** `dotnet test tests/Deal.Tests.Unit` → ожидаемый результат: ровно 1 тест PASS.
+
+## Вывод тестового запуска (финал)
+
+```
+[xUnit.net 00:00:00.00] xUnit.net VSTest Adapter v3.1.4+50e68bbb8b (64-bit .NET 10.0.11)
+[xUnit.net 00:00:00.08]   Discovering: Deal.Tests.Unit
+[xUnit.net 00:00:00.12]   Discovered:  Deal.Tests.Unit
+[xUnit.net 00:00:00.14]   Starting:    Deal.Tests.Unit
+[xUnit.net 00:00:00.18]   Finished:    Deal.Tests.Unit
+Сводка теста: всего: 1; сбой: 0; успешно: 1; пропущено: 0; длительность: 1,4 с
+Сборка успешно выполнено через 4,5 с
+```
+
+## Проверки
+
+- `dotnet test tests/Deal.Tests.Unit`: 1 тест найден → 1 PASS, 0 fail, 0 skipped.
+- Сборка 0 предупреждений / 0 ошибок при TreatWarningsAsErrors=true + EnforceCodeStyleInBuild=true —
+  иначе запуск упал бы на любом предупреждении. `Directory.Build.props`/`.editorconfig` не менялись.
+- В транзитивную сборку попали все 7 referenced-проектов + `Deal.Contracts` (через SharedKernel/модули) — успешно.
+
+## Созданные файлы
+
+- `src/core/tests/Deal.Tests.Unit/Deal.Tests.Unit.csproj` (шаблон, без правок)
+- `src/core/tests/Deal.Tests.Unit/MarkerTests.cs` (по плану, verbatim)
+- `tests/Deal.Tests.Unit` добавлен в `src/core/Deal.sln`
+- `.superpowers/sdd/deal-scaffold/task-4-report.md`
+
+## Опасения / Concerns
+
+- Шаблонный `Deal.Tests.Unit.csproj` дублирует `Nullable`/`ImplicitUsings`/`TargetFramework`, уже заданные в
+  `src/core/Directory.Build.props` (net10.0). Это безопасно и не вызвало ошибок сборки.
+- `xunit.runner.visualstudio` 3.1.4 в связке с `xunit` 2.9.3 — штатная комбинация шаблона .NET 10 SDK,
+  тесты обнаружены и выполнены корректно.
+- Проект не git-репозиторий: коммитов нет, изменения зафиксированы настоящим отчётом.
+
+## Статус задачи
+
+DONE (Steps 1–4 плана выполнены; `dotnet test` → ровно 1 PASS; 0 предупреждений / 0 ошибок).

.superpowers/sdd/deal-scaffold/task-5-report.md

@@ -0,0 +1,53 @@
+# Task 5 Report: Dev-Postgres в docker compose (схема на тенанта)
+
+Date: 2026-09-05
+
+## Files created
+
+- `deploy/compose.dev.yml` — verbatim from the plan (Step 1): service `postgres`, image `postgres:16-alpine`, `container_name: deal-postgres`, host port `5433:5432`, volume `deal_pgdata`, healthcheck `pg_isready -U deal -d deal` (interval 5s, timeout 3s, retries 10).
+- `deploy/.env.example` — verbatim from the plan (Step 2): `DEAL_PG_HOST/PORT/DB/USER/PASSWORD` (`localhost:5433`, `deal`/`deal`/`deal_dev_password`).
+
+`deploy/` directory did not exist and was created.
+
+## Container status
+
+- Command: `docker compose -f deploy/compose.dev.yml up -d`
+- Result: `deal-postgres` created and started; image was already present locally (no long pull).
+- Final status: `Up (healthy)` on `0.0.0.0:5433->5432/tcp`.
+- Existing LeadRadar containers (`leadradar`, `leadradar-ml`, `leadradar-minio`) were NOT touched and remain running.
+
+## psql verification (Step 4)
+
+Command:
+
+```
+docker exec deal-postgres psql -U deal -d deal -c "SELECT current_database(), current_schema();"
+```
+
+Output:
+
+```
+current_database | current_schema
+------------------+----------------
+ deal             | public
+(1 row)
+```
+
+Expected `deal | public` — PASS. DB `deal`, default schema `public` ready for migrations.
+
+## README change (Step 5)
+
+Appended to root `README.md` (existing content intact):
+
+```markdown
+## Запуск dev-окружения
+
+Postgres (схема на тенанта): `docker compose -f deploy/compose.dev.yml up -d`
+```
+
+## Concerns
+
+- None blocking. Minor notes:
+  - Password `deal_dev_password` is hardcoded dev-only value, fine for local dev per plan.
+  - Compose project name defaults to `deploy` (network `deploy_default`, volume `deploy_deal_pgdata`), since no `name:` was set in the plan file. Expected per plan; consistent on any host using `-f deploy/compose.dev.yml`.
+  - `postgres:16-alpine` was already cached locally, so startup was fast; first pull on a fresh host will take longer.

.superpowers/sdd/deal-scaffold/task-6-report.md

@@ -0,0 +1,54 @@
+# Task 6 — Tenant-контекст и подключение к Postgres (отчёт)
+
+**Дата:** 2026-09-05
+**Статус:** ✅ Выполнено (build 0 warnings / 0 errors, 3 теста PASS)
+
+## Файлы
+
+### Созданы (по коду плана, verbatim)
+- `src/core/Deal.SharedKernel/Tenants/TenantId.cs` — `readonly record struct TenantId`, валидация непустого `Value`, `SchemaName => "tenant_{Value}"`.
+- `src/core/Deal.SharedKernel/Tenants/ITenantContext.cs` — `TenantId? TenantId`, `HasTenant`, `string? SchemaName`.
+- `src/core/Deal.Infrastructure/Data/TenantContext.cs` — `AsyncLocal<TenantId?>`, имплементирует `ITenantContext` + `SetTenant`.
+- `src/core/Deal.Infrastructure/Data/ConnectionStringProvider.cs` — ctor бросает `InvalidOperationException` без `ConnectionStrings:DealPostgres`; `ForTenant` добавляет `;Search Path=...`.
+- `tests/Deal.Tests.Unit/TenantIdTests.cs` — 2 теста: `SchemaName_PrefixesTenant`, `TenantId_Empty_Throws`.
+
+### Изменены
+- `src/core/Deal.Api/Program.cs` — добавлены `using Deal.Infrastructure.Data;` и `using Deal.SharedKernel.Tenants;`, зарегистрированы `builder.Services.AddSingleton<ITenantContext, TenantContext>();` и `AddSingleton<ConnectionStringProvider>();`. `/api/health` и `public partial class Program` не тронуты.
+- `src/core/Deal.Infrastructure/Deal.Infrastructure.csproj` — добавлен `PackageReference Microsoft.Extensions.Configuration.Abstractions 10.0.11` (командой `dotnet add`, Ruling 4).
+
+## Отклонение от кода плана (требование стиля репозитория)
+
+`ITenantContext.cs`: члены интерфейса получили явный `public` (план их опускал). Иначе сборка падает с `IDE0040` (error): в корневом `C:\telbase\.editorconfig` задано `dotnet_style_require_accessibility_modifiers = always:error`, а `EnforceCodeStyleInBuild=true` + `TreatWarningsAsErrors=true`. Изменение семантики не меняет — члены интерфейса и так public. `.editorconfig`/`Directory.Build.props` не редактировались.
+
+`TenantId` (record struct с property-initializer-валидацией) успешно компилируется под net10.0 — перепроектирование не потребовалось.
+
+## Build
+
+Команда: `dotnet build Deal.sln` (из `src/core`)
+
+```
+Восстановление завершено (0,8 с)
+  Deal.SharedKernel net10.0 успешно выполнено
+  ...
+  Deal.Api net10.0 успешно выполнено (0,6 с)
+Сборка успешно выполнено через 2,5 с
+```
+
+Результат: 0 warnings, 0 errors (11 проектов собраны).
+
+## Tests
+
+Команда: `dotnet test tests/Deal.Tests.Unit --no-build`
+
+```
+Сводка теста: всего: 3; сбой: 0; успешно: 3; пропущено: 0; длительность: 1,1 с
+```
+
+PASS: `MarkerTests` (1) + `TenantIdTests` (2) = ровно 3.
+
+## Concerns / заметки
+
+1. **Template-level conflict (план vs .editorconfig):** код `ITenantContext` в плане не проходит `IDE0040` — потребовался явный `public` на членах интерфейса. Аналогичное стоит ожидать в будущих задачах, где план опускает модификаторы доступа у членов интерфейса.
+2. `ConnectionStringProvider` зарегистрирован в DI, но нигде не резолвится (как и задумано для Task 6) — конструктор с `InvalidOperationException` при отсутствии `ConnectionStrings:DealPostgres` сработает только с Task 7 (appsettings).
+3. NuGet-пакет выбран как `10.0.11` (latest stable, совместим с net10.0). Версия не зафиксирована в плане; при централизованном управлении пакетами (CPM) отсутствует — правок не требуется.
+4. Загруженных файлов-маркеров (`SharedKernelMarker.cs`, `InfrastructureMarker.cs`) не касались.

.superpowers/sdd/deal-scaffold/task-7-report.md

@@ -0,0 +1,91 @@
+# Task 7 — EF Core + миграции (public) (отчёт)
+
+**Дата:** 2026-09-05
+**Статус:** ✅ Выполнено (build 0 warnings / 0 errors; 4 теста PASS; миграция `InitialPublic` применена к `public`)
+
+## Файлы
+
+### Созданы (по коду плана, verbatim)
+- `src/core/Deal.Infrastructure/Persistence/Entities/TenantEntity.cs` — `TenantEntity` (`Guid Id`, `Name = string.Empty`, `Status = "active"`, `CreatedAt`).
+- `src/core/Deal.Infrastructure/Persistence/DealDbContext.cs` — `DealDbContext` + `DbSet<TenantEntity> Tenants`; в `OnModelCreating`: `ToTable("tenants", "public")`, `HasKey(Id)`, `Name` max 200 / required.
+- `src/core/Deal.Infrastructure/Persistence/DealDbDesignTimeFactory.cs` — `IDesignTimeDbContextFactory<DealDbContext>`; строка из env `DEAL_PG_CONNECTION`, fallback `Host=localhost;Port=5433;Database=deal;Username=deal;Password=deal_dev_password` (рабочий dev-Postgres Task 5).
+- `src/core/Deal.Infrastructure/Migrations/20260905190044_InitialPublic.cs` + `.Designer.cs` + `DealDbContextModelSnapshot.cs` — сгенерированы `dotnet ef migrations add InitialPublic`.
+- `tests/Deal.Tests.Unit/TenantEntityTests.cs` — тест дефолтов (см. Concern 3: строка `Assert.NotEqual` из плана скорректирована).
+
+### Изменены
+- `src/core/Deal.Infrastructure/Deal.Infrastructure.csproj` — добавлены пакеты (см. ниже).
+- `src/core/Deal.Api/Deal.Api.csproj` — добавлен `Microsoft.EntityFrameworkCore.Design` 10.0.11 с `PrivateAssets=all` (см. Concern 2).
+- `src/core/Deal.Api/Program.cs` — добавлены `using Deal.Infrastructure.Persistence;` и `using Microsoft.EntityFrameworkCore;`; после `CreateBuilder` добавлены `GetConnectionString("DealPostgres")` с тем же fallback и `builder.Services.AddDbContext<DealDbContext>(options => options.UseNpgsql(connectionString));`. Существующие 2 singleton-регистрации, `/api/health` и `public partial class Program` не тронуты.
+- `src/core/Deal.Api/appsettings.Development.json` — файл уже существовал (стандартный `Logging` от шаблона); блок `ConnectionStrings:DealPostgres` **добавлен к существующему содержимому** (merge, а не замена).
+- `tests/Deal.Tests.Unit/Deal.Tests.Unit.csproj` — добавлен ProjectReference на `Deal.Infrastructure` (Ruling 3, командой `dotnet add`).
+
+## Пакеты NuGet (версии, resolved latest stable для net10.0)
+
+Deal.Infrastructure:
+- `Microsoft.EntityFrameworkCore` **10.0.11**
+- `Microsoft.EntityFrameworkCore.Design` **10.0.11** (PrivateAssets=all, добавлен `dotnet add` автоматически)
+- `Microsoft.EntityFrameworkCore.Relational` **10.0.11** (см. Concern 1 — добавлен сверх списка плана)
+- `Npgsql.EntityFrameworkCore.PostgreSQL` **10.0.3**
+- (ранее, Task 6) `Microsoft.Extensions.Configuration.Abstractions` 10.0.11
+
+Deal.Api:
+- `Microsoft.EntityFrameworkCore.Design` **10.0.11** (PrivateAssets=all; см. Concern 2)
+
+## dotnet-ef: локальный tool
+
+Глобально dotnet-ef **не установлен** (`dotnet tool list --global`: только `dotnet-dump`, `ilspycmd`). По Ruling 5 создан локальный манифест:
+- `dotnet new tool-manifest` → SDK 10 создал манифест **в `src/core/dotnet-tools.json`** (не в `.config/`, как в документации SDK 8/9).
+- `dotnet tool install dotnet-ef` → **dotnet-ef 10.0.11**, запись добавлена в `src/core/dotnet-tools.json` (`isRoot: true`). Никакой манифест «выше» не найден — `dotnet new tool-manifest` сообщений о существующем не выдавал.
+
+## Миграция и БД
+
+Команды (из `src/core`, локальный tool):
+```
+dotnet ef migrations add InitialPublic --project Deal.Infrastructure --startup-project Deal.Api
+Build started... Build succeeded. Done.
+dotnet ef database update --project Deal.Infrastructure --startup-project Deal.Api
+Applying migration '20260905190044_InitialPublic'. Done.
+```
+
+Проверка (docker exec deal-postgres psql -U deal -d deal -c "\dt public.*"):
+```
+ Schema |         Name          | Type  | Owner
+--------+-----------------------+-------+-------
+ public | __EFMigrationsHistory | table | deal
+ public | tenants               | table | deal
+(2 rows)
+```
+
+Дизайн-тайм фабрика использовала fallback-строку (env `DEAL_PG_CONNECTION` не задан).
+
+## Build
+
+Команда: `dotnet build Deal.sln` (из `src/core`)
+
+```
+Deal.SharedKernel net10.0 успешно выполнено
+...
+Deal.Api net10.0 успешно выполнено (0,4 с)
+Сборка успешно выполнено через 2,3 с
+```
+
+Результат: **0 warnings, 0 errors** (11 проектов).
+
+## Tests
+
+Команда: `dotnet test tests/Deal.Tests.Unit`
+
+```
+Сводка теста: всего: 4; сбой: 0; успешно: 4; пропущено: 0; длительность: 1,0 с
+```
+
+PASS: `MarkerTests` (1) + `TenantIdTests` (2) + `TenantEntityTests` (1) = ровно 4.
+
+## Concerns / заметки
+
+1. **`Microsoft.EntityFrameworkCore.Relational` 10.0.11 добавлен явно (сверх 3 пакетов плана).** Причина: пакет `Microsoft.EntityFrameworkCore` 10.0.11 НЕ зависит от Relational (его nuspec тянет только Abstractions/Analyzers/Caching.Memory/Logging). Единственным источником Relational в графе `Deal.Api` оказывается Npgsql.EntityFrameworkCore.PostgreSQL 10.0.3 с диапазоном `[10.0.4, 11.0.0)`; NuGet выбирает минимальную версию диапазона → Relational 10.0.4, тогда как `Deal.Infrastructure` собирается против 10.0.11 (через Design 10.0.11 с PrivateAssets=all — виден только в собственном графе). Итог: MSB3277 (конфликт версий Relational) в сборке `Deal.Api`. Явная ссылка `Relational` 10.0.11 в Infrastructure (транзитивно утекает в Api) выравнивает все EF-сборки на 10.0.11. MSB3277 — MSBuild-warning (не C#), поэтому TreatWarningsAsErrors его не превращал в error, но требование «0 warnings» нарушалось.
+2. **`Microsoft.EntityFrameworkCore.Design` добавлен в `Deal.Api` (PrivateAssets=all).** `dotnet ef` требует Design-пакет в **startup**-проекте: `Your startup project 'Deal.Api' doesn't reference Microsoft.EntityFrameworkCore.Design...`. Ссылка в Infrastructure имеет `PrivateAssets=all` и в Api не утекает, поэтому первая попытка `migrations add` упала с этой ошибкой. После добавления в Api миграция создалась штатно (дизайн-тайм фабрика при этом по-прежнему из Infrastructure).
+3. **Тест скорректирован (единственное отступление от verbatim-кода плана).** Строка плана `Assert.NotEqual(Guid.Empty, entity.Id == Guid.Empty ? Guid.Empty : entity.Id);` невыполнима: `TenantEntity.Id` — автосвойство `Guid` без инициализатора → всегда `Guid.Empty`, тернарник всегда возвращает `Guid.Empty`, и `NotEqual(Guid.Empty, Guid.Empty)` падает (проверено: 1 FAIL на verbatim-версии). План под кодом сам разрешает правку: «тест проверяет дефолты; при необходимости скорректировать под реальную модель». Строка заменена на проверки реальных дефолтов: `Status == "active"`, `Name == string.Empty`, `CreatedAt == default(DateTimeOffset)`. Ожидание Task 13 (4 PASS) при verbatim-строке недостижимо.
+4. `appsettings.Development.json` уже существовал (Logging-блок); `ConnectionStrings` добавлены merge-правкой — стандартный шаблонный блок сохранён.
+5. `.editorconfig`/`Directory.Build.props` не редактировались. Генерённые миграционные файлы (`.Designer.cs`, Snapshot) предупреждений при сборке не дают.
+6. Проект не является git-репозиторием: коммиты/ветки не создавались (как и во всех предыдущих задачах).

.superpowers/sdd/deal-scaffold/task-8-report.md

@@ -0,0 +1,42 @@
+# Task 8 Report: Применение миграций ко всем схемам тенантов
+
+**Status:** DONE (with one documented deviation in the test file — see Concerns)
+
+## Files
+
+| File | Action |
+|---|---|
+| `src/core/Deal.Infrastructure/Migrations/TenantSchemaMigrator.cs` | Created (verbatim, plan lines 736–751) |
+| `src/core/tests/Deal.Tests.Unit/TenantSchemaMigratorTests.cs` | Created (test 1 verbatim; test 2 assertion repaired — see Concerns) |
+
+`TenantSchemaMigrator` is a single public static type in its own file with XML-doc from the plan.
+`CreateSchemaSql` uses doubled-quote identifier escaping (`Replace("\"", "\"\"")`); `ListTenantSchemasSql` is verbatim. Production code NOT modified relative to the plan.
+
+## Build output
+
+`dotnet build Deal.sln` — succeeded: 11/11 projects, **0 warnings / 0 errors**.
+
+## Test output
+
+`dotnet test tests/Deal.Tests.Unit --no-build` — **6 PASS / 0 FAIL** (4 existing + 2 new `TenantSchemaMigratorTests`).
+
+## Concerns / Deviation
+
+1. **Plan's test assertion was self-contradictory (verbatim code + verbatim test could not pass).**
+   Plan test 2 asserted `Assert.DoesNotContain("\"b\"", sql)` for input `tenant_a"b`.
+   With the sanctioned doubling escape the output is `CREATE SCHEMA IF NOT EXISTS "tenant_a""b"`, which
+   necessarily *contains* the substring `"b"` (2nd quote of the escaped pair `""` → `b` → closing `"`).
+   The assertion fails for any implementation that keeps the quote inside the identifier, and would even
+   pass for a quote-*stripping* bug — it tests nothing. The plan's own Step 3 criterion ("expected 6 PASS")
+   was therefore unreachable with that literal assertion.
+2. **Fix applied (test-only, minimal):** replaced the broken single assertion with two meaningful ones:
+   `Assert.Contains("\"tenant_a\"\"b\"", sql)` (quote is doubled) and
+   `Assert.DoesNotContain("\"tenant_a\"b\"", sql)` (raw unescaped form is absent).
+   Production code untouched. Precedent for adjusting plan tests to reality exists in plan Task 7's note.
+3. First test (`CreateSchemaSql_IsEscaped`) kept verbatim and passes.
+4. 1 public type = 1 file respected. `Directory.Build.props` untouched. No git operations performed.
+
+## Verification
+
+- Build: `dotnet build Deal.sln` → «Сборка успешно выполнено», 0 warnings/errors.
+- Tests: `dotnet test tests/Deal.Tests.Unit --no-build` → «всего: 6; сбой: 0; успешно: 6».

.superpowers/sdd/deal-scaffold/task-9-report.md

@@ -0,0 +1,53 @@
+# Task 9 Report: CI-скрипты и финальная проверка этапа
+
+**Status:** DONE — scripts created verbatim, both pass, all four final checks green. No deviations.
+
+## Files
+
+| File | Action |
+|---|---|
+| `scripts/build.sh` | Created (verbatim, plan lines 774–778) |
+| `scripts/test.sh` | Created (verbatim, plan lines 782–787) |
+| `.superpowers/sdd/deal-scaffold/progress.md` | Appended Task 9 ledger line after Task 8 (nothing else touched) |
+
+Script contents (both use `sh`, `set -e`, resolve repo root via `$(dirname "$0")/..`):
+
+- `scripts/build.sh` → `cd src/core && dotnet build Deal.sln`
+- `scripts/test.sh` → `cd src/core && dotnet test tests/Deal.Tests.Unit`
+
+No project/source files modified. No git operations (project is not a git repo).
+
+## Script run output (Step 3, from `C:\telbase`)
+
+`sh scripts/build.sh` — succeeded: 11/11 projects built, «Сборка успешно выполнено через 1,9 с», 0 warnings/0 errors.
+`sh scripts/test.sh` — succeeded: «Сводка теста: всего: 6; сбой: 0; успешно: 6; пропущено: 0; длительность: 1,0 с» (build 2,9 с).
+
+## Final stage verification (Step 4)
+
+| # | Check | Result |
+|---|---|---|
+| 1 | `dotnet build Deal.sln` (src/core) | PASS — 11/11 projects, 0 errors, 0 warnings |
+| 2 | `dotnet test tests/Deal.Tests.Unit` (src/core) | PASS — 6 PASS / 0 FAIL / 0 skipped |
+| 3 | `docker ps` → `deal-postgres` | PASS — «Up 12 minutes (healthy)» |
+| 4 | `curl http://localhost:5080/api/health` | PASS — `{"ok":true,"service":"deal"}`; process killed, port released |
+
+Check 4 detail (background pattern from earlier tasks):
+`dotnet run --project Deal.Api --no-build --urls http://localhost:5080 &` → sleep 8 →
+`curl -s http://localhost:5080/api/health` returned `{"ok":true,"service":"deal"}` →
+`kill $APP_PID` (PID 1384) → follow-up after 2 s: `curl -m 3` exit 7 (connection refused),
+`netstat -ano` shows no LISTENING socket on :5080 (only a client-side TIME_WAIT entry, PID 0).
+App log tail confirms clean startup («Application started. Press Ctrl+C to shut down.»), no errors.
+
+## Concerns
+
+- None blocking. Minor notes:
+  - `curl` exit code (7) and netstat were used to confirm port release; a residual client-side
+    `TIME_WAIT` socket on the ephemeral port is expected and self-clears — no listening socket remains.
+  - Scripts verified under the environment's `sh` (Windows); they make no assumptions beyond POSIX `sh`
+    and `dotnet` on PATH, so they are CI-portable. No chmod needed on this platform.
+  - `dotnet run` log redirected to `/tmp/deal-api-task9.log` during the health check for diagnosability.
+
+## Verification
+
+- Ledger updated: `.superpowers/sdd/deal-scaffold/progress.md` → Task 9 line appended under «## Task status».
+- This report supersedes as the record for Task 9; no project files changed by this task.