synthesis/IMPLEMENTATION-PLAN.md

Synthesis — Implementation Plan

Overview

Target: Vertical Slice — один полный ран через один биом (Каталитические Пустоши)
Approach: Каждая фаза даёт тестируемый, играбельный инкремент
Method: Полностью агентная разработка (AI пишет код, проверяет через Playwright и vitest)

---

Phase 0: Project Setup ✅

Цель: Собираемый, запускаемый проект с dev-инструментарием

#	Задача	Статус
0.1	Инициализация npm + зависимости (Phaser, bitECS, Vite, Vitest)	✅
0.2	TypeScript strict конфигурация	✅
0.3	Vite конфигурация (HMR, chunk splitting)	✅
0.4	Phaser game config (1280x720, pixel-art, arcade physics)	✅
0.5	BootScene с титульным экраном	✅
0.6	Cursor rules (6 правил под предметную область)	✅
0.7	Implementation plan + progress tracking	✅

Критерий готовности:

• npm run dev запускает dev-сервер
• Титульный экран виден на localhost:5173
• TypeScript компилируется без ошибок

---

Phase 1: Chemistry Engine

Цель: Ядро химической системы — элементы, реакции, соединения
Зависимости: Phase 0
Это чистая логика — идеальна для TDD (vitest)

#	Задача	Описание
1.1	Типы и интерфейсы	Element, Reaction, Compound, ReactionResult, ElementCategory, MatterState
1.2	Данные: 20 элементов	H, He, C, N, O, Na, Mg, Al, Si, P, S, Cl, K, Ca, Fe, Cu, Zn, Sn, Hg, Au — из реальной таблицы Менделеева
1.3	Реестр элементов	Загрузка из JSON, lookup по symbol/atomicNumber, валидация
1.4	Движок реакций	Ввод: элементы + условия → вывод: продукт ИЛИ причина неудачи. Lookup по отсортированному ключу реагентов (O(1))
1.5	Данные: 50 реакций	Базовые: горение, окисление, кислотно-щелочные, синтез солей, органика. Каждая с описанием науки
1.6	Соединения	Свойства: формула, название, игровой эффект, состояние, масса. Реестр с lookup
1.7	Тесты	Загрузка элементов, lookup, все 50 реакций (корректные продукты), невалидные реакции (корректные причины отказа)

Критерий готовности:

• npm run test:run — все тесты химии проходят
• Na + Cl → NaCl, H + H + O → H₂O, и т.д.
• Невалидная реакция возвращает человекочитаемую причину
• Все данные элементов соответствуют реальной таблице Менделеева

---

Phase 2: ECS Foundation

Цель: Работающая ECS с мостом к Phaser-рендерингу
Зависимости: Phase 0

#	Задача	Описание
2.1	World setup	bitECS world + контейнер времени (delta, elapsed, tick)
2.2	Core components	Position, Velocity, SpriteRef, Health, ChemicalComposition
2.3	Movement system	Обновляет Position по Velocity * delta
2.4	Phaser ↔ bitECS bridge	Синхронизация: ECS Position → Phaser sprite.x/y. Создание/удаление спрайтов по enterQuery/exitQuery
2.5	Entity factory	createEntity(world, components) → eid. Фабрика для типовых сущностей
2.6	Health system	Урон, лечение, смерть при health ≤ 0
2.7	Визуальный тест	10-20 цветных кругов двигаются по экрану — проверить скриншотом

Критерий готовности:

• Сущности рендерятся как спрайты/графика
• Движение работает (видно на скриншоте)
• Удаление сущности убирает спрайт с экрана

---

Phase 3: World Generation

Цель: Процедурный тайлмап для Каталитических Пустошей
Зависимости: Phase 2

