Warfactory Documentation Index

Documentation Structure

This documentation is organized by component type to provide focused information for each part of the Warfactory system.

📁 Global Documentation (/global/)

Complete project documentation with all design documents:

• vue-ensemble.md - Project vision and philosophy
• architecture-technique.md - Complete technical architecture
• map-system.md - Multi-scale map system (218+ elements)
• systeme-militaire.md - Combat and vehicle design systems
• economie-logistique.md - Economic simulation and supply chains
• gameplay-industriel.md - Factory management (Factorio-like)
• mecaniques-jeu.md - Research, breakthrough, and progression
• arbre-technologique.md - 3000+ technology tree
• metriques-joueur.md - Analytics system (3.1GB adaptive)
• coherence-problem.md - Resolved design challenges
• questions-ouvertes.md - Open questions and future considerations

🔧 Engine Documentation (/engines/)

Focused documentation for each of the 10 autonomous engines:

Core Engines

• Designer - Vehicle design with AI assistance (1-2 designs/tick)
• Economy - Market simulation and dynamic pricing
• Factory - Factorio-like production with belts and assemblers
• War - Multi-chunk combat and persistent frontlines

Specialized Engines

• Intelligence - Metrics collection (3.1GB adaptive) and reconnaissance
• Logistic - Supply chains and convoy management
• Map - Procedural generation (218+ elements) and chunk streaming
• Operation - Military strategy and adaptive AI generals

Support Engines

• Event - Breakthrough system and global events
• MacroEntity - Companies, diplomacy, administration (1000 pts/day)

🖥️ Server Documentation (/serveur/)

Server coordinator system:

• Engine communication and coordination
• Smart Client request/response handling
• Performance monitoring and load balancing
• Inter-engine message routing

💻 Client Documentation (/client/)

Smart Client interface system:

• Multi-scale user interface (World → Regional → Local → Detail)
• Factory management interface (Factorio-like)
• Vehicle design interface (grid-based component placement)
• Strategic command and diplomatic interfaces

Quick Navigation

For Engine Developers

Each engine folder contains:

• Core responsibilities and system overview
• Key mechanics from relevant design documents
• Communication patterns with other engines
• Implementation notes and architecture details

For System Architects

• Global Documentation - Complete system overview
• Server Documentation - Coordination architecture
• Performance specs: 60fps, 1000+ AI companies, adaptive scaling

For Game Designers

• Global Documentation - All gameplay mechanics
• Engine-specific docs - Focused system details
• Client Documentation - User interface requirements

Implementation Status

✅ Complete: Documentation structure with engine-specific focus ✅ Complete: 10 engine implementations with CMake build system ✅ Complete: Fast/full build presets for development efficiency 🔄 In Progress: Engine logic expansion and inter-engine communication 📋 Next: Gameplay feature implementation and testing

Build Commands Quick Reference

# Fast development build (minimal sanitizers)
cmake -DFAST_BUILD=ON .. && make claude-workflow-fast

# Full validation build (all sanitizers)
cmake -DCMAKE_BUILD_TYPE=Debug .. && make

# Single engine development
make economy-engine && ./bin/economy-engine

For complete build system documentation, see CLAUDE.md in the project root.