Contrats d’architecture
Patterns, alternatives et preuves
Ces patterns relient une décision à son implémentation et à une vérification susceptible de la contredire. Chaque nom mène à la section détaillée ; les résultats décrivent des tests documentés, pas des garanties pour toute scène ou tout matériel.
La même politique guide simulation, GPU et authoring : déclarer les accès, centraliser les valeurs dérivées et expliciter les durées de vie. Je préfère une dépendance vérifiable par le compilateur à une règle imposant de se souvenir de tous ses consommateurs.
| Pattern | Emplacement | Alternative évitée | Preuve dans le scénario mesuré |
|---|---|---|---|
| Le moteur de rendu planifie ; le backend exécute | Render/RenderGraph / RHI/D3D12/DxRenderGraphExecutor | Graphe qui enregistre des commandes | 242 vérifications du plan sans device. |
| Un seul transfert ECS/rendu | RenderExtractionSystem vers RenderScene | Moteur de rendu lisant le World vivant | Ajouter 100 000 entités sans mesh conserve les instances et les octets transférés. |
| Backend nul comme solution de build | Tessera.NoD3D12.sln | Isolation reposant uniquement sur #ifdef ou des recherches textuelles | Zéro Dx*.obj dans les quatre configurations de la solution sans D3D12. |
| Handles avec génération | RHI/Handles.h | Pointeur ou ComPtr dans un composant | Neuf tags de handle ; un PSO retiré par hot reload entraîne un draw ignoré, sans référence pendante. |
| Accès déclarés et DAG de hazards | SystemDescriptor, AccessAuditor | Locks dans l’ECS | Zéro mutex dans ECS/ ; 32 systèmes : 0,68 µs pour 10 000 entités et 0,86 µs pour un million. |
| Changements structurels différés | CommandBuffer, PlaybackCommands | Modifier les composants pendant l’itération | Dans le test, 1 000 entités produisent une transition d’archetype. |
| Versions pour les changements ; hash pour la restauration | TransformState, WorldSnapshot | Flags booléens comme seule source de validité | Dans la frame immobile mesurée, GPU Scene reçoit 0 octet d’upload. |
| Un producteur par valeur dérivée | CanonicalCookedKey, ComputeSceneRect | Recalculer identité ou rectangles chez chaque consommateur | Clé canonique partagée ; une clé recalculée a causé une scène magenta dans le diagnostic enregistré. |
| Composition avec contextes explicites | DxFramePassContext | God class ou extension par héritage | 85/85 fonctions virtual préservées dans 12 extractions de modules vérifiées. |
| Les defaults préservent le comportement | QualitySettings, EffectToggle | Appliquer un profil de qualité sans demande | Sans flag, la comparaison d’acceptation compte 0 pixel différent sur 1 440 000. |
| Provenance et identité dans la donnée | PROV, IDNT | Manifeste externe ou identité par chemin | Scan de 102 ms contre 316 s de recook dans le projet mesuré ; UUID préservé dans IDNT. |
| Instrumenter avant d’accepter | --*-probe | Se fier au seul build vert | Un vérificateur post-build contrôle DLLs de runtime et shaders ; les probes exercent les fonctionnalités. |
