# 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