# CLAUDE.md — Portail Réclamations Workman Group

Point d'entrée pour toute session de travail sur ce projet. Lis ce fichier en
premier, puis `docs/` pour le détail.

---

## Ce qu'est ce projet

Plateforme CCMS (Customer Complaint Management System) de gestion des
réclamations clients B2B pour **Workman Group**, conglomérat textile et
vêtement professionnel tunisien basé à Hammam-Sousse.

Trois entités concernées : **Workman** (vêtement professionnel et EPI, leader
sur le marché tunisien), **Stidexport** (fabrication pour l'export européen),
**MB Confection** (marché français).

Deux types de réclamations, traitées par des services différents mais dans le
même outil : **commerciales** (commande, devis, facturation, suivi) et
**qualité** (défaut sur un article livré).

Le système sert aussi de preuve documentaire pour la certification **ISO 9001**.

---

## État actuel : en production

Ce n'est pas un prototype. Le portail tourne réellement sur
`reclamation.workman-stid.com`, avec de vrais clients.

| Mesure | Valeur |
|---|---|
| Tests automatisés | **1408**, tous au vert |
| Modules PHP (`lib/`) | 34 |
| Écrans client (`public/`) | 20 |
| Écrans internes (`public/qualite/`) | 15 |
| Outils en ligne de commande | 7 |
| Tables en base | 36 |
| Migrations SQL | 31 |

---

## Contraintes techniques — non négociables

Ces règles ont été posées au premier jour et tenues sans exception depuis.
Les rompre casserait la cohérence de tout ce qui existe.

1. **PHP 8.2 procédural.** Pas de framework, pas de classes métier, pas de
   Composer. Des fonctions dans des fichiers, incluses par `require_once`.
2. **Zéro dépendance externe.** Aucune bibliothèque tierce, ni PHP ni
   JavaScript. Les besoins habituellement couverts par une bibliothèque ont
   été écrits à la main : génération XLSX via `ZipArchive` (extension native),
   graphiques en SVG produit côté serveur, envoi SMTP direct.
3. **Hébergement mutualisé OVH.** Pas de `exec()`, pas de `mysqldump`, pas de
   tâche en arrière-plan permanente. Tout doit fonctionner sous ces limites —
   c'est pourquoi le script de sauvegarde est écrit en PHP pur.
4. **Le JavaScript est un confort, jamais une nécessité.** Chaque écran doit
   rester utilisable sans lui. Le JS ajoute de l'aisance (autocomplétion,
   compression d'image avant envoi, champs conditionnels), il ne porte
   jamais une fonction indispensable à lui seul.
5. **Français sans accents dans le code.** Identifiants, commentaires et
   libellés des constantes PHP sont en français non accentué, pour éviter tout
   problème d'encodage sur cet hébergement. Les textes vus par l'utilisateur
   dans les gabarits HTML peuvent être accentués.

---

## Méthode de travail attendue

Établie et suivie sur l'ensemble du projet :

1. **Analyser l'existant d'abord.** Une grande partie de ce qui est demandé
   existe souvent déjà. Toujours vérifier avant de construire.
2. **Proposer, puis attendre validation.** Ne jamais anticiper une phase
   suivante ni coder hors du périmètre validé.
3. **Ne rien supprimer sans accord explicite.** Une fonctionnalité existante
   ne se modifie ni ne se retire sans confirmation.
4. **Tester réellement, pas seulement relire.** Vérifier le comportement par
   une vraie requête HTTP, un vrai fichier, une vraie base — pas par
   raisonnement sur le code. Voir `docs/TESTS.md`, section sur les pièges.
5. **Rejouer les 1408 tests avant toute livraison.** Une régression doit être
   détectée avant le client, pas après.
6. **Compte-rendu de fin de phase** en cinq points : réalisé, fichiers
   touchés, tests effectués, problèmes et risques, reste à faire.

---

## Documents de référence

| Fichier | Contenu |
|---|---|
| `docs/ARCHITECTURE.md` | Structure du code, modèle de données, modules |
| `docs/DECISIONS.md` | Décisions structurantes et leur justification |
| `docs/ETAT-AVANCEMENT.md` | Ce qui est fait, ce qui reste, ce qui attend validation |
| `INSTALLATION.md` | Installation et déploiement (existant, à la racine) |
| `DOCUMENTATION/phase-14-securite-iso9001.md` | Audit sécurité + correspondance ISO 9001 |

---

## Pièges connus — à lire avant de coder

- **Les migrations SQL s'exécutent dans l'ordre numérique, jamais
  alphabétique.** `migration-ccms-10.sql` vient après le `9`, pas après le `1`.
- **`entete()`/`pied()` (dans `lib/vue.php`) produisent deux habillages
  différents** selon que l'utilisateur est un client ou un compte qualité.
  Toucher à l'un sans vérifier l'autre casse la moitié des écrans.
- **`db()` termine le script** en cas d'échec de connexion. Un `try/catch`
  autour n'attrapera rien — voir `public/sante.php` qui contourne ce
  comportement avec sa propre connexion.
- **Un test qui échoue n'est pas toujours un bug du code.** Plusieurs fois sur
  ce projet, c'était l'assertion du test qui était devenue fausse après un
  changement volontaire. Vérifier laquelle des deux a raison avant de corriger.

## Skills installés (.claude/skills/)

code-reviewer, debugging-wizard, test-master, security-reviewer, ui-ux-pro-max (source et licence : `.claude/skills/SOURCE.md`).
Usage : revue avant livraison, débogage par hypothèses, rédaction de tests, revue de sécurité du code, conseils UI/UX et accessibilité (`python3 .claude/skills/ui-ux-pro-max/scripts/search.py "requête" --domain ux`). `ui-ux-pro-max` conseille seulement : le design system du portail prime et tout changement visuel passe par une proposition validée. Les règles de ce fichier priment en cas de conflit.
