# Guidelines — UX, UI et bonnes pratiques Synthèse des règles de conception et d'expérience utilisateur pour le projet Agent Docker (chatbot RAG Intersel). --- ## 1. Design system ### Palette (CSS custom properties) — Indigo chaleureux ```css --primary: #4f46e5 /* indigo 600 — boutons, liens, focus */ --primary-hover: #4338ca /* indigo 700 — hover */ --primary-light: #eef2ff /* indigo 50 — arrière-plan item actif */ --header-bg: #0f172a /* slate 900 — header sombre */ --bg: #f8fafc /* slate 50 — fond général */ --sidebar-bg: #f1f5f9 /* slate 100 — sidebar */ --surface: #ffffff /* blanc — zones élevées (input, cards) */ --border: #e2e8f0 /* slate 200 — séparateurs */ --text: #1e293b /* slate 800 — texte principal */ --text-muted: #64748b /* slate 500 — texte secondaire */ --bubble-user-bg: #e0e7ff /* indigo 100 — bulle utilisateur */ --bubble-user-text: #3730a3 /* indigo 800 */ --bubble-bot-bg: #ffffff /* blanc — bulle bot */ --bubble-bot-text: #334155 /* slate 700 */ ``` Focus ring : `box-shadow: 0 0 0 3px rgba(79, 70, 229, 0.15);` ### Dark mode (classe `body.dark`) ```css --header-bg: #020617 /* slate 950 */ --bg: #0f172a /* slate 900 */ --sidebar-bg: #1e293b /* slate 800 */ --surface: #1e293b --border: #334155 /* slate 700 */ --text: #f1f5f9 /* slate 100 */ --bubble-user-bg: #3730a3 /* indigo 800 */ --bubble-bot-bg: #334155 /* slate 700 */ ``` ### Typographie - **Police principale** : Inter (Google Fonts), poids 400, 500, 600 - **Taille de base** : 0.9375rem (~15px) pour les messages, 0.875rem pour les labels - **Line-height** : 1.5 à 1.6 pour la lisibilité ### Composants réutilisables - **Boutons** : `border-radius: 9px` (forms) / `12px` (chat), padding 0.65rem 1rem - **Inputs** : `border-radius: 9px`, focus `box-shadow: 0 0 0 3px rgba(79,70,229,0.15)` - **Cards** : `border-radius: 12px`, `border: 1px solid #e2e8f0`, `box-shadow: 0 1px 4px rgba(0,0,0,0.05)` - **Badges** : `badge-ok` (vert f0fdf4/166534), `badge-warn` (jaune fefce8/854d0e), `badge-error` (rouge fef2f2/b91c1c) --- ## 2. UX — Expérience utilisateur ### Chat - **Message max** : 2000 caractères (`CHAT_MAX_CHARS`) — afficher un compteur si pertinent - **Messages** : bulles alignées à droite (user) / gauche (bot), max-width 72% - **Avatars** : icônes FA (`fa-user` / `fa-robot`) dans un cercle coloré, 30×30px - **Typing indicator** : animation de 3 points pendant la génération de la réponse - **Message de bienvenue** : icône centrée, titre et description, ton professionnel - **Sources** : afficher les URLs/chunk_id des sources utilisées pour la réponse ### Formulaires (login / register) - **Présentation** : card centrée, max-width 400–440px, `border-radius: 16px` - **Logo** : carré indigo 44×44px (`#4f46e5`) avec icône FA, en haut de la card - **Labels** : toujours associés aux champs, taille 0.8rem, couleur `#475569` - **Validation** : messages d'erreur/succès stylés (fond coloré + bordure), pas d'`alert()` - **Feedback** : désactiver les boutons pendant les requêtes - **Redirection post-login/register** : délai ~1.5-2s pour laisser lire le message ### Accessibilité - `lang="fr"` sur `` - `viewport` pour le responsive - États `:focus` visibles sur tous les éléments interactifs - Contraste suffisant sur tous les textes --- ## 3. UI — Interface ### Cohérence entre les pages - Utiliser **Inter** et la palette ci-dessus partout - Icônes : **Font Awesome 6.5** (`fas fa-*`) - Header sombre (`#0f172a`) cohérent sur toutes les pages - Éviter les couleurs Bootstrap par défaut (`#007bff`) au profit de `--primary` ### Responsive - Layout flex/column adapté mobile - `overflow-y: auto` sur la zone de messages - Cards formulaire en largeur maximale avec `max-width` ### Dark mode (chat uniquement) - Classe `body.dark` gérée par JS + `localStorage` - Bouton toggle dans le header (icône lune/soleil) --- ## 4. Contraintes techniques (UX) | Limite | Valeur | Impact UX | |--------|--------|-----------| | Message chat max | 2000 caractères | Afficher limite ou compteur | | Taille payload | 16 Mo | Limite uploads fichiers | | URLs max (scraping) | 100 | Contexte limité pour les réponses | | Anti-spam | Message vide, répétition ≥50 car., URLs ≥5 | Messages d'erreur explicites | --- ## 5. Ton et contenu - **Langue** : français - **Ton** : professionnel, utile, factuel - **Erreurs** : messages clairs et actionnables (ex. « Message trop long. Max 2000 caractères. ») - **Réponses** : le bot doit citer les sources quand possible - **Pas d'`alert()`** : utiliser des blocs feedback stylés --- ## 6. Bonnes pratiques développement - **Templates** : Jinja2, structure cohérente (head, body, scripts) - **Styles** : CSS variables en `:root`, inline `