How adityajha002/ufas works
The repository contains a staff attendance mobile app, an administrative web console, and Go server code. The user workflow is enrollment, attendance actions, and viewing attendance history; administrators manage staff, schedules, configuration, audit records, and exports. Mobile hook-to-client and UI-to-API relationships are supported by the source index or excerpts. Server internals and several domain integrations are represented by their source paths, but links to them are omitted where the supplied evidence does not establish the calls.
Main entry points: App.tsx Admin console · client.ts Mobile API client · api.ts Admin API client · index.tsx Attendance app
Components 26
Attendance Mobile App
- Attendance app
app/src/app/index.tsx - Enrollment
app/src/screens/EnrollmentScreen.tsx - Attendance actions
app/src/hooks/useMarkAttendance.ts - In/out actions
app/src/hooks/useMarkInOut.ts - Out requests
app/src/hooks/useRequestOut.ts - History and cache
app/src/hooks/useHistory.ts - Mobile API client
app/src/api/client.ts - Device signing
app/src/native/attendanceSecurity.ts - Attendance views
app/src/components/AttendanceHistory.tsx
Admin Web Console
- Admin console
admin/webui/src/App.tsx - Admin API client
admin/webui/src/api.ts - Management panels
admin/webui/src/panels/SuperAdminConsole.tsx - Attendance and audit
admin/webui/src/panels/AttendancePanel.tsx - Admin dialogs
admin/webui/src/components/dialogs.tsx - Polling hook
admin/webui/src/hooks/usePolling.ts
Admin Server
- Admin HTTP handlers
admin/server/handlers.go - Admin authentication
admin/server/auth.go - Attendance administration
admin/server/admin_actions.go - Configuration and schedule
admin/server/admin_config.go - Audit and exports
admin/server/admin_audit.go - Admin persistence
admin/server/db.go
Attendance Server
- Attendance HTTP handlers
server/handlers.go - Schedule and schools
server/schedule.go - Attendance persistence
server/db.go
Other components
- Faculty member
- Administrator
Connections 18
- Faculty member → Attendance app: uses
- Attendance app → Enrollment: opens
- Attendance app → Attendance views: renders
- Enrollment → Mobile API client: calls
app/src/screens/EnrollmentScreen.tsx - Enrollment → Device signing: uses
app/src/screens/EnrollmentScreen.tsx - Attendance actions → Mobile API client: calls
app/src/hooks/useMarkAttendance.ts - Attendance actions → Device signing: signs with
app/src/hooks/useMarkAttendance.ts - History and cache → Mobile API client: calls
app/src/hooks/useHistory.ts - History and cache → Attendance views: feeds
- Mobile API client → Attendance HTTP handlers: HTTP requests
- Administrator → Admin console: uses
- Admin console → Admin API client: calls
admin/webui/src/App.tsx - Admin console → Polling hook: polls with
admin/webui/src/App.tsx - Admin console → Management panels: renders
admin/webui/src/App.tsx - Admin console → Admin dialogs: opens
admin/webui/src/App.tsx - Attendance and audit → Admin API client: uses
- Management panels → Admin API client: uses
admin/webui/src/panels/SuperAdminConsole.tsx - Admin API client → Admin HTTP handlers: HTTP requests