VEU.WathBody/1-docs/2-db

БД WatchBody (PostgreSQL)

Документация БД серверной части — шаг 6 процесса (std1\_process\process.md), правила d-db (std1\_rules\d\d-db.md), db-func (std1\_rules\db\db-func.md). Решение шага 6 — 0-mng\plan.md.

Общие сведения

• СУБД: PostgreSQL 17+; доступ — только через хранимые функции (Kit.Helpers\Db.Postgres.SqlServerHelper, tech-requirements разд. 3).
• Схемы-слои: src — основные данные (атлеты, тренировки, программы, метрики); ref — справочники (двигательные группы).
• Изоляция атлетов (🛡): каждая таблица данных несёт athlete_id; все функции слоя src принимают p_athlete_id и выбирают/пишут только в пределах атлета (requirements, Ф-8.5, инвариант раздела 5).
• Идемпотентность (🛡): клиентские сущности несут client_guid (UNIQUE) — повторная вставка возвращает существующий id (ON CONFLICT DO NOTHING + SELECT).
• JSON: версии программ и факты .fit — jsonb с проверкой схемы на стороне приложения (не в БД).

Состав

Файл	Содержание
ref\tables.md	справочники слоя ref
src\tables.md	таблицы слоя src
{слой}\functions.md	списки функций (после утверждения таблиц)

Таблица llm_calls (v2)

Журнал вызовов LLM-планировщика (дизайн LLM-планирования, разд. 8) создаётся в v2 вместе с LlmPlanner — в v1 не проектируется.