# adityajha002/ufas architecture

> Architecture diagram of the GitHub repository adityajha002/ufas, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adityajha002/ufas
- Repository: https://github.com/adityajha002/ufas

## Overview

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: [`admin/webui/src/App.tsx`](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/App.tsx) (Admin console), [`app/src/api/client.ts`](https://github.com/adityajha002/ufas/blob/main/app/src/api/client.ts) (Mobile API client), [`admin/webui/src/api.ts`](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/api.ts) (Admin API client), [`app/src/app/index.tsx`](https://github.com/adityajha002/ufas/blob/main/app/src/app/index.tsx) (Attendance app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Attendance Mobile App"]
  node_mobileapp["Attendance app<br/>[index.tsx]"]
  node_enrollment["Enrollment"]
  node_attendance["Attendance actions"]
  node_inout["In/out actions<br/>[useMarkInOut.ts]"]
  node_outrequest["Out requests<br/>[useRequestOut.ts]"]
  node_history["History and cache<br/>[useHistory.ts]"]
  node_mobileapi["Mobile API client<br/>[client.ts]"]
  node_security["Device signing"]
  node_mobileui["Attendance views"]
end

subgraph group_adminui["Admin Web Console"]
  node_adminapp["Admin console<br/>[App.tsx]"]
  node_adminapi["Admin API client<br/>[api.ts]"]
  node_adminpanels["Management panels"]
  node_adminattendance["Attendance and audit"]
  node_admindialogs["Admin dialogs<br/>[dialogs.tsx]"]
  node_polling["Polling hook<br/>[usePolling.ts]"]
end

subgraph group_adminserver["Admin Server"]
  node_adminhandlers["Admin HTTP handlers<br/>[handlers.go]"]
  node_adminauth["Admin authentication<br/>[auth.go]"]
  node_adminattendancebackend["Attendance administration<br/>[admin_actions.go]"]
  node_adminconfig["Configuration and schedule<br/>[admin_config.go]"]
  node_adminaudit["Audit and exports<br/>[admin_audit.go]"]
  node_admindb[("Admin persistence<br/>[db.go]")]
end

subgraph group_backend["Attendance Server"]
  node_mobilebackend["Attendance HTTP handlers<br/>[handlers.go]"]
  node_schedule["Schedule and schools<br/>[schedule.go]"]
  node_backenddb[("Attendance persistence<br/>[db.go]")]
end

node_staff(("Faculty member"))
node_admin(("Administrator"))

node_staff -->|"uses"| node_mobileapp
node_mobileapp -.->|"opens"| node_enrollment
node_mobileapp -.->|"renders"| node_mobileui
node_enrollment -->|"calls"| node_mobileapi
node_enrollment -->|"uses"| node_security
node_attendance -->|"calls"| node_mobileapi
node_attendance -->|"signs with"| node_security
node_history -->|"calls"| node_mobileapi
node_history -.->|"feeds"| node_mobileui
node_mobileapi -.->|"HTTP requests"| node_mobilebackend
node_admin -->|"uses"| node_adminapp
node_adminapp -->|"calls"| node_adminapi
node_adminapp -->|"polls with"| node_polling
node_adminapp -->|"renders"| node_adminpanels
node_adminapp -->|"opens"| node_admindialogs
node_adminattendance -->|"uses"| node_adminapi
node_adminpanels -->|"uses"| node_adminapi
node_adminapi -.->|"HTTP requests"| node_adminhandlers

click node_mobileapp "https://github.com/adityajha002/ufas/blob/main/app/src/app/index.tsx"
click node_enrollment "https://github.com/adityajha002/ufas/blob/main/app/src/screens/EnrollmentScreen.tsx"
click node_attendance "https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useMarkAttendance.ts"
click node_inout "https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useMarkInOut.ts"
click node_outrequest "https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useRequestOut.ts"
click node_history "https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useHistory.ts"
click node_mobileapi "https://github.com/adityajha002/ufas/blob/main/app/src/api/client.ts"
click node_security "https://github.com/adityajha002/ufas/blob/main/app/src/native/attendanceSecurity.ts"
click node_mobileui "https://github.com/adityajha002/ufas/blob/main/app/src/components/AttendanceHistory.tsx"
click node_adminapp "https://github.com/adityajha002/ufas/blob/main/admin/webui/src/App.tsx"
click node_adminapi "https://github.com/adityajha002/ufas/blob/main/admin/webui/src/api.ts"
click node_adminpanels "https://github.com/adityajha002/ufas/blob/main/admin/webui/src/panels/SuperAdminConsole.tsx"
click node_adminattendance "https://github.com/adityajha002/ufas/blob/main/admin/webui/src/panels/AttendancePanel.tsx"
click node_admindialogs "https://github.com/adityajha002/ufas/blob/main/admin/webui/src/components/dialogs.tsx"
click node_polling "https://github.com/adityajha002/ufas/blob/main/admin/webui/src/hooks/usePolling.ts"
click node_adminhandlers "https://github.com/adityajha002/ufas/blob/main/admin/server/handlers.go"
click node_adminauth "https://github.com/adityajha002/ufas/blob/main/admin/server/auth.go"
click node_adminattendancebackend "https://github.com/adityajha002/ufas/blob/main/admin/server/admin_actions.go"
click node_adminconfig "https://github.com/adityajha002/ufas/blob/main/admin/server/admin_config.go"
click node_adminaudit "https://github.com/adityajha002/ufas/blob/main/admin/server/admin_audit.go"
click node_admindb "https://github.com/adityajha002/ufas/blob/main/admin/server/db.go"
click node_mobilebackend "https://github.com/adityajha002/ufas/blob/main/server/handlers.go"
click node_schedule "https://github.com/adityajha002/ufas/blob/main/server/schedule.go"
click node_backenddb "https://github.com/adityajha002/ufas/blob/main/server/db.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_mobileapp,node_enrollment,node_attendance,node_inout,node_outrequest,node_history,node_mobileapi,node_security,node_mobileui toneBlue
class node_adminapp,node_adminapi,node_adminpanels,node_adminattendance,node_admindialogs,node_polling toneAmber
class node_adminhandlers,node_adminauth,node_adminattendancebackend,node_adminconfig,node_adminaudit,node_admindb toneMint
class node_mobilebackend,node_schedule,node_backenddb toneRose
class node_staff,node_admin toneIndigo
```

## Components

### Attendance Mobile App

- [Attendance app](https://github.com/adityajha002/ufas/blob/main/app/src/app/index.tsx): `app/src/app/index.tsx`
- [Enrollment](https://github.com/adityajha002/ufas/blob/main/app/src/screens/EnrollmentScreen.tsx): `app/src/screens/EnrollmentScreen.tsx`
- [Attendance actions](https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useMarkAttendance.ts): `app/src/hooks/useMarkAttendance.ts`
- [In/out actions](https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useMarkInOut.ts): `app/src/hooks/useMarkInOut.ts`
- [Out requests](https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useRequestOut.ts): `app/src/hooks/useRequestOut.ts`
- [History and cache](https://github.com/adityajha002/ufas/blob/main/app/src/hooks/useHistory.ts): `app/src/hooks/useHistory.ts`
- [Mobile API client](https://github.com/adityajha002/ufas/blob/main/app/src/api/client.ts): `app/src/api/client.ts`
- [Device signing](https://github.com/adityajha002/ufas/blob/main/app/src/native/attendanceSecurity.ts): `app/src/native/attendanceSecurity.ts`
- [Attendance views](https://github.com/adityajha002/ufas/blob/main/app/src/components/AttendanceHistory.tsx): `app/src/components/AttendanceHistory.tsx`

### Admin Web Console

- [Admin console](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/App.tsx): `admin/webui/src/App.tsx`
- [Admin API client](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/api.ts): `admin/webui/src/api.ts`
- [Management panels](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/panels/SuperAdminConsole.tsx): `admin/webui/src/panels/SuperAdminConsole.tsx`
- [Attendance and audit](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/panels/AttendancePanel.tsx): `admin/webui/src/panels/AttendancePanel.tsx`
- [Admin dialogs](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/components/dialogs.tsx): `admin/webui/src/components/dialogs.tsx`
- [Polling hook](https://github.com/adityajha002/ufas/blob/main/admin/webui/src/hooks/usePolling.ts): `admin/webui/src/hooks/usePolling.ts`

### Admin Server

- [Admin HTTP handlers](https://github.com/adityajha002/ufas/blob/main/admin/server/handlers.go): `admin/server/handlers.go`
- [Admin authentication](https://github.com/adityajha002/ufas/blob/main/admin/server/auth.go): `admin/server/auth.go`
- [Attendance administration](https://github.com/adityajha002/ufas/blob/main/admin/server/admin_actions.go): `admin/server/admin_actions.go`
- [Configuration and schedule](https://github.com/adityajha002/ufas/blob/main/admin/server/admin_config.go): `admin/server/admin_config.go`
- [Audit and exports](https://github.com/adityajha002/ufas/blob/main/admin/server/admin_audit.go): `admin/server/admin_audit.go`
- [Admin persistence](https://github.com/adityajha002/ufas/blob/main/admin/server/db.go): `admin/server/db.go`

### Attendance Server

- [Attendance HTTP handlers](https://github.com/adityajha002/ufas/blob/main/server/handlers.go): `server/handlers.go`
- [Schedule and schools](https://github.com/adityajha002/ufas/blob/main/server/schedule.go): `server/schedule.go`
- [Attendance persistence](https://github.com/adityajha002/ufas/blob/main/server/db.go): `server/db.go`

### Other components

- **Faculty member**
- **Administrator**

## Connections

- Faculty member → Attendance app: uses
- Attendance app → Enrollment: opens
- Attendance app → Attendance views: renders
- Enrollment → Mobile API client: calls (evidence: `app/src/screens/EnrollmentScreen.tsx`)
- Enrollment → Device signing: uses (evidence: `app/src/screens/EnrollmentScreen.tsx`)
- Attendance actions → Mobile API client: calls (evidence: `app/src/hooks/useMarkAttendance.ts`)
- Attendance actions → Device signing: signs with (evidence: `app/src/hooks/useMarkAttendance.ts`)
- History and cache → Mobile API client: calls (evidence: `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 (evidence: `admin/webui/src/App.tsx`)
- Admin console → Polling hook: polls with (evidence: `admin/webui/src/App.tsx`)
- Admin console → Management panels: renders (evidence: `admin/webui/src/App.tsx`)
- Admin console → Admin dialogs: opens (evidence: `admin/webui/src/App.tsx`)
- Attendance and audit → Admin API client: uses
- Management panels → Admin API client: uses (evidence: `admin/webui/src/panels/SuperAdminConsole.tsx`)
- Admin API client → Admin HTTP handlers: HTTP requests
