material batching

docs/tech/ARCHI_CPU_GPU.md

@@ -16,19 +16,27 @@ Bonnes Pratiques & Guide d'Implémentation
 
 Ce document sert de spécification technique et de trame d'implémentation pour l'architecture de rendu 3D pilotée par le GPU (GPU-Driven Rendering) utilisant wgpu. L'objectif est de déléguer un maximum de charges de calcul au GPU pour soulager le CPU et maximiser les performances de parallélisme.
 
-> **État du document : ACTUEL (implémenté — Phase 3 du ROADMAP, 2026-07-20, DRAFT Étape 17).**
+> **État du document : ACTUEL (implémenté — Phase 3 du ROADMAP, Étape 17, validé 2026-09-22).**
 > La répartition CPU/GPU, le compute pass (World Matrices + Frustum Culling), l'Indirect Draw Buffer
 > et les buffers persistants en VRAM décrits ici sont en place : `shaders/gpu_driven.wgsl`
 > (deux entry points `compute_matrices` + `cull`, un module, layout explicite à 3 groupes) et les
 > buffers de slots du `Renderer` (`TransformSlot`/`MatSlot`/`BBoxSlot`/`DrawSlot`/`CullUniforms`,
 > capacité fixe de 256 slots).
-> **Écarts documentés** (cf. DRAFT Étape 17) : (D1) un draw indirect **par slot** plutôt qu'une
+> Ce document est la **référence durable** de la conception : le draft d'origine de l'Étape 17
+> (décisions D1–D14, layouts, plan de validation) a été vidé de `docs/DRAFT.md` après validation
+> et vit dans le git (`git show 3a424af:docs/DRAFT.md`) ; l'essentiel en est repris ci-dessous.
+> **Écarts documentés** (numérotation du draft d'origine) : (D1) un draw indirect **par slot** plutôt qu'une
 > commande unique fusionnée ; (D12) 256 slots, slot matrice padded à 256 o (plafond `uniform` WebGPU) ;
 > (D5) culling par **sphère** conservative dérivée de l'AABB locale du mesh, pas par l'AABB transformée
 > exacte ; (D4) single buffer, pas de double-buffering.
 > **Piège connu (2026-09-22, D14)** : l'ordre des arguments de `select` en WGSL est l'inverse de la
 > convention HLSL — l'avoir inversé a produit un bug « fenêtre noire » (entités visibles remises à 0),
 > corrigé et vérifié par readback GPU. Documenté en tête de `gpu_driven.wgsl` et dans `AGENTS.md`.
+> **Batching par material (Étape 18, 2026-09-22)** : la passe principale émet désormais les draws
+> groupés par `Material` (1 `set_pipeline` + 1 bind group @2 par matériau distinct, pas par entité ;
+> le pass d'ombre — un seul pipeline — est inchangé). Réordonnancement sûr car tous les pipelines
+> sont opaques (`BlendState::REPLACE`) ; les no-ops cullés restent émis dans leur groupe.
+> Détail : `docs/user/gpu-driven.md` § « Batching by material ».
 
 1. Répartition des Rôles : CPU vs GPU (La Source de Vérité)