# Décisions structurantes

Chaque décision ci-dessous a été prise explicitement, avec une raison. Les
revenir sur sans connaître cette raison risque de recréer un problème déjà
résolu.

---

## Aucune bibliothèque PDF

**Décidé** : l'export PDF passe par l'impression du navigateur sur un gabarit
dédié, pas par une bibliothèque comme dompdf ou tcpdf.

**Pourquoi** : ajouter une bibliothèque romprait la contrainte « zéro
dépendance » posée au premier jour, pour un seul écran. Une feuille de style
`@media print` dédiée existe déjà : elle masque navigation et boutons, évite
les coupures de page au milieu d'un bloc. Le rendu est maîtrisé, pas une
capture brute de la page.

**Si à reconsidérer** : ce serait un choix d'architecture à part entière, pas
un ajout mineur.

---

## Excel généré à la main

**Décidé** : les fichiers `.xlsx` sont construits directement avec
`ZipArchive`, extension native de PHP.

**Pourquoi** : un `.xlsx` est structurellement une archive ZIP contenant du
XML. L'écrire à la main évite PhpSpreadsheet, donc respecte la contrainte de
dépendances.

**Validé par trois lecteurs indépendants** : `xmllint` sur chaque partie XML,
`openpyxl` (Python), et une conversion réelle par LibreOffice. Un matricule
commençant par zéro, les accents, les guillemets et les sauts de ligne en
cellule ressortent intacts.

**Piège** : le typage des cellules est explicite. Un `int` ou `float` PHP
devient un nombre Excel ; **toute chaîne reste du texte**, même si elle
ressemble à un nombre. C'est volontaire : deviner le type ferait perdre les
zéros non significatifs d'une référence comme `0123456`.

---

## Graphiques en SVG côté serveur

**Décidé** : aucune bibliothèque JavaScript de visualisation (Chart.js, D3).
`lib/svg.php` produit des courbes, barres et anneaux en SVG directement.

**Pourquoi** : cohérence avec la contrainte zéro dépendance, et les graphiques
restent visibles sans JavaScript — y compris à l'impression d'un rapport.

---

## Satisfaction basse : validation interne, jamais réouverture automatique

**Décidé** : une note ≤ 2/5 entre dans une file de validation
(`satisfaction_a_valider`). Un humain tranche : rouvrir, ou maintenir en l'état
avec un motif obligatoire.

**Pourquoi** : un client peut noter 2 pour une raison sans rapport avec la
résolution (un livreur désagréable). Rouvrir automatiquement un dossier
réellement réglé, sur un seul chiffre, serait faux. Cohérent avec l'esprit CAPA
du reste de l'outil : rien ne se referme sans regard humain.

---

## Le code client vient de l'ERP, le client ne le saisit pas

**Décidé** : le rapprochement se fait automatiquement par matricule fiscal.

**Pourquoi** : une saisie manuelle serait une source d'erreur, et le client ne
connaît généralement pas son code dans notre ERP.

---

## Modèle ERP : hypothèse assumée, pas vérité terrain

**Décidé** : la chaîne structurée (`erp_*`) a été conçue **sans accès réel** à
l'ERP Systematic de Workman Group.

**Trois paris explicites**, notés aussi dans les commentaires du code et de la
migration : un OF a au plus un sous-traitant, une matière vient d'un seul
fournisseur, un lot vient d'un seul OF.

**Si l'accès réel contredit ces hypothèses**, la migration se corrige à ce
moment-là — pas avant, faute de terrain pour trancher.

---

## L'IA : voie choisie, jamais construite

**Décidé** : appel à une API de langage externe (voie B), fournisseur
recommandé Claude (Haiku pour la classification, Sonnet pour la génération).

**Jamais commencé** : il manque une clé d'API pour tester en conditions
réelles. Construire sans pouvoir vérifier reproduirait le problème du webhook
Teams (voir ci-dessous).

**Garde-fou déjà conçu, à implémenter** : aucune sortie d'IA ne s'écrit seule
dans un dossier, et un verrou technique doit interdire à toute fonction IA de
clôturer un dossier de gravité bloquante.

---

## Catégories commerciales : additif, pas remplacement

**Décidé** : les 5 catégories demandées en phase 3 (retard de devis, erreur de
devis, erreur de commande, engagement non respecté, absence de retour) se sont
**ajoutées** aux 17 existantes. Total : 22.

« Absence de retour » a été traitée comme une catégorie distincte plutôt que
fusionnée avec `reponse`, `suivi` ou `injoignable` — décision prise faute de
précision, à corriger si elle ne correspond pas à l'intention.

---

## Ce qui n'a pas pu être vérifié

**Le canal Teams** (`envoyer_teams()` dans `lib/alertes.php`) suit le format
MessageCard de Microsoft mais **n'a jamais été testé en conditions réelles**,
faute de webhook disponible. À valider manuellement au premier envoi.

**Les tâches Cron** (sauvegarde, relances quotidiennes) sont documentées mais
leur activation réelle sur l'hébergement OVH n'est pas vérifiable depuis un
poste de développement.
