FND — Foundation, Application and Data

Цель

Создать стабильную платформу, на которой renderer, client runtime и Godot Editor могут развиваться независимо, используя одинаковые типы и build artifacts.

FND-1. Project profiles и configuration

Ввести BuildProfile и CapabilitySet.
Отделить 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 наследуют его явно.

FND-2. Application lifecycle

Реализовать state machine Boot → DataCheck → Login → Realm → Character → Loading → InWorld → Disconnect/Recovery.
Editor, sandbox и headless modes запускать разными composition roots.
Dependency injection выполнять composition layer; не использовать scene lookup как service locator.
Autoload ограничить действительно process-wide lifecycle services. Gameplay, renderer и editor sessions должны инстанцироваться и освобождаться явно.
Каждое состояние иметь cancellation, timeout, diagnostics и deterministic cleanup.

FND-3. Domain primitives

Typed IDs: content, server entry, entity, GUID, map, area, spell, item, quest, display и sound.
Typed coordinates и orientation; запретить Vector3 как межслойный wire/domain contract.
Value objects для locale, money, duration, percentage, level, power type и flags.
Commands/events/read models не наследуют Node/Resource.
Serialization version и unknown-field policy определить до сохранения snapshots/replays.

FND-4. Asset repository

Описать archive chain/locale/patch precedence для 3.3.5a.
Отделить original source → parsed canonical data → imported Godot resource → runtime cache.
Ввести provenance: source archive/path/hash, parser version, import profile и dependency hashes.
Не изменять extracted upstream files; custom content подключать ordered overlays.
Dedup textures/materials/meshes по canonical key, а не по случайной Node lifetime.
Missing/corrupt asset policy: placeholder только в dev profile, structured error в fidelity runs.

FND-5. Binary formats и typed tables

MPQ: archive ordering, locale, listfile absence, encrypted/compressed entries.
BLP: paletted/DXT, alpha depths, mip chains, color space и wrap/filter metadata.
DBC: schema descriptors, localized strings, relationships, hot reload только в authoring mode.
WDT/WDL/ADT: tile existence, terrain, holes, layers, placements, liquids, distant data.
M2/SKIN/WMO: versioned structs, bounds, batches, materials, animation, attachments, portals.
Audio/interface assets: MP3/WAV, fonts, XML, Lua, TOC и SavedVariables formats.
Parser API возвращает typed result + diagnostics; partial parse не маскируется как success.
Differential tests сравнивают текущие parsers с независимыми implementations (warcraft-rs, wow_dbc, WowDBDefs-driven schemas) на одинаковых fixtures; reference disagreement регистрируется, а не выбирается по большинству.

FND-6. Cache and build pipeline

Единый content-addressed cache manifest для terrain/M2/WMO/characters/audio/navigation/UI.
Atomic staging → verify → publish; crash не оставляет валидно выглядящий partial artifact.
Cache version включает schema, parser, shader/material contract и profile.
Headless commands используют те же services, что Editor actions.
Добавить dependency graph и incremental rebuild по hash.
Папки generated/cache исключить из Git и при необходимости из Godot import через .gdignore.

FND-7. Native boundary

GDExtension использовать для binary parsing, compression/crypto, large buffer transforms и измеренных hot paths.
GDScript использовать для orchestration, Editor UI и presentation composition.
Перед добавлением Rust/C/C++ dependency фиксировать ABI boundary и ownership.
Через native boundary передавать packed arrays/immutable result objects, избегать вызова на каждый vertex/instance.
Версию Godot/GDExtension API закрепить; обновление проходит compatibility matrix.

FND-8. Jobs and concurrency

Общий JobScheduler: priority, bounded capacity, cancellation, progress, correlation ID.
Pure CPU work выполняется workers; scene tree и GPU resources финализируются main thread budget.
Один resource не модифицируется конкурентно; shared mutable collections защищаются.
Каждый submitted worker task дожидается completion/cleanup.
Session/world unload отменяет jobs и освобождает RIDs/resources детерминированно.

Deliverables

Foundation package без renderer/network dependencies.
Headless data probe и cache inspector.
Coordinate/parser/cache fixtures.
Architecture dependency checker.
Документированные memory/thread ownership rules.

Gate

Одинаковые входы дают одинаковые manifests; application modes собираются разными roots; domain тестируется без SceneTree; cancellation и shutdown не оставляют jobs/RIDs.

6.0 KiB Raw Permalink Blame History