Fusionne github/ccr-8fe70239-2xoxym (session cloud du 13-14/10) dans les phases 30-31 faites sur le PC (rochers visibles, builds separes, densite des rochers, demo candidate). La phase cloud, nommee "Phase 30" dans ses commits, devient la Phase 32 : - NOTES-PHASE30.md (add/add) : la version du PC (rochers) est gardee ; celle du cloud devient NOTES-PHASE32.md. - MEMORY.md : sections 30 (rochers), 31, puis 32 (optimisation) dans l'ordre chronologique ; etat verifie en tete renomme fin de Phase 32. - References a l'optimisation renommees Phase 32 dans README.md, NOTES-AUDIT-GLOBAL.md, les commentaires du code et les libelles de tests. Les references aux rochers (Phase 30 PC) sont inchangees. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
133 lignes
14 KiB
Markdown
133 lignes
14 KiB
Markdown
# NOTES-AUDIT-GLOBAL.md — Rapport d'audit global et état des lieux du projet Vercora
|
||
|
||
Date de l'audit : 2026-08-28 (à l'issue des 26 premières phases livrées).
|
||
Machine de test : Intel Core i5-14600K (20 cœurs logiques), 64 Go RAM, GPU intégré Intel UHD Graphics 770, Windows 11 64-bit, Vulkan SDK 1.4.357.0.
|
||
|
||
---
|
||
|
||
## 1. Résumé exécutif
|
||
|
||
Après 26 phases de développement itératif livrées sans moteur tiers, le projet **Vercora est dans un état technique robuste, sain et remarquablement cohérent**. Le moteur Vulkan maison C++20 gère un terrain LiDAR réel de 25 km² (5x5 km) avec streaming par quadtree LOD, orthophoto 8192x8192, végétation instanciée à deux essences réparties par exposition solaire (adret/ubac), faune dynamique avec mémoire d'empreinte environnementale, système météo synoptique déterministe, gestion des besoins primaires et récolte/artisanat de 5 matières premières, éditeur de niveau complet et 4 modes de déplacement physiques (marche avec filtre de pente, vélo, parapente, escalade). **Zéro erreur de validation Vulkan** n'a été émise sur l'ensemble des runs. La suite de tests logiques headless compte **3 607 assertions et affiche 100 % de succès**. L'architecture a éliminé les doubles sources de vérité (température, adret/ubac, orientation solaire). Seul un défaut d'intégration résiduel de la Phase 26 (4 points de compilation oubliés dans CMake/tests) et une variabilité temporelle du harnais d'automatisation Win32 sur machine chargée ont été diagnostiqués.
|
||
|
||
---
|
||
|
||
## 2. Bilan chiffré
|
||
|
||
### 2.1 Tests unitaires & logiques headless
|
||
- **Script :** ools\run_logic_tests.bat
|
||
- **Total d'assertions vérifiées :** **3 607 / 3 607**
|
||
- **Échecs :** **0**
|
||
- **Taux de réussite :** **100 %**
|
||
- **Couverture logique :** Quadtree terrain, streaming LOD, échantillonnage de hauteur, calculs d'incidence et gradients, physique marche/pente/glissade, physique vélo (braquage, adhérence, pente max 23.6%), aérodynamique parapente (finesse, dérive, vent relatif, thermiques), mécanique d'escalade (adhérence, énergie, récupération, décrochage), simulation météo synoptique & locale, besoins primaires (faim, soif, thermorégulation, fatigue), récolte & façonnage (bois, pierre, argile, sable, fibres, résine avec essence d'arbre), catalogue et persistance de l'éditeur de niveau, partitionnement spatial et collision généralisée.
|
||
|
||
### 2.2 Suite de validation Vulkan réelle ( ools\run_vulkan_check.ps1)
|
||
- **Protocole :** 5 runs complets consécutifs (10 scénarios A..J répartis sur 14 processus distincts par run).
|
||
- **Messages [Validation] Vulkan :** **0 sur la totalité des 5 runs (0 erreur, 0 avertissement de couche)**.
|
||
- **Crashes / Plantages moteur :** **0**.
|
||
- **Taux de runs 100% verts du harnais :** **1 / 5 (20 %)** de runs entièrement validés par le script d'automatisation.
|
||
- **Diagnostic des échecs du harnais d'automatisation :**
|
||
- **Run 1 :** 100 % vert de bout en bout (0 sortie non nulle, toutes étapes validées).
|
||
- **Run 2 :** Arrêt au Scénario I (perte de message lors du test de fréquentation de 240s) ; dans les étapes précédentes, approche à 0.94 m au lieu de <= 0.80 m sur l'abattage LiDAR du scénario C.
|
||
- **Run 3 :** sommet atteint : False dans le Scénario F (escalade) et HasExited=True au démarrage de J2 (délai de libération de processus).
|
||
- **Run 4 & 5 :** Le nouveau diagnostic de santé machine (Phase 26) s'est déclenché : [ATTENTION] 6 processus n'ont pratiquement PAS RENDU D'IMAGES (perte de tics de rendu quand la machine absorbe une charge concurrente en tâche de fond, faussant les temporisations Win32 PostMessage).
|
||
- **Conclusion harnais :** Les échecs ne sont pas des bugs du jeu (qui ne crashe jamais et respecte strictement la spec Vulkan), mais des faux-négatifs inhérents au pilotage asynchrone aveugle par PostMessage/Start-Sleep sous forte charge CPU.
|
||
|
||
### 2.3 Profiling comparatif Debug vs Release (Terrain réel 25 km² / survol 900 m/s & vue stationnaire)
|
||
|
||
Les mesures confirment avec éclat les découvertes de la Phase 19 : **le profil Debug ne reflète pas la réalité du moteur**.
|
||
|
||
| Métrique | Configuration Debug | Configuration Release | Facteur de gain |
|
||
|---|---:|---:|---:|
|
||
| **Cadence (survol 900 m/s)** | 102.7 FPS (2 055 frames / 20 s) | **378.0 FPS (7 560 frames / 20 s)** | **+268 % (x3.68)** |
|
||
| **Géométrie d'une tuile LOD** | 1 936.0 µs / tuile | **163.8 µs / tuile** | **x11.8 plus rapide** |
|
||
| **Téléversement GPU d'une tuile** | 596.9 µs / tuile | **339.4 µs / tuile** | x1.76 |
|
||
| **Temps total mesh tuiles (session)** | 3 157 ms | **645 ms** | **−80 %** |
|
||
| **Poste CPU Arbres (gatherTrees)** | 3 339.5 µs / image | **484.8 µs / image** | **x6.9 plus rapide** |
|
||
| **Poste CPU Herbe (gatherGrass)** | 1 286.6 µs / image | **116.7 µs / image** | **x11.0 plus rapide** |
|
||
| **Poste CPU Fibres (gatherFiber)** | 278.2 µs / image | **26.3 µs / image** | **x10.6 plus rapide** |
|
||
| **Part du GPU (drawFrame)** | 45.1 % du temps de frame | **76.5 % à 93.9 % du frame** | **Moteur GPU-bound** |
|
||
| **Trous de streaming (tuiles vides)** | **0 frame** | **0 frame** | Parfait |
|
||
|
||
### 2.4 Matrice de fonctionnement des activités et sous-systèmes
|
||
|
||
| Système / Activité | Phase d'introduction | État fonctionnel | Vérification |
|
||
|---|---|---|---|
|
||
| **Marche & Terrain** | Phase 1..7, 24 | **Opérationnel** | Franchissement doux, arrêt au seuil de 84 %, glissade aval au-delà de 84 %, décalage caméra sans à-coup. |
|
||
| **Vélo de montagne** | Phase 13, 22 | **Opérationnel** | Prise en selle (B), accélération en descente (jusqu'à 50 km/h), pédalage en côte, calage au-delà de 23.6%, freinage et pied à terre propres. |
|
||
| **Parapente** | Phase 8, 23 | **Opérationnel** | Décollage (V), prise de portance, virages, sensibilité au vent et thermiques, atterrissage automatique au contact du sol. |
|
||
| **Escalade** | Phase 14 | **Opérationnel** | Accrochage aux parois > 84% (X), déplacement multidirectionnel, gestion de l'endurance, sortie au sommet ou au pied de paroi. |
|
||
| **Artisanat & Récolte (5 matières)** | Phase 5, 6, 22, 26 | **Opérationnel** | Bois (abattage, débitage), pierre (ramassage, percussion, éclats), argile & sable (creusage sur gisements morphologiques, refus à distance), résine (arbres résineux identifiés), fibres (arrachage en lisière et repousse). |
|
||
| **Éditeur de niveau** | Phase 15 | **Opérationnel** | Mode direct (F2), catalogue d'assets, pose au sol/visée, rotation/mise à l'échelle, suppression/undo, sauvegarde (F5) et rechargement (F9) avec collision en jeu normal. |
|
||
| **Faune & Milieu** | Phase 17, 20 | **Opérationnel** | Placement selon couvert/pente, détection du joueur, fuite dynamique, empreinte environnementale (fréquentation/déforestation) persistante par cellule. |
|
||
| **Météo déterministe** | Phase 23, 25 | **Opérationnel** | Cycle nycthéméral continu, gradient altimétrique de température (6.5 °C/km), modèle adret/ubac solaire, nuages, vent et inversions thermiques. |
|
||
| **Arguments CLI (26 flags)** | Phase 1..26 | **100 % Opérationnel** | Les 26 arguments (--demo, --no-lod, --no-ortho, --no-vegetation, --no-grass, --single-tree-species, --no-species-aspect, etc.) testés individuellement et validés avec succès. |
|
||
|
||
---
|
||
|
||
## 3. Tableau de la dette technique consolidée
|
||
|
||
| # | Sujet de la dette | Origine | État réel actuel | Criticité | Recommandation |
|
||
|---|---|---|---|---|---|
|
||
| **D1** | **Compilation CMake / Tests Phase 26** | Phase 26 | **Corrigé lors de l'audit** : TreeSpecies.cpp manquait dans CMakeLists.txt et
|
||
un_logic_tests.bat, incidence manquait dans Weather.cpp:723, et estResin() appelait l'ancienne API. | *Bloquant (Build)* | Fait. Maintenir des tests d'intégration CMake systématiques. |
|
||
| **D2** | **Flakiness du harnais Win32 (
|
||
un_vulkan_check.ps1)** | Phase 15..26 | **Ouvert (Outillage)** : Les commandes PostMessage envoyées sans accusé de réception à des intervalles fixes échouent lorsque le thread UI subit des latences ou des saccades. | *Gênant (Test)* | Conserver le diagnostic de santé (Phase 26) et envisager un mode d'auto-pilotage interne ou d'injection directe de commande dans l'engine loop pour les tests d'intégration longs. |
|
||
| **D3** | **Gestion des dégâts et de la santé du joueur** | Phase 14, 16, 24 | **Ouvert (Conception)** : Une chute en escalade ou une glissade prolongée replace le joueur au sol ou l'arrête sans affecter une jauge de santé physique (seule l'endurance est consommée). | *Cosmétique / Gameplay* | À traiter lors de la prochaine phase de gameplay (système de santé / blessures). |
|
||
| **D4** | **Placement des gisements de matières** | Phase 22 | **Ouvert (Assumé)** : Les gisements d'argile et de sable sont positionnés par heuristique morphologique (creux, talwegs, proximité de cours d'eau) et non d'après une vraie carte géologique IGN. | *Mineur (Gameplay)* | Suffisant pour le gameplay actuel ; une couche géologique pourra être introduite ultérieurement si nécessaire. |
|
||
| **D5** | **Récolte de résine dans le harnais automatisé** | Phase 22, 26 | **Ouvert (Harnais)** : Le scénario J n'exerce pas la résine car le script ne peut pas orienter la visée vers un tronc spécifique sans capturer la souris réelle de l'utilisateur. | *Outillage* | Totalement couvert et prouvé par les tests logiques headless ests\logic_tests.cpp. |
|
||
| **D6** | **Streaming partiel du terrain depuis le disque** | Phase 10 | **Non traité (Architecture)** : La heightmap complète est chargée en mémoire vive (25 Mo pour la zone 2m, 100 Mo pour la 1m). | *Négligeable* | Sur les configurations cibles modernes (16 à 64 Go de RAM), l'empreinte de 100 Mo est totalement négligeable et dispense d'un I/O asynchrone complexe. |
|
||
| **D7** | **Format d'objets pour l'éditeur (glTF)** | Phase 15 | **Non traité (Éditeur)** : L'éditeur ne charge actuellement que des fichiers .obj. | *Confort éditeur* | Ajouter inygltf / support glTF si des assets externes plus complexes sont importés. |
|
||
| **D8** | **Texture de détail de près (micro-relief)** | Phase 11 | **Non traité (Rendu)** : À 0.61 m/texel, l'orthophoto vue à ras du sol manque de micro-détail procédural sous les pieds. | *Cosmétique (Rendu)* | Envisager un shader de détail triplanaire ou un mélange de textures de détail sous les pieds. |
|
||
|
||
---
|
||
|
||
## 4. Découvertes et surprises de l'audit
|
||
|
||
1. **Surprise négative — Découverte d'un build cassé en sortie de Phase 26 :**
|
||
- Le repository tel que laissé à la fin de la Phase 26 ne compilait pas en partant de zéro : src/world/TreeSpecies.cpp n'avait été ajouté ni à CMakeLists.txt ni à ools\run_logic_tests.bat.
|
||
- Une variable incidence non déclarée causait une erreur de compilation dans src/world/Weather.cpp:723.
|
||
- estResin() dans ests/logic_tests.cpp appelait encore l'ancienne signature ResinStand::isConifer au lieu de TreeSpecies.
|
||
- *Ces points ont été immédiatement corrigés pour permettre l'audit.*
|
||
2. **Surprise positive — Rigueur architecturale sans compromis :**
|
||
- Aucune duplication de source de vérité n'a été trouvée dans le code : la température est calculée exclusivement par WeatherSystem, l'exposition solaire adret/ubac par spectSignal(), les limites de pente par SlopeLimits.hpp, les espèces d'arbres par reeSpeciesAt().
|
||
- Le moteur respecte scrupuleusement la spécification Vulkan : **0 message de validation**, destruction ordonnée de tous les buffers, textures et pipelines.
|
||
3. **Surprise positive — Performances en Release époustouflantes :**
|
||
- Le moteur tourne à **378 FPS constants sur GPU intégré Intel UHD 770** lors d'un survol de terrain à 900 m/s.
|
||
- Les temps de génération de maillage de tuiles ne prennent que **163 µs** par tuile en Release, confirmant que le choix architectural de la Phase 19 (défaut séquentiel sans surcoût de synchronisation de threads) était le bon.
|
||
4. **Validation complète des 26 flags CLI :**
|
||
- Les 26 arguments de lancement sont tous fonctionnels, reconnus sans avertissement et testés unitairement.
|
||
|
||
---
|
||
|
||
## 5. Recommandation pour la suite
|
||
|
||
### Verdict global : **VERT / PRÊT POUR DE NOUVELLES FONCTIONNALITÉS (GO)**
|
||
|
||
Le projet Vercora est sur des fondations techniques saines, stables et vérifiées. Aucune dette architecturale bloquante n'entrave le développement.
|
||
|
||
### Prochaines étapes recommandées par ordre de priorité :
|
||
|
||
1. **Boucle de Survie & Progression du Joueur :**
|
||
- Intégration d'un système de santé, blessures et fatigue liée aux activités physiques (impact des chutes en escalade, glissades, froid nocturne).
|
||
- Recettes d'artisanat combinant les 5 matières récoltées (ex: confection d'outils, cordes en fibres + résine, abris de bivouac).
|
||
2. **Amélioration du Rendu & Immersion :**
|
||
- Texture de micro-détail / micro-relief procédural pour le sol au premier plan (résolvant le flou de l'orthophoto vue de très près).
|
||
- Brouillard volumétrique / brume de vallée basée sur le champ de piégeage d'air froid du système météo.
|
||
3. **Écosystème Faune & Flore :**
|
||
- Comportements étendus de la faune (troupeaux, pâturage, cycles repos/déplacement selon l'heure météo).
|
||
- Cueillette de baies / champignons selon l'humidité et le couvert forestier.
|
||
|
||
---
|
||
|
||
## Suite donnee (Phase 32, 2026-10-13)
|
||
|
||
L'optimisation des ressources de `NOTES-PHASE32.md` reprend ce rapport :
|
||
- **D6** (heightmap entiere en RAM) : examine et CONSERVE - c'est la verite
|
||
physique, et ses altitudes ne se codent pas sans perte sur 16 bits.
|
||
- Les postes que cet audit ne chiffrait pas (format de sommet de 68 o,
|
||
topologie recopiee par tuile, une allocation Vulkan par buffer, staging en
|
||
memoire unifiee) sont traites : pic GPU du survol 285 -> 87 Mo,
|
||
~17 000 -> 22 `vkAllocateMemory` en 30 s.
|
||
- Le projet compile aussi sous Linux (GCC, Clang) et se mesure sans GPU
|
||
(lavapipe), voir `README.md`.
|