technowebtech/school-managment-saas-project-fe

Purpose and Runtime

This is a Vite-served React single-page frontend for a broad school/institution management platform. It covers operational modules (academics, admissions, finance, HR), public/marketing surfaces, and platform/tenant administration. No backend, database, deployment manifests, or service implementation is present; APIs, sockets, payments, and public endpoints are client integration boundaries.

Paths: src/main.jsx, src/App.jsx, vite.config.js, src/lib/api.js

Application Bootstrap and Route Composition

src/main.jsx mounts the React application. App.jsx is the primary composition and navigation entry point, with route definitions centralized in routes.config.js. Feature directories expose module-level route/page composition through their index.jsx files; this permits one SPA shell to dispatch into a large module catalog.

Paths: src/main.jsx, src/App.jsx, src/routes.config.js

Shell, Navigation, and Cross-Cutting UI

The authenticated application shell is built around Layout.jsx, navigation groups, command palette/search, notifications, and reusable page/form primitives. NavGroups.jsx and searchIndex.js define discoverability metadata independently from feature page implementations. Shared CrudPage, ModulePage, and DynamicForm components provide a common presentation pattern across modules.

Paths: src/components/Layout.jsx, src/data/NavGroups.jsx, src/components/CrudPage.jsx

Session, Authorization, and Global State

React contexts provide app-wide boundaries for authentication, theme, confirmation/prompt modals, loading/preloader state, and notifications. Authentication-aware routing/rendering is supported by auth pages and access-denied UI; user administration and RBAC are separate operational features.

Paths: src/context/AuthContext.jsx, src/components/AccessDenied.jsx, src/features/users/RolePermissions.jsx

Domain Feature Modules

src/features is the principal domain boundary. Most modules are isolated route/page bundles, commonly with dashboards, reports, settings, and transactional workflows. High-detail domains include academics, admissions, accounting, assessment, students, and AI. Their module index.jsx files are the integration seam to the route layer, while feature-specific pages own the workflows.

Paths: src/features/academics/index.jsx, src/features/admission/index.jsx, src/features/accounting/index.jsx

Specialized Interactive Flows

Assessment contains test delivery, paper building, media, proctoring, and exam-security concerns; student pages include profile-specific routing. Public and marketing feature sets form distinct unauthenticated/site-facing surfaces rather than extensions of the administrative shell.

Paths: src/features/assessment/TestRunner.jsx, src/features/assessment/useExamSecurity.js, src/features/publicSite/index.jsx

Multi-Tenant Platform Administration and Integrations

Platform administration models tenant-level controls such as subscriptions, domains, feature flags, branding, localization, limits, clusters, and secrets. Browser-side integration adapters provide API/public API access, WebSocket connectivity, payment-provider definitions, downloads, tenant-subdomain resolution, and master-data/resource hooks. External service contracts are not visible in this repository.

Paths: src/features/platform/PlatformLayout.jsx, src/features/platform/Tenants.jsx, src/lib/socket.js