How thienbaovoquang-hub/vschool works
SchoolHub is a school-management application presented as a desktop workspace. A user signs in, opens role-allowed apps and tabs, manages school records, and can import/export data or synchronize with cloud services. The source index documents administration, student and staff management, learning, library, communications, facilities, student services, analytics, and emulation capabilities. Several app implementations were not sampled, so their subsystem nodes are included but their internal call paths are not inferred.
Main entry points: appRegistry.ts App registry · App.tsx App coordinator · ExcelImportDialog.tsx Spreadsheet import · services.ts Cloud data services
Components 27
Desktop workspace
- App coordinator
src/App.tsx - Sign-in screen
src/components/auth/LoginScreen.tsx - Window manager hook
src/hooks/useWindowManager.ts - Window manager
src/components/desktop/WindowManager.tsx - App registry
src/data/appRegistry.ts
School operations
- Administration
src/components/apps/AdministrationApp.tsx - School management
src/components/apps/SchoolManagementApp.tsx - Learning and timetable
src/components/apps/LearningApp.tsx - Library services
src/components/apps/LibraryApp.tsx - Student services
src/components/apps/StudentServicesApp.tsx - Communications
src/components/apps/CommunicationApp.tsx - Facilities
src/components/apps/FacilitiesApp.tsx - Analytics and AI
src/components/apps/AnalyticsAIApp.tsx - Emulation and competitions
src/components/emulation/EmulationHubView.tsx
Data and access
- Role permissions
src/utils/rbac.ts - Data catalogs
src/utils/catalogs/catalogRegistry.ts - Sync and conflict logic
src/utils/syncEngine.ts - Module data actions
src/components/importExport/ModuleDataActions.tsx - Spreadsheet import
src/components/importExport/ExcelImportDialog.tsx - Import validation
src/utils/importExport/validator.ts - Spreadsheet engine
src/utils/importExport/excelEngine.ts
Cloud integrations
- Cloud data services
src/firebase/services.ts - Firebase configuration
src/firebase/config.ts - Google Workspace auth
src/services/googleAuth.ts - Google sync routes
src/server/googleRoutes.ts - Application server
server.ts
Other components
- School user
Connections 29
- School user → App coordinator: uses
src/App.tsx - App coordinator → Sign-in screen: renders
src/App.tsx - App coordinator → Window manager hook: manages windows
src/App.tsx - App coordinator → Role permissions: checks access
src/App.tsx - App coordinator → Sync and conflict logic: uses sync logic
src/App.tsx - App coordinator → Cloud data services: writes cloud data
src/App.tsx - App coordinator → Google Workspace auth: disconnects account
src/App.tsx - Window manager hook → App registry: resolves app metadata
src/hooks/useWindowManager.ts - Window manager → App registry: reads app metadata
src/components/desktop/WindowManager.tsx - Window manager → Window manager hook: renders managed windows
src/components/desktop/WindowManager.tsx - App registry → Administration: registers app
- App registry → School management: registers app
- App registry → Learning and timetable: registers app
- App registry → Library services: registers app
- App registry → Student services: registers app
- App registry → Communications: registers app
- App registry → Facilities: registers app
- App registry → Analytics and AI: registers app
- App registry → Emulation and competitions: registers app
- Student services → Role permissions: filters leave requests
src/components/apps/StudentServicesApp.tsx - Module data actions → Spreadsheet import: opens import
src/components/importExport/ModuleDataActions.tsx - Spreadsheet import → Import validation: validates rows
src/components/importExport/ExcelImportDialog.tsx - Spreadsheet import → Spreadsheet engine: parses spreadsheet
src/components/importExport/ExcelImportDialog.tsx - Import validation → Data catalogs: resolves catalog values
src/utils/importExport/validator.ts - Spreadsheet engine → Data catalogs: builds catalog lists
src/utils/importExport/excelEngine.ts - Cloud data services → Firebase configuration: uses configuration
src/firebase/services.ts - Cloud data services → Sync and conflict logic: uses sync logic
src/firebase/services.ts - Google Workspace auth → Firebase configuration: uses configuration
src/services/googleAuth.ts - Application server → Google sync routes: mounts routes
server.ts