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.4 KiB

Raw Blame History

Factory-Engine Documentation

Engine Overview

Factory-Engine handles Factorio-like production simulation with assembly lines, belts, and automated manufacturing.

Key Responsibilities:

Production line simulation
Resource flow management
Factory optimization
Industrial automation

Core Systems

Production System

From gameplay-industriel.md:

Assembly Lines: Multi-stage production processes
Belt Networks: Resource transportation within factories
Assemblers: Automated production units
Quality Control: Production efficiency and defect rates

Resource Flow

Input/Output Management: Raw materials → finished products
Throughput Optimization: Bottleneck identification and resolution
Inventory Management: Buffer stocks and storage
Production Scheduling: Order prioritization and batching

Factory Design

Layout Optimization: Efficient factory floor planning
Upgrade Paths: Production line improvements
Automation Levels: Manual → semi-auto → fully automated
Modular Design: Expandable production modules

Engine Architecture

Core Classes

class FactoryEngine {
    // Factory management
    void addProductionLine(std::unique_ptr<ProductionLine> line);
    void removeProductionLine(int lineId);

    // Production control
    void startProduction();
    void stopProduction();
    void pauseProduction();

    // Performance monitoring
    double getTickRate() const;
    size_t getActiveLines() const;
};

Communication with Other Engines

Economy-Engine: Production costs, resource pricing, order fulfillment
Logistic-Engine: Raw material delivery, finished goods shipping
Designer-Engine: Vehicle production requirements and specifications
Intelligence-Engine: Production metrics and efficiency reporting
MacroEntity-Engine: Company production goals and priorities

Key Design Documents

gameplay-industriel.md - Complete factory system design
economie-logistique.md - Production economics and supply chains
architecture-technique.md - Performance requirements
mecaniques-jeu.md - Research and upgrade mechanics

Implementation Notes

Factorio-inspired belt and assembler mechanics
Real-time production simulation at 60fps
Modular production line design
Automatic optimization suggestions for players

2.4 KiB Raw Blame History