docs(M04): prioritize renderer fidelity milestone

Work-Package: M04-RND-FIDELITY-ROADMAP-001
Agent: sindo-main-codex-renderer-roadmap
Tests: coordination, documentation, target sequence, old-link and diff gates pass
Fidelity: original build-12340 captures are authoritative; Noggit is secondary reference
This commit is contained in:
2026-08-02 17:41:18 +04:00
parent 4369dd3c91
commit f77f50c0f9
28 changed files with 279 additions and 76 deletions
+1 -1
View File
@@ -10,7 +10,7 @@
- Отделить user settings, developer settings, server connection profiles и content project settings.
- Secrets хранить вне Git/Resource; поддержать environment/OS credential provider.
- Настройки иметь schema version, defaults, validation, migration и reset-by-section.
- `Blizzlike335` сделать неизменяемым базовым профилем; enhanced settings наследуют его явно.
- `Blizzlike335` сделать неизменяемым базовым профилем; Enhanced/Racing settings наследуют его явно и не меняют default behavior.
## FND-2. Application lifecycle
+43 -1
View File
@@ -4,6 +4,43 @@
Воспроизвести визуальные правила WoW 3.3.5a и дать opt-in улучшения, сохранив frame pacing на больших мирах Godot.
## M04 execution policy
M04 выполняет renderer fidelity до Editor, network и gameplay milestones. M03
facade, ownership, streaming budgets и cache rules сохраняются: fidelity работа
расширяет services и shaders, но не возвращает прямой cross-layer доступ к
streamer internals.
Authoritative oracle — оригинальный клиент build 12340. Noggit полезен для
обзорной композиции, placements и будущего Editor viewport, но не подтверждает
точные lighting, shadow, liquid, material или effect semantics.
Reference corpus принимает versioned CSV и приватные captures. Для каждой
выбранной локации базовый набор содержит две позиции: `wide` для sky/fog/WDL и
общей композиции, `ground` для terrain/material/M2/WMO. Специализированные
water, interior, shadow, character и effect viewpoints добавляются только когда
две базовые позиции не покрывают уникальную визуальную policy.
Repository хранит schema, coordinates/camera/settings metadata, SHA-256,
comparison metrics, gap classification и human approval. Proprietary image/video
bytes остаются вне Git. Неизвестные camera/time/weather/settings поля отмечаются
как `Unknown`; их запрещено угадывать или автоматически считать parity evidence.
Обязательный порядок реализации:
1. reference manifest, validator, paired capture и semantic region diff;
2. deterministic color/gamma/sampling/alpha/fog pipeline;
3. environment/sky/weather и terrain/WDL/MCSH;
4. M2/WMO material passes и indoor/outdoor lighting;
5. graphics-setting-aware shadows и liquids;
6. GPU animation, characters, attachments, equipment и mounts;
7. particles, ribbons, weather и spell visual lifecycle;
8. Enhanced/Racing profile separation, traversal/performance/lifetime closeout.
Полный custom `RenderingDevice` backend допускается только после bounded spike,
доказавшего, что точный critical pass нельзя реализовать Godot spatial/sky/
particle/compositor механизмами в установленном performance budget.
## RND-1. Renderer architecture
- `WorldRenderFacade` принимает focus, environment snapshot и entity presentation commands.
@@ -99,4 +136,9 @@
## Gate
Видимый мир не деградирует при декомпозиции; under-foot/near-field quality готова до появления в кадре; long traversal не создаёт recurring hitches/leaks; Enhanced всегда отключаем.
Для утверждённой original-client capture matrix отсутствуют неклассифицированные
визуально различимые gaps; каждый `Verified` class имеет fixture, metrics и human
approval. Under-foot/near-field quality готова до появления в кадре; temporal
effects совпадают по phase/duration/trajectory; long traversal не создаёт
recurring hitches/leaks; Enhanced/Racing всегда отключаем и не меняет
`Blizzlike335` default behavior.
@@ -66,7 +66,7 @@
## EDT-8. Graphics extension tools
- Material/shader profile editor с Blizzlike/Enhanced comparison.
- Material/shader profile editor с Blizzlike/Enhanced/Racing comparison.
- Texture replacement/upscale overlays и mip/alpha/color-space validation.
- Water/sky/weather/light preview with fixed time and reference capture.
- Character/equipment/animation/attachment preview.