# kartik192008/attendencesystem architecture

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

- Interactive diagram: https://gitdiagram.com/kartik192008/attendencesystem
- Repository: https://github.com/kartik192008/attendencesystem

## Overview

AttendenceSystem is a student attendance-management app: users sign in, review attendance and subject-planning information, record attendance, and manage an academic calendar and settings. The sampled app loads and saves data through its API adapter; a separate Express service exposes health, session, and data routes backed by Supabase. The workspace also contains a component-preview sandbox and a reusable fetch client. The README is only a title, and several feature and adapter implementations were not sampled, so uncertain connections are omitted.

Main entry points: [`artifacts/att-attendance/src/App.tsx`](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx) (Attendance app), [`artifacts/api-server/src/routes/index.ts`](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/index.ts) (Route registry), [`artifacts/api-server/src/routes/data.ts`](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/data.ts) (Data routes), [`artifacts/api-server/src/middlewares/auth.ts`](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/middlewares/auth.ts) (Auth middleware)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_attendance["Attendance app"]
  node_app["Attendance app<br/>[App.tsx]"]
  node_dashboard["Overview<br/>[App.tsx]"]
  node_attendance_log["Attendance log<br/>[App.tsx]"]
  node_subject_planner["Subject planner<br/>[App.tsx]"]
  node_academic_calendar["Academic calendar<br/>[App.tsx]"]
  node_settings["Settings<br/>[App.tsx]"]
  node_login["Login page<br/>[login.tsx]"]
  node_api_adapter["Data API adapter<br/>[api.ts]"]
  node_browser_storage["Browser storage<br/>[storage.ts]"]
  node_supabase_client["Supabase client<br/>[supabase.ts]"]
end

subgraph group_server["API service"]
  node_api_entry["Express app<br/>[app.ts]"]
  node_route_registry["Route registry<br/>[index.ts]"]
  node_health_route["Health route<br/>[health.ts]"]
  node_auth_route["Auth routes<br/>[auth.ts]"]
  node_data_route["Data routes<br/>[data.ts]"]
  node_auth_middleware["Auth middleware<br/>[auth.ts]"]
  node_server_supabase["Server Supabase client<br/>[supabase.ts]"]
  node_logger["HTTP logger<br/>[logger.ts]"]
end

subgraph group_preview["Component preview"]
  node_preview_app["Preview app<br/>[App.tsx]"]
  node_preview_plugin["Preview discovery plugin"]
end

subgraph group_client["API client"]
  node_fetch_client["Custom fetch<br/>[custom-fetch.ts]"]
end

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

node_student -->|"uses"| node_app
node_app -->|"renders"| node_dashboard
node_app -->|"routes to"| node_attendance_log
node_app -->|"routes to"| node_subject_planner
node_app -->|"routes to"| node_academic_calendar
node_app -->|"routes to"| node_settings
node_app -->|"renders"| node_login
node_app -->|"loads and saves"| node_api_adapter
node_browser_storage -.->|"stores locally"| node_supabase_service
node_api_entry -->|"mounts"| node_route_registry
node_api_entry -->|"configures"| node_logger
node_route_registry -->|"registers"| node_health_route
node_route_registry -->|"registers"| node_auth_route
node_route_registry -->|"registers"| node_data_route
node_auth_route -->|"applies"| node_auth_middleware
node_data_route -->|"applies"| node_auth_middleware
node_data_route -->|"uses"| node_server_supabase
node_auth_middleware -->|"validates tokens"| node_server_supabase
node_server_supabase -->|"connects"| node_supabase_service
node_preview_app -.->|"presents previews"| node_student
node_fetch_client -.->|"sends requests"| node_supabase_service

