# Portail réclamations — Workman Group

Installation sur hébergement mutualisé OVH. Compter 30 minutes.

Prérequis : PHP 8.1 ou supérieur, une base MySQL, un accès FTP.

---

## 1. Créer la base de données

Espace client OVH → Web Cloud → Hébergements → votre hébergement → onglet
**Bases de données** → *Créer une base de données*.

Notez le **serveur** (`xxxxx.mysql.db`), le **nom de la base**, l'**utilisateur**
et le **mot de passe**. La création prend quelques minutes.

## 2. Importer le schéma

> **`schema.sql` est réservé à une base VIDE.** Il commence par des
> `DROP TABLE` : l'exécuter sur une base en service effacerait tous les
> comptes et toutes les réclamations. Pour mettre à jour une base existante,
> utilisez uniquement les fichiers `sql/migration-*.sql`.
>
> Un garde-fou en tête du fichier interrompt le script si la base contient
> déjà des données, avec une erreur du type
> `Table 'ARRET_BASE_NON_VIDE_UTILISEZ_LES_FICHIERS_MIGRATION' doesn't exist`.
> Cette erreur est volontaire : c'est la protection qui fonctionne.

Ouvrez phpMyAdmin depuis l'espace client, sélectionnez votre base, onglet
**Importer**, choisissez `sql/schema.sql`, exécutez.

Vérifiez ensuite la présence de six tables et deux vues.

## 3. Créer le compte du service qualité

Le premier compte est un cas particulier : il n'y a encore personne pour le
valider. Créez-le par le formulaire d'inscription, puis en base :

    UPDATE clients SET role = 'qualite', actif = 1
     WHERE email = 'reclamations@workmangroup.tn';

Notez le `actif = 1` : sans lui le compte reste en attente. Les suivants se
valident depuis l'écran **Comptes** du back-office, sans passer par SQL.

### Détail

À faire **après** avoir déposé les fichiers et configuré l'application
(étapes 4 et 5), car il faut que le portail soit accessible.

Les mots de passe sont stockés sous forme de hash bcrypt : une empreinte
irréversible. MySQL ne sait pas la calculer, on ne peut donc pas taper un
mot de passe directement dans phpMyAdmin. On laisse l'application le faire.

1. Ouvrez le portail, cliquez sur **Créer un compte**.
2. Inscrivez-vous avec l'adresse du service qualité, par exemple
   `reclamations@workmangroup.tn`, et le mot de passe de votre choix.
3. Dans phpMyAdmin, onglet **SQL**, exécutez :

       UPDATE clients SET role = 'qualite'
        WHERE email = 'reclamations@workmangroup.tn';

4. Déconnectez-vous et reconnectez-vous : vous arrivez sur le back-office.

Même méthode pour ajouter un collègue au service qualité : il crée son
compte, vous passez son `role` à `qualite`.

## 4. Configurer l'application

Copiez `config/config.exemple.php` en `config/config.php` et renseignez :

- le bloc `db` avec les identifiants de l'étape 1
- le bloc `smtp` avec le compte d'envoi (`ssl0.ovh.net`, port 465, sécurité
  `ssl` pour MX Plan ; `proN.mail.ovh.net`, port 587, sécurité `tls` pour
  Email Pro)
- le bloc `notifications` avec les adresses qui reçoivent les réclamations
- la clé `app.url` avec l'adresse publique du portail : elle construit les liens
  « Consulter le dossier » dans les e-mails envoyés aux clients

`config/config.php` ne doit jamais être accessible depuis le web ni versionné.

## 5. Déposer les fichiers

Deux organisations fonctionnent, l'application s'adapte automatiquement.

**Recommandée** — les dossiers sensibles hors de l'espace web :

    /                      racine FTP
      config/  lib/  outils/  sql/
      www/                 ← contenu de public/

**À plat** — si votre offre ne permet pas d'écrire au-dessus de `www` :

    www/
      config/  lib/  outils/  sql/  assets/  qualite/  uploads/
      index.php  reclamation.php  dossier.php  …

