Ghasi-edTech Developer Portal

Welcome. This portal is the single stop for everything a backend, frontend, DevOps, or integration developer needs. It is generated from the documentation repo, the per-service specs, and the OpenAPI surfaces in this monorepo. Hand-written sections live under _authored/ and the codegen never overwrites them.

Where to start

• First time? Read Prerequisites and Quickstart.
• Working on a service? Browse the Microservice Catalog and pick yours. Each service section embeds its OpenAPI as Swagger UI.
• Integrating from a frontend? Frontend → Design system and Frontend → Client SDK.
• On call? Incident Response Runbook.

Source-of-truth invariants

Every example you see in the portal must:

• Carry Authorization: Bearer <jwt> and X-Tenant-Id (except the small public allow-list).
• Use cursor pagination — never page / offset.
• Show the response envelope { data, meta } and errors as RFC 9457 problem+json.
• Mask PII (emails, tokens, credentials, free-text answers, health data).
• Point at ai-gateway-service for any LLM / embedding / TTS call. Direct provider URLs are forbidden.