Добро пожаловать в базу знаний и техническую документацию проекта FantasyRPG — тактической пошаговой PvE RPG с линейной сюжетной кампанией и кооперативом до 3 игроков (боевая система вдохновлена DOS2/BG3/Pillars, но объём осознанно урезан для соло-разработки — см. roadmap.md).
Единственный портал вики — этот файл. project_wiki.md в корне репозитория был его побайтовым дублем и теперь просто указывает сюда.
| Модуль | Описание | Статус |
|---|---|---|
| 🗺️ Дорожная Карта | Вехи, оценки в часах, критерии закрытия, явный список вырезанного и почему. | Основной источник правды по плану |
| 🏛️ Архитектура Проекта | Принципы Clean Architecture, слои приложения, Zero-GC — точечно, не как самоцель. | Актуально |
| 📊 Модель Домена | Герои, характеристики (HeroStats), оружие, броня, калькулятор урона. |
Описывает целевой дизайн после Вехи 0, не текущий код — см. пометки внутри файла |
| 🔄 Боевая Система (FSM) | Пошаговый движок, конечный автомат состояний, паттерн Command. | Есть известное расхождение с кодом (ICombatCommand/APCost) — см. пометки внутри файла |
| 🧝♂️ Расы и Синергии | 3 фиксированных сюжетных героя + 4 расы (четвёртая — среди врагов/NPC), синергии в коопе. | Актуально |
| 📐 Принятые решения (ADR) | Архитектурные и геймдизайнерские решения с альтернативами и причинами отказа. Неизменяемы после принятия. | Обязательны к соблюдению — статус Accepted означает «решено», а не «реализовано» |
| 🗺️ Перемещение по сетке | Сводный текущий контракт Pathfinder, стоимости, легальность клеток, AP. Перезаписывается, в отличие от ADR. |
Принятый дизайн, реализации пока ноль — начинать чтение отсюда, а не с ADR-0001 |
| 📅 Журнал Прогресса | Хроника разработки по дням. | Актуально |
| 📜 Квесты и Персистентный Мир | Персистентный спавн NPC в стиле Kingdom Come. | Отложено, не для текущего скоупа — оставлено на случай будущего сиквела |
Актуальный статус и критерии закрытия каждого этапа — в roadmap.md. Здесь — только напоминание правила: пункт считается сделанным только если он подтверждён автотестом (для Core) или запускаемым билдом (для всего остального), а не потому что файл создан. Предыдущая версия этой вики отмечала «Сессия 2 — 100% завершено», хотя расход AP не был подключён к выполнению команд ни в одном месте кода — это и есть пример того, чего это правило должно не допускать впредь.