appflows 1.0.0__tar.gz

appflows-1.0.0/.gitignore

@@ -0,0 +1,21 @@
+.venv/
+__pycache__/
+*.pyc
+
+# build / packaging
+dist/
+build/
+*.egg-info/
+
+# outils
+.pytest_cache/
+.ruff_cache/
+.coverage
+.claude/
+htmlcov/
+
+# artefacts d'exécution
+errors.log
+
+# analyses locales
+docs/analyses/

appflows-1.0.0/CHANGELOG.md

@@ -0,0 +1,560 @@
+# Journal des modifications
+
+Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/) et le
+versionnage [SemVer](https://semver.org/lang/fr/).
+
+## [1.0.0] — 2026-10-10
+
+### Modifié
+
+- Le projet s'appelle désormais **appflows** (anciennement `schema-archi`) :
+  distribution PyPI `appflows`, paquet `import appflows`, commandes
+  `appflows` et `appflows-ui`, images conteneur `appflows` et
+  `appflows-bulk`, dépôt `framagit.org/opikanoba/appflows`. Aucun alias
+  `schema_archi` n'est fourni ; `schema-archi` reste figé en 0.12.1 sur PyPI.
+- Variables d'environnement de l'éditeur web préfixées `APPFLOWS_`.
+
+### Déprécié
+
+- Les variables `SCHEMA_ARCHI_*` sont encore lues, avec un avertissement au
+  journal, quand leur équivalent `APPFLOWS_*` est absent.
+
+## [0.12.1] — 2026-09-26
+
+### Ajouté
+
+- Chaînes de flux à **sens mêlés** : `m <-(sftp:22)- eie -(mllp:2575)-> pacs`
+  décrit un seul flux de `m` vers `pacs`, où le bus va chercher puis pousse.
+  La donnée se lit de gauche à droite ; la flèche dit qui initie la connexion,
+  et son connecteur passe sur le nœud visé. Placement inchangé.
+- `Link(reverse=True)`, équivalent objet d'un lien écrit `<-` dans une telle
+  chaîne.
+
+### Modifié
+
+- Un bus dont seule la sortie porte un connecteur reçoit une entrée neutre,
+  comme il recevait déjà une sortie neutre face à une entrée déclarée.
+- La ligne `a --> e1 <-- m` n'est plus refusée pour « sens contradictoires » :
+  elle se lit comme un flux de `a` vers `m`.
+
+## [0.12.0] — 2026-09-22
+
+### Ajouté
+
+- Une seconde topologie, `type: doctype`, qui suit un **type de document**
+  plutôt qu'une application : ceux qui le produisent à gauche, ceux qui le
+  consomment à droite, les bus entre les deux, et pas d'application centrale.
+- `examples/yaml/resultats.yaml` et `examples/16_doctype.py` illustrent la
+  nouvelle topologie ; modification du README et `docs/api.md`.
+- 20 définitions dans `tests/data/` couvrant les combinaisons de topologie,
+  disposition et grammaire de flux (bus en cascade, libellés multiples,
+  tags, connecteurs, etc.), destinées aux futurs tests de non-régression.
+- `docs/analyses/` : rapport d'analyse de code avant publication — aucun
+  défaut bloquant.
+
+### Modifié
+
+- `docs/formats.md` est réorganisé
+- Revue du README 
+
+## [0.11.0] — 2026-09-20
+
+### Ajouté
+
+- `scripts/build_container.sh` construit les images conteneur (éditeur web,
+  lot, ou les deux), taguées de la version du projet, et **vérifie** chacune
+  sans privilège — `--read-only`, `--cap-drop ALL`, `no-new-privileges`
+- `scripts/run_container.sh` lance l'éditeur en conteneur confiné, sans
+  limite de taille par défaut (`--max-flows`, `--max-apps` pour en poser),
+  au premier plan ou en arrière-plan (`--detach`, `--stop`), avec `--dry-run`.
+- `scripts/check.sh`, la barrière qualité en une commande — ruff, pyright,
+  pytest, et `--matrix` pour rejouer pytest sur Python 3.11 à 3.14 via uv.
+  `build-release.sh` l'appelle, et un crochet `pre-push` versionné
+  (`git config core.hooksPath scripts/hooks`) la lance avant tout envoi.
+- Un `flow.margin` trop petit pour la hauteur des pastilles de connecteur est
+  signalé au chargement de la configuration
+- Une virgule s'écrit dans un libellé en l'échappant : `[commande\, urgente]`
+  est un seul libellé, dessiné `commande, urgente`.
+- Les extras `png` et `ui` rejoignent le groupe `dev` : `uv run pytest`
+  exerce désormais l'export PNG et l'API web au lieu de sauter leurs tests.
+- `tests/test_e2e.py` : l'éditeur web joué dans un vrai Chromium 
+- Éditeur web : chaque panneau est plafonné à 200 000 caractères et un corps
+  de requête annoncé trop gros est refusé avant lecture (`413`), pour qu'une
+  saisie démesurée ne mobilise pas le serveur.
+- `examples/finances.yaml` et `examples/soins.yaml`, définitions des deux
+  illustrations du README, désormais régénérées par `sample/build.py` avec
+  les images de la documentation.
+- L'exemple « Format de définition » du README est `examples/yaml/patient.yaml`
+  — un bus, MLLP et SFTP —, rendu par `examples/build.py` dans ses deux
+  lectures (`patient-appli.png`, `patient-tech.png`) pour montrer d'un coup
+  d'œil ce que la clé `type` change.
+- Éditeur web : le séparateur entre les panneaux se glisse à la souris pour
+  élargir la saisie ou l'aperçu, se déplace au clavier (flèches, Début, Fin)
+  et revient au partage initial sur double-clic. Le partage est retenu par le
+  navigateur.
+- API objet : `Generator` accepte des `Application` et `Bus` à la place des
+  dictionnaires code → libellé, et un `Link(source, target, protocol, port)` —
+  ou une liste de liens qui s'enchaînent — à la place de la chaîne d'un flux.
+  Le rôle de l'application centrale fixe la colonne (source → droite, cible →
+  gauche). Cinq exemples, `sample/11` à `15`, reprennent les définitions texte.
+- Un libellé par flèche sur une chaîne relayée : `a --> bus --> m [DOC1, DOC2]`
+  écrit `DOC1` au-dessus de la première flèche et `DOC2` au-dessus de la
+  seconde. 
+- Dix exemples commentés d'utilisation de l'API Python dans `sample/`
+- Clé de définition `layout`, `auto` (défaut) ou `explicit`. En `explicit`, le
+  sens d'écriture décide seul du côté de chaque boîte, **bus compris** : `a -->
+  esb --> m` place `a` et `esb` à gauche, `m --> esb --> b` les place à droite.
+  C'est la seule façon de choisir le côté d'un bus, et un même bus écrit des
+  deux côtés ouvre désormais une boîte de chaque côté.
+- Exemple `examples/explicite.yaml`, qui montre une application et un bus
+  dessinés de part et d'autre du centre.
+
+### Modifié
+
+- Un seul répertoire d'exemples : `sample/` disparaît, ses quinze programmes
+  Python, `build.py` et leur README rejoignent `examples/`, dont les
+  définitions YAML et `config.yaml` passent dans `examples/yaml/`. Les rendus
+  de la documentation suivent, de `docs/images/sample/` vers
+  `docs/images/api/`.
+
+- Les fonctions et méthodes des tests (Python et JavaScript), de l'éditeur
+  web et des scripts portent des noms anglais, comme le reste du code ; le
+  module `journal.py` devient `logtext.py`.
+
+- Les exemples, jeux de test et extraits de documentation emploient des noms
+  d'application génériques (« Gestion financière », « Dossier de soins »,
+  « Messagerie »…) à la place de noms de produits réels ;
+  `examples/magh2.yaml`, `cora.yaml` et `opik.yaml` deviennent
+  `finances.yaml`, `soins.yaml` et `socle.yaml`.
+
+- `graph()` calcule la géométrie lui-même quand `calculate_positions()` n'a
+  pas été appelé : instancier `Generator` puis appeler `graph()` suffit.
+  L'appel explicite reste possible, pour lire les coordonnées avant de
+  dessiner. Remplacer `graph_config` ou relire les flux fait recalculer au
+  prochain `graph()`.
+
+- **Configuration hiérarchisée.** `GraphConfig` est découpée par sujet —
+  `page`, `app`, `main`, `flow`, `tag`, `bus`, `connector` —, chaque sujet
+  étant une dataclass (`AppConfig`, `FlowConfig`…) et chaque paire un objet
+  (`padding.x`, `label.halo.width`). 
+
+- **La virgule sépare désormais les libellés d'un flux** : un libellé ne peut
+  plus en contenir. `[commande, urgente]` se lit comme deux libellés au lieu
+  d'un seul.
+
+- La boîte d'un bus s'ouvre désormais à la hauteur de l'application centrale, et
+  se ferme avec elle quand aucun lien direct ne s'affiche sous ses traversées :
+  un côté entièrement relayé donne une boîte exactement aussi haute que le
+  centre. Elle cède devant ce qui occupe déjà sa colonne — un second bus, la
+  flèche d'un flux qui la traverse. Sa largeur, elle, ne change pas.
+
+- **Changement de comportement par défaut** : en `layout: auto`, les liens
+  directs d'une même application sont désormais regroupés d'un seul côté — une
+  seule boîte, plus haute — là où deux écritures opposées (`p --> m` et `m -->
+  p`) donnaient jusqu'ici deux boîtes homonymes. Le côté retenu est celui de ses
+  flux relayés s'il y en a, sinon celui que désignent le plus de ses lignes ; à
+  égalité, la première déclarée. Pour retrouver les deux boîtes, déclarer
+  `layout: explicit`.
+
+- Le choix du côté quitte `generator.py` pour un module dédié, `sides.py`.
+  `Generator.parse_flows` retombe du rang C 16 au rang C 11.
+
+- Le protocole d'un connecteur s'écrit en graisse normale, comme le port qui
+  l'accompagne, et non plus en gras.
+
+### Supprimé
+
+- La forme plate `parameters:` (`APP_FONT_SIZE`, `TAG_COLORS: [...]`) n'est
+  plus lue, sans compatibilité : un fichier qui la contient est refusé avec un
+  message explicite. Une table de conversion figure dans `docs/formats.md` § 4.
+
+### Corrigé
+
+- **Sécurité, éditeur web.** Deux entrées de moins de deux kilo-octets
+  occupaient le serveur huit à dix secondes et jusqu'à plusieurs centaines de
+  mégaoctets : une bombe d'alias YAML, et un document de mille crochets
+  ouvrants (récursion du parseur). Le YAML est désormais lu par un chargeur
+  strict — sans alias, borné à 32 niveaux —, la forme de la définition est
+  contrôlée avant usage (libellés, lignes de flux, `main`/`type`/`layout`),
+  et un corps sans `Content-Length` est refusé en 411 avant lecture. L'export
+  PNG refuse en 400 un raster au-delà de 25 mégapixels et les erreurs Cairo
+  (qui sortaient en 500) ; les rendus passent par un exécuteur borné sous
+  délai (`503` au-delà), et uvicorn limite ses connexions, coupe les
+  connexions oisives et n'annonce plus sa version — le tout réglable par
+  `SCHEMA_ARCHI_RENDER_WORKERS`, `SCHEMA_ARCHI_RENDER_TIMEOUT` et
+  `SCHEMA_ARCHI_CONCURRENCY`. Un schéma de plus de 200 flux ou de 100
+  applications et bus est refusé en 400 avant toute analyse
+  (`SCHEMA_ARCHI_MAX_FLOWS`, `SCHEMA_ARCHI_MAX_APPS`, `0` pour lever la
+  limite) ; la page l'annonce dans un bandeau, avec le rappel qu'une
+  installation locale n'a pas cette contrainte ; la bibliothèque et la
+  commande restent sans limite. Une réponse 422 ne recopie plus le document
+  reçu, et un lien `//autre-site/` n'est plus rendu cliquable. Toute réponse
+  porte une politique de sécurité de contenu (`script-src 'self'`) et les
+  en-têtes `nosniff`, `X-Frame-Options`, `Referrer-Policy` ; un limiteur de
+  débit par adresse (`SCHEMA_ARCHI_RATE_LIMIT`, 5 rendus/s, rafale 20)
+  répond 429 aux clients qui enchaînent les rendus ; `X-Forwarded-For` n'est
+  lu que sur demande (`SCHEMA_ARCHI_PROXY_HEADERS`). `docker/README.md`
+  décrit l'exposition publique : conteneur confiné, Caddy ou nginx. Le
+  journal cite l'adresse d'origine des saisies refusées et n'en reprend
+  qu'un extrait borné sur une ligne (`logtext.excerpt`) ; les liens du SVG
+  s'ouvrent dans un nouvel onglet, sans `opener` ni `Referer`. Analyse
+  complète dans `docs/analyses/analyse-2026-09-19-securite-web.md`.
+- Éditeur web : `Tab` et `Maj+Tab` passent par `insertText` au lieu de
+  réécrire le champ, si bien que `Ctrl+Z` annule l'indentation et remonte
+  toujours aux frappes d'avant. Sans `insertText`, l'écriture directe reste le
+  repli.
+- Deux bus empilés dans une même colonne se fermaient chacun sur leur
+  contenu, séparés d'un double blanc ; ils avancent désormais l'un vers l'autre
+  jusqu'à `page.vspace`. Les bus d'une même chaîne s'ouvrent et se ferment à
+  la même hauteur. Devant un lien direct, une boîte de bus continue de se
+  fermer sur son contenu : c'est voulu.
+- Le libellé d'un lien direct placé du même côté qu'un bus pouvait déborder
+  sur les boîtes des deux bouts : sa flèche traverse deux bandes et la colonne
+  du bus, et rien ne vérifiait que l'ensemble lui suffisait. Le manque est
+  désormais réparti sur les bandes traversées ; les schémas où le libellé
+  tenait déjà ne changent pas.
+- Nom d'application, nom de bus, libellé de flux et port posent leur ligne de
+  base eux-mêmes, comme les pastilles, au lieu de `dominant-baseline="middle"`
+  : ils tombaient 1 à 2 px trop haut, et pas au même endroit dans un
+  navigateur et dans le PNG de cairosvg. Le SVG ne contient plus aucun
+  `dominant-baseline`.
+- Éditeur web : le glissement du séparateur mesurait depuis le bord du
+  conteneur et non du panneau, d'où un décalage d'une marge intérieure entre
+  le pointeur et la gouttière. Trouvé par le test de bout en bout.
+- Éditeur web : la coloration n'est plus refaite en entier à chaque touche.
+  Elle est calculée ligne par ligne avec mémoire — une frappe ne recolore que
+  sa ligne — et regroupée par image d'écran (`requestAnimationFrame`), de
+  sorte que la saisie ne l'attend jamais.
+- Les illustrations du README (`docs/images/finances.png` et `soins.png`,
+  autrefois `magh2.png` et `cora.png`) dataient d'avant la
+  0.9.0 et n'avaient pas de définition source dans le dépôt.
+- pyright est déclaré dans le groupe `dev` et verrouillé par `uv.lock` :
+  `build-release.sh` ne l'installe plus à la volée dans une version flottante.
+- Le tag d'un bus (`esb: EAI !interne`, ou `Bus(..., tag="interne")`) était
+  accepté mais jamais dessiné. Il l'est désormais, en pastille sous le nom,
+  dans une bande de titre ouverte d'autant ; la boîte s'élargit à un tag plus
+  large que le nom, et les couleurs se dérivent de celles du bus faute d'être
+  déclarées dans `tag.colors`.
+- La documentation citait un paramètre `CONNECTOR_DEFAULT_COLORS` qui n'a
+  jamais existé : les couleurs d'un connecteur non déclaré sont dérivées de
+  sa boîte.
+- La pastille d'un connecteur n'entrait dans la largeur d'aucune boîte : au-delà
+  d'une douzaine de caractères, un protocole recouvrait la boîte entière,
+  ressortait du bord opposé et son port s'écrivait hors du cadre. Une boîte
+  réserve désormais la place que ses pastilles réclament à l'intérieur.
+- La boîte d'un bus mordait sur le groupe suivant dès que `CONNECTOR_LABEL_GAP`
+  dépassait ce que `VSPACE` absorbait (77 aux autres valeurs par défaut) : la
+  mise en page réservait le blanc au-dessus d'un groupe de bus, jamais celui du
+  dessous. Une flèche voisine traversait alors la boîte.
+- Les paramètres de `parameters` n'étaient contrôlés qu'en type : un `VSPACE`
+  négatif, un `APP_PARAM` nul ou une taille de police nulle étaient retenus en
+  silence et produisaient un schéma illisible. Ils sont désormais bornés, et une
+  valeur hors intervalle est signalée puis remplacée par le défaut.
+- Un flux traversant **deux bus ou plus et écrit l'application centrale en
+  dernier** (`a --> e1 --> e2 --> m`) annonçait sa chaîne dans l'ordre
+  d'écriture, à rebours de l'ordre de placement. Deux emplacements pourtant
+  identiques passaient pour distincts : la colonne était mal triée, les boîtes
+  de bus s'étiraient sur toute sa hauteur, et la flèche d'un flux qui
+  n'empruntait pas un bus traversait sa boîte de part en part — donnant à lire
+  un raccordement inexistant. La chaîne d'un emplacement est désormais posée par
+  la répartition, dans l'ordre vu depuis le centre.
+- Le protocole d'un connecteur et le texte d'un tag remontaient au-dessus du
+  centre de leur pastille : `dominant-baseline="middle"` aligne sur la
+  demi-hauteur d'x, non sur celle des capitales. Ces deux libellés posent
+  désormais leur ligne de base eux-mêmes, ce qui aligne du même coup le SVG et
+  le PNG, que cairosvg centrait autrement.
+- Éditeur web : une définition bien formée en YAML mais mal structurée — un
+  `main:` qui désigne une application inconnue, un `apps:` donné en liste, un
+  flux non textuel — sortait en `500 Internal Server Error`, et l'éditeur
+  n'affichait plus que « Échec de la requête (500) ». Ces saisies sont
+  désormais converties en `400` avec le message d'origine, comme le promettait
+  déjà le contrat de `build_svg`.
+
+## [0.10.0] — 2026-09-06
+
+### Ajouté
+
+- Bus d'intégration : la clé `bus` déclare des relais, et un flux peut en
+  traverser un ou plusieurs — `m --> e1 --> e2 --> pas [IMS]`. Le bus est
+  dessiné en boîte grise à angles vifs, nom en haut, chaque traversée
+  matérialisée par un trait.
+- Détail technique d'un lien : `-(protocole:port)->` dessine un connecteur à
+  cheval sur le bord de la boîte où la flèche arrive, deux tiers dedans, un
+  tiers dehors. Une entrée déclarée sur un bus appelle une sortie neutre.
+- Clé `type` : `appli` (défaut) ou `appli+tech`. En `appli`, les détails
+  techniques écrits dans les flux sont ignorés et les bus restent dessinés —
+  la même définition sert donc aux deux lectures.
+- `-->` et `<--` comme synonymes de `->` et `<-`, mieux distingués du tiret
+  admis dans un code.
+- Paramètres de rendu des bus (`BUS_*`) et des connecteurs (`CONNECTOR_*`,
+  `PORT_*`), dont `CONNECTOR_COLORS`, qui habille les pastilles par protocole,
+  et `CONNECTOR_LABEL_GAP`, qui encadre les connecteurs d'une boîte — sous son
+  libellé, et au-dessus de sa bordure du bas.
+- Les clés de premier niveau inconnues d'une définition sont signalées : un
+  `buss:` mal orthographié ne passe plus en silence.
+- Exemples `examples/bus.yaml` et `examples/technique.yaml`.
+- Éditeur web : deux boutons « Charger » et « Enregistrer » agissant sur le
+  panneau affiché, pour lire un fichier local et en produire un. Tout se passe
+  dans le navigateur, sans route serveur.
+- Suite de tests JavaScript de l'éditeur web (`tests/js`, exécutée par `node
+  --test` et déclenchée depuis `pytest`), avec un DOM de substitution sans
+  dépendance npm.
+- Éditeur web : `Tab` indente les lignes d'une sélection multiligne et
+  `Maj+Tab` les désindente ; `Échap` relâche le piège clavier, la tabulation
+  suivante rend la main au reste de la page.
+
+### Corrigé
+
+- Éditeur web : tabuler une sélection de plusieurs lignes la remplaçait par
+  deux espaces, effaçant le texte choisi.
+- Éditeur web : la coloration d'une ligne de parenthèses jamais refermées, ou
+  d'une longue suite de chiffres, coûtait un temps quadratique et figeait la
+  saisie. Les jetons sont bornés, et au-delà de 200 000 caractères le calque
+  rend le texte sans coloration.
+- Éditeur web : deux rendus lancés coup sur coup pouvaient revenir dans le
+  désordre et afficher l'aperçu périmé.
+- Éditeur web : une réponse serveur illisible, des défauts incomplets ou un
+  onglet mal étiqueté échouaient en silence — chacun donne désormais un
+  message, ou retombe sur une valeur sûre.
+- Éditeur web : un fichier chargé au format Windows laissait des « \r » dans
+  le texte, ce qui brouillait la coloration en fin de ligne.
+
+### Modifié
+
+- Le côté d'un flux relayé ne vient plus du sens d'écriture mais d'un
+  équilibrage : les bus sont répartis de part et d'autre pour que chaque côté
+  porte à peu près autant de flux. Les liens directs gardent la règle
+  historique.
+- Une application citée des deux côtés est désormais dessinée **deux fois**,
+  une par emplacement, au lieu d'une seule boîte partagée. Seule l'application
+  centrale reste unique.
+- Le module `generator` est scindé : `layout` calcule la géométrie, `svg`
+  produit le dessin, `generator` porte l'état et l'analyse.
+- `FLOW_GAP` passe de 3 à 0 : la pointe d'une flèche touche désormais ce
+  qu'elle vise — bord de rectangle, de boîte de bus ou de pastille.
+- Une largeur unique pour toutes les applications, une autre pour tous les
+  bus : deux objets de même nature ne diffèrent plus de taille selon le côté ou
+  le rang où ils tombent. Les connecteurs n'élargissent plus leur boîte — elle
+  range son nom au-dessus d'eux et grandit en hauteur.
+- L'application centrale est plus large que ses satellites d'un facteur
+  `MAIN_WIDTH_RATIO`, 1,2 par défaut. Le canevas d'`examples/minimal.yaml`
+  passe donc de 676 à 696 de large.
+
+### Corrigé
+
+- Une application émettant **et** recevant n'est plus placée puis replacée : le
+  trou vertical qu'elle laissait dans sa première colonne, et les deux dessins
+  superposés au même endroit, disparaissent.
+
+## [0.9.0] — 2026-09-06
+
+### Corrigé
+
+- Le cœur ne dépend plus d'aucune pile web : elle était installée d'office,
+  pour un éditeur qui n'a jamais été qu'un extra. Une installation nue se
+  limite désormais à `loguru` et `pyyaml`.
+- L'état du générateur repart de zéro à chaque définition : deux `load_data()`
+  successifs ne mêlent plus les applications des deux fichiers, et
+  `parse_flows()` appelé deux fois ne double plus les flèches.
+- Les valeurs de configuration sont contrôlées : un entier ou une couleur
+  fautifs sont signalés et remplacés par le défaut, au lieu de lever au rendu
+  ou d'être interpolés tels quels dans le SVG.
+- Les couleurs sont échappées à l'écriture des attributs SVG.
+- Le trait d'une flèche s'arrête à la base de sa pointe : il la traversait et
+  ressortait en bourrelet au-delà.
+- L'éditeur web déclare sa page en route : les visiteurs ne partagent plus les
+  mêmes panneaux et le même aperçu.
+- Le libellé d'une application était 6,5 px sous le centre de son rectangle :
+  `dominant-baseline` et `TEXT_VERTICAL_OFFSET` se cumulaient.
+- La largeur d'un rectangle tient compte des glyphes du libellé, et non plus
+  seulement de leur nombre : un `W` ne comptait pas plus qu'un `i`.
+
+### Ajouté
+
+- Tag d'application : `m: Dossier patient !chu` dessine une pastille arrondie sous le nom,
+  dans le rectangle. Les couleurs se déduisent de l'application — bordure
+  assombrie, fond éclairci — ou se déclarent par nom de tag dans `TAG_COLORS`.
+- Largeur de colonne calée sur le libellé le plus long (`APP_PADDING_X`) : les
+  noms d'application ne débordent plus de leur cadre.
+- Restylage du rendu : bordures plus épaisses, angles plus arrondis, marges et
+  interlignes plus généreux, pointe de flèche en triangle plein, libellés de
+  flux centrés sur leur flèche et détachés du trait par un halo.
+- `FLOW_WIDTH` devient un plancher : la bande de flèches s'élargit à son
+  libellé le plus long, qui ne déborde donc plus sur les rectangles.
+- Paramètres de rendu jusqu'ici écrits en dur ou absents :
+  `RECT_STROKE_WIDTH`, `FLOW_STROKE_WIDTH`, `APP_FONT_SIZE`, `MAIN_FONT_SIZE`,
+  `FLOW_FONT_SIZE`, `LABEL_HALO_WIDTH`, `LABEL_HALO_COLOR`, `FLOW_GAP`.
+- Pile de polices système, avec Arial en dernier recours, au lieu d'Arial seul.
+- `<title>` et `<desc>` sur le SVG, `<title>` sur chaque lien de flux.
+- `SCHEMA_ARCHI_HOST` et `SCHEMA_ARCHI_PORT` pour l'éditeur web.
+- Tests de l'éditeur web (`tests/test_ui.py`), jusqu'ici sans couverture.
+- `docs/publication.md` : comptes et jetons, choix du numéro de version,
+  répétition sur TestPyPI, étiquetage et diagnostic des échecs. Le README et
+  `docs/formats.md` y renvoyaient sans qu'il existe.
+
+### Modifié
+
+- L'éditeur web est réécrit en HTML/CSS/JavaScript servi par FastAPI, à la
+  place de NiceGUI : une page statique, une API JSON de quatre routes, et un
+  coloriseur maison qui distingue les codes, le sens, le libellé et le lien
+  d'un flux. Aucune ressource externe, donc utilisable hors ligne. L'extra
+  `ui` installe désormais `fastapi` et `uvicorn`.
+- L'export PNG est proposé dans l'éditeur quand l'extra `png` est présent ;
+  l'image `archi-app` l'embarque désormais.
+- Images Docker en deux étages, sans dépendances de développement, uv épinglé
+  et exécution sous un utilisateur non privilégié.
+
+### Ruptures
+
+Ces changements modifient une sortie existante — régénérer les SVG de
+référence commités ailleurs :
+
+- une colonne dont les libellés l'exigent est plus large que `APP_PARAM.width`,
+  qui devient une largeur plancher ;
+- un schéma à sens unique ne réserve plus de colonne vide : le bloc central
+  démarre à `MARGIN_LEFT` ;
+- `APP_PARAM.padding_top` et `padding_bottom`, inutilisés depuis l'origine,
+  sont retirés — les configurations qui les portent restent acceptées, la clé
+  est ignorée avec un avertissement.
+- Le restylage change l'apparence **et les dimensions** de tout schéma :
+  traits, arrondis, marges, position des libellés. Les valeurs par défaut de
+  `RECT_CORNER`, `APP_PARAM.height`, `MARGIN_TOP`, `MARGIN_LEFT`, `HSPACE`,
+  `VSPACE`, `FLOW_WIDTH`, `FLOW_MARGIN`, `LINK_LINE_ARROW`, `LABEL_OFFSET_Y` et
+  `TEXT_VERTICAL_OFFSET` sont toutes modifiées. Une configuration qui les fixe
+  explicitement conserve son rendu d'origine.
+- `LABEL_OFFSET_X` est retiré : le libellé n'est plus décalé depuis le départ
+  de la flèche, il est centré dessus.
+
+## [0.7.3] — 2026-07-27
+
+Correctifs issus de l'audit de la 0.7.1 par un programme tiers.
+
+### Corrigé
+
+- Couleurs de texte configurables : `fill` remplace `color`, sans effet en SVG.
+- Le rectangle de l'application centrale ne dépasse plus le bas du schéma.
+- La CLI retourne `1` quand une définition échoue, et poursuit le lot.
+- La clé `main` redevient facultative (`m` par défaut).
+- `parse_flow` rejette le texte parasite en fin de ligne (`fullmatch`).
+- Les codes d'application acceptent le tiret et le point (`si-rh`, `app.v2`).
+- Le SVG porte un `viewBox` et utilise `dominant-baseline`.
+- Les applications citées dans aucun flux sont signalées en `WARNING`.
+- Seuls les liens `http`, `https`, `mailto` et relatifs donnent une ancre.
+- `split_endpoints` rejette une chaîne portant les deux séparateurs.
+
+### Ajouté
+
+- `FLOW_TEXT_COLOR` : couleur du libellé d'un flux, distincte du trait.
+- `Generator.orphan_apps()` : applications rattachées à aucun flux.
+
+### Modifié
+
+- La bibliothèque est muette par défaut ; l'appelant fait
+  `logger.enable("schema_archi")`.
+- `cli.process_diagram` retourne un `DiagramStatus` au lieu d'un booléen.
+
+### Ruptures
+
+Ces changements modifient une sortie existante — régénérer les SVG de
+référence commités ailleurs :
+
+- le texte des applications prend la couleur configurée, noir auparavant ;
+- la hauteur du SVG diminue de `MARGIN_TOP` (20 px par défaut) ;
+- `a -> b [x] et voilà` devient une ligne invalide, jusqu'ici tolérée.
+
+## [0.7.1] — 2026-07-27
+
+Changement des noms des applications dans l'exemple.
+
+## [0.7.0] — 2026-07-26
+
+Première version distribuable sur PyPI. Le projet passe d'un ensemble de
+modules à plat à une bibliothèque installable.
+
+### Ruptures
+
+- Les modules à la racine deviennent un paquet `schema_archi` en layout `src/` :
+  - `schema_app` → `schema_archi.generator` (la classe `Generator`)
+  - `formats` → `schema_archi.formats`
+  - `bulk_graph` → `schema_archi.cli`
+  - `schema_archi/__init__.py` (dataclasses) → `schema_archi.models`
+  - `ui/app-ui.py` → `schema_archi.ui.app`
+  - `ui/local_file_picker.py` → `schema_archi.ui.file_picker`
+- `GraphConfig` est déplacée dans `schema_archi.config`.
+- `formats.load_data()` est remplacée par `formats.load_file()`, qui ne
+  transforme plus le contenu lu (voir *Corrigé*).
+- `formats.prepare_data()` est renommée `formats.parse_flows_def()`.
+- `formats.from_json()` et `formats.to_json()`, inutilisées, sont supprimées.
+- `Generator.load_config()` et `Generator.set_config()` renvoient désormais un
+  booléen indiquant si la configuration a été appliquée.
+- `requires-python` passe de `>=3.14` à `>=3.11`.
+- Suppression du générateur arbre/bus (`schema.py`), des services web
+  FastAPI/Flask (`services/`), des interfaces expérimentales à base de tables et
+  du sélecteur de fichiers `local_file_picker`, devenu sans appelant.
+- `Generator.graph()` lève `RuntimeError` au lieu d'`AssertionError` lorsque le
+  générateur n'est pas initialisé.
+- `Flow.direction` (chaîne `"forward"` / `"backward"`) devient `Flow.is_forward`
+  (booléen), et `link` / `position` prennent une valeur par défaut.
+- `Application` n'a plus d'égalité structurelle : deux applications de mêmes
+  libellé et code sont désormais distinctes. L'appartenance à une colonne se
+  teste en temps constant, sans comparer les flux accumulés.
+- `formats.parse_flows_def()` ne renvoie plus le dictionnaire reçu ; il se
+  contente de le modifier sur place.
+- `FORWARD_FLOW` et `BACKWARD_FLOW` passent de `schema_archi.config` à
+  `schema_archi.formats` — ils décrivent la syntaxe des définitions, pas le
+  rendu. Ils restent exportés depuis `schema_archi`.
+- `Generator.calculate_lane()` devient `_layout_lane()`, privée : c'était une
+  étape interne du calcul, jamais destinée à un appel direct. Elle ne renvoie
+  plus rien.
+- `Generator._adapt_app_width()` devient `_app_width()` et ne prend plus
+  d'argument : le nom de l'application n'était pas utilisé.
+
+### Ajouté
+
+- Commandes `schema-archi` (traitement par lot) et `schema-archi-ui` (éditeur web).
+- Extras `png` (cairosvg) et `ui` (nicegui) ; le cœur ne dépend plus que de
+  `loguru` et `pyyaml`.
+- Marqueur `py.typed` (PEP 561).
+- Options `--no-png` et `--log-file` sur la ligne de commande.
+- Prise en charge des extensions `.yml` et `.json` en entrée de la CLI.
+- `GraphConfig.from_dict()` ignore les clés inconnues au lieu d'échouer, et
+  convertit les listes de couleurs en tuples.
+- Suite de tests pytest (102 tests) remplaçant les scripts ad hoc.
+- Configuration ruff (lint et formatage) dans `pyproject.toml`, couvrant 22
+  familles de règles ; le dépôt est sans signalement, et `pyright` non plus.
+- `Generator(apps, flows, main=...)` : le constructeur accepte le code de
+  l'application centrale et la définit avant d'analyser les flux.
+- `formats.split_endpoints()` sépare `"a->b"` en source, cible et sens.
+- `GraphConfig.LABEL_OFFSET_X` / `LABEL_OFFSET_Y` remplacent des décalages de
+  libellé jusqu'ici codés en dur.
+
+- Documentation détaillée : `docs/formats.md` (référence des formats d'entrée,
+  grammaire des flux, paramètres de configuration, messages de diagnostic),
+  `docs/algorithme.md` (les cinq étapes de la génération, formules de placement,
+  exemple chiffré, limites connues) et `docs/publication.md`
+- `examples/minimal.yaml`, le schéma détaillé dans la documentation.
+- `scripts/build-release.sh` : construction de la distribution, contrôles de
+  qualité et d'artefacts, essai d'installation hors du dépôt, et publication
+  optionnelle sur TestPyPI ou PyPI.
+
+### Corrigé
+
+- **L'option `-c/--config` n'avait aucun effet.** `load_config()` passait par un
+  chargeur qui exigeait une clé `flows_def`
+- Le fichier de configuration était lui-même traité comme un diagramme, faute
+  d'être exclu de la liste des entrées.
+- Le message d'erreur de la CLI mentionnait des formats JSON/TOML alors que
+  seul YAML était accepté.
+- `errors.log` était créé dans le répertoire courant à chaque exécution.
+- Le bouton d'enregistrement de l'éditeur web téléchargeait la chaîne littérale
+  `"svg_display.content"` au lieu du SVG.
+- `GraphConfig` partageait un même objet `APP_PARAM` entre instances.
+- Les journaux par flux passent de `INFO` à `DEBUG`.
+- **Le SVG produit n'était pas échappé** : une application nommée `R&D` ou un
+  libellé contenant `<` suffisait à produire un fichier XML invalide. 
+- Les marges du canevas étaient inversées : `HSPACE` s'ajoutait à la hauteur et
+  `VSPACE` à la largeur.
+- Les flux dont aucune extrémité n'est l'application centrale disparaissaient
+  sans le moindre message.
+- `Generator(apps, flows)` n'analysait rien d'exploitable : `parse_flows()`
+  était appelé alors qu'aucune application centrale n'était définie.

appflows-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024-2026 Frédéric Laurent
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.