Dans ce second cas, les `.htaccess` livrés dans `config/`, `lib/`, `outils/`
et `sql/` interdisent l'accès direct à ces dossiers depuis le navigateur.
Ne les supprimez pas.

Dans les deux cas, `assets/`, `qualite/` et `uploads/` restent à côté de
`index.php`. Droits sur `uploads` : 755, accessible en écriture par PHP.

## 6. Activer HTTPS

Espace client → onglet **Multisite** → activez le certificat SSL gratuit sur
le domaine. Sans HTTPS, les mots de passe circulent en clair et les cookies
de session ne sont pas protégés.

Le `.htaccess` de `www` force déjà la redirection vers HTTPS.

## 7. Mise à jour d'une base existante

Si la base a été installée avant l'ajout des notifications, exécutez
`sql/migration-notifications.sql` dans phpMyAdmin. Sur une installation
neuve, `schema.sql` contient déjà la table : rien à faire.

## 8. Vérifier

1. Ouvrez le site : la page de connexion s'affiche.
2. Créez un compte client de test, déposez une réclamation avec une photo.
3. Vérifiez que l'e-mail arrive au service qualité, photo jointe.
4. Connectez-vous avec le compte qualité : le dossier apparaît, changez son
   statut, vérifiez que le client voit la mise à jour.
5. Vérifiez la cloche en haut à droite : elle porte un compteur jaune côté
   qualité dès le dépôt, et côté client dès le premier changement de statut.
6. Vérifiez que le client reçoit bien l'e-mail d'avancement, et qu'une note
   interne ne lui envoie rien.
7. Supprimez le compte de test dans phpMyAdmin.

---

## En cas de problème

**Premier réflexe : `diagnostic.php`.** Ce fichier est livré dans `public/`.
Ouvrez-le dans le navigateur : il teste la version de PHP, les extensions,
la présence et la validité de `config.php`, la connexion à la base, les
tables du schéma, les droits du dossier des photos et l'état du HTTPS.
Chaque échec indique quoi corriger.

**Supprimez-le du serveur une fois l'installation validée** : il révèle des
informations sur votre configuration.

**Page blanche** — activez temporairement l'affichage des erreurs en ajoutant
`ini_set('display_errors', '1');` en haut de `www/index.php`, ou consultez les
logs dans l'espace client, section *Logs*. Retirez-le ensuite.

**Impossible de se connecter au back-office** — le compte existe mais son
`role` est resté à `client`. Vérifiez la valeur dans la table `clients`.

**« Configuration absente »** — `config/config.php` n'a pas été créé, ou son
chemin relatif ne correspond pas à votre arborescence.

**« Le service est momentanément indisponible »** — identifiants de base
incorrects, ou base pas encore active côté OVH.

**E-mail non reçu** — ouvrez `test-mail.php` : il envoie un message réel et
affiche le dialogue complet avec le serveur SMTP, en interprétant les codes
d'erreur courants. Les identifiants y sont masqués. Supprimez ce fichier une
fois le test concluant. Sinon, vérifiez que l'adresse d'expédition est une vraie boîte
et non un alias, que SPF contient `include:mx.ovh.com`, et activez DKIM dans
l'espace client. En dernier recours, passez `smtp.actif` à `false` : PHP
bascule alors sur `mail()`, sans pièces jointes.

**Photos qui ne s'affichent pas** — droits du dossier `www/uploads`, et taille
maximale d'upload PHP (`upload_max_filesize`, `post_max_size`) à ajuster dans
un fichier `.ovhconfig` ou `.user.ini` si nécessaire.

---

## Notifications

Deux canaux, déclenchés automatiquement.

**Nouvelle réclamation** — chaque compte ayant le rôle `qualite` reçoit une
alerte dans l'application, et un e-mail part vers les adresses du bloc
`notifications` avec les photos en pièces jointes. Les dossiers en gravité
bloquante sont préfixés `[URGENT]` en objet.

**Avancement du dossier** — à chaque changement de statut ou message publié,
le client reçoit une alerte dans son espace et un e-mail contenant le nouveau
statut, le message du service qualité et un lien direct vers le dossier.
Les notes internes ne déclenchent rien.

