# bajrangi-it/attendify architecture

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

- Interactive diagram: https://gitdiagram.com/bajrangi-it/attendify
- Repository: https://github.com/bajrangi-it/attendify

## Overview

CampusAttend OS is a role-based college attendance and institutional operations platform. Faculty launch live sessions and students check in; the system records attendance for student history, faculty monitoring, reports, and institutional oversight. The product spans the web portal, mobile app, classroom kiosk, attendance API, QR/security functions, and Supabase data services. The README documents capabilities beyond the sampled source, including role-specific administration, dynamic QR rotation, audit controls, and asynchronous reporting; edges for those documented flows cite the README where implementation wiring was not shown.

Main entry points: [`apps/college-web/src/lib/supabase.ts`](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/lib/supabase.ts) (Supabase Services), [`apps/college-web/src/App.tsx`](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/App.tsx) (College Portal), [`apps/attendance-engine/src/server.ts`](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/server.ts) (Engine API), [`apps/attendance-engine/src/services/reportQueue.ts`](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/reportQueue.ts) (Async Reporting)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["User Applications"]
  node_web["College Portal<br/>[App.tsx]"]
  node_web_auth["Web Authentication<br/>[AuthContext.tsx]"]
  node_live_session["Live Session Console"]
  node_timetable["Timetable Management"]
  node_governance["Governance Views"]
  node_web_student["Student Portal"]
  node_mobile["Universal Mobile App<br/>[App.tsx]"]
  node_mobile_auth["Mobile Authentication<br/>[AuthContext.tsx]"]
  node_mobile_scan["Mobile QR Check-in"]
  node_mobile_faculty["Mobile Faculty Console"]
  node_kiosk["Smart Display Kiosk<br/>[App.tsx]"]
end

subgraph group_engine["Attendance Engine"]
  node_api["Engine API<br/>[server.ts]"]
  node_authz["API Authentication<br/>[authMiddleware.ts]"]
  node_sessions["Session Services<br/>[sessionService.ts]"]
  node_display_service["Display Services<br/>[displayService.ts]"]
  node_attendance["Attendance Processing"]
  node_reporting["Async Reporting<br/>[reportQueue.ts]"]
  node_audit["Audit Services<br/>[auditService.ts]"]
  node_report_generator["Report Generation<br/>[reportGenerator.ts]"]
end

subgraph group_security["QR Security"]
  node_sdk["Attendance SDK<br/>[client.ts]"]
  node_qr_token["QR Token Issuance<br/>[index.ts]"]
  node_qr_verify["QR Attendance Verification<br/>[index.ts]"]
end

subgraph group_data["Platform Data"]
  node_supabase[("Supabase Services<br/>[supabase.ts]")]
  node_redis[("Redis Cache<br/>[cache.ts]")]
end

node_faculty(("Faculty"))
node_students(("Students"))
node_admins(("Institutional Staff"))

node_faculty -->|"runs sessions"| node_live_session
node_students -->|"scan QR"| node_mobile_scan
node_admins -->|"manage institution"| node_governance
node_web -->|"uses auth"| node_web_auth
node_web -->|"routes to"| node_live_session
node_web -->|"routes to"| node_timetable
node_web -->|"routes to"| node_governance
node_web -->|"routes to"| node_web_student
node_web_auth -->|"authenticates via"| node_supabase
node_live_session -->|"reads and writes"| node_supabase
node_timetable -->|"reads and writes"| node_supabase
node_mobile -->|"uses auth"| node_mobile_auth
node_mobile -->|"routes to"| node_mobile_scan
node_mobile -->|"routes to"| node_mobile_faculty
node_mobile_auth -->|"loads profiles"| node_supabase
node_mobile_faculty -->|"reads attendance"| node_supabase
node_kiosk -.->|"rotates codes"| node_qr_token
node_kiosk -.->|"requests display data"| node_display_service
node_api -->|"mounts session routes"| node_sessions
node_api -->|"mounts attendance routes"| node_attendance
node_api -->|"mounts display routes"| node_display_service
node_api -->|"mounts report routes"| node_reporting
node_api -.->|"uses authentication"| node_authz
node_sessions -->|"reads sessions"| node_supabase
node_sessions -->|"uses cache"| node_redis
node_display_service -->|"reads display data"| node_supabase
node_attendance -.->|"records check-ins"| node_supabase
node_attendance -.->|"checks rate limits"| node_redis
node_reporting -.->|"queues generation"| node_report_generator
node_reporting -->|"tracks reports"| node_supabase
node_reporting -->|"audits requests"| node_audit
node_qr_token -.->|"issues HMAC tokens"| node_sdk
node_qr_verify -.->|"verifies check-in"| node_attendance
node_sdk -.->|"supports drift verification"| node_qr_verify
node_supabase -.->|"stores canonical records"| node_students

