# Проект «АРХИМЕД» — игровая вселенная олимпиадной математики и физики

> Интерактивная платформа для школьников 10–17 лет: сюжетные острова, ИИ-наставник, виртуальная лаборатория, дуэли и родительский кабинет. Модуль «Химия» — в расширении.

## 🌐 Живое демо (GitHub Pages)

- **Витрина проекта**: https://s5hyhbpftv-alt.github.io/arhimed/
- **MVP-приложение**: https://s5hyhbpftv-alt.github.io/arhimed/MVP/ — работает прямо в браузере (5 разделов: «Начальная школа» (1–4 кл) + 4 острова, 87 задач (71 основная + 80 для 1–4 классов), 32 урока, легенда). Голосовая озвучка и живой агент требуют локальных серверов `tts_server.py` (8124) и `агент_сервер.py` (8125) с ключом Яндекса.
- Репозиторий: https://github.com/s5hyhbpftv-alt/arhimed

## 📂 Карта файлов проекта

### Продукт и концепция
| Файл | Что это |
|---|---|
| `ПРОЕКТ_АРХИМЕД.md` | **Главный документ**: концепция + 13 разделов (резюме, рынок, аудитория, вселенная, механики, ТЗ-блоки, архитектура, монетизация, roadmap, риски, команда/финансы, метрики, шаги) |
| `ПРОТОТИП_ОСТРОВ_СИРАКУЗЫ.md` | **Дизайн-прототип первого острова**: сюжет, 6 глав, паспорта задач, механика экрана, UX-флоу, визуальный стиль, химия-тизер, план плейтеста |
| `ПРОТОТИП_ГЛАВА1_СИРАКУЗЫ.html` | **Кликабельный HTML-прототип главы 1** «Стражники»: 3 задачи, подсказки-лестница, награды, прогресс в localStorage (открой в браузере) |
| `ПРОТОТИП_ОСТРОВ_БАШНЯ_НЬЮТОНА.md` | **Дизайн-прототип второго острова** (физика) — 12 переработанных задач: кинематика, маятник, свободное падение, бросок, силы, импульс, наклонная плоскость, графики, сложение скоростей, тяготение |
| `ПРОТОТИП_ФИЗИКА_ТРЕНАЖЕР.html` | **Интерактивный тренажёр физики** «Башня Ньютона»: 26 задач (кинематика, силы, энергия, теплота, электричество, рычаг, импульс), миссии, фотореалистичные 3D-сцены (IBL, тени, SSAO), ползунки с живым расчётом, разбор с векторами (открой в браузере) |
| `ПРОТОТИП_МАТЕМАТИКА_ТРЕНАЖЕР.html` | **Интерактивный тренажёр математики** «Сиракузы»: 26 задач (Дирихле, комбинаторика, инварианты, взвешивания, НОК, периметр, объём, проценты, НОД, размещения, чётность, углы, Эйлер, дроби, движение, признаки делимости, совместная работа), миссии Архимеда, 3D-сцены, ползунки, разбор (открой в браузере) |
| `ПРОТОТИП_ОСТРОВ_ЛАБОРАТОРИЯ_ЛАВУАЗЬЕ.md` | **Дизайн-прототип третьего острова** (химия: стехиометрия, титрование, качественный анализ; Париж эпохи революции) |
| `ПРОТОТИП_ОСТРОВ_МЕНДЕЛЕЕВА.md` | **Дизайн-прототип четвёртого острова** (химия: периодичность, валентность, предсказания элементов; СПб, 1869) |
| `ПРОТОТИП_ЛАБОРАТОРИЯ_МАЯТНИК.html` | **Кликабельный прототип виртуальной лаборатории**: маятник, определение g, погрешности, автопротокол, медаль за точность (открой в браузере) |
| `ПРОТОТИП_ТИТРОВАНИЕ.html` | **Кликабельный прототип титрования**: виртуальная бюретка, переход цвета фенолфталеина, расчёт C(HCl), медаль за точность (открой в браузере) |
| `ПРОТОТИП_ХИМИЯ_ТРЕНАЖЕР.html` | **Интерактивный тренажёр химии** «Лаборатория Лавуазье»: 7 задач (молярная масса, закон сохранения, уравнения, массовая доля, молярный объём, титрование, строение атома), 3D-сцены с анимацией (молекулы, реакция H₂+O₂, титрование, атом), ползунки, миссии Лавуазье (открой в браузере) |
| `ПРОТОТИП_УРОК_ОБЪЯСНИ_И_РЕШИ.html` | **«Книга знаний Архимеда» — обучение по схеме «сначала объясни, потом реши»**: 6 интерактивных уроков по типам задач ВсОШ по математике (6–7 класс) — числа-перевёртыши, принцип Дирихле, процессы с делением (улитки), логика «чёт/нечёт — правда/ложь», круговой турнир, «оценка и пример». Каждый урок: анимированное объяснение приёма на реальной задаче ВсОШ → мини-проверка понимания → 2 задачи на закрепление с подсказками. Прогресс в `arhimed_urok_v1` (12 ⭐) |
| `ПРОТОТИП_ОНБОРДИНГ.html` | **Кликабельный прототип онбординга**: имя героя, цвет хитона, обучающая задача, выбор сложности (открой в браузере) |
| `ХАБ_ПРОТОТИП.html` | **Карта вселенной**: страница со ссылками на все HTML-прототипы и дизайн-документы (начните отсюда) |
| **`MVP/`** | **Единое MVP-приложение (M1 «ядро» + M2 «Книга знаний» + M3 «Тур/Дуэль» + голосовой агент готовы, сборка v34)** — профиль/онбординг, Путь (5 разделов: «Начальная школа» (1–4 кл) + 4 острова: 🏛 Сиракузы · 🍎 Ньютон · ⚗️ Лавуазье · 💻 Информатика), банк 87 задач (71 + 80 для началки) с движком микро-петли (подсказки-лестница, «Решение Архимеда»), раздел «Книга» с 32 уроками (28 ВсОШ + 4 для начальной школы) «объясни→реши», экран «📜 Легенда об Архимеде» (`js/legend.js`), родительский дашборд (прогноз к ВсОШ, слабые темы, лимиты). Архитектура: `data/tasks.js` + `data/lessons.js` + слои core/engine/app/dashboard/lessons/legend/simulator/duel/agent(voice/assistant/live). Запуск: `python3 -m http.server 8123` → `http://localhost:8123/MVP/` |
| `ПРОТОТИП_ВСЕЛЕННАЯ.html` | **Единая Вселенная АРХИМЕД** 🌌: всё в одном продукте — мини-онбординг (профиль в `arhimed_profile_v1`), карта 6 островов, агрегация прогресса из всех модулей (звёзды, решённые задачи, медали), ранг исследователя, открытие модулей в модальном окне, сброс прогресса (открой в браузере) |
| `МОБ_ПРИЛОЖЕНИЕ/` | **Мобильное PWA-приложение** 📱: работает на **Android и iPhone** — устанавливается на главный экран (Android: «⋮ → Добавить на главный экран», iPhone: «Поделиться → На экран „Домой“»), офлайн-режим, тач-интерфейс, нижняя навигация (Острова / Мой путь / Профиль), просмотр модулей в полноэкранном режиме, та же агрегация прогресса. Файлы: `index.html` (UI), корневые `manifest.webmanifest` + `sw.js` (кэш всех островов), иконки в `icons/`. **Запуск:** `python3 -m http.server 8000` в корне проекта → открыть `http://localhost:8000/МОБ_ПРИЛОЖЕНИЕ/` (service worker требует HTTP, не file://) |
| `chemistry-demo/` | **React-демо 3D-химии** (Vite + React + Three.js): фотореалистичное стекло (transmission/ior), объёмная жидкость, пузырьки; **драг-энд-дроп пробирок в колбу**; миссии «найди раствор», подсказки Архимеда, дневник открытий, звёзды и ранги, туториал. Запуск: `cd chemistry-demo && npm install && npm run dev` |
| `ТЗ_MVP.md` | **Детальное ТЗ на MVP**: объём, требования по ролям (MoSCoW), контент, ИИ-слой, архитектура, user stories, этапы, метрики (включая модуль «Химия») |
| `ПИТЧ_ПРЕЗЕНТАЦИЯ.md` | **Питч-дек на 12 слайдов** для инвесторов и партнёров (текст) |
| `ПИТЧ_АРХИМЕД.pdf` | **Готовая презентация 12 слайдов** (16:9, кириллица, фирменная палитра) — для показа инвесторам |
| `ФИНАНСОВАЯ_МОДЕЛЬ.md` + `ФИНАНСОВАЯ_МОДЕЛЬ_24М.csv` | **Финансовая модель**: unit-экономика, 24-месячный прогноз, 3 сценария, точка безубыточности (~M12), потребность ~21 млн ₽ |

### Подготовка к ВсОШ (6–7 классы) — для контента и родителей
| Файл | Содержание |
|---|---|
| `ВСОШ_МАТЕМАТИКА_6_7_ЗАДАНИЯ_2020_2025.md` | **Реестр материалов ВсОШ по математике за 5 лет**: устройство этапов для 6–7 классов (школьный/муниципальный, Сириус-формат, «клоны»), официальные архивы и банки заданий, **карта тем по реальным задачам 2022/23–2025/26** (6 и 7 классы) с примерами сюжетов и ответами |
| `ПРОТОТИП_УРОК_ОБЪЯСНИ_И_РЕШИ.html` | **Интерактивная реализация методики** (см. ниже): сначала объяснение приёма в анимированной форме, потом задачи. 6 уроков по реальным типам ВсОШ 6–7 классов |
| `МЕТОДИКА_ОБУЧЕНИЯ_ВСОШ_МАТЕМАТИКА_6_7.md` | **Методика обучения решению задач ВсОШ**: 14 компетенций с уровнями, «арсенал приёмов» (сигнал → действие), лестница из 7 ступеней разбора задачи, стратегия на школьном и муниципальном турах, годовой план по месяцам, ресурсы, **карта «приём ВсОШ ↔ остров АРХИМЕД»** и критерии готовности |
| `ЛЕГЕНДА_АРХИМЕДА.md` | **Легенда мира**: полная вводная история «Хранитель Внутреннего моря» — пролог, главы об островах (Сиракузы, Ньютон, Лавуазье, 💻 Цитадель Информатики), Тур и эпилог с тремя правилами Архимеда. Короткая версия встроена в приложение (экран «Легенда», `MVP/js/legend.js`) |

### Исследование рынка (6 отчётов)
| Файл | Содержание |
|---|---|
| `otchet_rossijskie_platformy.md` | 15+ российских платформ, 10 трендов, 10 пробелов рынка РФ |
| `edtech_report.md` | 15+ международных платформ, тренды, доказательная база механик |
| `otchet_motivaciya_olimpiadnaya_matematika_fizika.md` | EdTech-механики: геймификация, ИИ-тьюторы, мотивация, анти-паттерны |
| `otchet_nishi_i_boli.md` | Боли детей и родителей, незанятые ниши (топ-10) |
| `otchet_atrium.md` | Разбор конкурента «Атриум» (онлайн-школа + Физтех-лицей) |
| `otchet_ximiya.md` | Олимпиадная химия: платформы, виртуальные лаборатории, пробелы |

### Служебные
| Файл | Содержание |
|---|---|
| `ИТОГИ_ИССЛЕДОВАНИЯ.md` | Сводная выжимка исследования для команды |
| `ИНТЕРВЬЮ_ГАЙД.md` | Гайд валидационных интервью (гипотезы H1–H6) |

## 🎯 Ключевая идея (в двух словах)

**«АРХИМЕД»** = *Duolingo × AoPS × PhET × сюжетный сериал × ИИ-тьютор + родительский дашборд.*

- **Детям:** приключение вместо «ещё одного курса» — задачи вшиты в историю, ИИ-Архимед ведёт наводящими вопросами, дуэли и турниры дают драйв.
- **Родителям:** видимый прогресс, прогноз олимпиадных результатов, безопасная среда, честные деньги.
- **Ниша (доказана исследованием):** русскоязычных адаптивных тренажёров олимпиадных приёмов нет; виртуальная лаборатория экспериментального тура не существует нигде; геймификация олимпиадного уровня отсутствует у всех РФ-игроков.

## 🎨 Дизайн-система презентаций

- Шрифты: **PT Serif** (заголовки) + **Montserrat** (текст) — в папке `шрифты/` (TTF, кириллица, загружены с GitHub)
- Палитра: ночной синий `#131E36` · бронза `#B08D57` · терракота `#C96F4A` · золото `#D9A441` · мрамор `#F8F3E8`
- Авторская графика: воронка TAM/SAM/SOM, диаграмма LTV/CAC, таймлайн roadmap, меандр-декор, тёмные акцентные слайды
- Генератор: `сгенерировать_питч_pdf.py` (reportlab) → `ПИТЧ_АРХИМЕД.pdf` (12 слайдов, 16:9)

## 🚀 Следующие шаги

1. Плейтест прототипа острова «Сиракузы» (20 школьников, см. §9 прототипа) — в т.ч. на телефонах через `МОБ_ПРИЛОЖЕНИЕ/`
2. Валидационные интервью (20+ респондентов, `ИНТЕРВЬЮ_ГАЙД.md`)
3. Сборка MVP по `ТЗ_MVP.md` (2 острова, 100–150 задач, лаборатория, дуэли, кабинет родителя)
4. Питч по `ПИТЧ_ПРЕЗЕНТАЦИЯ.md` (инвесторы / олимпиадные центры / корпорации)