StillHammer
6c7934d530
Major integration of Points 251-570 from master list: - Points 251-350: Configuration system (error handling, security, deployment) - Points 351-390: Claude Code development practices added to CLAUDE.md - Points 391-470: Integration patterns and UX already covered in architecture - Points 471-570: Business logic and build system already documented - Points 136-142: Interface contracts already integrated Created complete docs/configuration/ folder with: - transport-economic-system.md (economic parameters) - module-configuration.md (smart dependencies) - error-handling.md (crash recovery, Redis failover) - security-measures.md (anti-cheat, server authority) - deployment-strategies.md (V1→V2 migration, hot-reload) Progress: 357/570 points integrated (63%), only 131 concrete points remaining 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
140 lines
4.3 KiB
Markdown
140 lines
4.3 KiB
Markdown
# Configuration Documentation
|
|
|
|
Ce dossier contient toute la documentation relative à la configuration du système Warfactory.
|
|
|
|
## Fichiers de Configuration
|
|
|
|
### `transport-economic-system.md`
|
|
**Points 251-290 - Configuration Parameters**
|
|
|
|
Configuration économique complète avec paramètres JSON :
|
|
|
|
#### Transport Configuration
|
|
- Coûts par mode de transport (ship/train/air/truck)
|
|
- Seuils de volume et temps de livraison
|
|
- Optimisation multi-modale
|
|
|
|
#### Storage Configuration
|
|
- Coûts de stockage (€0.02/kg/day)
|
|
- Seuils d'inventaire (urgent/normal/oversupplied)
|
|
- Capacités maximales
|
|
|
|
#### Market Configuration
|
|
- Phases économiques (6h cycles)
|
|
- Multiplicateurs de rareté
|
|
- Limites de coûts de transport
|
|
|
|
#### Infrastructure Configuration
|
|
- Coûts de construction (rail/port/airport)
|
|
- Périodes de retour sur investissement (max 15 ans)
|
|
- Déclencheurs d'investissement
|
|
|
|
### `module-configuration.md`
|
|
**Configuration Système Modulaire**
|
|
|
|
Configuration des modules et systèmes de dépendances :
|
|
|
|
#### Smart Dependencies
|
|
- Configuration avec recalculation automatique
|
|
- Mapping ConfigKey → ComponentID
|
|
- Propagation intelligente des changements
|
|
|
|
#### Module Config Patterns
|
|
- A/B testing via configuration
|
|
- Hot-swapping de systèmes
|
|
- Configuration adaptable par environnement
|
|
|
|
#### Avantages Modulaires
|
|
- Config changes instantanés (vs restart)
|
|
- Testing et debugging surgical
|
|
- Déploiement microservices-like
|
|
|
|
### `error-handling.md`
|
|
**Points 291-310 - Error Handling**
|
|
|
|
Gestion complète des erreurs et fiabilité système :
|
|
|
|
#### Engine Crash/Restart
|
|
- Health check HTTP (30s intervals)
|
|
- Redis heartbeat monitoring
|
|
- Recovery automatique avec state restoration
|
|
|
|
#### Redis Failover
|
|
- Persistence avec snapshots + append-only
|
|
- Multiple instances (primary/replica)
|
|
- Message replay après restart
|
|
|
|
#### Anti-cheat & Validation
|
|
- Server authoritative design
|
|
- Anti-cheat psychologique (bugs simulés)
|
|
- Input validation V1/V2
|
|
|
|
#### Network & Module Failures
|
|
- Graceful degradation avec cache fallback
|
|
- Module isolation (pas de cascade)
|
|
- Timeout handling resilient
|
|
|
|
### `security-measures.md`
|
|
**Points 311-330 - Security Measures**
|
|
|
|
Mesures de sécurité complètes et anti-cheat avancé :
|
|
|
|
#### Server Authority
|
|
- Server contrôle simulation complète
|
|
- Zero game logic côté client
|
|
- Mode-based security (dev/solo/multiplayer)
|
|
|
|
#### Anti-cheat System
|
|
- Anti-cheat psychologique avec bugs simulés
|
|
- Design-based prevention structurelle
|
|
- Guerre psychologique contre cheaters
|
|
|
|
#### Client Prediction
|
|
- V1 Thin Client (server authoritative)
|
|
- V2 Shared Logic (prediction + validation)
|
|
- Migration progressive sans réécriture
|
|
|
|
#### Psychological Warfare
|
|
- Escalation progressive contre cheaters
|
|
- Retention joueurs légitimes
|
|
- Stratégies comportementales adaptatives
|
|
|
|
### `deployment-strategies.md`
|
|
**Points 331-350 - Deployment Strategies**
|
|
|
|
Stratégies de déploiement et migration progressive :
|
|
|
|
#### Progressive V1→V2 Migration
|
|
- Migration zero-risk avec A/B testing
|
|
- Fallback automatique vers V1
|
|
- Forward-compatible architecture
|
|
|
|
#### Hot-reload Production
|
|
- Updates sans downtime en production
|
|
- State preservation durant updates
|
|
- Rollback rapide si problème
|
|
|
|
#### A/B Testing Strategies
|
|
- Testing dynamique via configuration
|
|
- User segmentation et metrics collection
|
|
- Gradual expansion 5% → 100%
|
|
|
|
#### Risk Mitigation
|
|
- Backward compatibility préservée
|
|
- Progressive enhancement sans régression
|
|
- Mode-based deployment (dev/staging/prod)
|
|
|
|
## Intégration
|
|
|
|
Ces paramètres correspondent aux **Points 251-350** de la master integration list et sont prêts pour intégration dans les systèmes de jeu.
|
|
|
|
**Status :** ✅ **SPÉCIFIÉS ET VÉRIFIÉS**
|
|
|
|
**Localisations originales :**
|
|
- `docs/toCheck/transport-economic-system.md` → Paramètres économiques (251-290)
|
|
- `docs/toCheck/architecture-modulaire.md` → Configuration modulaire + Anti-cheat (311-330)
|
|
- `docs/global/architecture-technique.md` → Error handling (291-310) + Server authority (311-330)
|
|
- `docs/architecture-technique.md` → Client prediction (311-330) + Migration V1→V2 (331-350)
|
|
- `docs/configuration/` → A/B testing et deployment patterns (331-350)
|
|
|
|
**Points couverts :** 100+ paramètres de configuration, error handling, sécurité et déploiement détaillés |