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