Skip to content

structures

diapason.succes.structures

Les cinq formes qu'un projet Succès peut prendre, et leurs règles.

Un projet n'est pas toujours une liste. Selon la forme choisie, les mêmes tâches se pensent autrement :

  • flat — la liste simple, l'existant.
  • tree — l'arbre généalogique : l'objectif engendre ses livrables, chaque étage porte un nom (levelLabels).
  • mindmap — la carte neuronale : mêmes données que l'arbre, rendu radial ; c'est la forme de la phase d'idéation.
  • pipeline — le couloir d'étapes : chaque tâche traverse les stages du projet, la vue est un kanban.
  • network — le réseau de dépendances : des tâches reliées par des arêtes « débloque → », sans hiérarchie ; le graphe doit rester sans boucle, sinon « que puis-je faire maintenant ? » n'a plus de réponse.
  • cycle — la roue des routines : un « nouveau tour » décoche TOUTES les tâches du projet, cadencées ou non. La cadence est un rappel affiché, pas un filtre : une tâche exceptionnelle terminée dans un projet cycle repart elle aussi au tour suivant, et c'est voulu — un tour est un tour.

Ce module ne touche pas à la base : il définit et VALIDE. Les écritures vivent dans store.py / workspace.py, la surface HTTP dans routes.py.

decode_structure_config(raw)

Relit la configuration stockée sans jamais faire échouer une lecture.

normalize_cadence(raw)

La cadence d'une tâche de cycle, encodée pour la colonne.

"" = pas de cadence. Sinon {"every": "day"|"week"|"month", "day": int?} — day vaut 0..6 (lundi=0) pour la semaine, 1..28 pour le mois, et n'a pas de sens pour le jour.

normalize_structure(value, *, kit_id='')

La forme demandée, ou une erreur qui dit lesquelles existent.

normalize_structure_config(structure, raw)

La configuration propre à une forme, validée et rien de plus.

On ne garde QUE les clés que la forme connaît : une configuration qui survivrait à un changement de forme transporterait des réglages morts, et le client mobile les re-synchroniserait à jamais.

stages_of(structure, config)

Les étapes d'un projet pipeline ; vide pour toute autre forme.