# Economy-Engine Documentation

## Engine Overview
**Economy-Engine** handles market simulation, pricing dynamics, and economic interactions between companies.

**Key Responsibilities:**
- Real-time market pricing simulation
- Supply and demand calculations
- Company economic interactions
- Resource flow optimization

## Core Systems

### Market Simulation
From `economie-logistique.md`:
- **Dynamic Pricing**: Supply/demand based price fluctuations
- **Market Depth**: Multiple buyers/sellers with varying priorities
- **Price Discovery**: Realistic market mechanisms
- **Resource Categories**: Raw materials, components, finished products

### Economic Mechanics
- **Company Budgets**: Financial constraints and cash flow
- **Trade Networks**: Inter-company commerce
- **Market Manipulation**: Large players affecting prices
- **Economic Warfare**: Sanctions, embargos, trade restrictions

### Performance Requirements
From `architecture-technique.md`:
- **Real-time Processing**: Market updates at 60fps
- **Scalability**: Support 1000+ AI companies
- **Autonomous Operation**: Self-regulating market dynamics

## Engine Architecture

### Core Classes
```cpp
class EconomyEngine {
    // Market management
    void updateMarketPrices();
    double getPrice(const std::string& resource) const;
    void processTradeOrder(const TradeOrder& order);

    // Company economics
    void updateCompanyBudgets();
    bool validateTransaction(int buyerCompany, int sellerCompany, const TradeOrder& order);

    // Market analysis
    MarketData getMarketData(const std::string& resource) const;
    std::vector<PriceHistory> getPriceHistory(const std::string& resource) const;
};
```

### Communication with Other Engines
- **Factory-Engine**: Production costs and output volumes
- **Logistic-Engine**: Transportation costs and supply chain efficiency
- **MacroEntity-Engine**: Company budgets, diplomatic trade relations
- **War-Engine**: Wartime economic impacts, resource scarcity
- **Intelligence-Engine**: Market intelligence and economic espionage

## Key Design Documents
- `economie-logistique.md` - Complete economic system design
- `architecture-technique.md` - Performance specifications
- `coherence-problem.md` - Economic balance considerations
- `mecaniques-jeu.md` - Economic progression mechanics

## Implementation Notes
- Negative prices are allowed for certain scenarios (waste disposal, etc.)
- Market depth simulation for realistic price discovery
- Company-specific pricing preferences and strategies
- Economic warfare and sanction mechanics