initial commit

Change-Id: I2176a752738f5a750cdad5c5722ca01248d30106

README.md

@@ -0,0 +1,23 @@
+# sonar-test-pyt2
+
+> **System-of-Record branch** — application code lives on `dev`.
+
+| Branch    | Purpose |
+|-----------|---------|
+| `dev`     | Inner loop — push freely, deploys to dev env automatically |
+| `staging` | Staging env — promoted from dev via PR (CI gate + 1 approval) |
+| `prod`    | Production — promoted from staging via PR (CI gate + 1 approval) |
+| `main`    | System of record — receives merges from prod after releases |
+
+## Platform CI/CD
+
+Workflows in `.gitea/workflows/` are **runtime-agnostic** — they read
+`.platform/config.yaml` at run-time to determine build toolchain, container
+port, and health endpoint. No workflow files need updating when this service
+is migrated to a different runtime.
+
+| Config key | Value |
+|------------|-------|
+| `runtime` | `python-fastapi` |
+| `health_path` | `/health` |
+| `container_port` | `8000` |