From d8afd5b9890e16305ffb6eec99ced602d10b3313 Mon Sep 17 00:00:00 2001
From: Thomas Stallinger <stallinger@gmx.de>
Date: Sun, 14 Jun 2026 21:34:15 +0200
Subject: [PATCH] Initial platform documentation

---
 README.md       | 13 +++++++++++++
 architecture.md | 25 +++++++++++++++++++++++++
 2 files changed, 38 insertions(+)
 create mode 100644 README.md
 create mode 100644 architecture.md

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