aissia/docs/04-reference/metriques-joueur.md

Métriques Joueur

Vue d'ensemble

Le système de métriques de Warfactory fournit aux joueurs des statistiques détaillées avec graphiques complets de performance, permettant l'analyse fine de leur progression industrielle et militaire.

Architecture Données

Distinction Breakthrough vs Métriques

Breakthrough System : Données minimales (~KB par company)

• State actuel uniquement
• Compteurs cumulatifs simples
• Focus : Performance et déclenchement conditions

Système Métriques : Données historiques complètes (~MB par entité)

• Historique détaillé production
• Graphiques temporels complets
• Focus : Analyse et visualisation

Volume de Données par Partie (300-400h)

Companies IA (1000)

• Fréquence : 1 point toutes les 10min
• Ressources : 10 produits trackés par company
• Volume : 1000 × 10 × (400h × 6 points/h) × 8 bytes = 192MB par partie

États (50)

• Fréquence : 1 point toutes les 10min
• Ressources : 3000 ressources par état
• Volume : 50 × 3000 × (400h × 6 points/h) × 8 bytes = 2.9GB par partie

Joueurs (Scaling Adaptatif Multijoueur)

• Solo/Company partagée : 1 point toutes les 30sec = 120 points/h
• Multijoueur adaptatif : Fréquence réduite selon nombre de companies
  • 1 company : 2 points/min (120 points/h)
  • 5 companies : 0.4 points/min (24 points/h)
  • 10+ companies : 0.25 points/min minimum (15 points/h)
• Ressources : 40 produits trackés
• Volume variable : 1 × 40 × (400h × points/h) × 8 bytes = 15MB à 3MB selon config

Total par partie : ~3.1GB constant (data sharing + scaling adaptatif)

• Joueurs même company : Dataset partagé (pas de duplication)
• Free-for-all : Granularité réduite maintient volume total stable

Types de Métriques

1. Production & Économie

Métriques de Production

• Production par ressource : Steel/h, Electronic components/h, Véhicules/jour
• Efficacité usines : % utilisation, downtime, bottlenecks identifiés
• Évolution capacités : Courbes de croissance industrielle
• Ratios production : Input/Output, waste, efficiency metrics

Métriques Économiques

