VEU.WathBody/1-docs/4-modules/m02-rest-api/SKILL.md

2.0 KiB
Raw Blame History

Навык: модуль 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).