0.7.56

docs/DB_EVENT_MODEL_REVIEW.md

@@ -2,6 +2,21 @@
 
 # Database Event Model Review — `khadhroony-bobobot` `0.7.47-1FE5`
 
+
+## Note `0.7.56` — modèle fee parent + amount legs
+
+`0.7.56` ajoute `k_sol_fee_event_amounts` comme table enfant de `k_sol_fee_events`. Cette table est obligatoire dès qu'un event fee porte plusieurs montants, plusieurs mints ou plusieurs destinations. Le parent `k_sol_fee_events` reste l'ancre logique liée au `decoded_event_id`; les legs portent `leg_index`, `token_mint`, `amount_raw`, comptes source/destination et `amount_source`.
+
+Invariants :
+
+- tout parent fee avec `fee_token_mint + fee_amount_raw` doit avoir un leg scalaire automatique ;
+- un fee multi-leg/multi-mint ne doit pas agréger artificiellement le parent ;
+- les replays doivent supprimer/remplacer les legs avec le parent ;
+- les transactions failed restent audit-only ;
+- la recovery `allowlisted_inner_spl_transfer` est strictement allowlistée et ne s'applique pas par défaut aux futurs decoders.
+
+Le contrôle standard `parent scalar without leg` doit être vide sur toute base de validation. Voir `docs/reports/FEE_EVENT_AMOUNTS_MODEL_NOTE_0_7_56.md`.
+
 ## Conclusion courte
 
 La base actuelle est **suffisante pour continuer le décodage exhaustif en audit-only**, parce que `k_sol_dex_decoded_events` garde les events décodés avec `payload_json`.