initial commit

Change-Id: I84f1c77dbf214ee51341ec8443810c0711a16d83

.platform/initialized.md

@@ -0,0 +1,25 @@
+# Platform Initialization
+
+| Field | Value |
+|-------|-------|
+| Component | `test-alex-1` |
+| Repository | `apps/test-alex-1` |
+| Runtime | `python-fastapi` |
+| Branch model | `dev` → `staging` → `prod` (→ `main` SoR) |
+| Code lives on | `dev` (push to dev triggers build + deploy to dev env) |
+| Protected | `main`, `staging`, `prod` (require PR + passing CI + 1 approval) |
+| Free push | `dev` (inner loop — no PR, no approval required) |
+
+## Promotion flow
+
+Push to `dev` freely. The CI/CD pipeline builds and deploys to the dev
+environment automatically on every commit.
+
+Promotion to higher environments requires a PR — the integration test must
+pass and 1 reviewer must approve before the merge is allowed:
+
+- **dev → staging** — opens a PR; CI gate + 1 approval required
+- **staging → prod** — opens a PR; CI gate + 1 approval required
+
+`main` is the system of record. It contains only workflow files and
+platform metadata. Application code is promoted to it from `prod` via PR.