Contratos de arquitectura
Patrones, alternativas y evidencia
Estos patrones conectan una decisión con su implementación y con una verificación que puede contradecirla. Cada nombre enlaza a la sección detallada; los resultados describen tests documentados, no garantías para cualquier escena o hardware.
La misma política guía simulación, GPU y autoría: declarar el acceso, centralizar los valores derivados y explicitar los ciclos de vida. Prefiero una dependencia verificable por el compilador a una regla que exige recordar a todos sus consumidores.
| Patrón | Dónde vive | Alternativa evitada | Evidencia en el escenario medido |
|---|---|---|---|
| El renderizador planifica; el backend ejecuta | Render/RenderGraph / RHI/D3D12/DxRenderGraphExecutor | Grafo que graba comandos | 242 verificaciones del plan sin device. |
| Un único handoff ECS/render | RenderExtractionSystem a RenderScene | Renderizador leyendo el World vivo | Añadir 100.000 entidades sin mesh conserva instancias y bytes de upload. |
| Backend nulo como solución de build | Tessera.NoD3D12.sln | Aislamiento basado solo en #ifdef o búsquedas de texto | Cero Dx*.obj en las cuatro configuraciones de la solución sin D3D12. |
| Handles con generación | RHI/Handles.h | Puntero o ComPtr en un componente | Nueve tags de handle; un PSO retirado por hot reload provoca un draw omitido, sin referencia colgante. |
| Acceso declarado y DAG de hazards | SystemDescriptor, AccessAuditor | Locks dentro del ECS | Cero mutex en ECS/; 32 sistemas: 0,68 µs con 10 mil entidades y 0,86 µs con un millón. |
| Cambios estructurales diferidos | CommandBuffer, PlaybackCommands | Mutar componentes durante la iteración | En el test, 1.000 entidades generan una transición de archetype. |
| Versiones para cambios; hash para restauración | TransformState, WorldSnapshot | Flags booleanos como única fuente de validez | En el frame estático medido, GPU Scene recibe 0 bytes de upload. |
| Un productor por valor derivado | CanonicalCookedKey, ComputeSceneRect | Recalcular identidad o rectángulos en cada consumidor | Clave canónica compartida; una clave recalculada causó una escena magenta en el diagnóstico registrado. |
| Composición con contextos explícitos | DxFramePassContext | God class o extensión por herencia | 85/85 funciones virtual preservadas en 12 extracciones de módulos verificadas. |
| Los defaults preservan el comportamiento | QualitySettings, EffectToggle | Aplicar un perfil de calidad sin petición | Sin flag, la comparación de aceptación tiene 0 de 1.440.000 píxeles diferentes. |
| Procedencia e identidad dentro del dato | PROV, IDNT | Manifiesto externo o identidad por ruta | Escaneo de 102 ms frente a 316 s de recook en el proyecto medido; UUID preservado en IDNT. |
| Instrumentar antes de aceptar | --*-probe | Confiar solo en un build verde | Un verificador posbuild comprueba DLLs de runtime y shaders; los probes ejercitan las funciones. |
