2.9 KiB

Raw Blame History

Спецификация 01: LocalDb (Room) — схема

Источники: архитектура 1.2 (LocalDb), 2-db src-таблицы (зеркала), tech-req SyncQueue, Р2-Б (UUID-PK генерирует телефон).

1. База

AppDatabase (Room, version = 1): один атлет на устройство (athlete_id на сервер подставляет ключ — Ф-7.2). Все PK — UUID (String) кроме отмеченного. Timestamps — epoch millis (Long); даты (daily_log/breaks) — ISO yyyy-MM-dd (String).

2. Таблицы

Entity	Колонки (ключевые)	Примечание
`exercise`	id PK, name (UNIQUE), group_code, is_base, is_active	справочник атлета (Ф-4)
`program_version`	id PK, version, status, author, based_on_version?, body JSON, rationale, created_at	локальная копия (с сервера + локальные draft)
`workout`	id PK, program_version_id?, started_at, ended_at?, status (active/finished/cancelled), session_kind, avg_hr?
`workout_set`	id PK, workout_id FK→workout(cascade), exercise_id?, seq, weight_kg, reps, done_at, source (voice/watch/edit), in_plan, rpe?, knee_pain?
`command_log`	id PK, workout_id FK, t_offset_s, recognized_text, semantics JSON, accepted	голос m11; в m09 — ручная заготовка
`daily_log`	date PK (yyyy-MM-dd), guid (стабильный UUID записи), bp_sys?, bp_dias?, weight_kg?, hr_resting?, wellbeing?	день уникален (Ф-13.1); guid — client_guid для sync (errata 2026-10-19: сервер требует UUID у всех сущностей)
`breaks`	id PK, kind?, source (manual), started_on, planned_return?, ended_on?, note	Ф-14.2
`profile`	singleton (id=0), guid (стабильный UUID записи), sex?, birth_year?, weight_kg?, hr_max?	Ф-6; guid — client_guid для sync (errata 2026-10-19)
`sync_pending`	client_guid PK, entity, payload JSON, created_at	очередь (spec 03)

Индексы: workout_set.workout_id, sync_pending.created_at, exercise.name.

3. DAO (по одному на группу)

WorkoutDao: активная тренировка (status=active), upsert, список истории (finished/cancelled по убыванию started_at), подходы тренировки;
ExerciseDao / ProgramDao / DailyLogDao / BreakDao / ProfileDao — upsert/select;
SyncDao: pending(limit) по возрастанию created_at, deleteAll(guids), count().

4. Правила

🛡 Пишет только WorkoutCore (и SyncQueue — свой статус);
миграции: version 1, fallbackToDestructiveMigration запрещён после первого релиза (сейчас допустим — до m10);
body/semantics/payload — строки JSON (kotlinx-serialization).

2.9 KiB Raw Blame History Unescape Escape