How earsokchan/school-management-system-dynamic-school-website works
HSKTH is a bilingual school website and management platform. Visitors browse localized school pages and public information, while administrators sign in to edit content and manage academic records; changes flow through server actions or API routes to MongoDB, with uploads stored in Vercel Blob. The graph retains public news/events and results, admin operations, authentication, localization, and persistence. Public page loading and several unsampled admin/API connections are documented at subsystem level; those links are dashed where source excerpts do not establish the exact caller.
Main entry points: actions.ts Server actions · [lang] Localized pages · admin Admin pages · admin-auth.ts Session security
Components 26
Public website
- Localized pages
src/app/[lang] - Website sections
src/components/home - Site navigation
src/components/layout - Site search
src/components/layout/SearchOverlay.tsx - News and events
src/data/news.ts - Student results
src/data/results.ts
Admin management
- Admin pages
src/app/admin - Admin workspace
src/components/admin/AdminShell.tsx - Content managers
src/components/admin/NewsManager.tsx - School records
src/components/admin/StudentManager.tsx - Collection client
src/hooks/use-collection.ts
Server services
- Localization
src/lib/i18n.ts - Login and sessions
src/app/api/auth/login/route.ts - Session security
src/lib/server/admin-auth.ts - Content API
src/app/api/content/[collection]/route.ts - Page content APIs
src/app/api/academics-content/route.ts - Server actions
src/lib/server/actions.ts - Content validation
src/lib/server/content-validation.ts - Image storage
src/lib/server/blob.ts - Content seeding
src/lib/server/seed.ts
Content and storage
- Collection access
src/lib/server/collections.ts - MongoDB client
src/lib/server/mongodb.ts - MongoDB
- Vercel Blob
Other components
- School visitor
- Administrator
Connections 32
- School visitor → Localized pages: browses
- Localized pages → Website sections: renders
- Localized pages → Localization: localizes
- Localized pages → Site navigation: uses layout
- Website sections → News and events: displays
- Website sections → Student results: displays
- Site search → News and events: searches
src/components/layout/SearchOverlay.tsx - Site search → Localization: localizes
src/components/layout/SearchOverlay.tsx - Administrator → Login and sessions: signs in
- Login and sessions → Session security: validates credentials
src/app/api/auth/login/route.ts - Administrator → Admin pages: manages
- Admin pages → Admin workspace: uses workspace
- Admin workspace → Localization: sets locale
src/components/admin/AdminShell.tsx - Admin pages → Content managers: hosts editors
- Admin pages → School records: hosts managers
- Content managers → Collection client: edits collections
src/components/admin/NewsManager.tsx - School records → Collection client: manages records
- Collection client → Server actions: calls actions
src/hooks/use-collection.ts - Server actions → Session security: checks session
src/lib/server/actions.ts - Server actions → Content validation: validates data
src/lib/server/actions.ts - Server actions → Collection access: reads and writes
src/lib/server/actions.ts - Content API → Session security: requires admin
src/app/api/content/[collection]/route.ts - Content API → Content validation: validates payload
src/app/api/content/[collection]/route.ts - Content API → Collection access: accesses data
src/app/api/content/[collection]/route.ts - Page content APIs → Session security: requires admin
src/app/api/academics-content/route.ts - Page content APIs → MongoDB client: reads and writes
src/app/api/academics-content/route.ts - Collection access → MongoDB client: uses client
src/lib/server/collections.ts - MongoDB client → MongoDB: connects
- Content managers → Image storage: uploads images
src/components/admin/NewsManager.tsx - Image storage → Vercel Blob: stores files
- Server actions → Image storage: uploads images
src/lib/server/actions.ts - Server actions → Content seeding: seeds content
src/lib/server/actions.ts