• Revenus/Dépenses : Graphiques détaillés par source et destination
• Flux financiers : Cash flow, profit margins, ROI investissements
• Commerce international : Exports/imports par pays et ressource
• Coûts opérationnels : Breakdown par type (énergie, main d'œuvre, matières premières)

2. Recherche & Développement

Progression Technologique

• Timeline breakthroughs : Chronologie découvertes avec sources
• Sources de découverte : Ratio Scrap vs Natural vs Events vs Purchase
• Domaines expertise : Radar de spécialisations technologiques
• Investissements R&D : Allocations budget et ROI par domaine

Innovation Metrics

• Taux découverte : Breakthroughs/mois in-game
• Efficacité R&D : Coût moyen par breakthrough
• Diversification : Spread technologique sur domaines
• Compétitivité : Position vs autres companies (si intel disponible)

3. Expansion & Influence

Contrôle Géographique

• Territoire contrôlé : Surface, ressources accessibles, population
• Infrastructure : Density routes, bases, installations industrielles
• Influence diplomatique : Relations par pays/région, contrats actifs
• Sécurité zones : Threat levels, incidents sécuritaires

Visualisations

Graphiques Temporels

Production Dashboard

Production Steel (tonnes/jour)
    ▲
1000│     ╭─╮
 800│   ╭─╯ ╰─╮
 600│ ╭─╯     ╰─╮
 400│╭╯         ╰─╮
 200│╯             ╰───
   0└─────────────────────▶
    Mois 1  2  3  4  5  6

Financial Trends

Cash Flow (M€)
    ▲
 5.0│ ██████████████████▒▒▒▒ Revenue
 4.0│ ████████████▒▒▒▒▒▒▒▒▒▒ Expenses
 3.0│ ████████▒▒▒▒▒▒▒▒▒▒▒▒▒▒ Profit
 2.0│ ████▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
 1.0│ ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒
   0└─────────────────────▶
    Q1   Q2   Q3   Q4

Breakthrough Timeline

Découvertes Technologiques
│
├─ Mois 2: Radar Avancé (Scrap Analysis)
├─ Mois 4: Matériaux Composites (Natural)
├─ Mois 7: IA Tactique (Purchase Intel)
├─ Mois 9: Blindage Réactif (Capture)
└─ Mois 12: Moteurs Fusion (Event)

Radar Charts

Technology Mastery

       IA (8/10)
         /\
        /  \
Electronics   Matériaux
  (6/10) ────────── (9/10)
        \    /
         \  /
      Moteurs (4/10)

Heatmaps

Market Opportunities

Resource vs Country Demand
         │UKR│POL│GER│FRA│
Steel    │ ██│ ▓▓│ ░░│ ▓▓│
Electronics│▓▓│ ██│ ██│ ▓▓│
Vehicles │ ██│ ▓▓│ ░░│ ░░│

Système de Stockage

Architecture Données

Structure TimeSeries Simplifiée

struct MetricTimeseries {
    int32_t value;            // 4 bytes signed int
    // Timestamp et résolution stockés en métadonnées
};

struct TimeseriesMetadata {
    uint32_t start_timestamp;
    uint32_t interval_seconds; // Ex: 30s pour joueur, 600s pour IA
    uint32_t data_count;
};

struct EntityMetrics {
    EntityID entity_id;

    // Production (par ressource) - listes simples de int32
    map<ResourceType, vector<int32_t>> production_history;
    map<ResourceType, TimeseriesMetadata> production_metadata;

    // Financial - listes simples
    vector<int32_t> revenue_history;
    vector<int32_t> expenses_history;
    vector<int32_t> cash_flow_history;
    TimeseriesMetadata financial_metadata;

    // Technology
    vector<BreakthroughEvent> breakthrough_timeline;
};

Breakthrough Events Simplifié

struct BreakthroughEvent {
    uint32_t timestamp;
    TechID technology_id;
    BreakthroughSource source; // SCRAP, NATURAL, PURCHASE, EVENT
    string details;            // "Scrap: T-72 Tank"
};

Agrégation & Compression

Résolution Adaptative

• Dernière semaine : Points toutes les 30sec (joueur) / 10min (IA)
• Dernier mois : Agrégation horaire
• Derniers 6 mois : Agrégation quotidienne
• Plus ancien : Agrégation hebdomadaire

Compression Intelligente

• Delta encoding : Stocker différences vs valeurs absolues
• Run-length encoding : Pour périodes stables (production constante)
• Lossy compression : Données anciennes → précision réduite acceptable

Interface Métriques

Dashboard Principal

Vue d'Ensemble

┌─────────────────┬─────────────────┬─────────────────┐
│   PRODUCTION    │    FINANCES     │   RECHERCHE     │
│ Steel: ↗ +15%   │ Profit: ↗ +8%   │ 3 breakthroughs│
│ Elec:  ↘ -3%    │ Cash: 2.4M€     │ this month      │
├─────────────────┼─────────────────┼─────────────────┤
│   TERRITOIRE    │   DIPLOMATIC    │    STATUS       │
│ 12 installations│ 3 trade deals   │ ✅ Operational  │
│ 3 countries     │ 85% relations   │ 🔄 Expanding    │
└─────────────────┴─────────────────┴─────────────────┘

Navigation & Drill-Down

• Overview → Domain → Specific Metric → Detailed Timeline
• Comparisons : Self vs time, targets vs actual, competitors (si data available)
• Filters : Date ranges, metric types, zoom levels, entity types

Métriques Spécialisées

Competitive Intelligence (si disponible)

Market Share Analysis
Company        │Production│Revenue│Breakthroughs│
Thales         │    25%   │  30%  │     18      │
Lockheed       │    18%   │  22%  │     15      │
Player         │    12%   │  15%  │     12      │
Dassault       │    15%   │  18%  │     10      │
Others         │    30%   │  15%  │     45      │

Privacy & Intelligence

Data Visibility

Player Data (Full Access)

• Toutes métriques personnelles : Production, finances, recherche, combat
• Historique complet : Depuis début de partie
• Analytics avancées : Trends, predictions, optimization suggestions

Competitor Data (Limited)

• Via espionnage : Intel partiel sur production/capabilities
• Market signals : Déductions via prix, volumes, nouvelles exportations
• Combat assessment : Performance observée lors d'engagements
• Public information : Certaines métriques "corporate" accessibles

State Data (Contextual)

• Economic indicators : PIB, imports/exports publics
• Military capabilities : Intel selon relations diplomatiques
• Technology level : Observations équipements, brevets publics

---

Les métriques constituent l'outil principal d'analyse et d'optimisation continue pour maîtriser la complexité industrielle et militaire de Warfactory