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>
72 lines
3.0 KiB
Markdown
72 lines
3.0 KiB
Markdown
# MacroEntity-Engine Documentation
|
|
|
|
## Engine Overview
|
|
**MacroEntity-Engine** handles companies, diplomacy, and administration points with macro-level strategic rhythm.
|
|
|
|
**Key Responsibilities:**
|
|
- Company management (2-4 features per company)
|
|
- Diplomatic relations and sanctions
|
|
- Administration points system (1000 points/day, 1 day = 10 min real)
|
|
- Macro-level strategic decisions (~1 action every 3-5 days per company)
|
|
|
|
## Core Systems
|
|
|
|
### Company Management
|
|
From `mecaniques-jeu.md`:
|
|
- **Company Features**: 2-4 distinct capabilities per company
|
|
- **Strategic Focus**: Specialization in military, economic, or industrial domains
|
|
- **Company Evolution**: Gradual expansion and capability development
|
|
- **AI Behavior**: Distinct personalities and strategic preferences
|
|
|
|
### Administration System
|
|
- **Point Allocation**: 1000 administration points per day (10 minutes real-time)
|
|
- **Action Costs**: Major decisions consume administration points
|
|
- **Daily Reset**: Fresh allocation each game day
|
|
- **Strategic Pacing**: Prevents rapid micro-management, encourages planning
|
|
|
|
### Diplomacy System
|
|
From `coherence-problem.md`:
|
|
- **Relations Management**: Company-to-company diplomatic status
|
|
- **Economic Sanctions**: Trade restrictions and embargos
|
|
- **Military Alliances**: Coordinated defense and intelligence sharing
|
|
- **Diplomatic Actions**: Treaties, trade agreements, conflict declarations
|
|
|
|
## Engine Architecture
|
|
|
|
### Core Classes
|
|
```cpp
|
|
class MacroEntityEngine {
|
|
// Company management (2-4 features per company)
|
|
void createCompany(int companyId, const std::string& name);
|
|
void updateCompanyFeatures(int companyId);
|
|
|
|
// Administration (1000 points/day, 1 day = 10 min real)
|
|
bool consumeAdminPoints(int companyId, int points);
|
|
void resetDailyAdminPoints(int companyId);
|
|
|
|
// Diplomacy (sanctions, embargos, relations)
|
|
void setDiplomaticRelation(int company1, int company2, const std::string& relation);
|
|
void applySanctions(int targetCompany, const std::vector<std::string>& sanctions);
|
|
|
|
// Performance: ~1 action every 3-5 days per company (macro rhythm)
|
|
double getActionFrequency() const { return actionFrequency_; }
|
|
};
|
|
```
|
|
|
|
### Communication with Other Engines
|
|
- **Economy-Engine**: Diplomatic trade relations, sanctions impact
|
|
- **War-Engine**: Military alliances, conflict coordination
|
|
- **Intelligence-Engine**: Diplomatic intelligence, espionage operations
|
|
- **All Engines**: Company-level decision coordination and policy implementation
|
|
|
|
## Key Design Documents
|
|
- `mecaniques-jeu.md` - Administration and company systems
|
|
- `coherence-problem.md` - Diplomatic balance and sanctions
|
|
- `architecture-technique.md` - Macro-level performance requirements
|
|
- `economie-logistique.md` - Company economic interactions
|
|
|
|
## Implementation Notes
|
|
- Macro rhythm: 1 action every 3-5 days prevents micro-management
|
|
- Administration points create meaningful strategic choices
|
|
- Company features provide distinct strategic identities
|
|
- Diplomatic actions have long-term consequences across all systems |