From e462211c49bde216e6e04d3fc8444931eaac1a50 Mon Sep 17 00:00:00 2001
From: cinereal <cinereal@riseup.net>
Date: Sat, 31 May 2025 20:31:21 +0200
Subject: [PATCH] md -> mmd

usage:

```sh
nix-shell -p mermaid-cli --command 'mmdc -i data-model.mmd -o
data-model.svg -b transparent'
```
---
 architecture-docs/{data-model.md => data-model.mmd} | 7 +------
 architecture-docs/data-model.svg                    | 1 +
 2 files changed, 2 insertions(+), 6 deletions(-)
 rename architecture-docs/{data-model.md => data-model.mmd} (80%)
 create mode 100644 architecture-docs/data-model.svg

diff --git a/architecture-docs/data-model.md b/architecture-docs/data-model.mmd
similarity index 80%
rename from architecture-docs/data-model.md
rename to architecture-docs/data-model.mmd
index 5ceec50..b3d8ef0 100644
--- a/architecture-docs/data-model.md
+++ b/architecture-docs/data-model.mmd
@@ -1,8 +1,3 @@
-<!-- usage: `nix-shell -p pandoc -p mermaid-filter --command 'pandoc data-model.md -o data-model.html -F mermaid-filter'` -->
-
-# fediversity entity relations
-
-```mermaid
 ---
 title: Fediversity entity relations
 ---
@@ -27,4 +22,4 @@ erDiagram
     application ||--o{ version : follows
     application ||--o{ script : runs
     deployed }|--o{ version : follows
-```
+    script }o--|| token : uses
diff --git a/architecture-docs/data-model.svg b/architecture-docs/data-model.svg
new file mode 100644
index 0000000..05db9ac
--- /dev/null
+++ b/architecture-docs/data-model.svg
@@ -0,0 +1 @@
+<svg aria-roledescription="er" role="graphics-document document" viewBox="0 -61 993.4453125 1226" style="max-width: 993.445px; background-color: transparent;" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns="http://www.w3.org/2000/svg" width="100%" id="my-svg"><style>#my-svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;fill:#333;}#my-svg .error-icon{fill:#552222;}#my-svg .error-text{fill:#552222;stroke:#552222;}#my-svg .edge-thickness-normal{stroke-width:1px;}#my-svg .edge-thickness-thick{stroke-width:3.5px;}#my-svg .edge-pattern-solid{stroke-dasharray:0;}#my-svg .edge-thickness-invisible{stroke-width:0;fill:none;}#my-svg .edge-pattern-dashed{stroke-dasharray:3;}#my-svg .edge-pattern-dotted{stroke-dasharray:2;}#my-svg .marker{fill:#333333;stroke:#333333;}#my-svg .marker.cross{stroke:#333333;}#my-svg svg{font-family:"trebuchet ms",verdana,arial,sans-serif;font-size:16px;}#my-svg p{margin:0;}#my-svg .entityBox{fill:#ECECFF;stroke:#9370DB;}#my-svg .attributeBoxOdd{fill:#ffffff;stroke:#9370DB;}#my-svg .attributeBoxEven{fill:#f2f2f2;stroke:#9370DB;}#my-svg .relationshipLabelBox{fill:hsl(80, 100%, 96.2745098039%);opacity:0.7;background-color:hsl(80, 100%, 96.2745098039%);}#my-svg .relationshipLabelBox rect{opacity:0.5;}#my-svg .relationshipLine{stroke:#333333;}#my-svg .entityTitleText{text-anchor:middle;font-size:18px;fill:#333;}#my-svg #MD_PARENT_START{fill:#f5f5f5!important;stroke:#333333!important;stroke-width:1;}#my-svg #MD_PARENT_END{fill:#f5f5f5!important;stroke:#333333!important;stroke-width:1;}#my-svg :root{--mermaid-font-family:"trebuchet ms",verdana,arial,sans-serif;}</style><g/><defs><marker orient="auto" markerHeight="240" markerWidth="190" refY="7" refX="0" id="MD_PARENT_START"><path d="M 18,7 L9,13 L1,7 L9,1 Z"/></marker></defs><defs><marker orient="auto" markerHeight="28" markerWidth="20" refY="7" refX="19" id="MD_PARENT_END"><path d="M 18,7 L9,13 L1,7 L9,1 Z"/></marker></defs><defs><marker orient="auto" markerHeight="18" markerWidth="18" refY="9" refX="0" id="ONLY_ONE_START"><path d="M9,0 L9,18 M15,0 L15,18" fill="none" stroke="gray"/></marker></defs><defs><marker orient="auto" markerHeight="18" markerWidth="18" refY="9" refX="18" id="ONLY_ONE_END"><path d="M3,0 L3,18 M9,0 L9,18" fill="none" stroke="gray"/></marker></defs><defs><marker orient="auto" markerHeight="18" markerWidth="30" refY="9" refX="0" id="ZERO_OR_ONE_START"><circle r="6" cy="9" cx="21" fill="white" stroke="gray"/><path d="M9,0 L9,18" fill="none" stroke="gray"/></marker></defs><defs><marker orient="auto" markerHeight="18" markerWidth="30" refY="9" refX="30" id="ZERO_OR_ONE_END"><circle r="6" cy="9" cx="9" fill="white" stroke="gray"/><path d="M21,0 L21,18" fill="none" stroke="gray"/></marker></defs><defs><marker orient="auto" markerHeight="36" markerWidth="45" refY="18" refX="18" id="ONE_OR_MORE_START"><path d="M0,18 Q 18,0 36,18 Q 18,36 0,18 M42,9 L42,27" fill="none" stroke="gray"/></marker></defs><defs><marker orient="auto" markerHeight="36" markerWidth="45" refY="18" refX="27" id="ONE_OR_MORE_END"><path d="M3,9 L3,27 M9,18 Q27,0 45,18 Q27,36 9,18" fill="none" stroke="gray"/></marker></defs><defs><marker orient="auto" markerHeight="36" markerWidth="57" refY="18" refX="18" id="ZERO_OR_MORE_START"><circle r="6" cy="18" cx="48" fill="white" stroke="gray"/><path d="M0,18 Q18,0 36,18 Q18,36 0,18" fill="none" stroke="gray"/></marker></defs><defs><marker orient="auto" markerHeight="36" markerWidth="57" refY="18" refX="39" id="ZERO_OR_MORE_END"><circle r="6" cy="18" cx="9" fill="white" stroke="gray"/><path d="M21,18 Q39,0 57,18 Q39,36 21,18" fill="none" stroke="gray"/></marker></defs><path style="stroke: gray; fill: none;" marker-start="url(#ZERO_OR_MORE_START)" marker-end="url(#ZERO_OR_MORE_END)" d="M155.457,95L144.885,103.333C134.312,111.667,113.167,128.333,102.595,145C92.022,161.667,92.022,178.333,92.022,186.667L92.022,195" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ZERO_OR_MORE_END)" d="M250.61,95L261.182,103.333C271.755,111.667,292.9,128.333,303.472,145C314.045,161.667,314.045,178.333,314.045,186.667L314.045,195" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ZERO_OR_MORE_END)" d="M265.913,270L255.217,278.333C244.521,286.667,223.128,303.333,212.432,326.25C201.736,349.167,201.736,378.333,201.736,407.5C201.736,436.667,201.736,465.833,206.498,488.75C211.26,511.667,220.784,528.333,225.546,536.667L230.308,545" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONE_OR_MORE_START)" marker-end="url(#ONLY_ONE_END)" d="M375.886,445L367.694,453.333C359.503,461.667,343.119,478.333,327.785,495C312.451,511.667,298.165,528.333,291.022,536.667L283.879,545" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ZERO_OR_MORE_END)" d="M356.346,270L365.746,278.333C375.147,286.667,393.947,303.333,403.347,320C412.748,336.667,412.748,353.333,412.748,361.667L412.748,370" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ONE_OR_MORE_END)" d="M429.457,445L433.17,453.333C436.883,461.667,444.31,478.333,448.023,501.25C451.736,524.167,451.736,553.333,451.736,582.5C451.736,611.667,451.736,640.833,451.736,670C451.736,699.167,451.736,728.333,451.736,757.5C451.736,786.667,451.736,815.833,451.736,845C451.736,874.167,451.736,903.333,451.736,932.5C451.736,961.667,451.736,990.833,483.509,1016.405C515.283,1041.977,578.829,1063.954,610.602,1074.942L642.375,1085.931" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ZERO_OR_ONE_END)" d="M462.748,423.387L500.311,435.322C537.875,447.258,613.003,471.129,650.567,491.398C688.13,511.667,688.13,528.333,688.13,536.667L688.13,545" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ONLY_ONE_END)" d="M362.748,420.52L315.079,432.934C267.41,445.347,172.073,470.173,124.405,497.17C76.736,524.167,76.736,553.333,76.736,582.5C76.736,611.667,76.736,640.833,80.29,663.75C83.843,686.667,90.949,703.333,94.502,711.667L98.056,720" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ZERO_OR_ONE_START)" marker-end="url(#ONLY_ONE_END)" d="M612.748,598.533L556.746,610.444C500.744,622.356,388.74,646.178,317.129,666.484C245.519,686.79,214.301,703.579,198.693,711.974L183.084,720.369" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ONE_OR_MORE_END)" d="M656.544,620L649.524,628.333C642.505,636.667,628.466,653.333,621.447,670C614.428,686.667,614.428,703.333,614.428,711.667L614.428,720" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ZERO_OR_MORE_END)" d="M614.428,795L614.428,803.333C614.428,811.667,614.428,828.333,621.571,845C628.713,861.667,642.999,878.333,650.142,886.667L657.285,895" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONLY_ONE_START)" marker-end="url(#ZERO_OR_MORE_END)" d="M664.428,771.939L706.595,784.116C748.763,796.292,833.098,820.646,875.266,841.156C917.434,861.667,917.434,878.333,917.434,886.667L917.434,895" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ONE_OR_MORE_START)" marker-end="url(#ZERO_OR_MORE_END)" d="M720.829,620L728.096,628.333C735.362,636.667,749.895,653.333,757.161,676.25C764.428,699.167,764.428,728.333,764.428,757.5C764.428,786.667,764.428,815.833,757.285,838.75C750.142,861.667,735.856,878.333,728.713,886.667L721.571,895" class="er relationshipLine"/><path style="stroke: gray; fill: none;" marker-start="url(#ZERO_OR_MORE_START)" marker-end="url(#ONLY_ONE_END)" d="M917.434,970L917.434,978.333C917.434,986.667,917.434,1003.333,892.38,1021.974C867.326,1040.614,817.217,1061.228,792.163,1071.535L767.109,1081.843" class="er relationshipLine"/><g transform="translate(142.51904296875,20 )" id="entity-setup-860214c0-b79b-5813-86f0-47e9c4e8c6ea"><rect height="75" width="121.029296875" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(60.5146484375,37.5)" y="0" x="0" id="text-entity-setup-860214c0-b79b-5813-86f0-47e9c4e8c6ea" class="er entityLabel">Fediversity setup</text></g><g transform="translate(20,195 )" id="entity-env-35d32653-154f-5acd-b6b2-9fd9ea87299e"><rect height="75" width="144.044921875" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(72.0224609375,37.5)" y="0" x="0" id="text-entity-env-35d32653-154f-5acd-b6b2-9fd9ea87299e" class="er entityLabel">run-time environment</text></g><g transform="translate(612.74755859375,545 )" id="entity-deployed-d54cc0d6-796f-54ac-bf09-1bbef98d2f52"><rect height="75" width="150.765625" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(75.3828125,37.5)" y="0" x="0" id="text-entity-deployed-d54cc0d6-796f-54ac-bf09-1bbef98d2f52" class="er entityLabel">deployed configuration</text></g><g transform="translate(45.005859375,720 )" id="entity-staged-e0928344-d87d-5271-ab0c-f4f1a6e0675d"><rect height="75" width="138.078125" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(69.0390625,37.5)" y="0" x="0" id="text-entity-staged-e0928344-d87d-5271-ab0c-f4f1a6e0675d" class="er entityLabel">staged configuration</text></g><g transform="translate(642.375,1070 )" id="entity-token-db962146-f9e2-53e5-919d-8477e228f710"><rect height="75" width="124.734375" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(62.3671875,37.5)" y="0" x="0" id="text-entity-token-db962146-f9e2-53e5-919d-8477e228f710" class="er entityLabel">deployment token</text></g><g transform="translate(861.421875,895 )" id="entity-script-bd44958a-4d90-5e8f-a07a-ae08e775d2b3"><rect height="75" width="112.0234375" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(56.01171875,37.5)" y="0" x="0" id="text-entity-script-bd44958a-4d90-5e8f-a07a-ae08e775d2b3" class="er entityLabel">migration script</text></g><g transform="translate(264.044921875,195 )" id="entity-operator-6c3c8122-d73d-5044-ae44-1ef3f93ceeda"><rect height="75" width="100" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(50,37.5)" y="0" x="0" id="text-entity-operator-6c3c8122-d73d-5044-ae44-1ef3f93ceeda" class="er entityLabel">operator</text></g><g transform="translate(201.736328125,545 )" id="entity-domain-ca07e5df-bb03-5f49-b416-a004831c8637"><rect height="75" width="100" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(50,37.5)" y="0" x="0" id="text-entity-domain-ca07e5df-bb03-5f49-b416-a004831c8637" class="er entityLabel">domain</text></g><g transform="translate(362.74755859375,370 )" id="entity-deployment-6e8d4da4-7b9e-52d1-a6c4-135846840a1b"><rect height="75" width="100" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(50,37.5)" y="0" x="0" id="text-entity-deployment-6e8d4da4-7b9e-52d1-a6c4-135846840a1b" class="er entityLabel">deployment</text></g><g transform="translate(564.427734375,720 )" id="entity-application-7e39266e-e9df-5da1-a01a-dc1a3810d603"><rect height="75" width="100" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(50,37.5)" y="0" x="0" id="text-entity-application-7e39266e-e9df-5da1-a01a-dc1a3810d603" class="er entityLabel">application</text></g><g transform="translate(639.427734375,895 )" id="entity-version-fdae9614-9260-58ea-8354-92bcbcd0d630"><rect height="75" width="100" y="0" x="0" class="er entityBox"/><text style="dominant-baseline: middle; text-anchor: middle; font-size: 12px;" transform="translate(50,37.5)" y="0" x="0" id="text-entity-version-fdae9614-9260-58ea-8354-92bcbcd0d630" class="er entityLabel">version</text></g><rect height="14" width="29.796875" y="129.4892578125" x="93.94374084472656" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="136.4892578125" x="108.84217834472656" id="rel1" class="er relationshipLabel">offers</text><rect height="14" width="35.34375" y="129.48931884765625" x="279.5528869628906" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="136.48931884765625" x="297.2247619628906" id="rel2" class="er relationshipLabel">serves</text><rect height="14" width="28.015625" y="391.44775390625" x="187.7407684326172" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="398.44775390625" x="201.7485809326172" id="rel3" class="er relationshipLabel">owns</text><rect height="14" width="25.359375" y="486.9562683105469" x="316.06756591796875" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="493.9562683105469" x="328.74725341796875" id="rel4" class="er relationshipLabel">uses</text><rect height="14" width="19.359375" y="305.6945495605469" x="388.9849548339844" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="312.6945495605469" x="398.6646423339844" id="rel5" class="er relationshipLabel">has</text><rect height="14" width="53.375" y="813.9727783203125" x="425.0484924316406" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="820.9727783203125" x="451.7359924316406" id="rel6" class="er relationshipLabel">generates</text><rect height="14" width="19.359375" y="458.90130615234375" x="581.4035034179688" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="465.90130615234375" x="591.0831909179688" id="rel7" class="er relationshipLabel">has</text><rect height="14" width="19.359375" y="488.73297119140625" x="117.3116226196289" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="495.73297119140625" x="126.9913101196289" id="rel8" class="er relationshipLabel">has</text><rect height="14" width="52.6875" y="639.716064453125" x="367.5317077636719" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="646.716064453125" x="393.8754577636719" id="rel9" class="er relationshipLabel">compares</text><rect height="14" width="51.359375" y="658.2584838867188" x="597.9451293945312" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="665.2584838867188" x="623.6248168945312" id="rel10" class="er relationshipLabel">describes</text><rect height="14" width="36.6875" y="842.8743286132812" x="605.5105590820312" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="849.8743286132812" x="623.8543090820312" id="rel11" class="er relationshipLabel">follows</text><rect height="14" width="23.34375" y="807.5166625976562" x="794.5454711914062" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="814.5166625976562" x="806.2173461914062" id="rel12" class="er relationshipLabel">runs</text><rect height="14" width="36.6875" y="750.3170776367188" x="746.0841674804688" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="757.3170776367188" x="764.4279174804688" id="rel13" class="er relationshipLabel">follows</text><rect height="14" width="25.359375" y="1034.8800048828125" x="846.065673828125" class="er relationshipLabelBox"/><text style="text-anchor: middle; dominant-baseline: middle; font-size: 12px;" y="1041.8800048828125" x="858.745361328125" id="rel14" class="er relationshipLabel">uses</text><text class="entityTitleText" y="-25" x="496.72265625" text-anchor="middle">Fediversity entity relations</text></svg>
\ No newline at end of file