EduCalxSchool Operations Platform

代課 · 請假 · 課表 — Developer docs and user guide for Hong Kong schools

Developer Guide

Architecture, routes, access control, testing, and monorepo setup for contributors.

EduCalx SaaS target — Supabase, Render API, RBAC tiers, and phased roadmap.

Traditional Chinese guide for teachers, office, principal, and admin roles.

Supabase local setup, launch readiness checklists, and database migrations.

App	Command	Port	Purpose
School app (canonical)	`cd apps/web && pnpm dev`	5173	Teachers, office, principal, admin
Root mirror (legacy)	`npm run dev`	5173	Same UI from root `src/`
Super Admin	`pnpm run dev:super-admin`	5174	Multi-school console + iframe preview
API	`cd apps/api && pnpm dev`	3001	Fastify `/v1/*` (optional for local UI)

Current vs target

The school app runs on in-memory local data by default. Supabase + Render API are the target production stack — see Architecture.