StillHammer bb92e9dc93 Add comprehensive engine-focused documentation structure

📚 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>

2025-09-19 14:41:03 +08:00

2.9 KiB

Raw Blame History

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

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

2.9 KiB Raw Blame History