How marco-sawiris/st.gorge-dashboard works
This is an Arabic-language student and attendance management application, with a web UI and Android wrapper. Staff use the dashboard to browse and filter students, record attendance and follow-ups, import attendance from PDFs, and synchronize changes with Google Sheets; offline changes are queued locally for later reconciliation. The server adds authenticated access and a Sheets relay. Assistant, charts, and notifications are additional product capabilities. The README is empty, so capability coverage comes from the tree and source index; links to unsampled features are omitted where their wiring is not evidenced.
Main entry points: App.tsx Dashboard shell · AppContext.tsx Application state · auth.ts Authentication routes · index.ts User and session store
Components 25
Dashboard
- Dashboard shell
src/App.tsx - Student views
src/components/cards/StudentCard.tsx - Search and filters
src/components/common/SearchFilterBar.tsx - Dashboard charts
src/components/charts/DashboardChartsView.tsx - Follow-up log
src/components/followup/FollowupLogView.tsx
Student Workflows
- Assistant engine
src/services/assistantEngine.ts - Attendance import UI
src/components/modals/PdfAttendanceImportModal.tsx - PDF import processing
src/services/pdfAttendanceImportService.ts - PDF attendance parser
src/services/pdfAttendanceParser.ts
Offline and Sync
- Application state
src/context/AppContext.tsx - Local records and queue
src/services/indexedDbService.ts - Sheet data parser
src/services/googleSheetParser.ts - API configuration
src/services/apiConfig.ts
Server and Integrations
- HTTP server
server.ts - Sheets routes
server/routes/sheets.ts - Health route
server/routes/health.ts - Google Sheets service
server/services/googleSheetsService.ts - PostgreSQL
Identity and Security
- Authentication routes
server/routes/auth.ts - User and session store
server/db/index.ts - Token middleware
server/middleware/auth.ts - JWT security
server/security/jwt.ts - Password hashing
server/security/argon2.ts
Other components
- Staff user
- Google Sheets
Connections 35
- Staff user → Dashboard shell: uses
- Dashboard shell → Student views: renders
src/App.tsx - Dashboard shell → Search and filters: renders
src/App.tsx - Dashboard shell → Dashboard charts: renders
src/App.tsx - Dashboard shell → Follow-up log: renders
src/App.tsx - Dashboard shell → Application state: reads state
src/App.tsx - Dashboard shell → Assistant engine: opens assistant
- Dashboard shell → Attendance import UI: renders
src/App.tsx - Attendance import UI → PDF attendance parser: uses
src/components/modals/PdfAttendanceImportModal.tsx - Attendance import UI → PDF import processing: uses
src/components/modals/PdfAttendanceImportModal.tsx - Attendance import UI → Local records and queue: reads and writes
src/components/modals/PdfAttendanceImportModal.tsx - PDF import processing → PDF attendance parser: parses with
src/services/pdfAttendanceImportService.ts - PDF import processing → Local records and queue: uses
src/services/pdfAttendanceImportService.ts - Application state → Local records and queue: reads and writes
src/context/AppContext.tsx - Application state → Sheet data parser: loads sheets
src/context/AppContext.tsx - Application state → PDF import processing: uses
src/context/AppContext.tsx - Application state → API configuration: uses
src/context/AppContext.tsx - API configuration → HTTP server: configures requests
- HTTP server → Authentication routes: registers
server.ts - HTTP server → Sheets routes: registers
server.ts - HTTP server → Health route: registers
server.ts - Authentication routes → User and session store: reads and writes
server/routes/auth.ts - Authentication routes → Password hashing: verifies password
server/routes/auth.ts - Authentication routes → JWT security: verifies tokens
server/routes/auth.ts - Authentication routes → Token middleware: uses
server/routes/auth.ts - Token middleware → JWT security: verifies tokens
server/middleware/auth.ts - User and session store → Password hashing: hashes seeded passwords
server/db/index.ts - User and session store → PostgreSQL: persists records
server/db/index.ts - Sheets routes → Token middleware: protects routes
server/routes/sheets.ts - Sheets routes → User and session store: uses
server/routes/sheets.ts - Sheets routes → Google Sheets service: requests sheet data
server/routes/sheets.ts - Health route → User and session store: checks storage
server/routes/health.ts - Health route → Google Sheets service: checks Sheets
server/routes/health.ts - Google Sheets service → Sheet data parser: parses rows
server/services/googleSheetsService.ts - Google Sheets service → Google Sheets: reads and writes
server/services/googleSheetsService.ts