# 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](./engines/designer/)** - Vehicle design with AI assistance (1-2 designs/tick)
- **[Economy](./engines/economy/)** - Market simulation and dynamic pricing
- **[Factory](./engines/factory/)** - Factorio-like production with belts and assemblers
- **[War](./engines/war/)** - Multi-chunk combat and persistent frontlines

#### Specialized Engines
- **[Intelligence](./engines/intelligence/)** - Metrics collection (3.1GB adaptive) and reconnaissance
- **[Logistic](./engines/logistic/)** - Supply chains and convoy management
- **[Map](./engines/map/)** - Procedural generation (218+ elements) and chunk streaming
- **[Operation](./engines/operation/)** - Military strategy and adaptive AI generals

#### Support Engines
- **[Event](./engines/event/)** - Breakthrough system and global events
- **[MacroEntity](./engines/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](./global/)** - Complete system overview
- **[Server Documentation](./serveur/)** - Coordination architecture
- **Performance specs**: 60fps, 1000+ AI companies, adaptive scaling

### For Game Designers
- **[Global Documentation](./global/)** - All gameplay mechanics
- **Engine-specific docs** - Focused system details
- **[Client Documentation](./client/)** - 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

```bash
# 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.