warfactoryracine/docs/engines/logistic

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

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