initial commit

Change-Id: Ie217b81d147f0eef5dcd2bf9285bc1e51bcf0d0b

docs/architecture.md

@@ -0,0 +1,30 @@
+# Architecture
+
+`sonar-test-nest2` is a `typescript-nestjs` service.
+
+| Component | Detail |
+|-----------|--------|
+| Runtime | `typescript-nestjs` |
+| Container port | `3000` |
+| Health check | `/health` |
+| Metrics | `/metrics` (Prometheus format) |
+| Image | Azure Container Registry (`bstagecjotdevacr`) |
+
+## Deployment flow
+
+```
+Push to dev/staging/prod
+  → build-push.yml  (build + test → push image to ACR)
+  → deploy-humanitec.yml (hctl score deploy)
+```
+
+## Branch model
+
+| Branch | Purpose |
+|--------|---------|
+| `main` | System of record — catalog, docs, score.yaml, platform config |
+| `dev` | Active development |
+| `staging` | Pre-production (lazy-created on first promote) |
+| `prod` | Production (lazy-created on first promote) |
+
+Promotions between environments are triggered from the Backstage CI/CD tab.