click node_app "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx"
click node_dashboard "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx"
click node_attendance_log "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx"
click node_subject_planner "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx"
click node_academic_calendar "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx"
click node_settings "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx"
click node_login "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/pages/login.tsx"
click node_api_adapter "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/lib/api.ts"
click node_browser_storage "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/lib/storage.ts"
click node_supabase_client "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/lib/supabase.ts"
click node_api_entry "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/app.ts"
click node_route_registry "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/index.ts"
click node_health_route "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/health.ts"
click node_auth_route "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/auth.ts"
click node_data_route "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/data.ts"
click node_auth_middleware "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/middlewares/auth.ts"
click node_server_supabase "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/lib/supabase.ts"
click node_logger "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/lib/logger.ts"
click node_preview_app "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/mockup-sandbox/src/App.tsx"
click node_preview_plugin "https://github.com/kartik192008/attendencesystem/blob/main/artifacts/mockup-sandbox/mockupPreviewPlugin.ts"
click node_fetch_client "https://github.com/kartik192008/attendencesystem/blob/main/lib/api-client-react/src/custom-fetch.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,node_dashboard,node_attendance_log,node_subject_planner,node_academic_calendar,node_settings,node_login,node_api_adapter,node_browser_storage,node_supabase_client toneBlue
class node_api_entry,node_route_registry,node_health_route,node_auth_route,node_data_route,node_auth_middleware,node_server_supabase,node_logger,node_supabase_service toneAmber
class node_preview_app,node_preview_plugin toneMint
class node_fetch_client toneRose
class node_student toneIndigo
```

## Components

### Attendance app

- [Attendance app](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx): `artifacts/att-attendance/src/App.tsx`
- [Overview](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx): `artifacts/att-attendance/src/App.tsx`
- [Attendance log](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx): `artifacts/att-attendance/src/App.tsx`
- [Subject planner](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx): `artifacts/att-attendance/src/App.tsx`
- [Academic calendar](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx): `artifacts/att-attendance/src/App.tsx`
- [Settings](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/App.tsx): `artifacts/att-attendance/src/App.tsx`
- [Login page](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/pages/login.tsx): `artifacts/att-attendance/src/pages/login.tsx`
- [Data API adapter](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/lib/api.ts): `artifacts/att-attendance/src/lib/api.ts`
- [Browser storage](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/lib/storage.ts): `artifacts/att-attendance/src/lib/storage.ts`
- [Supabase client](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/att-attendance/src/lib/supabase.ts): `artifacts/att-attendance/src/lib/supabase.ts`

### API service

- [Express app](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/app.ts): `artifacts/api-server/src/app.ts`
- [Route registry](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/index.ts): `artifacts/api-server/src/routes/index.ts`
- [Health route](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/health.ts): `artifacts/api-server/src/routes/health.ts`
- [Auth routes](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/auth.ts): `artifacts/api-server/src/routes/auth.ts`
- [Data routes](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/routes/data.ts): `artifacts/api-server/src/routes/data.ts`
- [Auth middleware](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/middlewares/auth.ts): `artifacts/api-server/src/middlewares/auth.ts`
- [Server Supabase client](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/lib/supabase.ts): `artifacts/api-server/src/lib/supabase.ts`
- [HTTP logger](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/api-server/src/lib/logger.ts): `artifacts/api-server/src/lib/logger.ts`

### Component preview

- [Preview app](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/mockup-sandbox/src/App.tsx): `artifacts/mockup-sandbox/src/App.tsx`
- [Preview discovery plugin](https://github.com/kartik192008/attendencesystem/blob/main/artifacts/mockup-sandbox/mockupPreviewPlugin.ts): `artifacts/mockup-sandbox/mockupPreviewPlugin.ts`

### API client

- [Custom fetch](https://github.com/kartik192008/attendencesystem/blob/main/lib/api-client-react/src/custom-fetch.ts): `lib/api-client-react/src/custom-fetch.ts`

### Other components

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

## Connections

- Student → Attendance app: uses
- Attendance app → Overview: renders (evidence: `artifacts/att-attendance/src/App.tsx`)
- Attendance app → Attendance log: routes to (evidence: `artifacts/att-attendance/src/App.tsx`)
- Attendance app → Subject planner: routes to (evidence: `artifacts/att-attendance/src/App.tsx`)
- Attendance app → Academic calendar: routes to (evidence: `artifacts/att-attendance/src/App.tsx`)
- Attendance app → Settings: routes to (evidence: `artifacts/att-attendance/src/App.tsx`)
- Attendance app → Login page: renders (evidence: `artifacts/att-attendance/src/App.tsx`)
- Attendance app → Data API adapter: loads and saves (evidence: `artifacts/att-attendance/src/App.tsx`)
- Browser storage → Supabase: stores locally
- Express app → Route registry: mounts (evidence: `artifacts/api-server/src/app.ts`)
- Express app → HTTP logger: configures (evidence: `artifacts/api-server/src/app.ts`)
- Route registry → Health route: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Auth routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Route registry → Data routes: registers (evidence: `artifacts/api-server/src/routes/index.ts`)
- Auth routes → Auth middleware: applies (evidence: `artifacts/api-server/src/routes/auth.ts`)
- Data routes → Auth middleware: applies (evidence: `artifacts/api-server/src/routes/data.ts`)
- Data routes → Server Supabase client: uses (evidence: `artifacts/api-server/src/routes/data.ts`)
- Auth middleware → Server Supabase client: validates tokens (evidence: `artifacts/api-server/src/middlewares/auth.ts`)
- Server Supabase client → Supabase: connects (evidence: `artifacts/api-server/src/lib/supabase.ts`)
- Preview app → Student: presents previews
- Custom fetch → Supabase: sends requests