Un échec d'envoi d'e-mail est journalisé mais n'interrompt jamais le dépôt ni
le traitement : la notification dans l'application reste visible.

Pour ajouter un membre au service qualité, passez son `role` à `qualite` dans
la table `clients`. Il recevra les alertes dès la réclamation suivante.

## Rapprochement avec l'ERP Systematic

Le portail peut proposer au client ses propres commandes et pré-remplir les
références, dates, quantités et numéros de lot. Trois étapes.

**1. Créer la table.** Sur une installation neuve, `schema.sql` la contient
déjà. Sinon, exécutez `sql/migration-commandes.sql`.

**2. Alimenter `commandes_ref`.** Deux sources possibles, même script.

Par fichier, pour démarrer sans rien demander à l'éditeur :

    php outils/importer-commandes.php --csv=/chemin/export.csv

Colonnes attendues, séparateur `;` ou `,`, dates en français ou en ISO :
`code_erp, societe, entite, numero_commande, bl, facture, date_livraison,
reference_produit, designation, lot, qte_livree`

Par connexion directe au MySQL de l'ERP : renseignez le bloc `erp` de
`config/config.php` avec un compte **en lecture seule** et adaptez la requête
aux noms de tables de votre installation. Puis planifiez une tâche Cron
nocturne dans l'espace client OVH :

    /usr/local/php8.3/bin/php /home/.../outils/importer-commandes.php --purge

Le script est idempotent : le relancer ne crée jamais de doublon. L'option
`--test` lit sans rien écrire, utile pour valider un export avant de l'intégrer.

**3. Rattacher les comptes clients.** Renseignez `code_erp` dans la table
`clients` avec le code du client dans l'ERP. Sans ce code, l'autocomplétion
reste inactive pour ce compte et la saisie manuelle fonctionne comme avant.

Ce rattachement explicite est volontaire : le portail ne devine jamais le
lien à partir de la raison sociale. Deux noms proches suffiraient à exposer
les commandes d'un client à un autre.

## Réinitialisation de mot de passe

Accessible depuis la page de connexion. Le client saisit son adresse, reçoit
un lien valable **une heure**, à **usage unique**. Toute demande antérieure est
annulée dès qu'une nouvelle est faite, et trois demandes par heure et par compte
au maximum sont acceptées.

Le jeton n'est jamais stocké en clair : seule son empreinte SHA-256 est en base.
Une fuite de la table ne permettrait pas de prendre la main sur un compte.

Le message affiché est identique que le compte existe ou non — sinon le
formulaire deviendrait un moyen de découvrir vos clients.

**Prérequis** : `app.url` correctement renseignée dans `config.php`, et l'envoi
SMTP fonctionnel. Sans e-mail, pas de lien.

## Pages légales

`mentions-legales.php` et `donnees-personnelles.php` sont accessibles depuis le
pied de page de toutes les pages. Leur contenu est alimenté par le bloc `legal`
de `config/config.php` : raison sociale, adresse, matricule fiscal, registre de
commerce, directeur de publication, hébergeur, adresse de contact pour l'exercice
des droits, durée de conservation.

**Ces textes sont un modèle de départ, pas un document validé.** Ils couvrent la
loi tunisienne n° 2004-63 et les principes du RGPD pour vos clients européens.
Faites-les relire par votre conseil juridique avant l'ouverture du portail, et
vérifiez si une déclaration auprès de l'INPDP est requise pour ce traitement.

## Journal d'audit

`qualite/journal.php`, réservé au rôle `qualite`. Enregistre les connexions
réussies et échouées, les créations de compte, les demandes et changements de
mot de passe, les dépôts de réclamation, les changements de statut, les messages
publiés, les notes internes et les exports CSV. Chaque entrée porte la date,
l'auteur, le dossier concerné, un détail et l'adresse IP.

Filtres par action, par période et recherche libre sur l'e-mail, la référence
ou l'IP. Depuis le détail d'un dossier, les entrées le concernant sont
consultables.

La table est en **ajout seul** : aucune fonction de l'application ne modifie ni
ne supprime une entrée. C'est ce qui lui donne sa valeur probante. L'e-mail de
l'auteur est recopié dans chaque entrée, de sorte que la trace reste exploitable
même si le compte est supprimé par la suite.

