Fichiers
vercora/NOTES-AUDIT-GLOBAL.md
T
Claude b2410c365e Documentation : README, etat de MEMORY.md, suite de l'audit
- README.md (nouveau) : demarrage rapide - build Windows et Linux, donnees,
  lancement et options, tests, arborescence.
- MEMORY.md : index des notes jusqu'a la Phase 30, bloc "Etat verifie" a
  jour (builds, tests, ressources journalisees, formats GPU, options,
  validation de synchronisation, mesure sans GPU), prochaines etapes
  0bis et 4 mises a jour.
- NOTES-AUDIT-GLOBAL.md : suite donnee par la Phase 30.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MG5dK27RsN97DDm7CQRhx2
2026-10-14 19:34:37 +00:00

Brut Annotations Historique

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 30, 2026-10-13)

L'optimisation des ressources de NOTES-PHASE30.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.