guidelines.md 5.0 KB

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

--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)

--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 <html>
  • 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 <style> dans les templates
  • JS : feedback immédiat (loading, erreur), désactivation du bouton pendant requête

Dernière mise à jour : 2025-03-03