67 lines
3.1 KiB
Markdown
67 lines
3.1 KiB
Markdown
# Design : statistiques mensuelles dans la page Rapports
|
|
|
|
Date : 2026-03-13
|
|
|
|
## Objectif
|
|
|
|
Ajouter une section "Détail mensuel" sous les cartes annuelles existantes dans `/reports`. 12 cartes (une par mois) donnant en un coup d'œil : distance parcourue par mode de transport + durée de travail typique.
|
|
|
|
## Décisions clés
|
|
|
|
- **Types de jours inclus** : tous les jours enregistrés (y compris absences = 0 min).
|
|
- **Statistique temporelle** : médiane (plus robuste que la moyenne face aux GARDE à 10h et aux absences).
|
|
- **"Par semaine"** : médiane de la durée totale hebdomadaire (somme des minutes par semaine ISO, puis médiane).
|
|
- **Layout** : 12 cartes empilées sous un titre "Détail mensuel".
|
|
- **Couleurs transport** : évocatrices (vert vélo, indigo électrique, ambre diesel).
|
|
|
|
## Architecture
|
|
|
|
### Données calculées par mois
|
|
|
|
```python
|
|
monthly_data[month_int] = {
|
|
"km_by_vehicle": {vehicle_id: km},
|
|
"km_total": int,
|
|
"median_daily_min": int, # médiane de entry.total_minutes() sur toutes les entries du mois
|
|
"median_weekly_min": int, # médiane des sommes hebdomadaires (semaines ISO)
|
|
"entry_count": int,
|
|
}
|
|
```
|
|
|
|
### Répartition du code
|
|
|
|
- **`app/business/time_calc.py`** : nouvelle fonction `monthly_stats(entries)` → calcule les médianes journalière et hebdomadaire. Pas de dépendance Flask.
|
|
- **`app/routes/reports.py`** : groupement des entries par mois + calcul des km par véhicule (déjà dans ce fichier), appel de `monthly_stats`, transmission du tout au template.
|
|
- **`app/templates/reports.html`** : section "Détail mensuel" avec les 12 cartes.
|
|
|
|
## Visuel des cartes
|
|
|
|
```
|
|
┌─────────────────────────────────────────────┐
|
|
│ JANVIER 21 jours │
|
|
│ │
|
|
│ 312 km │
|
|
│ [████████████░░░░░░░░░░░░░░░░░░░░░░░░░░░░] │
|
|
│ ■ Vélo (132 km) ■ Électrique (108 km) │
|
|
│ ■ Diesel (72 km) │
|
|
│ │
|
|
│ Médiane/jour 7h52 Médiane/sem. 38h45 │
|
|
└─────────────────────────────────────────────┘
|
|
```
|
|
|
|
- **Barre transport** : `div` flex, sections `width: X%` en `style=` inline (contrainte Tailwind CDN).
|
|
- **Couleurs** :
|
|
- Vélo → `#4ade80` (vert vif)
|
|
- Électrique (fuel = "electric") → `#818cf8` (indigo)
|
|
- Diesel → `#d4a574` (ambre chaud)
|
|
- **Légende** : carré coloré + nom du véhicule + km, sous la barre.
|
|
- **Mois vide** (0 entrées) : carte discrète, texte "Aucune entrée", sans barre.
|
|
|
|
## Tests
|
|
|
|
- Nouvelle fonction `monthly_stats()` dans `tests/test_time_calc.py` :
|
|
- cas nominal (entries avec time_slots)
|
|
- absences (total_minutes = 0) incluses dans la médiane
|
|
- mois avec une seule semaine
|
|
- Route `reports` : vérifier que `monthly_data` est bien transmis au template (test existant à étendre si besoin).
|