# Рекомендации агенту — этап 7 (модуль m01-server-db)

> По итогам архитектурной сверки этапа 7 с документацией
> (ревью 2026-10-18). Получателю: кодирующему агенту, продолжающему
> модуль по d-dev. Базовые файлы стандарта `std1\` не править — все
> исправления только в проектных файлах этого репозитория.

## Итог сверки (что подтверждено)

- 38 psql-функций (37 `src` + 1 `ref`), 38 тестов, 38 спецификаций в
  `func_specs` — совпадает с `readme.md` (d-dev-4).
- 13 репозиториев DAL и 7 фильтров — совпадает с заявкой d-dev-6.
  Группировка по файлам (важно понимать при правках):
  - `ProgramRepository.cs` → `ProgramRepository` + `ProgramVersionRepository`;
  - `WorkoutRepository.cs` → `WorkoutRepository` + `WorkoutSetRepository` + `CommandLogRepository`;
  - `DailyLogRepository.cs` → `DailyLogRepository` + `WorkoutMetricsRepository` + `BreakRepository`;
  - `ExerciseRepository.cs` → `ExerciseRepository` + `ExerciseReplacementRepository`;
  - остальные — по файлу на класс.
- Тесты C#: 55/55 PASS, сборка без ошибок (проверено 2026-10-18).
- Шаг 7 readme («статусы функций DONE») корректно ⬜: в
  `1-docs\2-db\{src,ref}\functions.md` функции ещё `DEV`.

## Что исправить до утверждения 6.4

1. **`readme.md` модуля, шаг 5:** указано «`repository_tests\` —
   12 файлов», фактически в каталоге **11** (отдельного файла по
   `ProgramVersion` нет — его тесты внутри `ProgramRepository.md`).
   Исправить число на 11 (либо добавить недостающий файл по d-tst —
   тогда обосновать в readme). Правится только файл модуля.
2. **`1-docs\0-mng\plan.md`, строка m01:** дополнить состав модуля
   пометкой о группировке репозиториев (8 файлов → 13 классов) — чтобы
   ревью 6.4 сверялось с фактической структурой кода.

## Как продолжать работу

- Первый шаг со статусом ⬜ в `readme.md` модуля — точка входа
  (сейчас это 6.4 «Утверждение репозиториев» — шаг «**Пользователь!**»,
  без явного утверждения не переходить).
- После 6.4 — шаг 7: перевести статусы функций `DEV → DONE` в
  `1-docs\2-db\src\functions.md` и `1-docs\2-db\ref\functions.md`,
  убедиться что сборка и тесты зелёные (55/55), затем обновить статусы
  в `readme.md` модуля и `plan.md`.
- Доступ к БД — только Kit.Helpers `Db.Postgres.SqlServerHelper`;
  psql-тесты — PostgreSQL 17 в docker `watchbody-pg` (порт 5433,
  БД `watchbody`), прогон фиксировать в readme модуля.
- Новые сущности/функции не вводить без изменения `module_reqs.md` —
  состав зафиксирован шагами d-dev-2/3 и утверждён.