Glossaire

C — Explications et glossaire

Ce document sert d’onboarding, de clarification terminologique et de référence rapide.

IDE de projet personnel

Ici, “IDE” ne veut pas dire IDE de code classique.

Il désigne un environnement intégré de gestion et de structuration de projet.

Il sert à :

• cadrer
• suivre
• documenter
• exporter
• reprendre un projet plus tard

ProjectDocument

Le ProjectDocument est le document racine d’un projet.

C’est la vraie unité de travail. L’interface React ne fait que l’éditer.

Structure typique :

{
  "schemaVersion": "1.0",
  "project": {},
  "stages": {},
  "workstreams": [],
  "backlog": [],
  "journal": [],
  "decisions": [],
  "attachments": [],
  "repository": null,
  "settings": {},
  "sync": {}
}

Repository lié

Le bloc facultatif repository relie un projet à son dépôt canonique sans modifier le fonctionnement local-first de l’application.

Il peut mémoriser le fournisseur, le nom complet du dépôt, son URL, sa branche par défaut, sa visibilité, sa convention de gouvernance et de futures métadonnées d’intégration. Quand aucun dépôt n’est lié — notamment pour les anciens fichiers JSON — sa valeur normalisée est null.

MVP

Dans ce projet, le MVP désigne la plus petite version capable de démontrer que l’outil a une valeur réelle.

Ce n’est pas :

• une maquette cosmétique
• une version parfaite
• une version déjà cloud / collaborative / enterprise

C’est :

• une version exploitable
• une version qui prouve la logique du produit
• une version volontairement limitée

Stages

Les stages sont les étapes v.0.0 → v.1.0.

Elles servent à suivre l’avancement avec une logique de cycle.

Exemples :

• v.0.0 = problème initial
• v.0.2 = formalisation du MVP
• v.0.4 = assemblage
• v.1.0 = première livraison fonctionnelle du projet suivi

Une étape répond à la question : où en est le projet dans son cycle ? Elle ne décrit pas à elle seule tous les domaines qui avancent en parallèle.

Chantiers / workstreams

Un chantier est un front de travail parallèle qui traverse plusieurs étapes. Le terme professionnel anglais est workstream.

Exemples :

• logiciel : produit, UI/UX, frontend, backend, données, qualité ;
• recherche : état de l'art, méthode, collecte, analyse, éthique ;
• association : juridique, finances, opérations, communication ;
• projet personnel : planification, achats, production, documentation.

Un chantier répond à la question : sur quel domaine travaille-t-on ? Il est facultatif et personnalisable. #94 a livré le modèle compatible, les suggestions multi-domaines et les références backlog/étape ; #95 ajoute l'onglet de gestion, le filtrage du backlog et la matrice visuelle. Un ancien projet sans workstreams continue à fonctionner normalement.

Jalon

Un jalon est un point de convergence vérifiable. Plusieurs chantiers doivent par exemple fournir leurs livrables avant de déclarer un prototype validé ou un lancement public. Un jalon n'est ni une tâche ni un chantier supplémentaire.

Progression déclarée

La progression déclarée est une estimation métier facultative comprise entre 0 et 100 %. Elle est renseignée consciemment et reste prioritaire. Aucune estimation calculée ne l'écrit ou ne la remplace silencieusement.

Progression effective

La progression effective est le pourcentage affiché sur le tableau de bord. Sa source est visible : valeur manuelle, objectifs vérifiables d'une roadmap GitHub, ou estimation depuis l'étape actuelle. Elle n'est pas sauvegardée comme une seconde vérité dans le document projet.

Roadmap mesurable

Une roadmap mesurable décrit ses objectifs avec des cases Markdown cochées ou non cochées. Seuls les objectifs feuilles comptent, avec une pondération facultative. Le fichier canonique de ce dépôt est ROADMAP.md.

Backlog

Le backlog contient ce qui doit être capturé sans interrompre le flux principal :

• idées futures
• améliorations
• tâches non prioritaires
• chantiers reportés

Formule utile : capturer sans dériver.

Journal

Le journal est la mémoire chronologique du projet.

Il répond à la question : qu’est-ce qui s’est passé, quand, et pourquoi ?

Il sert à noter :

• décisions
• comptes-rendus de session
• pistes de réflexion
• extraits utiles
• impacts constatés

Décisions

Le bloc décisions formalise les arbitrages importants :

• contexte
• décision retenue
• conséquences

Quand la décision mérite une trace durable, elle peut devenir une ADR.

Attachments v1

Les attachments sont des pièces jointes légères ou des références structurées liées à un projet.

Types actuellement prévus :

• url
• note
• snippet
• file_ref

Ce ne sont pas encore de vrais binaires gérés comme dans une application desktop complète.

Settings

Les settings sont les préférences d’interface et de comportement.

