osFoundry / Platform
Notes — Diagrammes
Les diagrammes Mermaid vivent à côté de leur source. Éditez d'un côté, rendu de l'autre.
Présentation
Notes (Diagrammes) est la surface d'écriture Mermaid intégrée aux Notes d'osFoundry. Un diagramme Mermaid se définit en texte brut (organigrammes, diagrammes de séquence, diagrammes de classes, machines à états, diagrammes ER, diagrammes de Gantt), et cette fonction conserve ce texte et son image rendue dans la même note. Vous modifiez le code d'un côté et le diagramme s'affiche de l'autre, si bien que la définition et le résultat ne se désynchronisent jamais.
Parce que le diagramme est stocké sous forme de son code source, et non comme une image exportée, il reste une partie du texte de la note. Vous pouvez le comparer (diff), le copier, le confier à un agent ou le coller dans une autre note sans perdre la possibilité de le modifier. Rien n'est aplati en une capture d'écran qu'il faudrait redessiner pour la changer. Modifiez une flèche dans le code et le rendu le reflète aussitôt : c'est ce qui rend l'itération sur un diagramme rapide plutôt que fastidieuse.
Tout cela se trouve dans osFoundry, un espace de travail de bureau avec votre propre clé où le chat, les agents, les apps, le code et les connaissances partagent un même endroit. Notes fonctionne en local-first, donc un diagramme que vous esquissez (une architecture, un processus, un modèle de données) reste sur votre appareil sauf choix contraire. Et comme osFoundry exécute n'importe quel modèle pour lequel vous apportez votre propre clé, un agent de l'espace de travail peut rédiger ou réviser le code Mermaid directement dans la note, et vous le voyez s'afficher à l'instant même où il arrive.
Fonctionnalités clés
- Rédigez des diagrammes Mermaid dans une note et voyez-les s'afficher côte à côte : le code d'un côté, l'image de l'autre
- Les modifications du code redessinent l'image à mesure que vous tapez, donc itérer sur un flux ou une séquence est immédiat
- Les diagrammes sont stockés sous forme de leur texte source, et non d'images figées, ce qui les garde modifiables, comparables et copiables
- Prend en charge les types couverts par Mermaid : organigrammes, séquence, classes, états, ER et Gantt
- Notes en local-first garde le code source de vos diagrammes sur votre appareil ; les agents que vous exécutez avec votre propre clé peuvent rédiger ou réviser le Mermaid directement
Cas d’usage
- Ingénieur : documente le flux de requêtes d'un service sous forme de diagramme de séquence Mermaid dans une note et ajuste le code au fil des changements de conception
- Rédacteur technique : garde un organigramme d'architecture en ligne avec le document qui l'explique, en modifiant le code plutôt qu'en réexportant une image
- Chef d'équipe : esquisse un calendrier de projet sous forme de diagramme de Gantt et demande à un agent de l'espace de travail de mettre à jour le code Mermaid quand les dates changent
Questions fréquentes
Quels types de diagrammes Mermaid puis-je afficher ?
L'ensemble standard de Mermaid : organigrammes, diagrammes de séquence, diagrammes de classes, diagrammes d'états, diagrammes entité-association et diagrammes de Gantt. Vous les écrivez dans la syntaxe texte de Mermaid et la note les affiche en direct.
Le diagramme est-il enregistré comme image ou comme texte modifiable ?
Comme texte. Le code source Mermaid réside dans la note et le rendu en est généré. Autrement dit, vous pouvez toujours revenir modifier la définition au lieu de redessiner une image statique, et le code voyage avec la note quand vous la copiez.
Un agent IA peut-il écrire le diagramme à ma place ?
Oui. osFoundry est un espace de travail avec votre propre clé, donc un agent tournant sur un modèle que vous avez connecté peut produire ou réviser le code Mermaid dans la note. Comme le diagramme est du texte source, ce que l'agent écrit s'affiche exactement comme vos propres modifications.