Prévoyez une purge manuelle au-delà de la durée annoncée dans votre politique de
données, trois ans par défaut.

## Sauvegarde

**À mettre en place avant l'ouverture aux clients.** Sans elle, une erreur de
manipulation dans phpMyAdmin efface l'historique sans retour possible.

    php outils/sauvegarder.php --photos

Écrit une archive compressée de la base dans `sauvegardes/`, plus un zip des
photos. Rotation automatique à 30 jours, ajustable avec `--jours=60`. Le script
est écrit en PHP pur : ni `mysqldump` ni `exec()` ne sont nécessaires, ce qui le
rend utilisable sur mutualisé.

Planifiez-le en tâche Cron quotidienne dans l'espace client OVH :

    /usr/local/php8.3/bin/php /home/.../outils/sauvegarder.php --photos

**Une sauvegarde restée sur le même serveur ne protège que des erreurs de
manipulation.** Recopiez les archives ailleurs régulièrement — poste local,
espace de stockage séparé.

Pour restaurer :

    gunzip -c sauvegardes/base-AAAA-MM-JJ_HHMMSS.sql.gz | mysql -h serveur -u user -p base

Testez la restauration une fois sur une base vide avant d'en avoir besoin.

## Accusé de réception

Le client reçoit un courriel dès le dépôt : numéro de dossier, récapitulatif
de sa déclaration, délais annoncés, lien de suivi, et une mention prioritaire
si la gravité est bloquante. C'est ce qui évite l'appel téléphonique de
vérification dans les heures qui suivent.

## Protection contre les tentatives répétées

Cinq échecs de connexion en quinze minutes bloquent l'accès pendant dix
minutes. Le comptage porte à la fois sur l'adresse e-mail et sur l'adresse IP,
faute de quoi il suffirait de changer de compte à chaque essai. Une connexion
réussie remet le compteur à zéro. Tous les échecs sont journalisés.

## Raccourcis de l'interface

**Filtres rapides** en haut du back-office, avec leur compteur : à traiter,
hors délai, bloquantes, clôturées ce mois. « Hors délai » applique les
engagements affichés aux clients — plus de 48 h en statut Reçue, ou plus de
5 jours en Analyse. Le compteur passe en rouge dès qu'il n'est pas à zéro.

**Réponses types** dans le formulaire de traitement : huit modèles courants
(prise en charge, demande d'échantillon, réclamation acceptée, avoir, hors
garantie, délai supplémentaire, clôture). Le texte s'insère dans le message et
reste modifiable ; le curseur se place sur le premier élément à compléter,
signalé entre crochets. Modifiables dans `REPONSES_TYPES`, en haut de
`lib/vue.php`.

**Barre d'actions** sur chaque dossier : copier le numéro, copier les
références pour les coller dans l'ERP, imprimer. Côté qualité s'y ajoutent
« Appeler le client » et « Écrire au client » — utiles depuis un téléphone.
Côté client, un bouton pour contacter le service qualité.

**Impression** : une feuille de style dédiée masque la navigation, les
formulaires et les filtres, et empêche les blocs d'être coupés entre deux
pages. Utile pour joindre un dossier à un litige.

Tous ces raccourcis sont facultatifs : sans JavaScript, la page reste
entièrement utilisable.

## Validation des comptes clients

Un contact qui s'inscrit crée un compte **inactif**. Il voit un écran
d'attente, et une tentative de connexion lui indique que sa demande est en
cours d'examen. Le service qualité reçoit une alerte dans l'application et un
courriel avec la société, le contact, le téléphone et le matricule fiscal.

La validation se fait dans **Comptes**, depuis le back-office. C'est là que
vous renseignez le **code client ERP** : sans lui, l'autocomplétion des
commandes reste inerte pour ce client. Un compte actif sans code ERP est
d'ailleurs signalé en rouge dans la liste.

À la validation, le client reçoit un courriel lui confirmant que son accès est
ouvert.

