Ghasi-edTech

Developer reference

Welcome. This is the developer reference for the Ghasi-EdTech enterprise learning platform - covering every service, API, event schema, data model, and integration pattern you need to build on or integrate with the platform.

Where to start

• First time? Read Prerequisites and Local stack & dev setup to get your dev environment running.
• Building an integration? Jump to the Quickstart for your first authenticated API call in minutes.
• Working on a service? Browse the Microservice Catalog and pick yours. Each service section embeds its OpenAPI as Swagger UI.
• Frontend work? See Design System and Client SDK.
• On call? Incident Response Runbook.

API conventions

Every request and response in this platform follows these rules:

• All tenant-scoped endpoints require Authorization: Bearer <jwt> and X-Tenant-Id.
• Pagination is cursor-based - never page / offset.
• Successful responses use the { data, meta } envelope; errors use RFC 9457 problem+json.
• PII (emails, tokens, credentials, free-text answers, health data) is never logged or exposed in responses.
• All AI/LLM calls route through ai-gateway-service. Direct provider URLs are not available to consumers.