# Tests

**978 tests répartis en 30 suites**, dans `tests/`. Ils doivent tous passer
avant toute livraison.

---

## Lancer les tests

Chaque suite attend une **base fraîche**. Elles créent leurs propres comptes et
dossiers, et ne nettoient pas derrière elles — les enchaîner sur la même base
produit des faux échecs.

```bash
for suite in tests/*.php; do
  mysql -e "DROP DATABASE IF EXISTS wk; CREATE DATABASE wk;"
  mysql wk < sql/schema.sql
  php "$suite"
done
```

Chaque suite affiche `=== N reussis, M echecs ===`. Tout `M` non nul est à
traiter avant de livrer.

Prérequis : `config/config.php` doit exister et pointer vers une base de test
jetable. **Jamais vers la base de production** — les suites suppriment et
recréent des données.

---

## Ce que couvrent les suites

| Suite | Objet |
|---|---|
| `test.php`, `testnotif.php` | Socle : comptes, dépôt, notifications |
| `testv2` à `testv8` | Fonctionnalités historiques, cloisonnement, cohérence type/catégorie |
| `testmf.php` | Validation du matricule fiscal tunisien |
| `testccms1` à `testccms9` | Analyses, CAPA, 5 Pourquoi, Ishikawa, 8D, SLA, KPI, référentiels, API |
| `testp2` à `testp5` | Portail client, formulaires, workflow |
| `testp6`, `testp7` | Alertes, SLA en heures, analyse qualité |
| `testp9`, `testp10` | Satisfaction, tableau de bord direction |
| `testp11a`, `testp12` | Exports, chaîne ERP |
| `testvideo.php` | Pièces jointes vidéo |

---

## Pièges de méthode — appris à la dure sur ce projet

Ces erreurs ont réellement été commises ici. Les connaître évite de les
refaire.

### Un test qui échoue n'est pas toujours un bug du code

Plusieurs fois, l'assertion était devenue fausse après un changement
volontaire — par exemple « 17 catégories commerciales » après en avoir ajouté
cinq avec validation. **Vérifier laquelle des deux a raison** avant de
corriger le code.

### Vérifier le comportement réel, pas la syntaxe

`php -l` ne détecte pas deux clauses `WHERE` consécutives dans une requête
construite dynamiquement : la syntaxe PHP est valide, la requête SQL ne l'est
pas. Ce bug précis est passé par une page blanche en production. **Tester par
une vraie requête HTTP.**

### Le HTML du serveur ne suffit pas quand du JavaScript intervient

Un champ correctement rendu par le serveur peut être masqué ensuite par un
script dans le navigateur. Ce cas exact s'est produit : le champ « commercial »
était présent dans le HTML, invisible à l'écran, et trois vérifications par
requête HTTP ont conclu à tort que tout allait bien.

**Pour tester du JavaScript réellement** :

```bash
npm install jsdom
```

Puis charger le HTML réel du serveur dans un DOM, exécuter le script, et
observer l'état des éléments avant/après. C'est ce qui a permis de trouver le
bug et de prouver la correction.

### Construire des fichiers de test réalistes

Un `.xlsx` fabriqué comme une archive ZIP minimale n'est pas reconnu comme un
vrai fichier Excel par `finfo` — le test échouait pour une raison sans rapport
avec le code. Utiliser `ecrire_xlsx()` de `lib/export.php` pour produire un
fichier authentique.

### Attention au comptage par `grep`

Compter `grep -c "wk-ligne"` donne plusieurs correspondances par élément
(`wk-ligne`, `wk-ligne-h`, `wk-ligne-t`…). Cibler un motif réellement unique,
comme `href="dossier.php?id=`.

---

## Vérifications complémentaires avant livraison

```bash
find . -name "*.php" -exec php -l {} \; | grep -v "No syntax errors"
for j in public/assets/*.js; do node --check "$j"; done
```

Et pour les migrations, vérifier qu'elles restent réexécutables :

```bash
mysql wk < sql/migration-ccms-XX.sql   # deux fois de suite, sans erreur
```