Le même écran permet de modifier un code ERP, de passer un compte en service
qualité ou de l'en retirer, et de désactiver un compte. Trois garde-fous :
on ne peut pas se désactiver soi-même, ni retirer son propre accès qualité,
ni supprimer le dernier compte qualité actif. Une désactivation annule les
liens de réinitialisation en cours et conserve les dossiers.

Toutes ces actions sont journalisées.

**Pourquoi ce circuit.** Sans validation, n'importe qui connaissant l'adresse
du portail peut écrire dans votre système qualité, et vos statistiques de
défauts perdent leur valeur. La validation manuelle est aussi le seul moment
naturel pour établir le lien avec l'ERP.

## Messagerie par dossier

Sous chaque réclamation, un fil où le client et le service qualité échangent,
avec pièces jointes des deux côtés. Les messages du client apparaissent avec un
liseré jaune, ceux du service qualité en bleu, les notes internes en gris et
uniquement côté qualité.

Quand le client écrit, tout le service qualité reçoit une alerte dans
l'application et un courriel reprenant le message, avec `Reply-To` pointant sur
le client. Si le dossier était clôturé, l'objet est préfixé
`[DOSSIER CLOTURE]` et un encart le signale : à vous de décider s'il faut le
rouvrir.

Un message seul ne change jamais le statut du dossier. Seul le service qualité
le fait, explicitement.

**Pourquoi pas une bulle de chat en direct.** Elle promettrait une réponse
immédiate là où vous affichez 48 heures, et sortirait la conversation du
dossier : l'échange partirait chez un prestataire tiers, hors de votre journal
d'audit et hors de votre hébergement. Le fil par dossier garde tout chez vous,
horodaté et tracé.

**Mise à jour d'une base existante** : exécutez `sql/migration-messages.sql`.

## Commercial rattaché à la commande

Chaque réclamation porte le nom du commercial qui suit la commande. Il est
rempli automatiquement quand le client choisit une commande reconnue par
l'ERP, et reste modifiable à la main.

Pour l'alimenter, ajoutez une colonne `commercial` à votre export de commandes,
ou à la requête ERP du bloc `erp` de `config.php`. Le nom est **recopié sur la
réclamation à sa création** : si le portefeuille change plus tard, le dossier
garde le commercial qui suivait la commande à l'époque.

Il apparaît dans le détail du dossier, dans l'e-mail au service qualité, dans
l'export CSV, dans la recherche, et se filtre par `?commercial=Nom`.

**Mise à jour d'une base existante** : exécutez `sql/migration-commercial.sql`.

## Tableau de bord qualité

`qualite/tableau-bord.php`, avec une fenêtre réglable de 3 mois à 5 ans.

Six indicateurs de tête : volume, pièces concernées, clients touchés, délai moyen
avant première réponse, délai moyen jusqu'à clôture, dossiers sans aucune réponse.
Puis l'évolution mensuelle, les répartitions par nature, gravité, entité et
solution demandée, les articles les plus réclamés, les lots concentrant plusieurs
dossiers, et les clients les plus concernés.

**Le taux de défaut** est l'indicateur qui compte : pièces réclamées rapportées aux
pièces livrées, par référence. C'est le seul comparable d'un article à l'autre —
une référence vendue à 1 200 unités avec 36 réclamations va mieux qu'une référence
vendue à 300 avec 42. Il exige que `commandes_ref` soit alimentée depuis l'ERP
(`outils/importer-commandes.php`) ; sans cela le bloc affiche un message
d'indisponibilité.

Un lot qui revient sur plusieurs dossiers signale un incident de production, pas
un défaut isolé : c'est le premier endroit à regarder quand le volume monte.

## Relances automatiques

    php outils/relances.php

Envoie au service qualité la liste des dossiers hors des délais annoncés, et
dépose une alerte dans l'application. Sans ce script, les 48 heures affichées aux
clients ne sont qu'un affichage.

Tâche Cron, chaque matin :

    /usr/local/php8.3/bin/php /home/.../outils/relances.php

