From 894d4f50ef30f18f438b3c43cc8787454176921f Mon Sep 17 00:00:00 2001
From: Adrian Rumpold <a.rumpold@gmail.com>
Date: Tue, 29 Apr 2025 14:12:32 +0200
Subject: [PATCH] Add high-level architecture to README

---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/README.md b/README.md
index e69de29..8287b86 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,26 @@
+High-level architecture:
+
+```mermaid
+flowchart TD
+    Cellar[Cellar API]
+    Frontend
+
+    subgraph backend
+        client[Cellar Client]
+        conv[Formex -> HTML converter]
+        FastAPI
+    end
+
+    Cellar --> meta@{ shape: docs, label: "XML/RDF Metadata"}
+    Cellar --> docs@{ shape: docs, label: "Formex/XHTML/PDF text"}
+
+    meta --> client
+    docs --> client
+
+    client -- Formex --> FastAPI
+    client -- Formex --> conv
+
+    conv -- HTML --> FastAPI
+
+    FastAPI -- TOC, HTML article text --> Frontend
+```