# Performance S2S — Application PHP

Application de pilotage financier interne S2S : dashboard, trésorerie, rentabilité, réserve de sécurité et projection de trésorerie.

## Stack
- PHP 8.1+ (PHP 8.3 recommandé), PDO
- MySQL 8+ ou MariaDB 10.4+
- HTML/CSS/JavaScript, Chart.js
- Architecture PHP monolithique en couches

## Installation locale
1. Créer une base vide et exécuter le schéma de la livraison précédente :
   ```bash
   mysql -u root -p -e "CREATE DATABASE performance_s2s CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
   mysql -u root -p performance_s2s < database/schema.sql
   mysql -u root -p performance_s2s < database/seeds/001_reference_data.sql
   ```
   Copier les fichiers SQL dans le dossier `database/` ou adapter le chemin.
2. Copier `.env.example` en `.env` et configurer l'accès MySQL.
3. Installer l'autoload Composer :
   ```bash
   composer dump-autoload
   ```
4. Copier le logo `logo-s2s.png` dans `public/assets/img/logo-s2s.png`.
5. Créer le compte admin :
   ```bash
   php scripts/create_admin.php "Administrateur S2S" admin@s2s.tn "UnMotDePasseLongEtUnique"
   ```
6. Démarrer :
   ```bash
   php -S 127.0.0.1:8000 -t public
   ```
7. Ouvrir `http://127.0.0.1:8000`.

## Structure
```text
app/
  Config/Database.php
  Controllers/DashboardController.php
  Core/{Auth,Csrf,Env}.php
  Helpers/helpers.php
  Services/{CashFlow,Runway,Profitability,Forecast}Service.php
  Views/{layout,dashboard,login}.php
public/
  index.php
  assets/{css,js,img}/
scripts/create_admin.php
```

## Formules métier utilisées
- Trésorerie consolidée = soldes d'ouverture des comptes actifs + mouvements `transactions` jusqu'à la date.
- Flux mensuel opérationnel et burn = somme des transactions `INFLOW` et `OUTFLOW`, en excluant `TRANSFER_IN` et `TRANSFER_OUT`. Les transferts restent présents dans le solde par compte, mais ne doivent pas gonfler les flux consolidés.
- Résultat de gestion = revenus HT reconnus − dépenses HT reconnues, à partir des lignes de documents validés.
- Réserve de sécurité = 3 × charges fixes mensuelles moyennes observées sur les 3 derniers mois.
- Runway simplifié = cash consolidé / consommation nette mensuelle positive des 3 derniers mois. Si aucune consommation nette positive, le runway est `N/A`.
- Prévision centrale = flux `CONFIRMED` et `CONTRACTUAL`. `PROBABLE` et `HYPOTHETICAL` restent visibles hors base.

## À compléter avant production
Cette livraison est un socle fonctionnel de démarrage, pas une application financière prête à déployer sans recette.
- Les pages CRUD (factures, dépenses, paiements, comptes, imports, budgets et scénarios) ne sont pas encore développées.
- Ajouter les migrations SQL de version et des tests automatisés.
- Les calculs doivent traiter explicitement les transferts : exclure `TRANSFER_IN` et `TRANSFER_OUT` des flux opérationnels et du burn, tout en les gardant dans les soldes par compte.
- Ajouter la gestion de rapprochement bancaire, contrepassations, clôture mensuelle et verrouillage des périodes.
- Valider les règles TVA/fiscalité tunisiennes avec l'expert-comptable.
- Ajouter RBAC granulaire, limitation de tentatives de connexion, CSP, journalisation structurée, politique de sauvegarde et tests de restauration.
- Chart.js et Google Fonts sont chargés via CDN dans ce starter; héberger localement en environnement fermé si nécessaire.
- Les montants affichés sont des données réelles uniquement si les factures, paiements, transactions et soldes d'ouverture ont été correctement saisis et rapprochés.

## Note de qualité financière
Le runway et les prévisions sont des indicateurs de gestion. Le runway basé sur une moyenne passée ne prédit pas les dates exactes de rupture de trésorerie. Utiliser la projection datée 13 semaines pour les décisions de court terme.
