# Performance S2S — Base de données

## Contenu
- `schema.sql` : schéma complet consolidé pour une nouvelle base vide.
- `migrations/001_core.sql` à `005_imports_alerts_audit.sql` : migrations ordonnées.
- `seeds/001_reference_data.sql` : rôles, produits/activités et catégories de départ.

## Installation
1. Créer une base `performance_s2s` en `utf8mb4`.
2. Exécuter les migrations dans l'ordre numérique, ou exécuter `schema.sql` une seule fois sur une base vide.
3. Exécuter `seeds/001_reference_data.sql`.
4. Créer le premier utilisateur via PHP `password_hash()` (ne jamais stocker un mot de passe en clair).
5. Créer les comptes bancaires/caisse et saisir le solde d'ouverture avec sa date de référence.
6. Importer les données historiques après nettoyage et rapprochement bancaire.

## Exemple de commandes
```bash
mysql -u root -p -e "CREATE DATABASE performance_s2s CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
mysql -u root -p performance_s2s < schema.sql
mysql -u root -p performance_s2s < seeds/001_reference_data.sql
```

## Règles d'intégrité applicative indispensables
- Une facture validée alimente le chiffre d'affaires à la date de reconnaissance, pas à la date de paiement.
- Chaque encaissement/décaissement partiel crée un paiement et un mouvement de trésorerie distincts.
- `revenue_payments.transaction_id` et `expense_payments.transaction_id` relient le paiement au mouvement réellement créé.
- Les mouvements de type `TRANSFER_IN` et `TRANSFER_OUT` doivent être créés dans la même transaction SQL que la ligne `transfers`. Ils ne sont ni revenus ni charges. Le total de trésorerie consolidé ne change pas.
- Toujours utiliser `DECIMAL`, jamais `FLOAT`/`DOUBLE`, pour les montants.
- Calculer `amount_tnd` côté serveur à partir du montant et du taux de change validé.
- Pour un document multi-lignes, les totaux de l'en-tête doivent être recalculés côté serveur à partir des lignes.
- Vérifier côté serveur que la somme des paiements confirmés ne dépasse pas le solde dû.
- Utiliser `PDO::beginTransaction()`, `commit()` et `rollBack()` pour toute opération qui écrit plusieurs tables.
- Ne jamais supprimer physiquement un paiement rapproché ou un mouvement financier. Utiliser annulation/contrepassation et journaliser l'action.
- Un transfert ne peut pas avoir le même compte source et destination.
- Un scénario prévisionnel doit distinguer CONFIRMED, CONTRACTUAL, PROBABLE et HYPOTHETICAL. Ne pas inclure les opportunités non signées dans le scénario de trésorerie confirmé.
- Une charge partagée non ventilée reste visible comme frais généraux. Toute ventilation doit utiliser une règle datée et traçable.
- Les snapshots KPI servent à historiser des résultats calculés; ils ne remplacent jamais les transactions sources.

## Limites et choix à finaliser avant production
- Le schéma est un socle de gestion interne, pas un logiciel comptable certifié. Faire valider les traitements TVA, retenues, fiscalité et règles tunisiennes par l'expert-comptable.
- Les autorisations granulaires sont à compléter dans le middleware PHP selon les rôles.
- Les devises étrangères sont stockées avec devise et taux; les conversions et écarts de change doivent être implémentés et testés côté service.
- Définir les règles métier de clôture mensuelle et de réouverture.
- Prévoir des tests automatisés pour les scénarios de paiements partiels, transferts, annulations, rapprochements et prévisions datées.
- `JSON` nécessite une version compatible; vérifier la version MariaDB réellement installée.
- Avant de lancer en production, tester le schéma sur une base de staging et tester une restauration complète des sauvegardes.
