Docs/SaaS + API

SaaS / Multi-Academy + Mobile API

LearnX AI is prepared for a SaaS buyer: separate tenant database foundation, package limits, user/course/student/storage/AI/API limits, tenant health, billing placeholder, AI usage dashboards, and Sanctum-based REST API readiness for future Flutter/mobile apps.

SaaS tenants — SaaS tenant console with packages, limits, health, usage, and billing placeholders.

API docs for tenant-aware mobile auth and LMS endpoints.

SaaS Foundation

Central records store tenants, domains, packages, subscriptions, billing placeholders, usage snapshots, health snapshots, and Super Admin users.
Tenant records store academy LMS data while existing academy_id remains a compatibility guard.
Limits warn at 80 and 95 percent and hard-block when configured, unless Super Admin override exists.
Health checks cover database, migrations, seeders, roles, storage, AI settings, limits, and domain verification.

API Readiness

Area	Endpoints	Purpose
Auth	`/api/v1/auth/login`, `/api/v1/me`, logout routes	Sanctum bearer tokens with abilities and tenant resolver.
Student	`/api/v1/student/*`	Dashboard, courses, player payload, progress, quiz, assignment, tutor, certificates.
Instructor	`/api/v1/instructor/*`	Teacher dashboard, courses, roster, grading, attempts, Q&A, earnings.
Academy	`/api/v1/academy/*`	Admin summaries, reports, certificates, commerce, package usage.

Demo And Developer Notes

Buyer exampleOpen SaaS tenants, inspect package limits and health, then open API docs to show tenant-aware mobile login.

Developer noteGuided anchors include saas-console, saas-kpis, saas-package-mix, saas-health-feed, and api-docs-workspace. Mobile APIs resolve tenants by domain or academy code.

Tenant health shows package and setup state.
Limits warn/block as configured.
API docs expose examples.
Tenant A data cannot leak to Tenant B.