Trois motifs de relance : aucune réponse après 2 jours ouvrés, aucune décision
après 5 jours ouvrés, ou date limite du client dépassée. Le calcul se fait en
**jours ouvrés** — un dossier déposé vendredi soir n'est pas en retard le
dimanche. Le script ne s'exécute pas le samedi ni le dimanche, et ne dépose
qu'une alerte par jour et par personne.

`--test` affiche sans rien envoyer, `--force` envoie même hors jour ouvré.
Si l'envoi du courriel échoue, l'alerte reste visible dans le portail.

## Matricule fiscal

Le matricule fiscal est **obligatoire** à la création de compte, et sa
structure est contrôlée.

Format attendu : `NNNNNNN/C/T/V/EEE` — 7 chiffres, une lettre-clé, un code
TVA, un code catégorie, 3 chiffres d'établissement. Exemple :
`1234567A/A/M/000`.

- **Code TVA** : `A` assujetti obligatoire, `B` facultatif, `P` partiel,
  `F` forfaitaire, `N` non assujetti.
- **Code catégorie** : `M` personne morale, `C` commerçant ou industriel,
  `P` profession libérale, `N` employeur non imposable.

La saisie est assistée : le champ se met en forme pendant la frappe et
affiche en clair ce que le matricule signifie, par exemple « Personne morale,
assujetti obligatoire à la TVA, siège ». Une erreur de structure est signalée
avant l'envoi. Le contrôle serveur reste la référence.

Les séparateurs sont libres à la saisie — barres obliques, tirets, espaces ou
rien — et le matricule est enregistré au format canonique. Les dossiers
anciens à 6 chiffres sont acceptés : refuser un matricule légitime
empêcherait un client de déposer sa réclamation.

**Ce contrôle porte sur la forme, jamais sur l'existence.** Un matricule bien
formé peut ne correspondre à aucun contribuable. Pour une vérification
officielle, utilisez le service e-Situation Fiscale de la DGI sur
`impots.finances.gov.tn`, ou la fiche publique sur `registre-entreprises.tn`.

Dans l'écran **Comptes**, chaque fiche affiche le matricule décodé. Un compte
dont le matricule ne respecte pas la structure porte la mention « Matricule à
vérifier » : c'est le cas des comptes créés avant cette version, qui ne sont
pas bloqués pour autant.

## Type de réclamation : qualité ou commerciale

Le client choisit dès la première étape du formulaire s'il s'agit d'un problème
sur le **produit** (qualité / production) ou sur la **commande** (commerciale et
logistique). Ce choix commande trois choses.

**Les natures proposées.**

*Qualité / production* : défaut produit, défaut de personnalisation, taille ou
coupe, emballage endommagé.

*Commerciale et logistique* : retard de livraison, écart de quantité, article non
conforme, erreur de facturation — et le suivi commercial proprement dit :
interlocuteur injoignable, délai de réponse trop long, devis non reçu ou
incomplet, absence de suivi de commande, documents manquants.

« Autre » figure dans les deux. Une combinaison incohérente est refusée côté
serveur, pas seulement masquée par le navigateur.

**Les réclamations sans marchandise.** Un devis jamais reçu ou un commercial
injoignable n'ont ni article, ni quantité, ni parfois de numéro de commande.
Quand la réclamation ne porte que sur ces natures-là, ces champs deviennent
facultatifs. Dès qu'une nature concerne une marchandise livrée — un retard, un
écart de quantité — ils redeviennent obligatoires.

**Les destinataires.** Renseignez le bloc `notifications` de `config.php` :

    'notifications' => [
        'qualite'     => ['reclamations@workmangroup.tn'],
        'commerciale' => ['commercial@workmangroup.tn'],
        'copie'       => ['mehdi.saidane@workmangroup.tn'],
    ],

Si `commerciale` est vide, tout arrive sur les adresses `qualite` : la
fonctionnalité se dégrade sans rien casser.

**Les alertes dans l'application.** Chaque compte back-office porte un champ
**Recevoir les dossiers**, réglable dans l'écran Comptes : les deux types,
qualité seulement, ou commercial seulement. Par défaut, un compte reçoit les
deux — c'est le comportement d'avant cette version, donc aucun compte existant
ne cesse d'être alerté.

