# Logistic-Engine Documentation

## Engine Overview
**Logistic-Engine** handles transport networks, supply chains, and convoy management across all map scales.

**Key Responsibilities:**
- Supply chain coordination between production sites
- Convoy routing and management
- Infrastructure vulnerability and security
- Transport optimization across multiple map scales

## Core Systems

### Supply Chain Management
From `economie-logistique.md`:
- **Multi-Site Coordination**: Raw materials → production → distribution
- **Route Optimization**: Cost-effective transportation paths
- **Capacity Planning**: Transport vehicle allocation
- **Supply Reliability**: Backup routes and contingency planning

### Transport Networks
From `map-system.md`:
- **Multi-Scale Routes**: World → Regional → Local scale coordination
- **Infrastructure**: Roads, railways, shipping lanes, air corridors
- **Convoy Management**: Vehicle groups with escorts and timing
- **Vulnerability**: Routes are visible on map and attackable

### Route Security
- **Infrastructure Protection**: Defending supply lines
- **Convoy Escorts**: Military protection for valuable shipments
- **Route Intelligence**: Monitoring for threats and optimal paths
- **Alternative Routing**: Adapting to blocked or dangerous routes

## Engine Architecture

### Core Classes
```cpp
class LogisticEngine {
    // Supply chain management
    void createSupplyChain(const std::string& chainId, const std::vector<int>& sites);
    void updateRoute(const std::string& routeId, const std::vector<std::pair<int,int>>& waypoints);

    // Convoy management
    void dispatchConvoy(const std::string& convoyId, const std::string& routeId);
    void trackConvoyProgress(const std::string& convoyId);

    // Infrastructure (routes visible on map, attackable)
    void markInfrastructureVulnerable(const std::string& routeId, bool vulnerable);
    bool isRouteSecure(const std::string& routeId) const;
};
```

### Communication with Other Engines
- **Economy-Engine**: Transportation costs, supply/demand coordination
- **Factory-Engine**: Production schedules and inventory requirements
- **War-Engine**: Route security, convoy protection, infrastructure attacks
- **Map-Engine**: Route planning across multiple map scales
- **Intelligence-Engine**: Route intelligence and threat assessment

## Key Design Documents
- `economie-logistique.md` - Complete supply chain system
- `map-system.md` - Multi-scale transport coordination
- `systeme-militaire.md` - Infrastructure vulnerability and protection
- `architecture-technique.md` - Performance requirements

## Implementation Notes
- Routes are visible on map and can be targeted by enemies
- Multi-scale coordination requires efficient route planning
- Real-time convoy tracking and threat response
- Supply chain resilience through redundant routing