feat(sprint3): EconomyModule TetardCoin + TwitchModule EventSub — migration + 36 tests

docs/economy-design.md

@@ -0,0 +1,80 @@
+# TetaRdPG — Economy Design : TetardCoin
+
+> Sprint 3 — Step 1 output
+> Date : 2026-03-17
+
+---
+
+## Taux de conversion
+
+**10 Bits = 1 TetardCoin (TC)**
+
+Justification : 100 Bits (cheer le plus courant sur Twitch) → 10 TC = 1 recharge endurance complète. Ni trop abondant (1:1 dévaluerait le TC immédiatement), ni trop rare (100:1 pénaliserait les petits cheers). Valeur implicite ~0,10 USD par TC, ancrée sur le cours Bits Twitch.
+
+---
+
+## Rewards Abonnés
+
+| Tier | TC / mois |
+|------|-----------|
+| Prime | 30 TC |
+| T1 | 50 TC |
+| T2 | 120 TC |
+| T3 | 350 TC |
+
+---
+
+## Rewards Bits — Seuils de Cheers
+
+Base : 10 Bits = 1 TC + prime de seuil
+
+| Seuil | TC crédité | Prime | Note |
+|-------|-----------|-------|------|
+| 100 Bits | 10 TC | 0 | Pas de prime — évite le split-cheering |
+| 500 Bits | 55 TC | +5 TC | ~10% prime |
+| 1 000 Bits | 115 TC | +15 TC | ~15% prime |
+| 5 000 Bits | 575 TC | +75 TC | ~15% prime |
+
+---
+
+## Utilisations TC
+
+| Usage | Coût TC | Description |
+|-------|---------|-------------|
+| Recharge endurance | 1 TC = +20 pts | Prime volume : 5 TC et 10 TC |
+| Cosmétiques Twitch | 20 – 150 TC | Titres, cadres, skins limités — rotation mensuelle |
+| Forge garantie | Max 12 TC | Supprime risque perte matériaux (20-40%) |
+| Tickets PvP | 5 TC = +3 tickets | Plafond +10 tickets/jour |
+| Artisanat accéléré | 1 TC = skip 15 min | Max 8 TC pour un craft de 2h |
+
+---
+
+## Sink Anti-Inflation
+
+**Oui — sinks actifs**
+
+Sinks primaires :
+- Endurance (consommation quotidienne si actif)
+- Forge garantie (usage situationnel fort)
+- Cosmétiques (rotation crée FOMO)
+- Artisanat accéléré (usage passif régulier)
+
+Sink secondaire proposé :
+- Création de guilde : 50 TC
+- Upgrade guilde (3 niveaux) : 30 / 60 / 100 TC
+
+---
+
+## Différenciateur vs StreamElements / Streamlabs Points
+
+StreamElements/Streamlabs = présence passive → points sans friction → aucune décision.
+
+TetardCoin = engagement actif → arbitrages réels (forge vs endurance vs guilde) → économie avec tension.
+
+**C'est la différence entre un programme de fidélité et un jeu.**
+
+---
+
+## Prochaines étapes → Step 2
+
+Implémenter : entité TetardCoin (balance + historique), service de conversion Bits→TC, migrations DB, API endpoints (balance, earn, spend, history), tests invariants économiques.