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

3.0 KiB

Raw Blame History

MacroEntity-Engine Documentation

Engine Overview

MacroEntity-Engine handles companies, diplomacy, and administration points with macro-level strategic rhythm.

Key Responsibilities:

Company management (2-4 features per company)
Diplomatic relations and sanctions
Administration points system (1000 points/day, 1 day = 10 min real)
Macro-level strategic decisions (~1 action every 3-5 days per company)

Core Systems

Company Management

From mecaniques-jeu.md:

Company Features: 2-4 distinct capabilities per company
Strategic Focus: Specialization in military, economic, or industrial domains
Company Evolution: Gradual expansion and capability development
AI Behavior: Distinct personalities and strategic preferences

Administration System

Point Allocation: 1000 administration points per day (10 minutes real-time)
Action Costs: Major decisions consume administration points
Daily Reset: Fresh allocation each game day
Strategic Pacing: Prevents rapid micro-management, encourages planning

Diplomacy System

From coherence-problem.md:

Relations Management: Company-to-company diplomatic status
Economic Sanctions: Trade restrictions and embargos
Military Alliances: Coordinated defense and intelligence sharing
Diplomatic Actions: Treaties, trade agreements, conflict declarations

Engine Architecture

Core Classes

class MacroEntityEngine {
    // Company management (2-4 features per company)
    void createCompany(int companyId, const std::string& name);
    void updateCompanyFeatures(int companyId);

    // Administration (1000 points/day, 1 day = 10 min real)
    bool consumeAdminPoints(int companyId, int points);
    void resetDailyAdminPoints(int companyId);

    // Diplomacy (sanctions, embargos, relations)
    void setDiplomaticRelation(int company1, int company2, const std::string& relation);
    void applySanctions(int targetCompany, const std::vector<std::string>& sanctions);

    // Performance: ~1 action every 3-5 days per company (macro rhythm)
    double getActionFrequency() const { return actionFrequency_; }
};

Communication with Other Engines

Economy-Engine: Diplomatic trade relations, sanctions impact
War-Engine: Military alliances, conflict coordination
Intelligence-Engine: Diplomatic intelligence, espionage operations
All Engines: Company-level decision coordination and policy implementation

Key Design Documents

mecaniques-jeu.md - Administration and company systems
coherence-problem.md - Diplomatic balance and sanctions
architecture-technique.md - Macro-level performance requirements
economie-logistique.md - Company economic interactions

Implementation Notes

Macro rhythm: 1 action every 3-5 days prevents micro-management
Administration points create meaningful strategic choices
Company features provide distinct strategic identities
Diplomatic actions have long-term consequences across all systems

3.0 KiB Raw Blame History