VEU.WathBody/1-docs/4-modules/m06-fit-import/api_specs/03-program-package.md

Спецификация 03: ProgramPackageImporter — пакет программы

Источники: 1-docs\3-tech\program-import-format.md, Ф-8.3, О-4-Б, 🛡3 module_reqs (неизменяемость версий).

1. Сигнатура

public Guid Import(int athleteId, string packageJson); // → version id

2. Валидация пакета (ошибка → ImportPackageException)

• корень — объект с weeks (массив, ≥ 1) и program_id (непустая строка); author ∈ user|admin (иное → ошибка; rules через пакет не задаётся, llm — v2);
• схема не валидируется глубже (body хранится как есть, v1).

3. Маппинг

1. src.program по external_id == program_id: нет → ProgramStore.EnsureProgram + запись ExternalId (ProgramRepository.Insert с параметром, З-35); есть → используется (title не меняется).
2. ProgramStore.CreateDraft(athleteId, body, author, rationale, basedOnVersion = null):
   • body — объект пакета целиком (program_id, weeks, rationale, profile — переносится как есть; в v1 профиль сервером не интерпретируется, format разд. 1);
   • version считает БД (max+1) — повтор пакета с тем же external_id → новая версия (формат разд. 3.2, 🛡3);
   • based_on_version = актуальная максимальная (гарантирует ProgramStore);
   • rationale — из пакета (поле rationale, иначе "").
3. Упражнения: weeks[].sessions[].exercises[].exercise_id — имя (UNIQUE(athlete_id, name)); отсутствующее → создание (ExerciseRepository.Insert): группа — по словарю фокусов (focus содержит push/pull/legs/cardio, иначе core) + запись в лог; существующее — не изменяется.

4. Результат

version id (для лога). Статус созданной версии — draft (🛡 авто-активации нет; активация — ProgramStore.Activate вручную).