VEU.WathBody/1-docs/4-modules/m01-server-db/agent_recommendations.md

3.5 KiB
Raw Blame History

Рекомендации агенту — этап 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 и утверждён.