commit d8afd5b9890e16305ffb6eec99ced602d10b3313
Author: Thomas Stallinger <stallinger@gmx.de>
Date:   Sun Jun 14 21:34:15 2026 +0200

    Initial platform documentation

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..04d236f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,13 @@
+# Stallinux Provisioning Platform
+
+Repositories:
+
+- provisioning-server
+- provisioning-client
+- platform-docs
+
+Planned:
+
+- profiles
+- installer definitions
+- ansible roles
diff --git a/architecture.md b/architecture.md
new file mode 100644
index 0000000..050a610
--- /dev/null
+++ b/architecture.md
@@ -0,0 +1,25 @@
+# Architecture
+
+Provisioning Client
+        ↓ HTTPS
+anode.stallinux.de
+        ↓
+Activation API
+        ↓
+Profile API
+        ↓
+Bootstrap API
+        ↓
+Installer
+        ↓
+Ansible Pull
+
+## Endpoints
+
+GET  /health
+
+POST /api/v1/activate
+
+GET  /api/v1/profiles/{id}
+
+GET  /api/v1/profiles/{id}/bootstrap