StillHammer
bb92e9dc93
📚 Complete documentation reorganization: 🗂️ Structure: - docs/global/ → Complete project documentation (all original files) - docs/engines/ → 10 engine-specific docs with focused responsibilities - docs/serveur/ → Server coordinator and inter-engine communication - docs/client/ → Smart Client interface and user experience 🔧 Engine Documentation: - Designer: Vehicle design with AI assistance (1-2 designs/tick) - Economy: Market simulation and dynamic pricing - Event: Breakthrough system and global events - Factory: Factorio-like production with belts/assemblers - Intelligence: Metrics collection (3.1GB adaptive) + reconnaissance - Logistic: Supply chains and convoy management - MacroEntity: Companies, diplomacy, administration (1000 pts/day) - Map: Procedural generation (218+ elements) + chunk streaming - Operation: Military strategy and adaptive AI generals - War: Multi-chunk combat and persistent frontlines 📋 Each engine doc includes: - Core responsibilities and system overview - Key mechanics from relevant design documents - Communication patterns with other engines - Implementation notes and architecture details 🎯 Navigation optimized for: - Engine developers (focused system details) - System architects (coordination patterns) - Game designers (mechanics integration) 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
70 lines
2.9 KiB
Markdown
70 lines
2.9 KiB
Markdown
# Intelligence-Engine Documentation
|
|
|
|
## Engine Overview
|
|
**Intelligence-Engine** handles comprehensive metrics collection (3.1GB adaptive scaling), reconnaissance systems, and fog of war management.
|
|
|
|
**Key Responsibilities:**
|
|
- Metrics collection with adaptive scaling (2 pts/min → 0.4 pts/min multiplayer)
|
|
- Satellite reconnaissance and intelligence gathering
|
|
- Fog of War (FOW) management at chunk granularity
|
|
- Analytics and intelligence reporting
|
|
|
|
## Core Systems
|
|
|
|
### Metrics Collection
|
|
From `metriques-joueur.md`:
|
|
- **Adaptive Scaling**: 3.1GB per game with intelligent compression
|
|
- **Data Points**: 2 points/minute solo → 0.4 points/minute in multiplayer
|
|
- **Categories**: Economic, military, industrial, diplomatic metrics
|
|
- **Real-time Analytics**: Live dashboard and trend analysis
|
|
|
|
### Reconnaissance System
|
|
From `architecture-technique.md`:
|
|
- **Satellite Intel**: Graduated levels (buildings → factories → company-specific)
|
|
- **Intelligence Gathering**: Economic espionage, military reconnaissance
|
|
- **Counter-Intelligence**: Protecting own information, detecting spying
|
|
- **Information Warfare**: Disinformation and intelligence manipulation
|
|
|
|
### Fog of War Management
|
|
- **Chunk Granularity**: 64x64 tile visibility units
|
|
- **Company-Specific FOW**: Each company has independent visibility
|
|
- **Information Sharing**: Allied intelligence cooperation
|
|
- **Visibility Mechanics**: Line of sight, reconnaissance units
|
|
|
|
## Engine Architecture
|
|
|
|
### Core Classes
|
|
```cpp
|
|
class IntelligenceEngine {
|
|
// Metrics (adaptive scaling: 2 pts/min → 0.4 pts/min multiplayer)
|
|
void collectMetrics(int companyId, const std::string& data);
|
|
void pushMetricsToDatabase();
|
|
void adjustScalingForMultiplayer(int numCompanies);
|
|
|
|
// Reconnaissance (satellite: buildings → factories → company specific)
|
|
void updateSatelliteIntel(int x, int y, const std::string& intelLevel);
|
|
std::string getIntelligence(int companyId, int x, int y) const;
|
|
|
|
// FOW management (chunk granularity)
|
|
void setChunkVisibility(int companyId, int chunkX, int chunkY, bool visible);
|
|
};
|
|
```
|
|
|
|
### Communication with Other Engines
|
|
- **All Engines**: Collects metrics from every system
|
|
- **Map-Engine**: Coordinates FOW and chunk visibility
|
|
- **MacroEntity-Engine**: Company intelligence operations
|
|
- **War-Engine**: Military reconnaissance and battle intelligence
|
|
- **Economy-Engine**: Economic intelligence and market analysis
|
|
|
|
## Key Design Documents
|
|
- `metriques-joueur.md` - Complete metrics system specification
|
|
- `architecture-technique.md` - FOW and reconnaissance mechanics
|
|
- `map-system.md` - Chunk-based visibility system
|
|
- `coherence-problem.md` - Performance optimization strategies
|
|
|
|
## Implementation Notes
|
|
- 3.1GB data scaling requires sophisticated compression
|
|
- Real-time metrics processing with minimal performance impact
|
|
- Chunk-level FOW for optimal performance
|
|
- Intelligence sharing mechanics between allied companies |