How basharalshameri/rafiq-al-quran-v2 works
Rafiq is an education and Quran-program administration platform, with a web frontend and a TypeScript/Express backend. The principal user workflow is to enter through the web app, navigate role-appropriate administration screens, and use feature APIs to manage organizational and educational records. Backend controllers pass scoped requests to domain services; sampled code confirms this for authentication, exams, finance, golden records, users, and staff operations. The README is empty, and source excerpts are selective, so the graph preserves visible product areas but omits uncertain frontend-to-backend wiring and unsampled persistence links.
Main entry points: useGlobalSearch.ts Global search · exams.controller.ts Exam controller · App.tsx Web app · users.api.ts User API
Components 20
Web application
- Web app
frontend/src/App.tsx - Page router
frontend/src/app/router.tsx - Sign-in UI
frontend/src/features/auth/auth.api.ts - Global search
frontend/src/features/search/useGlobalSearch.ts
Identity and organization
- User API
frontend/src/features/users/users.api.ts - Organization API
frontend/src/features/org/org.api.ts - User controller
backend/src/modules/users/users.controller.ts - User service
backend/src/modules/users/users.service.ts - Authentication service
backend/src/modules/auth/auth.service.ts
Education workflows
- Exam controller
backend/src/modules/exams/exams.controller.ts - Exam service
backend/src/modules/exams/exams.service.ts - Exam workflow
backend/src/modules/exams/exams.workflow.service.ts - Golden records
backend/src/modules/golden-records/golden-records.controller.ts
Finance and operations
- Finance controller
backend/src/modules/finance-v2/finance-v2.controller.ts - Finance services
backend/src/modules/finance-v2/services - Staff operations
backend/src/modules/staff-operations/staff-operations.controller.ts - Attendance services
backend/src/modules/attendance
Backend runtime
- HTTP server
backend/src/app/server.ts - API router
backend/src/app/router.ts
Other components
- Staff user
Connections 13
- Staff user → Web app: uses
- Web app → Page router: renders routes
- Staff user → Sign-in UI: signs in
- Global search → User API: queries people
- Global search → Organization API: queries centers
- User controller → User service: calls
- Authentication service → User API
- Exam controller → Exam service: calls
- Exam controller → Exam workflow: calls
- Golden records → Exam workflow
- Finance controller → Finance services: calls
- Staff operations → Attendance services: calls
- HTTP server → API router: dispatches