# Architecture

## Arborescence

```
config/         configuration, hors de l'espace web accessible
  config.php          identifiants réels (jamais versionné)
  config.exemple.php  modèle à copier

lib/            32 modules de logique métier, fonctions pures PHP
public/         racine web
  *.php               19 écrans côté client
  qualite/            14 écrans côté interne
  assets/             CSS, JS, images
  uploads/            pièces jointes déposées (créé à l'installation)

outils/         6 scripts en ligne de commande (tâches Cron)
sql/            schema.sql + 27 migrations numérotées
docs/           documentation de reprise
```

---

## Les modules `lib/`

**Socle** — `db.php` (connexion PDO, `config()`, `req()`, `lignes()`,
`valeur()`, `une_ligne()`), `auth.php` (sessions durcies, rôles, anti-force
brute), `vue.php` (gabarits `entete()`/`pied()`, constantes métier, échappement
`e()`), `erreurs.php` (gestionnaire global, aucune trace technique au visiteur).

**Métier central** — `reclamations.php` (création, validation, listes),
`workflow.php` (11 étapes sur 5 statuts techniques), `notifications.php`,
`mail.php` (SMTP direct, sans bibliothèque), `journal.php` (audit en ajout
seul).

**Qualité et CAPA** — `analyses.php` (5 Pourquoi, Ishikawa 6M), `actions.php`
(actions correctives, vérification d'efficacité), `huit-d.php` (démarche 8D en
8 disciplines), `kpi.php` (indicateurs ISO 9001).

**Pilotage** — `sla.php` (délais en jours ouvrés et en heures),
`alertes.php` (9 types, routage application/e-mail/Teams),
`statistiques.php`, `dashboard.php` (14 indicateurs, 9 graphiques),
`svg.php` (graphiques générés côté serveur, sans JavaScript),
`satisfaction.php` (enquête, file de validation interne).

**Intégration** — `commandes.php` (miroir ERP des commandes),
`erp_chaine.php` (chaîne Client → Commande → Produit → OF → Lot → Matière →
Fournisseur), `api.php` (API de lecture, clés hachées), `export.php`
(CSV, XLSX natif, gabarit imprimable).

**Support** — `affectations.php`, `comptes.php`, `matricule.php` (validation
du matricule fiscal tunisien), `referentiel.php`, `reinitialisation.php`,
`suivi.php` (consultation sans compte), `bloc-*.php` (fragments de gabarit
réutilisés entre écrans).

---

## Modèle de données

**Cœur** — `clients` (client externe et compte interne dans la même table,
distingués par `role`), `reclamations`, `reclamation_natures` (catégories, en
ENUM), `photos`, `historique`, `compteurs` (numérotation `RQ-`/`RC-`).

**Traitement** — `analyses`, `actions`, `analyse_pourquoi`, `analyse_causes`,
`huit_d`, `huit_d_etapes`, `affectations`, `etapes_workflow`.

**Pilotage** — `sla_regles` (jours ouvrés), `sla_heures` (urgences),
`alertes_config`, `satisfaction`, `satisfaction_a_valider`.

**Référentiels** — `types_reclamation`, `categories`, `statuts`, `priorites`.

**ERP** — `commandes_ref` (miroir plat des commandes), plus la chaîne
structurée : `erp_fournisseurs`, `erp_matieres`, `erp_produits`, `erp_of`,
`erp_lots`, reliées par de vraies clés étrangères.

**Technique** — `journal` (audit, jamais modifié ni supprimé), `cles_api`,
`jetons_reinit`, `jetons_suivi`.

---

## Workflow

Cinq statuts techniques en base (`recue`, `analyse`, `action`, `resolue`,
`rejetee`), affinés par onze étapes (`nouveau`, `a_qualifier`, `qualifie`,
`assigne`, `en_cours`, `reouvert`, `action_requise`, `attente_client`,
`resolu`, `validation_sat`, `cloture`).

**Point d'entrée unique** : `faire_avancer($id, $statut, $etape, $message,
$auteur)`. Elle gère la transition, la trace dans le journal avec l'état avant
et après, la réouverture automatique d'un dossier clos, et le déclenchement de
l'alerte correspondante. Ne jamais modifier un statut directement en base.

---

## Deux habillages, un seul point de code

`entete()` et `pied()` dans `lib/vue.php` produisent :

- **côté client** : barre horizontale en haut, bande haute-visibilité, logo ;
- **côté interne** (rôle `qualite`) : barre latérale de navigation à trois
  niveaux, feuille `assets/sidebar.css` chargée en plus.

La bascule se fait sur `$u['role'] === 'qualite'`. Un drapeau statique
(`_mode_barre_laterale()`) transmet l'information de `entete()` à `pied()`,
pour que celle-ci ferme la bonne structure sans avoir à changer sa signature
sur ses 19 points d'appel.

---

## Sécurité

- Mots de passe : `password_hash()`, jamais en clair.
- Sessions : `httponly`, `secure` sur HTTPS, `samesite=Lax`, expiration 2 h.
- CSRF vérifié sur toute action modifiant une donnée.
- Isolation client : `portee()` injecté **dans les requêtes SQL**, pas
  seulement à l'affichage.
- Pièces jointes : type MIME lu dans le contenu réel (`finfo`), jamais
  l'extension déclarée ; documents forcés en téléchargement, jamais exécutés.
- API : clés hachées SHA-256, portée limitable, 600 appels/heure.
- Journal d'audit : aucune fonction du code ne le modifie ni ne le supprime.
