26 lines
995 B
Markdown
26 lines
995 B
Markdown
# Platform Initialization
|
|
|
|
| Field | Value |
|
|
|-------|-------|
|
|
| Component | `alex-1` |
|
|
| Repository | `apps/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.
|