diff --git a/docs/frontend/ASSESSMENT_CARDS.md b/docs/frontend/ASSESSMENT_CARDS.md new file mode 100644 index 0000000..e7d67c0 --- /dev/null +++ b/docs/frontend/ASSESSMENT_CARDS.md @@ -0,0 +1,221 @@ +# 🃏 Assessment Cards - Design System + +## 📋 Vue d'Ensemble + +Les **Assessment Cards** sont des composants d'interface centraux de Notytex qui affichent les évaluations sous forme de cartes dans la liste principale. Elles ont été entièrement refactorisées en 2025 pour mettre en avant les **3 informations critiques** : classe, nom de l'évaluation et statut de correction. + +## 🎯 Objectifs du Design + +### **Hiérarchie Visuelle Optimisée** + +1. **PRIMAIRE** : Nom de la classe + Statut de correction (header) +2. **PRIMAIRE** : Titre de l'évaluation (corps principal) +3. **SECONDAIRE** : Meta-informations (trimestre, date, exercices, coefficient) +4. **ACTIONS** : Boutons contextuels selon l'état de correction + +### **Système de Couleurs Intelligent** + +Le header utilise un **code couleur basé sur l'état de correction** : + +- 🔴 **Rouge** : 0% correction (non commencée) +- 🟠 **Orange** : 1-99% correction (en cours) +- 🟢 **Vert** : 100% correction (terminée) + +## 🏗️ Structure de la Card + +``` +┌─────────────────────────────────────────┐ +│ Header: Classe + Progression │ ← Couleur selon statut +├─────────────────────────────────────────┤ +│ Titre de l'évaluation (très visible) │ +│ Description (optionnelle) │ +│ Meta: T1 • Date • Exercices • Coeff │ +│ Actions: Détails + Noter/Résultats │ +└─────────────────────────────────────────┘ +``` + +## 🎨 Spécifications Techniques + +### **Header Coloré Dynamique** + +```jinja2 +{% set progress_colors = { + 0: {'bg': 'from-red-500 to-red-600', 'text': 'text-red-100', 'badge': 'bg-red-400/30'}, + 'in_progress': {'bg': 'from-orange-500 to-orange-600', 'text': 'text-orange-100', 'badge': 'bg-orange-400/30'}, + 100: {'bg': 'from-green-500 to-green-600', 'text': 'text-green-100', 'badge': 'bg-green-400/30'} +} %} +``` + +**Logique de couleur :** + +- `progress.percentage == 0` → Rouge +- `progress.percentage == 100` → Vert +- Sinon → Orange + +### **Hiérarchie Typographique** + +| Élément | Classes TailwindCSS | Rôle | +| --------------- | ------------------------------------------- | ------------------------ | +| **Classe** | `text-base md:text-lg font-semibold` | Identification rapide | +| **Titre** | `text-xl md:text-2xl font-black` | Information principale | +| **Description** | `text-sm text-gray-600 italic line-clamp-2` | Contexte optionnel | +| **Meta** | `text-xs font-medium text-gray-600` | Informations secondaires | +| **Actions** | `text-xs font-medium` | Boutons d'action | + +### **Indicateur de Progression** + +```jinja2 +
{{ assessment.description }}
+{{ assessment.description }}
{% endif %} - -