initial commit

Change-Id: I84c73d9fbc3ab907d3b34cf59d343a84723a0d49

docs/index.md

@@ -0,0 +1,45 @@
+# gate-svc-1
+
+Task 14 gate canary - create-microservice scaffolded onto crucible-apps-dev-aks
+
+## Overview
+
+This service was scaffolded from the **Create Microservice** golden-path template on the Kyndryl Platform.
+
+- **Runtime**: `go`
+- **Owner**: group:default/platform-engineering
+- **Deployment profile**: `stateless`
+
+## Architecture
+
+See [architecture.md](architecture.md) for the full architecture diagram.
+
+At a glance:
+
+```
+┌──────────────────────────────────────┐
+│  Gitea Actions CI/CD                 │
+│  ┌─────────────┐  ┌───────────────┐  │
+│  │ build-push  │→ │ deploy-       │  │
+│  │ .yml        │  │ humanitec.yml │  │
+│  └─────────────┘  └───────────────┘  │
+└──────────────────────────────────────┘
+          │                │
+          ▼                ▼
+       Azure ACR     Humanitec API
+                          │
+                          ▼
+                   AKS (via Score)
+                          │
+                          ▼
+              ┌──────────────────────────┐
+              │  gate-svc-1        │
+              │  :8080     │
+              │  /api/items              │
+              │  /health         │
+              └──────────────────────────┘
+```
+
+## API Reference
+
+See [api.md](api.md) for the full OpenAPI reference.