Mybit Atlas

Это читательская точка входа в проект. Исходники документации остаются Markdown в Git, но Atlas собирает их в сайт с навигацией, оглавлением, поиском и диаграммами.

Где мы сейчас

Цель ближайшего цикла: получить и сохранить реальные данные тренировок, а не строить ещё одну прослойку инфраструктуры.

• Пробный Mini App доступен по публичному HTTPS и умеет сохранить тренировку в localStorage с выгрузкой JSON.
• Контракты, user_id, провенанс точек пульса и модель отметки подхода после выполнения уже приняты.
• core-service подключается к своей Postgres и накатывает миграции при старте.
• Следующая реализация — IngestSets: идемпотентно записать подходы и импортировать сохранённые JSON из пробного режима.

Что сделать владельцу

1. Провести 8–10 реальных тренировок в пробном режиме.
2. После каждой тренировки нажать «Выгрузить» и сохранить JSON.
3. Сформулировать одно решение, которое должен изменить датасет: например, «как выбирать длительность отдыха между подходами».

Подробный порядок и точки участия — в ближайшем плане.

Как читать Atlas

Раздел	Вопрос, на который отвечает
Цель	Зачем существует Mybit и что считается успехом
Текущее	Что уже сделано, что следующее и что нужно владельцу
Архитектура	Какие сервисы есть и как через них идут данные
Данные	Какие контракты и таблицы хранят факты
Решения	Почему система устроена именно так
История	Какие ошибки и разборы изменили курс

Граф трассируемости — следующий слой

Atlas будет показывать не только страницы, но и проверяемые связи между критичными артефактами:

flowchart LR
  I[GitLab issue] --> D[ADR]
  D --> P[proto field]
  P --> M[DB migration]
  M --> C[implementation]
  C --> T[test]

Узлы извлекаются из реальных файлов, а смысловые рёбра объявляются явно рядом с изменением. Проверка не угадывает: она подтверждает, что каждое указанное поле, файл, символ и тест действительно существуют. Полная модель — в TRACEABILITY.md.