# Design system — Portail réclamations Workman

Source unique : `public/assets/style.css` (jetons dans `:root`) et `public/assets/sidebar.css`. Aucune dépendance. Ce document décrit ce qui existe ; `tests/testcss.php` vérifie que chaque jeton du CSS est documenté ici.

## 1. Principes
- **Une couleur, un rôle.** Les valeurs ne sont jamais écrites en dur hors du bloc `:root` (testé).
- **Lisible d'abord.** Tout texte atteint 4,5:1 sur son fond (3:1 pour les grands textes et les contours). Testé.
- **Cibles tactiles de 44 px** minimum pour les boutons, liens de navigation et cases.
- **Mouvement sobre** : il explique un changement d'état, il ne décore pas. Désactivé si l'utilisateur demande moins de mouvement.
- **Le JavaScript est un confort.** Chaque écran reste utilisable sans lui.

## 2. Couleurs

### Marque
| Jeton | Valeur | Usage |
|---|---|---|
| `--bleu` | `#23387F` | Boutons principaux, sélection active, fond d'en-tête client |
| `--marque-nuit` | `#17245A` | Fonds de marque fixes : barre latérale, bandeau de connexion |
| `--bleu-nuit` | `#17245A` | Identique à `--marque-nuit` (ancien nom, conservé pour compatibilité) |
| `--bleu-clair` | `#4A5FA8` | Contours de focus, graphiques secondaires |
| `--bleu-degrade` | `#2A3C7E` | Début du dégradé du bandeau de connexion |
| `--hivis` | `#FECD4D` | Accent unique : court segment de la bande signature (tiré du logo), pastilles, sélection d'option |
| `--texte-pale` | `#C6D0EA` | Texte secondaire sur fond de marque |

### Texte
| Jeton | Valeur | Usage |
|---|---|---|
| `--texte` | `#17245A` | Texte courant, titres |
| `--texte-bleu` | `#23387F` | Liens et boutons secondaires |
| `--gris` | `#5A5E6B` | Texte atténué, aides, libellés de tableau |
| `--gris-clair` | `#9A9DA6` | Contours et désactivés uniquement, jamais de texte |
| `--sur-marque` | `#FFFFFF` | Texte posé sur `--bleu` ou `--marque-nuit` |
| `--sur-hivis` | `#17245A` | Texte posé sur `--hivis` |
| `--nuit-2`, `--nuit-3` | `#B4C0DF`, `#A3AFD0` | Texte d'accompagnement sur fond de marque |

### Fonds et surfaces
| Jeton | Valeur | Usage |
|---|---|---|
| `--toile` | `#F2F1EC` | Fond de page |
| `--carte` | `#FFFFFF` | Cartes, champs |
| `--surface` | `#F7F6F2` | Zones secondaires, survol d'en-tête de tableau |
| `--trait` | `#D9D5CB` | Bordures |
| `--trait-doux` | `#EBE9E2` | Séparateurs à l'intérieur d'un bloc |
| `--voile` | `rgba(15,20,36,.45)` | Fond derrière le menu mobile |

### États (fond + bordure + texte)
| État | Fond | Bordure | Texte |
|---|---|---|---|
| Erreur | `--erreur-fond` | `--erreur-bord` | `--rouge` |
| Succès | `--succes-fond` | `--succes-bord` | `--vert` |
| Alerte | `--alerte-fond` | `--alerte-bord` | `--ambre` |
| Information | `--info-fond` (ou `--bleu-pale`) | `--info-bord` | `--texte` |
| Neutre végétal | `--olive-fond` | `--olive-bord` | `--texte` |

`--etoile-on` `#B8860B` : survol d'une note. `--noir` `#000000` et `--gris-impr` `#999999` : impression uniquement.

`--rouge` `#B3261E`, `--vert` `#2E6B3E`, `--ambre` `#9A6300`, `--etoile` `#D4A017` : ne jamais utiliser seuls pour dire quelque chose ; toujours avec un libellé.

## 3. Typographie
- **Familles** : Barlow (texte, interface) ; Barlow Semi Condensed (titres, chiffres de tableau de bord) ; IBM Plex Mono (références de dossier).
- **Échelle** : 12 · 13 · 14 · 15 · 16 · 18 · 22 · 30 px. Titres d'accueil uniquement : 25, 33, 46 px. Toute autre taille est refusée par les tests.
- **Interligne** : 1,5 sur paragraphes et listes ; 1,2 sur les titres.
- **Longueur de ligne** : 75 caractères au plus pour les aides et les citations.
- **Chiffres** : `font-variant-numeric: tabular-nums` dans les tableaux et statistiques.

## 4. Espacement, rayons, ombres
- **Rayons** : `--rayon-s` 6 px (boutons, champs, options) · `--rayon-m` 8 px (alertes, cartes de menu) · `--rayon-l` 12 px (cartes) · `--rayon-pill` (badges, pastilles).
- **Ombres** : `--ombre-1` (repos, contour léger) · `--ombre-2` (survol de carte, panneaux) · `--ombre-3` (voile, superpositions).
- **Espacements** : multiples de 2 et 4 px ; marges de blocs 16, 18, 22 px. Les marges répétées se font par classes `u-mt-*`, `u-mb-*` (lot 3), jamais par `style=""`.

