StillHammer
bb92e9dc93
📚 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>
70 lines
2.9 KiB
Markdown
70 lines
2.9 KiB
Markdown
# 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 |