click node_web "https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/App.tsx"
click node_web_auth "https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/context/AuthContext.tsx"
click node_live_session "https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/views/teacher/LiveSessionManager.tsx"
click node_timetable "https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/views/timetable/TimetableManager.tsx"
click node_governance "https://github.com/bajrangi-it/attendify/tree/main/apps/college-web/src/views/director"
click node_web_student "https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/views/student/StudentDashboard.tsx"
click node_mobile "https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/App.tsx"
click node_mobile_auth "https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/src/context/AuthContext.tsx"
click node_mobile_scan "https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/src/views/student/StudentScannerScreen.tsx"
click node_mobile_faculty "https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/src/views/faculty/FacultyLiveSessionScreen.tsx"
click node_kiosk "https://github.com/bajrangi-it/attendify/blob/main/apps/smart-display/src/App.tsx"
click node_api "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/server.ts"
click node_authz "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/middleware/authMiddleware.ts"
click node_sessions "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/sessionService.ts"
click node_display_service "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/displayService.ts"
click node_attendance "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/attendanceService.ts"
click node_reporting "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/reportQueue.ts"
click node_audit "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/auditService.ts"
click node_sdk "https://github.com/bajrangi-it/attendify/blob/main/packages/attendance-sdk/src/client.ts"
click node_qr_token "https://github.com/bajrangi-it/attendify/blob/main/supabase/functions/session-qr-token/index.ts"
click node_qr_verify "https://github.com/bajrangi-it/attendify/blob/main/supabase/functions/verify-qr-attendance/index.ts"
click node_supabase "https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/lib/supabase.ts"
click node_redis "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/redis/cache.ts"
click node_report_generator "https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/reportGenerator.ts"

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_web,node_web_auth,node_live_session,node_timetable,node_governance,node_web_student,node_mobile,node_mobile_auth,node_mobile_scan,node_mobile_faculty,node_kiosk toneBlue
class node_api,node_authz,node_sessions,node_display_service,node_attendance,node_reporting,node_audit,node_report_generator toneAmber
class node_sdk,node_qr_token,node_qr_verify toneMint
class node_supabase,node_redis toneRose
class node_faculty,node_students,node_admins toneIndigo
```

## Components

### User Applications

- [College Portal](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/App.tsx): `apps/college-web/src/App.tsx`
- [Web Authentication](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/context/AuthContext.tsx): `apps/college-web/src/context/AuthContext.tsx`
- [Live Session Console](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/views/teacher/LiveSessionManager.tsx): `apps/college-web/src/views/teacher/LiveSessionManager.tsx`
- [Timetable Management](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/views/timetable/TimetableManager.tsx): `apps/college-web/src/views/timetable/TimetableManager.tsx`
- [Governance Views](https://github.com/bajrangi-it/attendify/tree/main/apps/college-web/src/views/director): `apps/college-web/src/views/director`
- [Student Portal](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/views/student/StudentDashboard.tsx): `apps/college-web/src/views/student/StudentDashboard.tsx`
- [Universal Mobile App](https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/App.tsx): `apps/student-mobile/App.tsx`
- [Mobile Authentication](https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/src/context/AuthContext.tsx): `apps/student-mobile/src/context/AuthContext.tsx`
- [Mobile QR Check-in](https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/src/views/student/StudentScannerScreen.tsx): `apps/student-mobile/src/views/student/StudentScannerScreen.tsx`
- [Mobile Faculty Console](https://github.com/bajrangi-it/attendify/blob/main/apps/student-mobile/src/views/faculty/FacultyLiveSessionScreen.tsx): `apps/student-mobile/src/views/faculty/FacultyLiveSessionScreen.tsx`
- [Smart Display Kiosk](https://github.com/bajrangi-it/attendify/blob/main/apps/smart-display/src/App.tsx): `apps/smart-display/src/App.tsx`

### Attendance Engine

- [Engine API](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/server.ts): `apps/attendance-engine/src/server.ts`
- [API Authentication](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/middleware/authMiddleware.ts): `apps/attendance-engine/src/middleware/authMiddleware.ts`
- [Session Services](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/sessionService.ts): `apps/attendance-engine/src/services/sessionService.ts`
- [Display Services](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/displayService.ts): `apps/attendance-engine/src/services/displayService.ts`
- [Attendance Processing](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/attendanceService.ts): `apps/attendance-engine/src/services/attendanceService.ts`
- [Async Reporting](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/reportQueue.ts): `apps/attendance-engine/src/services/reportQueue.ts`
- [Audit Services](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/auditService.ts): `apps/attendance-engine/src/services/auditService.ts`
- [Report Generation](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/services/reportGenerator.ts): `apps/attendance-engine/src/services/reportGenerator.ts`

### QR Security

- [Attendance SDK](https://github.com/bajrangi-it/attendify/blob/main/packages/attendance-sdk/src/client.ts): `packages/attendance-sdk/src/client.ts`
- [QR Token Issuance](https://github.com/bajrangi-it/attendify/blob/main/supabase/functions/session-qr-token/index.ts): `supabase/functions/session-qr-token/index.ts`
- [QR Attendance Verification](https://github.com/bajrangi-it/attendify/blob/main/supabase/functions/verify-qr-attendance/index.ts): `supabase/functions/verify-qr-attendance/index.ts`

### Platform Data

- [Supabase Services](https://github.com/bajrangi-it/attendify/blob/main/apps/college-web/src/lib/supabase.ts): `apps/college-web/src/lib/supabase.ts`
- [Redis Cache](https://github.com/bajrangi-it/attendify/blob/main/apps/attendance-engine/src/redis/cache.ts): `apps/attendance-engine/src/redis/cache.ts`

### Other components

- **Faculty**
- **Students**
- **Institutional Staff**

## Connections

- Faculty → Live Session Console: runs sessions
- Students → Mobile QR Check-in: scan QR
- Institutional Staff → Governance Views: manage institution
- College Portal → Web Authentication: uses auth (evidence: `apps/college-web/src/App.tsx`)
- College Portal → Live Session Console: routes to (evidence: `apps/college-web/src/App.tsx`)
- College Portal → Timetable Management: routes to (evidence: `apps/college-web/src/App.tsx`)
- College Portal → Governance Views: routes to (evidence: `apps/college-web/src/App.tsx`)
- College Portal → Student Portal: routes to (evidence: `apps/college-web/src/App.tsx`)
- Web Authentication → Supabase Services: authenticates via (evidence: `apps/college-web/src/context/AuthContext.tsx`)
- Live Session Console → Supabase Services: reads and writes (evidence: `apps/college-web/src/views/teacher/LiveSessionManager.tsx`)
- Timetable Management → Supabase Services: reads and writes (evidence: `apps/college-web/src/views/timetable/TimetableManager.tsx`)
- Universal Mobile App → Mobile Authentication: uses auth (evidence: `apps/student-mobile/App.tsx`)
- Universal Mobile App → Mobile QR Check-in: routes to (evidence: `apps/student-mobile/App.tsx`)
- Universal Mobile App → Mobile Faculty Console: routes to (evidence: `apps/student-mobile/App.tsx`)
- Mobile Authentication → Supabase Services: loads profiles (evidence: `apps/student-mobile/src/context/AuthContext.tsx`)
- Mobile Faculty Console → Supabase Services: reads attendance (evidence: `apps/student-mobile/src/views/faculty/FacultyLiveSessionScreen.tsx`)
- Smart Display Kiosk → QR Token Issuance: rotates codes
- Smart Display Kiosk → Display Services: requests display data
- Engine API → Session Services: mounts session routes (evidence: `apps/attendance-engine/src/server.ts`)
- Engine API → Attendance Processing: mounts attendance routes (evidence: `apps/attendance-engine/src/server.ts`)
- Engine API → Display Services: mounts display routes (evidence: `apps/attendance-engine/src/server.ts`)
- Engine API → Async Reporting: mounts report routes (evidence: `apps/attendance-engine/src/server.ts`)
- Engine API → API Authentication: uses authentication
- Session Services → Supabase Services: reads sessions (evidence: `apps/attendance-engine/src/services/sessionService.ts`)
- Session Services → Redis Cache: uses cache (evidence: `apps/attendance-engine/src/services/sessionService.ts`)
- Display Services → Supabase Services: reads display data (evidence: `apps/attendance-engine/src/services/displayService.ts`)
- Attendance Processing → Supabase Services: records check-ins
- Attendance Processing → Redis Cache: checks rate limits
- Async Reporting → Report Generation: queues generation
- Async Reporting → Supabase Services: tracks reports
- Async Reporting → Audit Services: audits requests (evidence: `apps/attendance-engine/src/routes/reportRoutes.ts`)
- QR Token Issuance → Attendance SDK: issues HMAC tokens
- QR Attendance Verification → Attendance Processing: verifies check-in
- Attendance SDK → QR Attendance Verification: supports drift verification
- Supabase Services → Students: stores canonical records