#	Задача	Описание
3.1	Tilemap система	Phaser Tilemap из data-driven определений тайлов
3.2	Biome data	biomes.json — Каталитические Пустоши: типы тайлов, распределение, цвета
3.3	Noise генерация	simplex-noise для terrain. Высота → тип тайла. Seed-based для воспроизводимости
3.4	Типы тайлов	Выжженная земля, кислотные озёра, кристаллические формации, гейзеры, минеральные жилы
3.5	Размещение ресурсов	Руды/минералы на основе параметров биома и noise-карты
3.6	Камера	Следование за игроком, zoom (колесо мыши), clamp по границам карты
3.7	Миникарта	Упрощённая мини-карта в углу (цветные пиксели по тайлам)

Критерий готовности:

• Карта генерируется с разнообразным рельефом
• Разные тайлы визуально отличимы
• Камера плавно следует за «игроком»
• Каждый запуск даёт уникальную карту

---

Phase 4: Player Systems

Цель: Играбельный персонаж: движение, сбор, крафт, бросок
Зависимости: Phase 2, Phase 1, Phase 3

#	Задача	Описание
4.1	Player entity + контроллер	WASD движение, мышь — направление/взаимодействие
4.2	Инвентарь	Весовой (атомные массы!), слоты, stack одинаковых элементов
4.3	Сбор элементов	Взаимодействие с объектами мира (руда, озеро, растение) → элемент в инвентарь
4.4	Крафтинг	Выбрать элементы → химический движок → результат/ошибка → в инвентарь
4.5	Система броска	ПКМ — запуск элемента/соединения как снаряда. Arcade physics для полёта
4.6	Quick slots	Клавиши 1-2-3-4 для быстрого переключения подготовленных предметов
4.7	HUD	UIScene поверх GameScene: кольцо здоровья, полоска инвентаря, инфо об элементе при наведении

Критерий готовности:

• Игрок ходит по карте WASD
• Подбирает элементы с земли
• Комбинирует на верстаке — видит результат или причину неудачи
• Бросает натрий в воду — экзотермическая реакция
• HUD показывает здоровье, инвентарь, quick slots

---

Phase 5: Creatures & Ecology ✅

Цель: Живая экосистема в Каталитических Пустошах
Зависимости: Phase 2, Phase 3

#	Задача	Описание
5.1	Данные существ	3 типа: Кристаллиды (медленные, прочные), Ацидофилы (кислотные), Реагенты (парные, взрывоопасные)
5.2	AI поведение	FSM: idle → wander → feed → flee → attack. Переходы по условиям (голод, угроза, территория)
5.3	Метаболизм	Что ест, что выделяет. Ацидофилы едят минералы → выделяют кислоту
5.4	Популяционная динамика	Упрощённые Лотка-Вольтерра: рождаемость, смертность, хищничество
5.5	Жизненный цикл	Яйцо → юность → зрелость → старение → смерть → разложение (→ нутриенты)
5.6	Взаимодействие	Наблюдение (кодекс), атака, базовое приручение
5.7	Тест экосистемы	Запустить без игрока: популяции должны колебаться, не вымирать полностью

Критерий готовности:

• Существа спавнятся, двигаются, едят, размножаются, умирают
• Популяция без вмешательства достигает динамического равновесия
• Истребление хищников → перенаселение травоядных → коллапс (эмерджентно!)
• Существа реагируют на игрока

---

Phase 6: Run Cycle ✅

Цель: Полный рогалик-цикл: рождение → смерть → перерождение
Зависимости: Phase 3, Phase 4, Phase 1

#	Задача	Описание
6.1	Споровая Колыбель	Сцена пробуждения: выбор школы (Алхимик для начала)
6.2	Триггер смерти	Health ≤ 0 → запуск death sequence
6.3	Анимация смерти	Тело Адепта распадается на элементы (реальный состав: 65% O, 18% C, 10% H...)
6.4	«Момент между»	WebGL fractal shader — психоделическая визуализация перерождения
6.5	Мета-прогрессия	Кодекс (открытые элементы/реакции), споры (валюта), persistence (IndexedDB)
6.6	Фазы рана	Пробуждение → Исследование → Эскалация → Кризис → Развязка. Таймер/прогрессия
6.7	Эскалация	Нарастающая энтропия: нестабильные реакции, агрессивные существа
6.8	Кризис: Химическая Чума	Цепная реакция отравляет атмосферу. Нужна химия для нейтрализации
6.9	Школа: Алхимик	Стартовый набор (H, O, C, Na, S, Fe), принцип (химическое равновесие)

