VEU.WathBody/1-docs/3-tech/program-import-format.md

Формат пакета программы (program-import.json)

Шаг 5 процесса разработки (std1\_process\process.md), решение ОВ-11 (ревью №3, О-4-Б, З-31). Пакет — импортируемый механизм эксплуатации (уточнение владельца 2026-10-17): назначается атлету индивидуально, нормативным источником документации разработки не является. Пример — ..\..\program-import.json (эксплуатационные данные). Импорт — --mode import (Server.WatchBody.Import), коды возврата — как у import (requirements 2.3).

1. Структура пакета

Поле	Тип	Назначение при импорте
program_id	string	внешний идентификатор пакета → src.program.external_id (UNIQUE)
version	int	номер версии; при конфликте с существующей — новая строка program_version (max+1)
based_on_version	int?	→ program_version.based_on_version
status	string	draft | active | archived → program_version.status (🛡 правила смены — Ф-10.3, program_version_update)
author	string	user | admin | rules → program_version.author (llm — v2)
created_at	ISO 8601	информационное поле (в БД — created_at строки версии)
profile	object	v1 игнорируется (не переносится в body): limitations и прочее носят справочный характер; Safety-порогами управляет только конфиг Safety.* (Р3-А). Поля задокументированы для совместимости v2
weeks	array	основное содержимое → program_version.body (см. раздел 2)
safety, nutrition, coordination_rules, metrics, rationale	mixed	переносятся в body как есть (rationale — также в колонку program_version.rationale)

2. Содержимое weeks → body

Иерархия: weeks[] → sessions[] → exercises[] → sets[] — соответствует схеме program_version.body (дизайн LLM-планирования, разд. 2):

• week (номер), goal, load_pattern — атрибуты недели;
• sessions[]: day, title, exercises[];
• exercises[]: name (→ сопоставление с src.exercise по UNIQUE(athlete_id, name); отсутствующее упражнение создаётся при импорте — группа по разделу пакета, иначе core и пометка в логе), sets[]: weight_kg, reps, rest_sec, rpe_target.
• progression_gate (у недель/пакета) — текст, в v1 переносится в body без интерпретации (правила прогрессии — конфиг Progression.*, Ф-12.2).

3. Маппинг и идемпотентность

1. program_id отсутствует в src.program → создаются program (external_id, title = program_id) и program_version (v1).
2. program_id есть → создаётся новая program_version (номер based_on_version/version из пакета; конфликт номеров — max+1 с записью в лог, код возврата 0).
3. 🛡 Неизменяемость версий не нарушается: повторный импорт никогда не переписывает существующую program_version.
4. Назначение атлета: пакет импортируется в контексте конкретного атлета (параметр режима import / сопоставление по каталогу файла); 🛡 изоляция атлетов сохраняется.
5. Ошибки схемы пакета (нет weeks, пустой program_id) — код возврата 2, файл остаётся в Import.Dir.