VEU.WathBody/1-docs/2-db/src/functions.md

Слой src — список функций

Список функций слоя src; формат — d-db-7 (std1\_rules\d\d-db.md), статусная модель — d-dev-1..3 (std1\_rules\d\d-dev.md). Таблицы — tables.md (утверждены 2026-10-17). 🛡 Во всех функциях p_athlete_id обязателен (кроме athlete_* — они для сервисов владельца): изоляция атлетов. Статусы: PLAN — только в списке (спецификаций и кода нет). УТВЕРЖДЕНО (2026-10-17) — список функций к реализации утверждён. Новая редакция (2026-10-17): + breaks (break_insert/update/select), session_kind в workout_insert/update — интеграция документа перерывов (Ф-14, изменение vision 1.4). Волна 2 (Р2-Б): insert клиентских сущностей принимает p_id (uuid) (PK — UUID); Р1-А: daily_log_upsert — p_hr_resting, p_wellbeing. Утверждение новой редакции — Пользователь!

Список функций

Сущность	Функция	Статус	Параметры	Возвращает	Функция	Репозиторий	Комментарий
athlete	athlete_insert	PLAN	p_name, p_api_key_hash	int — id атлета	-	-	AdminWeb; дубликаты hash — исключение UNIQUE
athlete	athlete_update	PLAN	p_id, p_name, p_api_key_hash, p_is_blocked	int — число строк	-	-	NULL-семантики нет (db-m-8)
athlete	athlete_select	PLAN	p_api_key_hash, p_is_blocked	TABLE — строки athlete	-	-	фильтры: NULL = без фильтра; для middleware и AdminWeb
athlete	athlete_get	PLAN	p_id	TABLE — одна строка	-	-	—
athlete_profile	athlete_profile_upsert	PLAN	p_athlete_id, p_sex, p_birth_year, p_weight_kg, p_hr_max	int — id	-	-	1:1 — ON CONFLICT (athlete_id) DO UPDATE
athlete_profile	athlete_profile_get	PLAN	p_athlete_id	TABLE — одна строка	-	-	—
exercise	exercise_insert	PLAN	p_athlete_id, p_name, p_group_id, p_is_base	int — id упражнения	-	-	дубликат имени у атлета — исключение UNIQUE
exercise	exercise_update	PLAN	p_athlete_id, p_id, p_name, p_group_id, p_is_base	int — число строк	-	-	exercise_id не меняется (Ф-4.3, 🛡)
exercise	exercise_delete	PLAN	p_athlete_id, p_id	int — число строк	-	-	логическое: is_active=0 (Ф-4.2)
exercise	exercise_select	PLAN	p_athlete_id, p_name, p_group_id, p_is_base, p_is_active	TABLE — строки + пары замен (MM)	-	-	по умолчанию только is_active; замены — денормализация (d-db-3)
exercise	exercise_get	PLAN	p_athlete_id, p_id	TABLE — одна строка + замены	-	-	—
exercise_replacement	exercise_replacement_insert	PLAN	p_athlete_id, p_exercise_id, p_replacement_id	int — id	-	-	оба упражнения — атлета, группа равна (проверка в функции)
exercise_replacement	exercise_replacement_delete	PLAN	p_athlete_id, p_exercise_id, p_replacement_id	int — число строк	-	-	—
program	program_insert	PLAN	p_athlete_id, p_title	int — id программы	-	-	вторая программа атлета — исключение UNIQUE
program	program_select	PLAN	p_athlete_id	TABLE — строки + активная версия	-	-	денормализация активной версии (d-db-3)
program	program_get	PLAN	p_athlete_id, p_program_id	TABLE — одна строка	-	-	—
program_version	program_version_insert	PLAN	p_athlete_id, p_program_id, p_based_on_version, p_author, p_body, p_rationale	int — id версии	-	-	version = max+1; status='draft'; body — jsonb
program_version	program_version_update	PLAN	p_athlete_id, p_id, p_status	int — число строк	-	-	🛡 меняется только статус; переходы draft→active→archived; активной становится ровно одна (сдвиг прежней в archived)
program_version	program_version_select	PLAN	p_athlete_id, p_program_id, p_status, p_author	TABLE — строки (без body)	-	-	body — отдельным get (крупный jsonb)
program_version	program_version_get	PLAN	p_athlete_id, p_id	TABLE — одна строка с body	-	-	—
workout	workout_insert	PLAN	p_athlete_id, p_id (uuid), p_program_version_id, p_started_at, p_session_kind	int — id	-	-	повтор client_guid возвращает существующий id (🛡 идемпотентность)
workout	workout_update	PLAN	p_athlete_id, p_id, p_ended_at, p_status, p_session_kind, p_avg_hr, p_facts_json, p_fit_file_id, p_hr_recovery_s	int — число строк	-	-	факты .fit дописывает FitParser; клиент — только ended/status/session_kind/avg_hr
workout	workout_select	PLAN	p_athlete_id, p_status, p_date_from, p_date_to	TABLE — карточки + подходы (агрегат jsonb)	-	-	мультикурсор/агрегат: карточка + sets (d-db-6)
workout	workout_get	PLAN	p_athlete_id, p_id	TABLE — одна строка + sets + command_log	-	-	полная карточка (Ф-9.2)
workout_set	workout_set_insert	PLAN	p_athlete_id, p_id (uuid), p_workout_id, p_exercise_id, p_seq, p_weight_kg, p_reps, p_done_at, p_source, p_in_plan, p_rpe, p_knee_pain	int — id	-	-	идемпотентность по client_guid
workout_set	workout_set_get	PLAN	p_athlete_id, p_id	TABLE — одна строка	-	-	—
command_log	command_log_insert	PLAN	p_athlete_id, p_id (uuid), p_workout_id, p_t_offset_s, p_recognized_text, p_semantics, p_accepted	int — id	-	-	🛡 не редактируется (Ф-1.5)
command_log	command_log_select	PLAN	p_athlete_id, p_workout_id	TABLE — строки	-	-	для сопоставления с .fit
daily_log	daily_log_upsert	PLAN	p_athlete_id, p_id (uuid), p_date, p_bp_sys, p_bp_dias, p_weight_kg, p_hr_resting, p_wellbeing	uuid — id	-	-	UNIQUE(athlete_id, date) — upsert; hr_resting/wellbeing — поля v1 (Р1-А)
daily_log	daily_log_select	PLAN	p_athlete_id, p_date_from, p_date_to	TABLE — строки	-	-	для сводки метрик и AdminWeb
workout_metrics	workout_metrics_upsert	PLAN	p_athlete_id, p_workout_id, p_adherence, p_tonnage, p_tonnage_by_group, p_e1pm_by_exercise, p_hr_metrics, p_red_flags	int — id	-	-	1:1, пересчёт MetricsEngine
workout_metrics	workout_metrics_select	PLAN	p_athlete_id, p_workout_id, p_date_from, p_date_to	TABLE — строки	-	-	графики AdminWeb (Ф-9.4)
breaks	break_insert	PLAN	p_athlete_id, p_id (uuid), p_kind, p_source, p_started_on, p_note	int — id	-	-	auto-ставит сервер по пропускам; manual — телефон
breaks	break_update	PLAN	p_athlete_id, p_id, p_ended_on	int — число строк	-	-	закрытие break первой сессией после возврата
breaks	break_select	PLAN	p_athlete_id, p_kind, p_date_from, p_date_to	TABLE — строки	-	-	журнал перерывов; CSV-выгрузка (документ перерывов разд. 4)