Exemples :

• langue
• thème système, sombre ou clair
• taille du texte et contraste
• préférence de réduction des animations
• preview Markdown
• densité UI
• format d’export
• autosave

Un réglage peut être présent dans le modèle sans être encore pleinement exploité dans l’UI.

Preview Markdown

Le preview Markdown est le panneau d’aperçu latéral.

Historique important :

• preview minimal
• puis preview de l’étape active
• puis preview du projet complet via le même export que le téléchargement

Conséquence : un switch étape / export complet devient un vrai besoin fonctionnel.

PWA

PWA signifie Progressive Web App.

Dans ce projet, cela veut dire :

• installable
• utilisable comme app locale
• service worker
• prompt d’update

localStorage et IndexedDB

• localStorage : simple, rapide, mais limité
• IndexedDB : plus robuste pour une app qui évolue

Le projet utilise désormais IndexedDB comme stockage principal avec fallback legacy.

Repository de stockage

La couche repository sert à découpler le store du détail technique localStorage vs IndexedDB.

Cela facilite :

• migration
• test
• évolution future

UserProfile local

Le profil utilisateur local est une identité minimale créée côté client.

Il sert à :

• identifier le propriétaire logique local
• préparer ownerId
• fournir une identité locale stable pour les sauvegardes et migrations

Il ne représente pas un compte cloud et ne prépare plus une architecture multi-utilisateur dans la roadmap actuelle.

ownerId

ownerId est l’identifiant persistant du propriétaire logique d’un projet.

Il remplace une logique plus floue de simple nom affiché.

Métadonnées de synchronisation

Le bloc sync contient des informations minimales comme :

• localVersion
• remoteVersion
• lastSyncedAt
• dirty

Il prépare une synchronisation future sans signifier qu’elle est déjà pleinement active.

Instantané portable

Un instantané portable est une sauvegarde versionnée de l'ensemble du portefeuille, écrite hors du stockage privé du navigateur. Chaque appareil écrit son propre fichier afin d'éviter que plusieurs appareils modifient simultanément le même document.

Un instantané n'est pas automatiquement appliqué : l'IDE doit identifier sa source, sa date et sa relation avec l'état local avant de proposer une restauration.

Transport de sauvegarde

Un transport de sauvegarde déplace un bundle ou un instantané entre emplacements ou appareils. Il ne devient ni le stockage de travail de l'IDE ni la source de vérité du projet. Le parcours manuel fonctionne sans transport configuré.

Exemples futurs ou facultatifs : synchroniseur de dossier, fournisseur de fichier cloud, WebDAV ou transfert direct entre appareils.

Syncthing

Syncthing est un outil externe qui synchronise des dossiers entre appareils. Dans cette architecture, il ne lit pas IndexedDB et ne remplace pas le stockage de l'IDE. Il transporte seulement les instantanés écrits dans un dossier choisi par l'utilisateur.

La logique applicative doit rester compatible avec un autre transport. Syncthing est une option utile pour les personnes qui l'utilisent déjà, mais il n'est ni la recommandation par défaut ni une dépendance de l'IDE.

Format .ipm

.ipm désigne éventuellement un futur conteneur portable d'IDE Project Manager. Il ne constitue ni un format propriétaire obligatoire, ni une nécessité pour les sauvegardes actuelles : le JSON ouvert reste le format par défaut.

Si de vraies pièces jointes binaires justifient un regroupement, .ipm pourra être une archive ZIP standard documentée, contenant un manifeste, les projets JSON et les fichiers référencés. Cette extension facultative ne doit pas bloquer la release 1.0.0 ni la continuité basée sur les bundles JSON.

Readiness ops

Readiness ops = niveau de préparation du produit pour être exploité dans des conditions plus sérieuses :

• sauvegarde / restauration
• états d’erreur visibles
• robustesse de persistance
• préparation maintenance
• comportements sûrs en cas de panne

ADR

ADR signifie Architecture Decision Record.

Structure courte typique :

• contexte
• décision
• alternatives
• conséquences

Exemples adaptés au projet :

• React + PWA plutôt que backend immédiat
• IndexedDB plutôt que localStorage seul
• preview projet complet plutôt que preview d’étape uniquement

QuadraFrame

QuadraFrame est la logique méthodologique A / B / C / D.

Dans ce projet :

• A = historique, vision, arbitrages, roadmap
• B = architecture, implémentation, workflow technique
• C = explications, onboarding, glossaire
• D = export vivant du projet

Chemin de travail par défaut

Le chemin de travail par défaut est le dossier préféré où l’utilisateur souhaite ranger imports, exports, attachments et backups.

Dans une simple web app, ce chemin n’est pas manipulable comme dans une application desktop native sans API spécifique supplémentaire du navigateur.

---

Source canonique : docs/project/c-glossary.md.