Contratos de arquitetura
Padrões, alternativas e evidências
Os padrões abaixo conectam uma decisão ao lugar onde ela vive e à verificação que pode contradizê-la. Cada nome leva à seção de detalhe; os resultados descrevem os testes documentados, não garantias para qualquer cena ou hardware.
A mesma política orienta simulação, GPU e autoria: declarar o acesso, concentrar a produção de dados derivados e tornar o ciclo de vida explícito. Prefiro uma dependência que o compilador pode verificar a uma regra que exige lembrar de todos os seus consumidores.
| Padrão | Onde vive | Alternativa evitada | Evidência no cenário medido |
|---|---|---|---|
| O renderizador planeja; o backend executa | Render/RenderGraph / RHI/D3D12/DxRenderGraphExecutor | Grafo que grava comandos | 242 verificações do plano sem device. |
| Um único handoff ECS/render | RenderExtractionSystem para RenderScene | Renderizador lendo o World vivo | Adicionar 100.000 entidades sem mesh mantém as mesmas instâncias e os mesmos bytes de upload. |
| Backend nulo como solução de build | Tessera.NoD3D12.sln | Isolamento sustentado apenas por #ifdef ou busca textual | Zero Dx*.obj nas quatro configurações da solução sem D3D12. |
| Handles com geração | RHI/Handles.h | Ponteiro ou ComPtr em componente | Nove tags de handle; PSO aposentado no hot reload resulta em draw pulado, sem referência pendurada. |
| Acesso declarado e DAG de hazards | SystemDescriptor, AccessAuditor | Locks dentro do ECS | Zero mutex em ECS/; 32 sistemas: 0,68 µs com 10 mil entidades e 0,86 µs com 1 milhão. |
| Mudança estrutural diferida | CommandBuffer, PlaybackCommands | Mutar componentes durante a iteração | No teste, 1.000 entidades geram uma transição de archetype. |
| Versões para sujeira; hash para restauração | TransformState, WorldSnapshot | Flags booleanas como única fonte de validade | No quadro parado medido, a GPU Scene recebe 0 bytes de upload. |
| Um produtor por valor derivado | CanonicalCookedKey, ComputeSceneRect | Recalcular identidade ou retângulo em cada consumidor | Chave canônica compartilhada; uma chave recalculada causou uma cena magenta no diagnóstico registrado. |
| Composição com contextos explícitos | DxFramePassContext | God class ou extensão por herança | 85/85 funções virtual preservadas nas 12 extrações de módulos verificadas. |
| Defaults preservam o comportamento | QualitySettings, EffectToggle | Aplicar um perfil de qualidade sem pedido | Sem flag, a comparação de aceitação tem 0 de 1.440.000 pixels diferentes. |
| Proveniência e identidade no próprio dado | PROV, IDNT | Manifesto externo ou identidade por caminho | Varredura de 102 ms contra 316 s de recook no projeto medido; UUID preservado em IDNT. |
| Instrumentar antes de aceitar | --*-probe | Confiar apenas em build verde | Verificador pós-build confere DLLs de runtime e shaders; probes exercitam os recursos. |
