doc

docs/tech/ARCHI_APP.md

@@ -15,14 +15,17 @@ stale_after: 2027-01-31
 
 wsg_lib est un moteur de rendu modulaire basé sur wgpu. Il adopte une architecture à deux niveaux : une façade de haut niveau pour la productivité et un accès bas niveau pour un contrôle total.
 
-> **État du document : CIBLE (architecture visée, en grande partie non implémentée).**
+> **État du document : ACTUEL pour la façade (`App`/`AppHandler`, §3, §4A) ; CIBLE pour la partie
+> GPU-driven (§1, §4B, §5, §6).** La façade `AppBuilder`/`App`/`AppHandler` est livrée et est le
+> **workflow recommandé** : `setup` (déclaration de la scène) → par frame `update` (mutation) →
+> `render` (défaut : `App::render_scene` = itération des entités + **rendu groupé en une passe**,
+> un `CommandEncoder`/soumission par frame ; passe d'ombre en tête si un caster est actif).
+> Exemples : `simple` (2D unlit), `cube` (3D éclairé), `demo` (vitrine : primitives, lumières,
+> ombres, caméra orbitale). Le workflow **manuel** (exemple `manual`) coexiste pour le contrôle fin.
 > Les sections §1, §4B, §5 et §6 décrivent la **cible** : pipeline GPU-driven à deux passes
 > (Compute Pass → `draw_indexed_indirect`), buffers persistants en VRAM (Transform/Matrix/BBox/Indirect)
 > et synchronisation single/double buffer. **Rien de tout cela n'existe encore dans le code** — c'est
-> la trajectoire de ROADMAP.md (et README étape 2-3). L'état **réel actuel** est dans README.md :
-> workflow manuel uniquement, `Renderer` dessine un objet par soumission, shader en NDC sans MVP.
-> La §3 (`App`/`AppHandler`) correspond à l'état actuel, à une nuance près : `render()` ne peut pas
-> encore dessiner la scène (l'acquisition/présentation de frame fonctionne, pas le rendu de la scène).
+> la trajectoire ROADMAP Phase 3.
 
 ## 1. Philosophie et Principes
 
@@ -85,7 +88,7 @@ pub trait AppHandler {
 
 - **Shaders** : Chargés avant la renderloop.
 - **PipelineCache** : Enregistre les shaders.
-- **Matériaux** : Créés avec un shader associé. Un mesh sans matériau explicite utilise `basic_shader` par défaut.
+- **Matériaux** : Créés avec un shader associé. Un mesh sans matériau explicite utilise le matériau par défaut de la scène (`standard`).
 - **Scene** : Assemblage des objets. L'utilisateur peuple la scène via `app.scene`.
 
 ### B. Boucle de Rendu — Pipeline GPU-Driven
@@ -155,3 +158,9 @@ Single buffer (phase initiale) : Update écrit, Compute lit au frame suivant —
 - **Synchronisation** : Toujours appeler `begin_compute_pass` avant `begin_render_pass` sur le même `CommandEncoder`. Les barrières entre passes sont automatiques — ne jamais insérer de barrière manuelle sauf besoin critique.
 - **Synchronisation single buffer (phase initiale)** : La séquence `queue.submit()` après chaque compute pass garantit que les données Transform sont valides avant le render pass suivant. Aucun conflit de lecture/écriture n'est possible tant que `desired_maximum_frame_latency` ≥ 3.
 - **Double Buffering (future migration)** : Sera implémenté sur les buffers Transform et Matrix seulement, pas sur BoundingBox ni Indirect Draw. Le switch se résume à : dupliquer ces deux buffers, ajouter une méthode `swap()` appelée dans `AboutToWait`, modifier les bind groups pour pointer vers l'index courant. Pas besoin de refonte architecturale.
+
+## Liens
+
+- [ARCHI_RENDU](ARCHI_RENDU.md) · [FRAME_LOOP](FRAME_LOOP.md) · [ARCHI_CPU_GPU](ARCHI_CPU_GPU.md) · [ARCHI_ARENES](ARCHI_ARENES.md)
+- Documentation utilisateur : [docs/user](../user/README.md) · [README racine](../../README.md) · [ROADMAP](../ROADMAP.md)
+- Référence API : `cargo doc -p wsg-lib --no-deps`