Conception de Tableau de Bord
Règles
- Disposition barre latérale + contenu principal : barre latérale fixe (w-64), zone principale fluide avec padding
- Navigation latérale : liens icône + libellé, surlignage de l'état actif, repliable sur mobile
- Ligne de cartes KPI en haut : 3 à 4 cartes dans une grille responsive — nom de la métrique, valeur, tendance (hausse/baisse en %), sparkline optionnel
- Tableaux de données : colonnes triables, filtrables par recherche/statut, paginés (10 à 25 lignes par défaut)
- Utiliser
@tanstack/react-table pour la logique de tableau headless — associer avec les composants Table de shadcn/ui
- Responsive : la barre latérale se réduit en menu hamburger au point de rupture
md, les cartes s'empilent sur 1 à 2 colonnes
- États de chargement : squelettes correspondant aux formes des cartes/tableaux — jamais de décalage de mise en page
- Sélecteur de plage de dates pour filtrer les données du tableau de bord — par défaut les 30 derniers jours
Structure de la mise en page
┌──────────┬────────────────────────────┐
│ Sidebar │ Header / Breadcrumbs │
│ ├────────────────────────────┤
│ Nav │ KPI Cards (3-4 grid) │
│ Links ├────────────────────────────┤
│ │ Charts / Graphs │
│ ├────────────────────────────┤
│ │ Data Table │
└──────────┴────────────────────────────┘
Motifs
function KPICard({ title, value, change }: { title: string; value: string; change: number }) {
return (
<Card>
<CardHeader className="pb-2">
<CardTitle className="text-sm font-medium text-muted-foreground">{title}</CardTitle>
</CardHeader>
<CardContent>
<div className="text-2xl font-bold">{value}</div>
<p className={cn("text-xs", change >= 0 ? "text-green-600" : "text-red-600")}>
{change >= 0 ? "+" : ""}{change}% vs période précédente
</p>
</CardContent>
</Card>
);
}
À éviter
- Contenu principal avec largeur fixe — toujours utiliser une mise en page fluide qui remplit l'espace disponible
- Tableaux sans pagination — les grands ensembles de données nuisent aux performances et à l'utilisabilité
- Absence d'états de chargement/vides — toujours afficher des squelettes ou un message "Aucune donnée"
- Barre latérale non repliable — les utilisateurs mobiles ont besoin de toute la largeur de la fenêtre
- Spinners de chargement pour les mises à jour partielles de page — utiliser des squelettes pour des sections spécifiques
- Trop de KPI — mettre en avant 3 à 5 métriques critiques, placer le reste dans des sections extensibles
- Barre latérale personnalisée de zéro — utiliser le composant sidebar de shadcn
- États vides sans actions — toujours inclure un CTA ("Aucune campagne pour l'instant. Créez la première →")