architecture-docs/.gitignore

@@ -0,0 +1,3 @@
+*.err
+*.odt
+.~lock*

architecture-docs/data-model.md

@@ -0,0 +1,28 @@
+<!-- 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
+---
+erDiagram
+    setup["Fediversity setup"]
+    env["run-time environment"]
+    deployed["deployed configuration"]
+    staged["staged configuration"]
+    token["deployment token"]
+
+    setup }o--o{ env : offers
+    setup ||--o{ operator : serves
+    operator ||--o{ domain : owns
+    deployment }|--|| domain : uses
+    operator ||--o{ deployment : has
+    deployment ||--|{ token : generates
+    deployment ||--o| deployed : has
+    deployment ||--|| staged : has
+    deployed |o--|| staged : compares
+    deployed ||--|{ application : describes
+    application ||--o{ version : follows
+    deployed }|--o{ version : follows
+```

architecture-docs/entity-relations.md

@@ -0,0 +1,26 @@
+# fediversity entity relations
+
+```mermaid
+---
+title: Fediversity entity relations
+---
+erDiagram
+    setup["Fediversity setup"]
+    env["run-time environment"]
+    deployed["deployed configuration"]
+    staged["staged configuration"]
+    token["deployment token"]
+
+    setup }o--o{ env : offers
+    setup ||--o{ operator : serves
+    operator ||--o{ domain : owns
+    deployment }|--|| domain : uses
+    operator ||--o{ deployment : has
+    deployment ||--|{ token : generates
+    deployment ||--o| deployed : has
+    deployment ||--|| staged : has
+    deployed |o--|| staged : compares
+    deployed ||--|{ application : describes
+    application ||--o{ version : follows
+    deployed }|--o{ version : follows
+```