31 lines
2.0 KiB
Markdown
31 lines
2.0 KiB
Markdown
# Навык: модуль m02-rest-api (REST API сервера WatchBody)
|
||
|
||
> Инструкция ИИ-агенту для продолжения работы над модулем. Модуль —
|
||
> детерминированный код; навык — только инструкция (d-dev-6).
|
||
|
||
## Контекст
|
||
|
||
Модуль реализует REST API сервера v1 системы WatchBody («Феникс 6X»):
|
||
проект `Server.WatchBody.Web` (ASP.NET Core minimal API), middleware
|
||
`X-Api-Key`, `POST /api/v1/sync`, чтение тренировок и активной
|
||
программы. Алгоритм — d-dev (`std1\_rules\d\d-dev.md`); требования
|
||
модуля — `1-docs\4-modules\m02-rest-api\module_reqs.md`
|
||
(самодостаточна); план и статусы шагов — `readme.md` рядом.
|
||
|
||
## Как продолжать
|
||
|
||
1. Прочитай `1-docs\4-modules\m02-rest-api\readme.md` — найди первый
|
||
шаг со статусом ⬜ и продолжай с него (прерывание/продолжение —
|
||
d-dev-6).
|
||
2. Каждый шаг с пометкой «**Пользователь!**» завершается остановкой и
|
||
явным утверждением пользователя — переход без утверждения запрещён
|
||
(d-dev-4).
|
||
3. Код модуля — `3-app\2-cli\Server.WatchBody.Web` (+ тесты в
|
||
`Server.WatchBody.Web.Tests`); доступ к БД — только репозитории
|
||
m01 из `Server.WatchBody.Core` (Kit.Helpers), прямой SQL запрещён.
|
||
4. Формат пакета sync и сущностей `data` — module_reqs разд. 4
|
||
(копия tech-requirements 2.1–2.2); инварианты 🛡 разд. 6 нарушать
|
||
запрещено.
|
||
5. Интеграционные тесты — WebApplicationFactory против PostgreSQL 17
|
||
в docker `watchbody-pg` (порт 5433, БД `watchbody`).
|