DIAGRAMMES C4 · DSL VERSIONNÉ

Vos diagrammes d'architecture, écrits comme du code.

Nanko modélise vos systèmes en Shape et Connector versionnés en base : la base de données reste la source de vérité, .nanko n'est qu'un format d'échange à l'export et à l'import. La route vers l'architecture cible devient un plan à jalons, avec une Current version que l'équipe choisit à la main.

EXPORT/IMPORT .NANKO VERSIONS IMMUABLES NAVIGATION MULTI-LAYER
nanko-platform.nanko 14 LIGNES · 5 ÉLÉMENTS
1// aperçu de plateforme
2@id platform-overview
3@version app:1.2.0
4@satisfies infra:^2.0
5rectangle webapp
6rectangle api
7circle store
8connector webapp api
9connector api store
10!LAYOUT
11webapp 80,120
12api 340,120
13store 340,340
14!END
MODÈLE VALIDE · RENDU DÉTERMINISTE
POURQUOI NANKO

Un diagramme qu'on n'a pas peur de rouvrir six mois plus tard.

01

La base de données fait autorité

La base de données est la source de vérité du contenu et des Version d'un Document. Le fichier .nanko n'existe qu'aux points d'export et d'import, jamais en synchronisation continue.

02

Le rendu est déterministe

Le Layout vit dans le même fichier .nanko que le contenu, versionné avec lui. Généré une seule fois à l'import, il est ensuite piloté à la main : jamais régénéré, jamais mélangé au contenu.

03

Les versions racontent la migration

Une cible, des jalons intermédiaires, une Current version choisie à la main. Chaque jalon livré peut la devenir ; la précédente rejoint l'historique du Layer sans disparaître.

LE VOCABULAIRE

Six mots-clés couvrent le cœur du modèle.

Le modèle reste volontairement petit : un Document versionné, un Draft éditable, une Current version choisie à la main. Le contenu ne porte jamais de position, Nanko s'occupe du placement dans le Layout.

document Un schéma versionné, identifié par un @id stable, positionné sur un Layer.
layer L'attribut de profondeur d'un Document dans un Project, pas une entité séparée.
version Un instantané figé et immuable d'un Document, identifié par @version (layer:semver).
draft L'état de travail courant d'un Document, modifiable librement, distinct de ses Version figées.
current version La Version désignée à la main comme faisant autorité pour la navigation inter-Layer.
satisfies La déclaration de compatibilité @satisfies layer:range : avertit, sans jamais choisir automatiquement.
MIGRATIONS

De l'architecture actuelle à la cible, par jalons.

Posez la cible, découpez le chemin en jalons datés. Quand un jalon est livré, promouvez-le en Current version : la précédente rejoint l'historique du Layer sans disparaître.

4JALONS
+3AJOUTS
−1RETRAIT
HISTORIQUE PLANIFIÉ
1.4.0Monolithe · mars
2.0.0Extraction API · juin
2.3.0 · CURRENTFile de rendus · août
3.0.0 · JALONCache lecture · oct.
3.1.0 · JALONÉvénements · déc.
4.0.0 · CIBLEPlateforme complète
L'ÉCART

Ce qui sépare deux versions, élément par élément.

Comparez n'importe quelle paire de versions, en liste ou sur le schéma. Chaque changement se rattache à la ligne du .nanko qui l'a produit.

2.3.0 → 3.0.0 4 CHANGEMENTS
+ rectangle read_cache L24
+ connector api read_cache L31
~ @satisfies infra:^2.0 → infra:^3.0 L10
connector webapp store L28
SOUS LE CAPOT

Des choix volontairement simples, pas encore sur-conçus.

Nanko n'ajoute une brique que quand un besoin réel la justifie. Le format d'échange, la recherche, les droits et le canvas suivent la même logique.

EXPORT / IMPORT

Le fichier ne vit qu'aux deux bouts

.nanko n'est jamais stocké par Nanko : la base de données est la source de vérité, le fichier n'existe qu'à l'export et à l'import.

RECHERCHE

Le plein texte remplace le rangement

Pas de dossiers ni de hiérarchie dans un Project : une recherche plein texte intégrée retrouve vos Document, sans moteur ni cache dédiés.

DROITS

Une Capability par Project, jamais implicite

Être membre d'une Org ne donne accès à aucun Project par défaut. Une Org peut définir une Capability par défaut pour couvrir le cas d'une petite équipe.

CANVAS

2D d'abord, l'isométrique en support

L'édition reste un canvas 2D top-down en v1. Un helper de navigation en pile de layers, isométrique et statique, aide à s'y repérer sans passer par la 3D.

Écrivez votre première architecture en dix lignes.

Nanko est en cours de construction. Dites-nous quelle architecture vous essayez de faire bouger : nous ouvrons les accès par vagues à mesure que le produit avance.