**Quand le client se trompe de guichet**, un bouton « Réorienter » sur le
dossier bascule le type. Les natures devenues incompatibles sont retirées, le
client est informé dans le fil, et l'opération est journalisée. Mieux vaut
réorienter que renvoyer le client remplir un second formulaire.

La liste du back-office porte un badge de type, se filtre par type, et le
tableau de bord affiche la répartition entre les deux.

**Mise à jour d'une base existante** : exécutez `sql/migration-types.sql` puis
`sql/migration-natures.sql`. Les dossiers déjà en base sont classés en `qualite`,
qui était le seul cas couvert, et aucune nature existante n'est retirée.

## Groupes d'accès du back-office

Trois groupes, réglables dans l'écran **Comptes** par un administrateur.

| Groupe | Voit | Peut aussi |
|---|---|---|
| **Administrateur** | Les deux types | Gérer les comptes, consulter le journal d'audit |
| **Qualité / production** | Réclamations sur le produit | — |
| **Commercial** | Réclamations sur la commande | — |

**Chaque groupe a son propre tableau de bord**, et pas seulement des données
filtrées : les blocs affichés changent. Le groupe qualité voit les articles les
plus réclamés, les lots suspects et le taux de défaut. Le groupe commercial voit
les commerciaux les plus concernés et le délai de première réponse par nature.
L'administrateur voit tout, plus la répartition entre les deux types.

Un lot de production n'a aucun sens pour un retard de devis, et un portefeuille
commercial n'en a aucun pour un défaut de couture.

**Le cloisonnement est appliqué en base, dans les requêtes.** Un membre du
groupe qualité qui saisit l'URL d'un dossier commercial obtient une page
introuvable, pas le dossier. Cela vaut pour la liste, le détail, les photos,
l'export CSV, les compteurs et l'ensemble du tableau de bord.

`comptes.php` et `journal.php` renvoient une erreur 403 pour les groupes
cloisonnés, et leurs boutons ne s'affichent pas.

**Deux garde-fous** : un administrateur ne peut pas se retirer ses propres
droits, et le dernier administrateur actif ne peut pas être rétrogradé. Sans
cela, une fausse manœuvre rendrait la gestion des comptes inaccessible à tout
le monde.

**Par défaut, tout compte back-office est administrateur.** C'est le
comportement d'avant cette version : aucun accès existant n'est restreint sans
décision explicite de votre part.

## Rapprochement automatique des comptes

L'autocomplétion des commandes n'apparaît que si le compte client porte son
**code client ERP**. Le saisir à la main pour chaque client est fastidieux et
source d'erreur : un code faux ne produit aucune suggestion, sans message.

Le portail le retrouve tout seul, à partir du **matricule fiscal** — la seule
donnée que le client saisit lui-même et que votre ERP connaît déjà.

**Ce qu'il faut faire** : ajouter une colonne `matricule_fiscal` à l'export de
commandes, ou à la requête ERP du bloc `erp` de `config.php`. Rien d'autre.

Ensuite, à la validation d'un compte, l'écran Comptes pré-remplit le code et
indique « Rapproché automatiquement par le matricule fiscal ». Le service
valide, sans rien saisir.

**Pour les comptes déjà créés** :

    php outils/rapprocher-comptes.php --test    simulation
    php outils/rapprocher-comptes.php           application

**Deux cas ne sont jamais devinés.** Un matricule inconnu de l'ERP, et un
matricule correspondant à plusieurs codes clients — plusieurs établissements,
par exemple. Dans ce second cas les codes candidats sont affichés et le service
tranche. Rattacher au hasard relierait un client aux commandes d'un autre.

Le matricule est normalisé avant comparaison : `1234567A/A/M/000` et
`1234567AAM000` se rapprochent.

**Mise à jour d'une base existante** : exécutez `sql/migration-rapprochement.sql`.

## Ce qui reste à faire un jour

- Pagination des listes au-delà de quelques centaines de dossiers
- Purge des photos des dossiers clôturés depuis longtemps
- Pagination de la liste au-delà de quelques centaines de dossiers
- Journal des connexions pour l'audit
