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.4 KiB
Markdown
70 lines
2.4 KiB
Markdown
# 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 |