Инвентаризация Political World
📦 Source project inventory Живой документ
Political World сейчас является одним из крупнейших источников реального материала для нашей документации.
Эта страница показывает, какие знания из него можно извлечь и что ещё требует отдельного probe перед превращением в технический гайд.
Уже задокументировано
Заголовок раздела «Уже задокументировано»Рекурсия при инициализации правительства
Заголовок раздела «Рекурсия при инициализации правительства»Реальный StackOverflow из-за цикла getter/setter во время первой инициализации.
Ограничение спама событий
Заголовок раздела «Ограничение спама событий»Quiet Feed разделил внутренние события симуляции и уведомления, показываемые игроку.
Самые ценные области для следующего разбора
Заголовок раздела «Самые ценные области для следующего разбора»| Область | Что можно документировать | Текущее состояние |
|---|---|---|
| Формы правления | инициализация, переходы, public IDs, missing-state handling | частично описано |
| Идеологии | деревья, эволюция, события, отображение в UI | нужна инвентаризация исходников |
| Политические партии | состояние партий, названия, выборы, отображение | нужна инвентаризация исходников |
| Выборы | поток выборов, cooldown, event output | нужен отдельный разбор |
| Советы / soviets | альтернативные структуры власти | дизайн есть; статус реализации нужно проверить |
| Репрессии / чистки | универсальная система авторитарной политики | статус реализации нужно проверить |
| Войны | объявление войны, внезапное нападение, завершение войны | нужна инвентаризация исходников |
| Международные блоки | надстройка над ванильными alliance, саммиты, решения | статус реализации нужно проверить |
| Саммиты | физические встречи лидеров и поток уведомлений | частично представлены в event system |
| Вечный лидер | долголетие относительно расы и влияние на succession | статус реализации нужно проверить |
| API layer | переиспользуемый Political World API для аддонов | нужна инвентаризация кода/API |
| Совместимость аддонов | Scenario Tools и будущие аддоны | нужны конкретные примеры зависимостей |
| Save compatibility | сохранение политического состояния | нужны целевые save/load тесты |
| Производительность | циклы политических обновлений и масштаб мира | нужен profiling |
| Локализация | названия идеологий, партий и форм правления | нужна инвентаризация localization |
Важное правило
Заголовок раздела «Важное правило»Механика, которую мы планировали или обсуждали, не равна механике, которая реально реализована и проверена.
В этой таблице эти состояния специально не смешиваются.
Перед превращением темы в технический гайд нужно найти:
- точную версию проекта;
- соответствующие исходные файлы;
- runtime entry points;
- данные, переживающие save/load;
- лог или минимальный тестовый сценарий;
- уже встречавшиеся failure modes.
Почему недоделанные системы тоже полезны
Заголовок раздела «Почему недоделанные системы тоже полезны»Даже брошенная или незаконченная механика может дать документации:
- неудачную архитектуру;
- открытие API;
- lifecycle-проблему;
- проблему совместимости;
- полезный probe;
- bottleneck производительности.
Мы сохраняем полученное знание, не выдавая саму механику за законченную.