Критерий готовности:

• Полный цикл: spawn → explore → gather → craft → die → fractal → respawn
• Кодекс сохраняется между ранами
• Споры начисляются за открытия
• Эскалация ощутимо меняет поведение мира
• Кризис запускается и решается через химию
• Fractal shader работает (даже простой вариант)

---

Phase 7: Mycelium ✅

Цель: Подземная сеть, связывающая раны
Зависимости: Phase 6

#	Задача	Описание
7.1	Граф Мицелия	Структура данных (ngraph): узлы, рёбра, метаданные
7.2	Грибные узлы	Точки на карте, где Мицелий выходит на поверхность. Визуально — светящиеся споты
7.3	Запись знаний	Депозит открытий в Мицелий для будущих ранов
7.4	Извлечение знаний	«Вспышки» — фрагменты воспоминаний из прошлых ранов
7.5	Микоз	Визуальное искажение при долгом контакте с узлом. Открывает скрытую информацию
7.6	Интеграция с Колыбелью	Стартовые бонусы за споры

Критерий готовности:

• Узлы видны на карте
• Взаимодействие с узлом показывает память прошлого рана
• Знание из рана N появляется как подсказка в ране N+1
• Микоз-эффект визуально работает
• Споры тратятся на бонусы при старте рана

---

Phase 8: First Archont — Ouroboros

Цель: Первый босс-бой (головоломка, не рефлексы)
Зависимости: Phase 5, Phase 6

#	Задача	Описание
8.1	Уроборос entity	Змей, поедающий хвост. Циклические фазы атаки
8.2	Паттерн-механика	Бой = петля с нарастающей сложностью. Игрок определяет паттерн и ломает его в нужный момент
8.3	Арена	Специальная генерируемая комната на подступах к Сердцу Синтеза
8.4	Множественные решения	Химическое, физическое, наблюдательное — минимум 3 пути к победе
8.5	Награда	Архонтова Память — лор-фрагмент в Кодексе, спорная щедрая награда

Критерий готовности:

• Бой имеет узнаваемый повторяющийся паттерн
• Паттерн усложняется с каждым циклом
• Минимум 2 валидных стратегии победы работают
• Победа добавляет лор в Кодекс

---

Vertical Slice = Phase 0–8

После Phase 8 игра содержит:

• ✅ Один полный биом (Каталитические Пустоши)
• ✅ Работающая химия (~20 элементов, ~50 реакций)
• ✅ Живая экосистема (3 вида существ с динамикой популяций)
• ✅ Полный цикл рана (рождение → смерть → перерождение)
• ✅ Мета-прогрессия между ранами (Кодекс, споры)
• ✅ Мицелий (память между ранами)
• ✅ Один босс (Уроборос)
• ✅ Фрактальная сцена смерти
• ✅ Одна школа (Алхимик)
• ✅ Один тип кризиса (Химическая Чума)

Это — вертикальный срез, описанный в GDD Section X.

---

Beyond Vertical Slice (Post-MVP)

Фаза	Содержание
Phase 9	+2 биома (Кинетические Горы, Вердантовые Леса), +20 элементов, +100 реакций
Phase 10	+3 школы (Механик, Натуралист, Навигатор), принципы физики и биологии
Phase 11	Великий цикл (7 ранов): следы между ранами, Великое Обновление
Phase 12	+3 Архонта (Спора Прайма, Энтропа, Когнитон)
Phase 13	Оставшиеся биомы + школы + существа
Phase 14	Сердце Синтеза (финальный регион), нарратив
Phase 15	Аудио: лупы, эмбиент, циклические саундскейпы
Phase 16	Полировка: шейдеры, частицы, UI/UX, accessibility