How cristalynllarenas19-oss/mobile-face-verification-and-geotagged-attendance-with-leave-management-system works
This is a mobile face-verification and geotagged attendance system with employee self-service and an administrative portal. Employees authenticate, record attendance using location and face/liveness checks, and manage leave; supervisors review attendance and leave, while administrators manage staff, schedules, reports, and system settings. The web and mobile apps call a NestJS API, whose domain modules implement these capabilities. The README is only a title, so additional capabilities and some client-to-server links are inferred from the source index or left unverified; unsampled backend internals are represented at their existing module directories.
Main entry points: lib/api.ts Web API Client · App.tsx Admin Portal · src/api.ts Mobile API Client · prisma.service.ts Application Database
Components 26
User Applications
- Admin Portal
apps/admin-web/src/app/App.tsx - Mobile App
apps/employee-mobile/App.tsx - Web API Client
apps/admin-web/src/lib/api.ts - Mobile API Client
apps/employee-mobile/src/api.ts
Attendance and Location
- Attendance Portal
apps/admin-web/src/features/attendance/AttendancePage.tsx - Employee Attendance
apps/employee-mobile/src/screens/AttendanceScreen.tsx - Face Registration
apps/admin-web/src/features/face-registration/FaceRegistrationPage.tsx - Attendance API
backend/src/modules/attendance/attendance.controller.ts - Face Verification API
backend/src/modules/face-verification - Face Profiles API
backend/src/modules/face-profiles/face-profiles.controller.ts - Geofencing API
backend/src/modules/geolocation/geolocation.controller.ts
Workforce Administration
- Employee Management
apps/admin-web/src/features/employees/EmployeesPage.tsx - Employees API
backend/src/modules/employees/employees.controller.ts - Schedules API
backend/src/modules/schedules/schedules.controller.ts - Reports API
backend/src/modules/reports - Dashboard API
backend/src/modules/dashboard
Leave and Reviews
- Employee Leave
apps/admin-web/src/features/employee-portal/LeavePage.tsx - Leave Management
apps/admin-web/src/features/leave/LeavePage.tsx - Leave API
backend/src/modules/leave/leave.controller.ts - Regularization Review
apps/employee-mobile/src/screens/supervisor/RegularizationReviewScreen.tsx
Identity and Platform
- Authentication API
backend/src/modules/auth/auth.service.ts - Audit Logging
backend/src/modules/audit-logs/audit-logs.service.ts - Application Database
backend/src/prisma/prisma.service.ts
Other components
- Employee
- Supervisor
- Administrator
Connections 32
- Employee → Mobile App: uses
apps/employee-mobile/App.tsx - Supervisor → Mobile App: uses
apps/employee-mobile/App.tsx - Administrator → Admin Portal: uses
apps/admin-web/src/app/App.tsx - Admin Portal → Attendance Portal: renders
apps/admin-web/src/app/App.tsx - Admin Portal → Employee Management: renders
apps/admin-web/src/app/App.tsx - Admin Portal → Face Registration: renders
apps/admin-web/src/app/App.tsx - Employee → Employee Attendance: records attendance
- Mobile App → Mobile API Client: requests data
apps/employee-mobile/App.tsx - Admin Portal → Web API Client: requests data
apps/admin-web/src/app/App.tsx - Mobile API Client → Attendance API: calls API
- Web API Client → Employees API: calls API
- Attendance API → Application Database: reads and writes
- Employees API → Application Database: reads and writes
- Face Registration → Face Profiles API: manages profiles
- Face Profiles API → Application Database: stores profiles
- Attendance API → Geofencing API: uses geofencing
- Mobile API Client → Face Verification API: calls API
- Mobile API Client → Geofencing API: calls API
- Web API Client → Schedules API: calls API
- Web API Client → Reports API: calls API
- Web API Client → Dashboard API: calls API
- Employee → Employee Leave: requests leave
- Supervisor → Leave Management: reviews leave
- Employee Leave → Mobile API Client: requests data
- Web API Client → Leave API: calls API
- Leave API → Application Database: reads and writes
- Supervisor → Regularization Review: reviews cases
- Web API Client → Authentication API: authenticates
- Authentication API → Application Database: reads and writes
backend/src/modules/auth/auth.service.ts - Authentication API → Audit Logging: records events
backend/src/modules/auth/auth.service.ts - Employees API → Employees API: scopes supervisor access
backend/src/modules/employees/employees.controller.ts - Leave API → Leave API: scopes supervisor access
backend/src/modules/leave/leave.controller.ts