Skip to content

Latest commit

 

History

History
144 lines (105 loc) · 4.5 KB

ARCHITECTURE.md

File metadata and controls

144 lines (105 loc) · 4.5 KB

Architecture — format 1 / application v0.3.12

1. Objectif

MindSpark ne remplace pas le système de fichiers. Il lui ajoute une couche de sens et de représentation.

Le répertoire technique .glom/ et les identifiants de format glom-* sont conservés pour compatibilité avec les données existantes ; la marque de l’application est désormais MindSpark.

Trois couches sont séparées :

  1. Objets — fichiers et dossiers réels ;
  2. Sens — tags, notes, liens, ressources virtuelles ;
  3. Représentation — position, zoom, relations et état visuel d'une vue.
              PWA
               │
      ┌────────┴────────┐
      │                 │
Système de fichiers   .glom/
      │                 │
  « objets »         « sens »
                        │
                  views/*.json
                        │
                 « représentation »

2. workspace.json

.glom/workspace.json contient l'identité du workspace, sa version de format et la vue par défaut.

Exemple conceptuel :

{
  "format": "glom-workspace",
  "version": 1,
  "id": "uuid",
  "name": "Chef-d'œuvre — Les jeux vidéo",
  "defaultView": "views/main-mindmap.json",
  "settings": {
    "autoCollapseLargeBranches": true,
    "autoCollapseThreshold": 20,
    "defaultLayoutMode": "right"
  }
}

Le champ version appartient au format de données, pas à la version de l'application.

Le bloc settings contient les préférences qui doivent voyager avec le workspace. Depuis v0.3.17, il porte le repli automatique des branches volumineuses ; v0.3.18 ajoute la disposition par défaut des nouvelles cartes. Une absence de ce bloc reste compatible : MindSpark applique alors les valeurs par défaut.

3. resources.json

Une ressource décrit une chose pouvant apparaître dans une ou plusieurs vues.

Types V0.1 :

  • root ;
  • folder ;
  • file ;
  • virtual ;
  • url.

Exemple :

{
  "id": "r-abc123",
  "type": "file",
  "path": "Histoire/Tennis-for-Two.pdf",
  "title": "Tennis for Two",
  "tags": ["histoire", "1958", "oscilloscope"],
  "notes": "Source importante pour la ligne du temps."
}

Une ressource virtual n'a aucun fichier physique.

4. views/*.json

La vue ne duplique pas la ressource. Elle ne stocke que sa représentation :

{
  "format": "glom-view",
  "version": 1,
  "type": "mindmap",
  "layoutMode": "down",
  "pan": {"x": 40, "y": 40},
  "zoom": 0.9,
  "nodes": [
    {"id":"n-1","resourceId":"r-abc123","x":820,"y":260,"collapsed":false,"layoutMode":"left"}
  ],
  "edges": [
    {"id":"m-1","from":"n-parent","to":"n-1","kind":"manual"}
  ]
}

Depuis v0.3.11, un workspace peut contenir plusieurs mindmaps dans views/*.json. workspace.json/defaultView désigne la carte active par défaut. Une même resourceId peut donc être représentée et stylée différemment dans plusieurs vues sans dupliquer le fichier physique.

Depuis v0.3.18, layoutMode peut être défini au niveau de la vue et, facultativement, au niveau d’un nœud. La valeur du nœud est une surcharge locale pour sa branche ; elle n’affecte ni resources.json ni l’arborescence physique.

Dans une vue donnée, v0.3.11 conserve encore une occurrence principale par ressource ; les occurrences multiples dans une même carte sont une évolution distincte.

5. Données locales au navigateur

Les handles du système de fichiers et permissions ne sont pas portables. Ils doivent rester dans IndexedDB ou dans le stockage local du navigateur, jamais dans .glom/.

Un second appareil relit .glom/ puis recrée sa propre autorisation d'accès au dossier.

6. Sécurité

Le dossier racine est choisi explicitement par l'utilisateur. La V0.1 :

  • n'efface aucun fichier physique ;
  • ne renomme aucun fichier physique ;
  • ne déplace aucun fichier physique ;
  • n'écrit que dans .glom/ lorsque le navigateur accorde l'accès en écriture.

7. Réversibilité

Test architectural :

Si .glom/ est supprimé, les fichiers utilisateur restent lisibles, organisés et indépendants de MindSpark.

La perte concerne uniquement la couche ajoutée : positions, liens visuels, tags et annotations.

8. Extension vers d'autres vues

Le modèle est orienté ressources, pas « logiciel de mindmap ».

resources.json
     │
     ├── views/mindmap.json
     ├── views/kanban.json
     ├── views/timeline.json
     └── views/graph.json

C'est ce qui permettra de montrer les mêmes ressources de plusieurs manières sans les dupliquer.