# ramitsarker29/attendance-check-karo architecture

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

- Interactive diagram: https://gitdiagram.com/ramitsarker29/attendance-check-karo
- Repository: https://github.com/ramitsarker29/attendance-check-karo

## Overview

Attendance Check karo is a student attendance web app for maintaining subjects and timetables, recording class outcomes, evaluating target and bunk limits, and simulating leave with recovery guidance. The UI is routed through App; authenticated views and account actions share AppContext, which owns workspace state and persistence. Calculations power dashboard and simulation insights, while routine, subject, semester, and history views handle distinct student tasks. The README documents backup/export and offline operation. Some feature modules were not sampled in full, so their links are limited to indexed references or documented behavior.

Main entry points: [`src/context/AppContext.tsx`](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/context/AppContext.tsx) (Workspace State), [`src/App.tsx`](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/App.tsx) (App Router), [`src/utils/calculations.ts`](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/utils/calculations.ts) (Attendance Calculations), [`src/components/AuthModal.tsx`](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/AuthModal.tsx) (Account Access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application Entry"]
  node_app["App Router<br/>[App.tsx]"]
end

subgraph group_student_views["Student Views"]
  node_auth["Account Access<br/>[AuthModal.tsx]"]
  node_welcome["Welcome View<br/>[WelcomeView.tsx]"]
  node_navbar["Navigation<br/>[Navbar.tsx]"]
  node_dashboard["Attendance Dashboard<br/>[Dashboard.tsx]"]
  node_subjects["Subject Manager<br/>[SubjectList.tsx]"]
  node_routine["Routine Manager<br/>[RoutineManager.tsx]"]
  node_simulator["Leave Simulator<br/>[LeaveSimulator.tsx]"]
  node_semester["Semester Manager"]
  node_history["Semester History<br/>[HistoryLog.tsx]"]
  node_migration["Migration Notice"]
end

subgraph group_workspace["Workspace Services"]
  node_context["Workspace State<br/>[AppContext.tsx]"]
  node_device_storage[("Browser Storage")]
  node_supabase_client["Supabase Client<br/>[supabase.ts]"]
end

subgraph group_attendance_logic["Attendance Logic"]
  node_metrics["Attendance Calculations<br/>[calculations.ts]"]
  node_initial_data["Sample Data<br/>[initialData.ts]"]
  node_validation["Input Validation<br/>[validation.ts]"]
end

node_student(("Student"))
node_supabase_service[("Supabase Service")]

node_student -->|"opens"| node_app
node_app -->|"provides state"| node_context
node_app -->|"renders"| node_auth
node_app -->|"renders"| node_welcome
node_app -->|"renders"| node_navbar
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_subjects
node_app -->|"routes to"| node_routine
node_app -->|"routes to"| node_simulator
node_app -->|"routes to"| node_semester
node_app -->|"routes to"| node_history
node_app -->|"renders"| node_migration
node_auth -->|"uses"| node_context
node_auth -->|"validates with"| node_validation
node_navbar -->|"uses"| node_context
node_dashboard -->|"uses"| node_context
node_dashboard -->|"calculates with"| node_metrics
node_subjects -->|"uses"| node_context
node_subjects -->|"calculates with"| node_metrics
node_routine -->|"uses"| node_context
node_simulator -->|"uses"| node_context
node_simulator -->|"simulates with"| node_metrics
node_semester -->|"uses"| node_context
node_history -->|"uses"| node_context
node_migration -->|"uses"| node_context
node_context -->|"reads and writes"| node_device_storage
node_context -->|"uses"| node_metrics
node_context -->|"loads"| node_initial_data
node_context -->|"validates with"| node_validation
node_context -.->|"uses optionally"| node_supabase_client
node_supabase_client -.->|"connects optionally"| node_supabase_service

click node_app "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/App.tsx"
click node_auth "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/AuthModal.tsx"
click node_welcome "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/WelcomeView.tsx"
click node_navbar "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/Navbar.tsx"
click node_dashboard "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/Dashboard.tsx"
click node_subjects "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/SubjectList.tsx"
click node_routine "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/RoutineManager.tsx"
click node_simulator "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/LeaveSimulator.tsx"
click node_semester "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/SemesterManager.tsx"
click node_history "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/HistoryLog.tsx"
click node_migration "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/MigrationBanner.tsx"
click node_context "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/context/AppContext.tsx"
click node_supabase_client "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/lib/supabase.ts"
click node_metrics "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/utils/calculations.ts"
click node_initial_data "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/utils/initialData.ts"
click node_validation "https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/utils/validation.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_app toneBlue
class node_auth,node_welcome,node_navbar,node_dashboard,node_subjects,node_routine,node_simulator,node_semester,node_history,node_migration,node_supabase_service toneAmber
class node_context,node_device_storage,node_supabase_client toneMint
class node_metrics,node_initial_data,node_validation toneRose
class node_student toneIndigo
```

## Components

### Application Entry

- [App Router](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/App.tsx): `src/App.tsx`

### Student Views

- [Account Access](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/AuthModal.tsx): `src/components/AuthModal.tsx`
- [Welcome View](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/WelcomeView.tsx): `src/components/WelcomeView.tsx`
- [Navigation](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/Navbar.tsx): `src/components/Navbar.tsx`
- [Attendance Dashboard](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/Dashboard.tsx): `src/components/Dashboard.tsx`
- [Subject Manager](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/SubjectList.tsx): `src/components/SubjectList.tsx`
- [Routine Manager](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/RoutineManager.tsx): `src/components/RoutineManager.tsx`
- [Leave Simulator](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/LeaveSimulator.tsx): `src/components/LeaveSimulator.tsx`
- [Semester Manager](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/SemesterManager.tsx): `src/components/SemesterManager.tsx`
- [Semester History](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/HistoryLog.tsx): `src/components/HistoryLog.tsx`
- [Migration Notice](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/components/MigrationBanner.tsx): `src/components/MigrationBanner.tsx`

### Workspace Services

- [Workspace State](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/context/AppContext.tsx): `src/context/AppContext.tsx`
- **Browser Storage**
- [Supabase Client](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`

### Attendance Logic

- [Attendance Calculations](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/utils/calculations.ts): `src/utils/calculations.ts`
- [Sample Data](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/utils/initialData.ts): `src/utils/initialData.ts`
- [Input Validation](https://github.com/ramitsarker29/attendance-check-karo/blob/main/src/utils/validation.ts): `src/utils/validation.ts`

### Other components

- **Student**
- **Supabase Service**

## Connections

- Student → App Router: opens (evidence: `README.md`)
- App Router → Workspace State: provides state (evidence: `src/App.tsx`)
- App Router → Account Access: renders (evidence: `src/App.tsx`)
- App Router → Welcome View: renders (evidence: `src/App.tsx`)
- App Router → Navigation: renders (evidence: `src/App.tsx`)
- App Router → Attendance Dashboard: routes to (evidence: `src/App.tsx`)
- App Router → Subject Manager: routes to (evidence: `src/App.tsx`)
- App Router → Routine Manager: routes to (evidence: `src/App.tsx`)
- App Router → Leave Simulator: routes to (evidence: `src/App.tsx`)
- App Router → Semester Manager: routes to (evidence: `src/App.tsx`)
- App Router → Semester History: routes to (evidence: `src/App.tsx`)
- App Router → Migration Notice: renders (evidence: `src/App.tsx`)
- Account Access → Workspace State: uses (evidence: `src/components/AuthModal.tsx`)
- Account Access → Input Validation: validates with (evidence: `src/components/AuthModal.tsx`)
- Navigation → Workspace State: uses (evidence: `src/components/Navbar.tsx`)
- Attendance Dashboard → Workspace State: uses (evidence: `src/components/Dashboard.tsx`)
- Attendance Dashboard → Attendance Calculations: calculates with (evidence: `src/components/Dashboard.tsx`)
- Subject Manager → Workspace State: uses (evidence: `src/components/SubjectList.tsx`)
- Subject Manager → Attendance Calculations: calculates with (evidence: `src/components/SubjectList.tsx`)
- Routine Manager → Workspace State: uses (evidence: `src/components/RoutineManager.tsx`)
- Leave Simulator → Workspace State: uses (evidence: `src/components/LeaveSimulator.tsx`)
- Leave Simulator → Attendance Calculations: simulates with (evidence: `src/components/LeaveSimulator.tsx`)
- Semester Manager → Workspace State: uses (evidence: `src/components/SemesterManager.tsx`)
- Semester History → Workspace State: uses (evidence: `src/components/HistoryLog.tsx`)
- Migration Notice → Workspace State: uses (evidence: `src/components/MigrationBanner.tsx`)
- Workspace State → Browser Storage: reads and writes (evidence: `src/context/AppContext.tsx`)
- Workspace State → Attendance Calculations: uses (evidence: `src/context/AppContext.tsx`)
- Workspace State → Sample Data: loads (evidence: `src/context/AppContext.tsx`)
- Workspace State → Input Validation: validates with (evidence: `src/context/AppContext.tsx`)
- Workspace State → Supabase Client: uses optionally (evidence: `src/context/AppContext.tsx`)
- Supabase Client → Supabase Service: connects optionally
