Add README

Author: HeatherHazell

README.md

@@ -0,0 +1,46 @@
+# 🔧 GitStream Automation Demo
+
+A full-stack demo app used to showcase `gitStream` automations like AI, `codeExperts`, contributor mapping, and PR workflows.
+
+### 🗂️ Structure
+
+- `frontend/` – HTML/JS UI and NodeJS proxy
+- `services/auth-python/` – Auth (FastAPI)
+- `services/billing-csharp/` – Billing (.NET Core)
+- `services/orders-java/` – Orders (Spring Boot)
+- `.cm/` – gitStream config
+- `docker-compose.yml` – Runs everything
+
+## 🧭 Architecture
+
+```mermaid
+
+graph TD
+
+  subgraph "☁️ Public Services"
+    P[🧭 Proxy<br/> NodeJS]
+  end
+
+  subgraph "🧑‍💻 Client"
+    A[🌐 Frontend <br/> HTML/JS]
+  end
+
+  subgraph "🏢 Internal Services"
+    B[🔐 Auth Service <br/> Python & FastAPI]
+    D[📦 Orders Service <br/> Java & Spring Boot]
+    C[💳 Billing Service <br/> CSharp & ASP.NET]
+  end
+
+  A --> P
+  P --> B
+  P --> D
+  D --> B
+  D --> C
+```
+
+### 🚀 Usage
+
+```bash
+docker-compose up --build
+```
+Open a browser to http://localhost:3000/