open-wc/targets/01-coordinates-and-seams.md

M01 — Coordinates and Architecture Seams

Outcome

Ввести независимые от scene tree типы координат, identity и streaming focus.

Steps

• Создать domain/value-object слой без Node/Resource dependencies.
• Определить canonical WoW, Godot, ADT tile/chunk и local coordinate types.
• Реализовать единственный CoordinateMapper для position и orientation.
• Собрать golden points из ADT, server spawn и оригинального клиента.
• Ввести StreamingFocus вместо неявной зависимости от active Camera3D.
• Ввести stable ContentId, EntityId и отличить их от WoW GUID/server entry.
• Запретить ручные axis conversion через code review rule/test search.

Verification

• Unit round-trip и boundary tests для всех coordinate spaces.
• Golden server spawn отображается в ожидаемой точке renderer.
• Existing render checkpoints не ухудшились.

Exit criteria

Renderer/test scene получают focus через контракт; координаты конвертируются централизованно; domain tests работают headless без сцены.

Evidence

• Date:
• Revision/worktree:
• Commands:
• Results:
• Fidelity comparison:
• Changed files:
• Remaining risks: