# 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
```cpp
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