# Designer-Engine Documentation

## Engine Overview
**Designer-Engine** handles autonomous vehicle conception for AI companies and provides design assistance for players.

**Key Responsibilities:**
- Vehicle design generation (1-2 designs globally per tick)
- Component grid placement and validation
- Blueprint management and evolution
- AI-driven design optimization

## Core Systems

### Vehicle Design System
From `systeme-militaire.md`:
- **Grid-based Component Placement**: Irregular chassis shapes with precise component positioning
- **Interface Mechanics**: Pick/place with A/E rotation, R for snap toggle
- **Template Support**: Save/load vehicle blueprints
- **Validation**: Ensure design constraints (weight, power, armor coverage)

### Design Evolution
From `arbre-technologique.md`:
- **Progressive Evolution**: T-72 → T-80 → T-90 design lineage
- **Technology Integration**: New components unlock through research
- **Doctrine Adaptation**: Designs adapt to military doctrine preferences

### Performance Requirements
From `architecture-technique.md`:
- **Design Rate**: 1-2 vehicle designs globally per tick maximum
- **Autonomous Operation**: AI companies generate designs independently
- **Player Assistance**: Provide design suggestions and optimization

## Engine Architecture

### Core Classes
```cpp
class DesignerEngine {
    // Design management (1-2 designs globally per tick)
    std::unique_ptr<VehicleDesign> createDesign(const std::string& type);
    void validateDesign(const VehicleDesign& design);
    void saveBlueprint(const VehicleDesign& design, const std::string& name);

    // Blueprint evolution
    void evolveBlueprintsFromExisting(); // T-72 → T-80 → T-90

    // Performance monitoring
    double getDesignRate() const;
    size_t getPendingDesigns() const;
};
```

### Communication with Other Engines
- **War-Engine**: Receives combat effectiveness feedback for design optimization
- **Economy-Engine**: Gets cost constraints and production capabilities
- **Intelligence-Engine**: Receives reconnaissance data on enemy designs
- **MacroEntity-Engine**: Gets company design preferences and doctrine
- **Event-Engine**: Processes breakthrough events for new technologies

## Key Design Documents
- `systeme-militaire.md` - Vehicle design system details
- `arbre-technologique.md` - Technology progression and design evolution
- `architecture-technique.md` - Performance specifications
- `mecaniques-jeu.md` - Research integration

## Implementation Notes
- Focus on autonomous AI design generation
- Player assistance tools for design optimization
- Blueprint persistence and sharing system
- Technology integration from research breakthroughs