System Architecture
Request Flow
API Request (via Core Router)
SSO Flow (Partner → Terang AI)
Docs Auto-Sync Flow
Services Overview
| Service | Domain | Stack | Purpose |
|---|---|---|---|
| Core API Router | api.terang.ai | Hono (Node.js) | Central gateway, SSO, OpenAPI aggregation |
| LMS Service | iai.terang.ai | Next.js 15 | LMS web app + API for IAI |
| Docs | docs.terang.ai | Mintlify | API & integration documentation |
| Future Services | — | TBD | Additional client apps |
Infrastructure
| Component | Technology |
|---|---|
| Orchestration | GKE Autopilot (asia-southeast2) |
| Container Registry | Google Artifact Registry |
| Database | PostgreSQL (Neon Serverless) |
| DNS / SSL | GCP Certificate Manager + Cloud DNS |
| CI/CD | GitHub Actions (Ubicloud runners) |
| Secrets | Google Secret Manager |
| Docs Hosting | Mintlify |