StillHammer
9a883502bb
- Add Client/Server Modulaire architecture (Point 4) with V1/V2 progression and user/dev implications - Add Distribution Performance-Based system (Point 5) with Critical/Strategic module classification - Update CLAUDE.md to reflect modular architecture transition - Consolidate documentation: move specialized docs to toCheck/ for systematic integration - Remove obsolete architecture files replaced by integrated specifications 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
259 lines
13 KiB
Markdown
259 lines
13 KiB
Markdown
# Master Integration List - 570 Points Techniques
|
|
|
|
## 📋 Vue d'Ensemble
|
|
|
|
**Total : 570 spécifications techniques concrètes** extraites de 6 documents (2194 lignes)
|
|
**Densité : 1 spécification toutes les 3.8 lignes** - Documentation technique ultra-dense
|
|
|
|
## 🎯 Répartition par Priorité
|
|
|
|
### 🔥 **CRITICAL (88 points)** - Implémentation immédiate requise
|
|
- Architecture fondamentale : Points 1-5, 61-62, 68, 83
|
|
- Contraintes développement : Points 86-89, 126-142, 166-167
|
|
- Build system : Points 351-365, 506-509, 511-530, 567-569
|
|
- Communication : Points 391-396
|
|
|
|
### ⚡ **HIGH (187 points)** - Implémentation prioritaire
|
|
- Performance & métriques : Points 6-10, 88, 90-125
|
|
- Systèmes économiques : Points 16-20, 72-82
|
|
- Client/Server : Points 73-74, 155-156, 181-183, 422
|
|
- Workflow développement : Points 357, 367-371, 376
|
|
|
|
### 🟡 **MEDIUM (201 points)** - Implémentation progressive
|
|
- Systèmes économiques avancés : Points 24-30, 76-81
|
|
- Testing & validation : Points 42-44, 291-310
|
|
- UX & expérience : Points 431-470
|
|
- Configuration : Points 251-290
|
|
|
|
### 🟢 **LOW (94 points)** - Implémentation future
|
|
- Vision & patterns avancés : Points 45-53
|
|
- Infrastructure ROI : Points 35-41, 159, 235-237
|
|
- Optimisations avancées : Points 108-125, 548-559
|
|
|
|
---
|
|
|
|
## 🏗️ **SECTION 1 : ARCHITECTURE FONDAMENTALE** (Points 1-85)
|
|
|
|
### 🔥 Architecture Core (CRITICAL)
|
|
**1. Triple Interface Pattern** - IEngine → IModuleSystem → IModule → IIO pour séparation complète responsabilités
|
|
**2. Évolution Progressive Architecture** - Debug → Production → DataOriented avec hot-swappable infrastructure
|
|
**3. Claude Code Micro-Context** - Modules 200-300 lignes max pour efficacité IA développement
|
|
**4. Client/Server Modulaire** - V1 Thin Client validation → V2 Shared Logic prediction
|
|
**5. Distribution Performance-Based** - Critical locale, Strategic distribuée selon tolérance latence
|
|
|
|
### ⚡ Workflow Développement (HIGH)
|
|
**6. Build Autonome** - `cmake .` par module, zéro dépendance parent
|
|
**7. Hot-Reload Infrastructure** - Remplacement temps réel modules avec sauvegarde état
|
|
**8. Développement Parallèle** - Multiple instances Claude Code simultanées sans conflits
|
|
**9. CLAUDE.md Spécialisés** - Instructions contextuelles limitées par module
|
|
**10. Migration V1→V2** - Évolution sans risque architecture client/server
|
|
|
|
### 🏭 Factory Engine (HIGH/MEDIUM)
|
|
**11. ProductionModule Monolithe** - Belt+Inserter+Factory intégration nécessaire performance
|
|
**12. Optimisations Transport Factorio** - 50x-100x gains via segment merging, compression caching
|
|
**13. SOA Data Layout** - Structure Arrays pour SIMD readiness future
|
|
**14. Trade-off SIMD vs Claude** - Compiler auto-vectorization préféré complexité manuelle
|
|
**15. Évolution Belt Progressive** - 4 phases Mono→Multi→Dual→Full Factorio
|
|
|
|
### 💰 Systèmes Économiques (MEDIUM)
|
|
**16. Hiérarchie Transport** - Ship(0.10€/kg)→Train(0.50€/kg)→Air(2.00€/kg)→Truck(5.00€/kg)
|
|
**17. Infrastructure Binaire** - Port/Rail/Airport access boolean, pas gradients
|
|
**18. Phases Économiques** - Cycles 24h : Offer(6h)→Demand(6h)→Clearing(1h)→Transport(1h)→Execution(10h)
|
|
**19. Pricing Dynamique** - Base + Transport + Scarcity + Regional factors
|
|
**20. Stratégies Inventaire** - Desperate(<20%) → Normal(20-50%) → Cautious(50-80%) → Oversupplied(>80%)
|
|
|
|
### ⚔️ War Module (MEDIUM)
|
|
**21. Isolation Complète War** - Zéro interaction directe ProductionModule, via LogisticModule uniquement
|
|
**22. Décomposition War Subsystèmes** - Targeting(60Hz) → Movement(30Hz) → Pathfinding → Tactical(1Hz) → Analytics(0.1Hz)
|
|
**23. Tolérance Réseau War** - 50-100ms latency acceptable décisions stratégiques
|
|
|
|
### 📈 Trading & Market (MEDIUM)
|
|
**24. Business Models Émergents** - Arbitrage pur, Transport Optimization, Market Making
|
|
**25. Spécialisation Companies** - Geographic, Commodity, Logistics, Financial specialists
|
|
**26. Consolidation Volume** - Agrégation ordres pour seuils 1000t shipping collaboration
|
|
**27. Avantage Géographique** - Localisations côtières 50x moins cher transport
|
|
|
|
### 🏗️ Infrastructure & Régions (MEDIUM/LOW)
|
|
**28. ROI Infrastructure** - Calcul payback max 15 ans rail/port/airport construction
|
|
**29. Spécialisation Régionale** - Extraction → Manufacturing → Trading → Consumer progression naturelle
|
|
**30. Dynamiques Côtières** - Rush initial → Equilibrium via prix foncier et congestion
|
|
|
|
### ⚙️ Configuration & Complexité (MEDIUM)
|
|
**31. Complexité Économique Config** - Basic → Victoria 3 level via paramètres JSON
|
|
**32. Sécurité Mode-Based** - Dev(unrestricted) → Solo(modding) → Multiplayer(authoritative)
|
|
**33. Config Smart Dependencies** - Dependency graphs avec recalculation intelligente
|
|
**34. Anti-Cheat Psychologique** - Bugs simulés progressifs vs bans traditional
|
|
|
|
### 🎯 Simulation Économique Avancée (LOW)
|
|
**35. Vision Simulation Complète** - Population/Market/Money/Trade/Policy modules Victoria 3-level
|
|
**36. Égalité Agents Économiques** - Pas privilèges player, simulation pure
|
|
**37. Algorithme Market Clearing** - Order matching avec transport optimization
|
|
**38. Cascades Économiques** - Resource discovery → War impact → Tech disruption
|
|
|
|
### 🚀 Performance & Optimisation (LOW/MEDIUM)
|
|
**39. Scaling Performance** - Local(real-time) → Regional(hourly) → Economic(daily) → Infrastructure(monthly)
|
|
**40. Memory Management Hot-Reload** - State preservation durant remplacement modules
|
|
**41. Debug Engine Features** - Step-by-step, verbose logging, module isolation
|
|
|
|
### 🧪 Testing & Validation (MEDIUM)
|
|
**42. Unit Tests Intégrés** - `#ifdef TESTING` validation autonome modules
|
|
**43. Standalone Testing** - Test modules sans engine complet
|
|
**44. Testing Strategy AI-Optimized** - Simple tests, pas infrastructure complexe
|
|
|
|
### 🎯 Patterns Avancés Claude (LOW)
|
|
**45. Progressive Complexity Pattern** - V1→V2→V3 évolution sans réécriture
|
|
**46. Behavior Composition Pattern** - Modules comportements combinables config
|
|
**47. Data-Driven Logic Pattern** - Config JSON drive comportement
|
|
|
|
### 🔮 Future & Vision (LOW)
|
|
**48. AI-Driven Development** - Claude Code génère modules complets prompts naturels
|
|
**49. Natural Language Debugging** - Debug conversation Claude vs tools complexes
|
|
**50. Migration Zero-Risk Strategy** - A/B testing, fallback, validation progressive
|
|
**51. Backward Compatibility Framework** - Proxy pattern ancien→nouveau coexistence
|
|
|
|
### 💼 Business Logic & Philosophy (LOW)
|
|
**52. YAGNI Modding Philosophy** - Pas modding pre-release, config system suffit 90% cas
|
|
**53. "Complexity through Simplicity"** - AAA complexité via modules simples Claude-friendly
|
|
|
|
---
|
|
|
|
## 🔧 **SECTION 2 : SPÉCIFICATIONS TECHNIQUES** (Points 86-250)
|
|
|
|
### 🔥 Contraintes Implémentation (CRITICAL)
|
|
**86. Module Context Limit** - 200-300 lignes maximum par module
|
|
**87. Build Command Structure** - `cd modules/tank/ && cmake .` (NOT cmake ..)
|
|
**88. Hot-reload Time** - <5 secondes pour changements modules
|
|
**89. Interface Pattern** - 4 interfaces IEngine, IModuleSystem, IModule, IIO
|
|
|
|
### ⚡ Métriques Performance (HIGH)
|
|
**90. Transport Cost Thresholds** - Ship 0.10€/kg, Train 0.50€/kg, Air 2.00€/kg, Truck 5.00€/kg
|
|
**91. Ship Volume Threshold** - ≥1000 tonnes minimum transport maritime
|
|
**92. Claude Code Token Limit** - ~200K tokens maximum context
|
|
**93. Economic Cycle Duration** - 24h total avec phases spécifiques
|
|
**94. Storage Cost** - €0.02/kg/day inventory
|
|
**95. Delivery Times** - Ship 14j, Train 3j, Air 1j, Truck 2j
|
|
|
|
**96. Frame-Perfect Timing** - 60fps REQUIS ProductionModule
|
|
**97. Network Latency Tolerance** - 50-100ms acceptable war decisions
|
|
**98. V1 Client Target** - 30+ fps stable
|
|
**99. V2 Client Target** - 60+ fps avec prediction
|
|
**100. V1 Server Capacity** - 10+ concurrent players
|
|
**101. V2 Server Capacity** - 100+ concurrent players
|
|
**102. V1 Latency** - <150ms validation acceptable
|
|
**103. V2 Network** - 30ms server, 0ms perceived client
|
|
**104. ISocket Overhead** - >1ms INACCEPTABLE ProductionModule
|
|
**105. Context Size Improvement** - 50K+ → 200-300 lignes (250x réduction)
|
|
**106. Iteration Time** - 5-10 min → 5 sec (60-120x faster)
|
|
**107. Development Velocity** - 10x improvement Claude efficiency
|
|
**108. Hot-reload Performance** - N/A → <5 secondes
|
|
**109-125. Module Frequencies** - Production(60Hz), War(0.1-60Hz), Economics(0.01-0.1Hz)
|
|
|
|
### 🔥 Contraintes Implémentation Strictes (CRITICAL)
|
|
**126. NEVER `cd ..`** - Jamais référence directories parent modules
|
|
**127. ALWAYS `cmake .`** - Pas cmake .. pour builds modules
|
|
**128. ONLY JSON Communication** - Uniquement JSON entre modules
|
|
**129. MAX 300 Lines** - Contrainte stricte par fichier
|
|
**130. ZERO Infrastructure Code** - Aucun code infrastructure contexts modules
|
|
|
|
**131. Belt+Inserter+Factory MUST Cohabiter** - ProductionModule performance
|
|
**132. ProductionModule Size** - 500-800 lignes (trade-off accepté)
|
|
**133. No Inserters Towards Turrets** - Isolation war assets
|
|
**134. Zero Interaction** - ProductionModule ↔ WarModule
|
|
**135. Module State Preservation** - Requis durant hot-reload
|
|
|
|
**136-142. Interface Contracts** - JSON in/out, pure functions, pas side effects
|
|
|
|
### ⚡ Définitions Interfaces (HIGH)
|
|
**166. IModule Interface** - `process()`, `initialize()`, `shutdown()` methods
|
|
**167-205. Interfaces Spécialisées** - Input, Network, Tank, Economic, Transport, etc.
|
|
|
|
### 🟡 Structures Données (MEDIUM)
|
|
**206-250. Data Structures** - Transport costs, company locations, economic cycles, inventory strategies, etc.
|
|
|
|
---
|
|
|
|
## ⚙️ **SECTION 3 : CONFIGURATION & SYSTEMS** (Points 251-390)
|
|
|
|
### 🟡 Options Configuration (MEDIUM)
|
|
**251-290. Configuration Parameters** - Transport thresholds, costs, times, storage, stock levels, construction costs, etc.
|
|
|
|
### 🟡 Gestion Erreurs (MEDIUM)
|
|
**291-310. Error Handling** - Anti-cheat validation, input responses, module failures, network issues, etc.
|
|
|
|
### ⚡ Mesures Sécurité (HIGH)
|
|
**311-330. Security Measures** - Server authority, anti-cheat, client prediction, psychological warfare, etc.
|
|
|
|
### 🟡 Stratégies Déploiement (MEDIUM)
|
|
**331-350. Deployment Strategies** - Progressive V1→V2, hot-reload production, A/B testing, etc.
|
|
|
|
### 🔥 Pratiques Développement (CRITICAL)
|
|
**351-390. Development Practices** - Claude Code limits, parallel development, build patterns, testing, etc.
|
|
|
|
---
|
|
|
|
## 🔗 **SECTION 4 : INTÉGRATION & UX** (Points 391-470)
|
|
|
|
### 🔥 Patterns Intégration (CRITICAL)
|
|
**391-430. Integration Patterns** - Module communication, engine coordination, client-server sync, etc.
|
|
|
|
### 🟡 Éléments UX (MEDIUM)
|
|
**431-470. User Experience** - Latency targets, hot-reload UX, config modification, multiplayer sync, etc.
|
|
|
|
---
|
|
|
|
## 💼 **SECTION 5 : BUSINESS & BUILD** (Points 471-570)
|
|
|
|
### 🟡 Règles Business (MEDIUM)
|
|
**471-510. Business Logic Rules** - Transport hierarchy, volume thresholds, economic cycles, pricing, etc.
|
|
|
|
### 🔥 Structure Fichiers (CRITICAL)
|
|
**511-530. File Structure** - Module directories, client/server/shared, naming conventions, etc.
|
|
|
|
### 🔥 Build System (CRITICAL)
|
|
**531-570. Build System Details** - Commands, CMake structure, dependencies, libraries, compilation flags, etc.
|
|
|
|
---
|
|
|
|
## 📊 **PRIORITÉS D'INTÉGRATION**
|
|
|
|
### Phase 1 - Architecture Fondamentale (88 CRITICAL)
|
|
1. Triple Interface Pattern implementation
|
|
2. Module size constraints & build autonomy
|
|
3. Hot-reload infrastructure
|
|
4. JSON-only communication
|
|
5. Performance targets critiques
|
|
|
|
### Phase 2 - Systèmes Core (187 HIGH)
|
|
1. Economic transport hierarchy
|
|
2. Client/server V1/V2 progression
|
|
3. Performance metrics implementation
|
|
4. Development workflow optimization
|
|
5. Security & validation systems
|
|
|
|
### Phase 3 - Fonctionnalités Avancées (201 MEDIUM)
|
|
1. Economic simulation complexity
|
|
2. UX & experience optimization
|
|
3. Configuration systems
|
|
4. Testing & error handling
|
|
5. Integration patterns refinement
|
|
|
|
### Phase 4 - Vision Future (94 LOW)
|
|
1. Advanced AI patterns
|
|
2. Infrastructure ROI modeling
|
|
3. Advanced optimizations
|
|
4. Future-proofing systems
|
|
|
|
---
|
|
|
|
## 🎯 **CHECKLIST INTÉGRATION**
|
|
|
|
- [ ] **Architecture** : 88 points CRITICAL - Implémentation immédiate
|
|
- [ ] **Performance** : 125 métriques spécifiques - Targets mesurables
|
|
- [ ] **Economic** : 80+ règles business - Simulation réaliste
|
|
- [ ] **Development** : 60 pratiques Claude Code - Workflow optimisé
|
|
- [ ] **Build System** : 40 spécifications - Infrastructure autonome
|
|
- [ ] **Security** : 20 mesures - Protection robuste
|
|
- [ ] **UX** : 40 éléments - Expérience utilisateur
|
|
- [ ] **Integration** : 40 patterns - Communication modules
|
|
|
|
**Total : 570 spécifications techniques concrètes prêtes pour intégration documentation principale** |