max-mappings — люди и семьи в студиях MAX

Маппинг участников MAX-чатов студии воздушной акробатики: родитель → ребёнок, со связями, датами рождения и уровнями достоверности. ПД детей — репозиторий private.

Каждый чат — в отдельной папке chats/<chat_name>/ со своим README, people.yaml, mappings.yaml, mappings.db и сырым дампом. Корневой README — только индекс и общие конвенции; детали каждого чата — в его README.

Чаты

Чат	MAX id	Период	People	Разборы	README
Воздушные группы Елены Александровны	-73224225947889	08.04–31.08.2026	71	coach_portrait, parents_report, parents_profiles	chats/воздушные_группы_елены_александровны/README.md
Воздушные соревнования	-73764253008113	20.04–31.08.2026	26	—	chats/воздушные_соревнования/README.md

Люди (отдельные разделы)

Разделы по конкретным людям (не по чатам): профиль, круг общения, сырые дампы.

Человек	MAX id	Раздел
Кривоченко Светлана Вячеславовна (мама Дениса)	118692551	people/кривоченко_светлана/README.md

Общие конвенции

• Ключ людей = MAX numeric ID (не отображаемое имя — оно меняется: «сопливая», «Гравитация»). Имя в аккаунте может переименовывать.
• role: staff / parent / child / member. Ребёнок-подросток со своим аккаунтом = отдельная запись role: child со ссылкой child_of.
• status: left — больше не занимается / ушла (уточнение тренера).
• confidence (в mappings): high — ручной маппинг или полное имя ребёнка с датой рождения в чате; med — систематические упоминания «своего» ребёнка (10+); low — только совпадение фамилии.
• source: manual — указал Денис / тренер; auto — выведено из текста.
• children — список детей родителя, у каждого name + опц. max_id, born, source.
• Люди, аккаунта в чате нет, но фамилия известна — ключ "TBD", детали в notes.

Как сгенерировано

1. Парсинг MAX-протокола (WebSocket ws-api.oneme.ru): CHAT_HISTORY (op 49) пейджингом по 100 сообщений назад от «сейчас», до пустого ответа.
2. CONTACT_GET (op 32) — по одному id — для имён/дат регистрации.
3. Все правки по людям/парам — в build_mappings.py (single source of truth), не в YAML. Запуск: python3 build_mappings.py → перегенерирует все файлы чатов
   • SQLite + этот README.

Как добавить новый чат

1. Слить полный дамп в raw/dump_<chat>.jsonl.
2. В build_mappings.py описать его в списке CHATS (dir, max_id, people, maps, chat.yaml, README) — people можно выбрать как подмножество из глобального словаря.
3. Запустить билдер, закоммитить, запушить.