## 5. Mouvement
- `--duree-rapide` 0,15 s : retours de survol et d'appui.
- `--duree-entree` 0,32 s : apparition des sections et des cartes.
- `--ease-sortie` : `cubic-bezier(.2,.7,.2,1)`.
- Sous `prefers-reduced-motion: reduce`, toutes les animations d'entrée et les déplacements au survol sont supprimés.

## 6. Composants

### Boutons
- `.wk-btn` : principal, fond `--bleu`, texte blanc, 44 px minimum, appui à 98 %.
- `.wk-btn-sec` : secondaire, contour `--trait`, texte `--texte-bleu`.
- `.wk-btn-fant` : sur fond de marque, contour clair.
- `.wk-btn-min` : variante compacte, reste à 44 px de hauteur.
- Désactivé : texte `--gris` sur `--trait-doux`.
- Un seul bouton principal par écran.

### Champs
- `.wk-in` : 44 px minimum, texte 16 px (évite le zoom automatique sur iPhone), contour `--gris`.
- Erreur : `.err` ou `.wk-in.err`, contour `--rouge` 2 px, message sous le champ relié par `aria-describedby`.

### Cartes et choix
- `.wk-carte` : fond `--carte`, contour `--trait`, rayon `--rayon-l`.
- `.wk-opt` : option cliquable ; `.wk-opt.on` : sélection par liseré jaune.

### Badges et pastilles
- `.wk-etat` : pilule, 13 px, bordure d'état.
- `.wk-puce`, `.wk-pastille` : compteurs.

### Alertes
- `.wk-alerte` (erreur), `.wk-ok` (succès), `.wk-info` (information), `.wk-avert` (avertissement).
- Un message de succès ou d'erreur est annoncé (`role="status"` ou `role="alert"`).

### Tableaux
- `.wk-tab` dans `.wk-tab-enveloppe` : défilement horizontal sur petit écran.
- En-tête sur `--surface`, survol de ligne, chiffres tabulaires.

### Navigation
- En-tête client : `.wk-entete`, bande signature en haut (bleu nuit avec un segment jaune de 28 px, comme le logo ; plus de chevrons), logo cliquable vers l'accueil.
- Menu qualité : `.wke-sidebar`, navigation étiquetée, `.wke-bascule` annonce `aria-expanded`, `.wke-voile` pour fermer, Échap ferme et rend le focus.

## 7. Logo
- **Logo actuel** : SAV premium, en tracés vectoriels (aucune police externe requise). Deux fichiers dans `public/assets/` :
  `sav-premium.svg` (sur fond clair : pages de suivi et de satisfaction, rapports imprimables) et `sav-premium-inverse.svg` (sur fond sombre : pages de connexion).
  `sav-premium-court-inverse.svg` (sur fond sombre, sans sous-titre) pour les petits formats : en-tête client et menu qualité. Proportions 197 × 96 : hauteur 34 px, largeur 70 px.
  Proportions complètes 420 × 96 : toujours fixer la hauteur et calculer la largeur (≈ 4,375 × hauteur).
- **Versions** : clair sur fond clair, inverse sur `--marque-nuit` ou `--bleu`, courte (sans sous-titre) pour les petits formats. Le pictogramme seul (favicon, icône d'application) n'est pas encore intégré au site.
- **Marge de protection** : au moins la hauteur du pictogramme autour de la marque.
- **Taille minimale** : 150 px de large pour la version complète (le sous-titre devient illisible en dessous) ; 60 px pour la version courte ; 16 px pour le pictogramme.
- **Ne pas** : étirer, changer les couleurs hors des versions prévues, poser le logo clair sur un fond clair, ajouter d'ombre.
- **Balisage** : toujours `width` et `height` (pas de décalage au chargement), `alt` sur l'image, lien `aria-label` quand le logo sert de lien.

## 8. Accessibilité
- Contrastes vérifiés par `testcss.php` (clair) : texte sur fond, texte d'accompagnement, couleurs d'état, texte sur marque.
- Focus clavier visible partout : contour `--bleu-clair` (sur fond clair) ou `--hivis` (sur barre latérale).
- Les cases et boutons radio sont masqués visuellement mais restent au clavier (`.wk-visuellement-cache`), jamais `display:none`.
- Titres : une seule balise `h1` par page.

## 9. Ajouter un jeton
1. Le définir dans le bloc `:root` de `style.css`, jamais ailleurs.
2. Le documenter dans ce fichier (`` `--nom` ``).
3. Si c'est une couleur de texte, vérifier 4,5:1 sur son fond (ajouter la paire à `testcss.php`).
4. Lancer `php tests/testcss.php`.
