valentineus/fparkan

Fork 0

Files

Valentin Popov 0d7ae6a017

Test / Lint (push) Failing after 1m10s

Details

Test / Test (push) Has been skipped

Details

Test / Render parity (push) Has been skipped

Details

Документирование и обновление спецификаций

- Обновлены спецификации `runtime-pipeline`, `sound`, `terrain-map-loading`, `texture`, `ui` и `wear`.
- Добавлены разделы о статусе покрытия и оставшихся задачах для достижения 100% завершенности.
- Внесены уточнения по архитектурным ролям, минимальным контрактам и требованиям к toolchain для каждой подсистемы.
- Уточнены форматы данных и правила взаимодействия между компонентами системы.

2026-02-19 11:07:04 +04:00

2.9 KiB

Raw Blame History

Documentation coverage audit

Дата аудита: 2026-02-19
Корпус данных: testdata/Parkan - Iron Strategy

1. Проверка форматов архивов

Результаты:

NRes: 120 архивов, roundtrip 120/120 (byte-identical)
RsLi: 2 архива, roundtrip 2/2 (byte-identical)
подтвержден один совместимый quirk: sprites.lib, entry 23, deflate EOF+1

Инструмент:

tools/archive_roundtrip_validator.py

2. Проверка рендерных форматов

Результаты:

MSH: 435/435 валидны
Texm: 518/518 валидны
FXID: 923/923 валидны
Terrain/Map (Land.msh + Land.map): 33/33 без ошибок/предупреждений

Инструменты:

tools/msh_doc_validator.py
tools/fxid_abs100_audit.py
tools/terrain_map_doc_validator.py

3. Глобальный статус по подсистемам

Подсистема	Статус	Что блокирует 100%
Архивы (`NRes`, `RsLi`)	практически закрыта	формализация редких не-ASCII/служебных edge-case
3D geometry (`MSH core`)	высокая готовность	семантика opaque-полей и канонический writer «с нуля»
Animation (`Res8/Res19`)	высокая готовность	полный FP-parity на всех edge-case
Material/Wear/Texture	высокая готовность	полная field-level семантика служебных флагов и writer-профиль
FXID	высокая готовность	полная field-level семантика payload по каждому opcode
Terrain/Areal map formats	высокая готовность	доменная семантика `class_id/logic_flag`, ветка `poly_count>0`
Render pipeline	хорошая	полный pixel-parity набор эталонных кадров в CI
AI/Behavior/Control/Missions/UI/Sound/Network	начальное покрытие	требуется полная спецификация форматов и runtime-контрактов

4. План доведения до 100%

Закрыть field-level семантику opaque/служебных полей в 3D/FX/terrain подсистемах.
Завершить canonical writer paths для авторинга новых ассетов без copy-through.
Зафиксировать и автоматизировать pixel/frame parity-критерии в CI.
Расширить подсистемные спецификации (AI, Behavior, Missions, Control, UI, Sound, Network) до уровня «полный формат + полный runtime-контракт + parity-тесты».

2.9 KiB Raw Blame History

Documentation coverage audit

1. Проверка форматов архивов

2. Проверка рендерных форматов

3. Глобальный статус по подсистемам

4. План доведения до 100%

2.9 KiB

Raw Blame History