Import de listes de tâches par document - Spécification (V1)

Projet : Plateforme MJY Holding Date : 8 juillet 2026 Décision d'architecture : voir ADR 0008 Statut : Cadrage validé - prêt pour développement

1. Objectif

Permettre à un manager (ex. Julien) de charger un document de to-do list et de générer d'un coup les tâches correspondantes, assignées aux collaborateurs, sans saisie manuelle ligne par ligne.

La V1 couvre l'import ponctuel : un fichier = un lot de tâches créées une fois. Les checklists récurrentes (montage vélo, ouverture quotidienne, inventaire…) sont hors périmètre (V2).

2. Principe : template à colonnes fixes, zéro IA

Plutôt que d'interpréter un texte libre avec un LLM (coûteux et non déterministe), l'utilisateur remplit un template à colonnes fixes. Le parsing est déterministe et gratuit. Un écran d'aperçu laisse l'utilisateur corriger avant création.

Deux formats équivalents sont fournis (mêmes colonnes) :

template_liste_taches.csv - s'ouvre dans Excel / Google Sheets / Word : format recommandé pour Julien (grille visuelle, difficile à casser).
template_liste_taches.md - tableau Markdown : pratique pour un usage « power user » / versionné dans Git.

3. Colonnes du template

Colonne	Obligatoire	Champ `task`	Détail
Tâche	✅	`title`	L'action à réaliser. Une ligne = une tâche.
Notes	–	`description`	Détails, contexte, « pourquoi », co-équipier, infos hors-tâche.
Assigné à	–	`owner`	Personne qui réalise la tâche. Un seul nom.
Responsable	–	`manager`	Personne qui valide la tâche (optionnel).
Priorité	–	`priority`	`bloquant` · `haute` · `normale` (vide = normale).
Pilier	–	`pillar`	Catégorie libre (voir §7). Ex. `Atelier`, `Stock`, `Achats`.
Échéance	–	`due_end`	Date `JJ/MM/AAAA` ou `AAAA-MM-JJ`.

Le projet cible n'est pas une colonne. Il est choisi au moment de l'upload : « j'importe cette liste dans le projet X ». Une liste = un projet.

Colonnes automatiques (jamais dans le document) : created_by = l'auteur de l'import ; status = todo à la création.

4. Règles de parsing (déterministes)

4.1 Priorité

Saisie (insensible casse/accents)	`priority`
`bloquant`, `bloquante`, `urgent`	`blocking`
`haute`, `élevée`, `high`	`high`
`normale`, `normal`, (vide)	`normal`

4.2 Assignation des noms (`owner` et `manager`)

Normaliser le nom saisi : minuscules, trim, suppression des accents, espaces multiples compactés. "My Tam " → my tam · "SOFIA" → sofia.
Comparer à member.name normalisé de la même façon.
Match trouvé → on renseigne l'id du membre.
Aucun match → champ laissé vide ; l'écran d'aperçu le signale (surligné) pour que Julien choisisse un membre.

4.3 Action partagée entre plusieurs personnes

task.owner accepte une seule personne. Une ligne dont l'« Assigné à » contient plusieurs noms doit être éclatée en une ligne par personne (voir l'exemple « miroirs » dans les templates). L'utilisateur duplique la ligne autant de fois que de personnes.

4.4 Échéance

Formats acceptés : AAAA-MM-JJ (recommandé) et JJ/MM/AAAA. Vide = pas d'échéance.

5. Écran d'aperçu (avant création)

L'utilisateur upload le fichier et choisit le projet cible.
Le système parse et affiche un tableau des tâches détectées, assignés déjà résolus en membres ; les noms non reconnus sont surlignés.
L'utilisateur corrige (assignation, priorité…) et peut décocher les lignes à ne pas créer.
Validation → création en base (statut todo).

6. Ce que la V1 ne fait PAS

Pas de déduplication : ré-uploader une liste recrée les tâches. La mise à jour d'une tâche existante se fait manuellement dans l'app.
Pas de tâches multi-assignées : action partagée = une tâche par personne, copies indépendantes non synchronisées (cf. « point de vigilance » de l'ADR 0008).
Pas de checklists récurrentes : reporté en V2.
Pas de colonne Phase : les tâches sont créées sans phase (phase_id nul). Une colonne optionnelle pourra être ajoutée plus tard.

7. Piliers suggérés (contexte ENGWE)

Valeurs de pillar conseillées pour les boutiques/ateliers ENGWE, tirées des procédures internes :

Pilier	Exemples de tâches
Atelier / Montage	montage vélo, essai avant livraison, réparation
Stock / Logistique	réappro Shifter, inventaire, rapport d'écart
Exploitation boutique	checklist d'ouverture, PLV à jour, diffuseurs
Sécurité / Conformité	émargement fiche sécurité, contrôle EPI, monte-charge
Expérience client	standard showroom, essai client, accueil téléphone
Achats / Matériel	EPI, consommables atelier, réassort accessoires, recharges diffuseurs
Entretien du lieu	nettoyage vitrine/sol, entretien vélos d'expo, éclairage/enseigne

Ces valeurs restent libres : le pilier est un simple texte, la liste ci-dessus est indicative.