# taachii/class-schedule architecture

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

- Interactive diagram: https://gitdiagram.com/taachii/class-schedule
- Repository: https://github.com/taachii/class-schedule

## Overview

This is a class-schedule web application: users choose an academic year and semester, filter by group and subject, and view a calendar; administrators can edit events and related reference data. The graph follows the evidenced page-to-component and store-to-query paths, plus the calendar export endpoint. Source excerpts do not show every data-loading or admin interaction, so uncertain relationships are omitted; the README describes only the Next.js starter and documents no additional product capabilities.

Main entry points: [`app/page.tsx`](https://github.com/taachii/class-schedule/blob/main/app/page.tsx) (Schedule page), [`store/scheduleStore.ts`](https://github.com/taachii/class-schedule/blob/main/store/scheduleStore.ts) (Schedule state), [`components/CalendarView/CalendarView.tsx`](https://github.com/taachii/class-schedule/blob/main/components/CalendarView/CalendarView.tsx) (Calendar view), [`app/admin/page.tsx`](https://github.com/taachii/class-schedule/blob/main/app/admin/page.tsx) (Admin login)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_schedule["Schedule browsing"]
  node_schedulepage["Schedule page<br/>[page.tsx]"]
  node_yearpicker["Year selector<br/>[HomeSelector.tsx]"]
  node_groupselector["Group selector<br/>[GroupSelector.tsx]"]
  node_filters["Subject filters<br/>[SubjectFilters.tsx]"]
  node_calendar["Calendar view<br/>[CalendarView.tsx]"]
  node_timeline["Daily timeline"]
  node_header["Schedule header<br/>[Header.tsx]"]
  node_pdf["PDF view<br/>[PdfExportView.tsx]"]
end

subgraph group_admin["Administration"]
  node_eventeditor["Event editor"]
  node_adminactions["Admin actions<br/>[actions.ts]"]
  node_adminpage["Admin login<br/>[page.tsx]"]
  node_authapi["Authentication API<br/>[route.ts]"]
end

subgraph group_data["Schedule data"]
  node_store["Schedule state<br/>[scheduleStore.ts]"]
  node_queries["Schedule queries<br/>[queries.ts]"]
  node_supabase["Supabase client<br/>[client.ts]"]
  node_database[("Supabase database")]
end

subgraph group_exports["Calendar export"]
  node_icsapi["ICS export API<br/>[route.ts]"]
end

node_visitor(("Schedule user"))
node_adminuser(("Administrator"))

node_visitor -->|"opens"| node_schedulepage
node_schedulepage -->|"renders"| node_yearpicker
node_schedulepage -->|"renders"| node_groupselector
node_schedulepage -->|"renders"| node_filters
node_schedulepage -->|"renders"| node_calendar
node_schedulepage -->|"renders"| node_header
node_schedulepage -->|"renders"| node_pdf
node_schedulepage -->|"reads state"| node_store
node_yearpicker -->|"fetches semesters"| node_queries
node_groupselector -->|"updates selection"| node_store
node_filters -->|"reads state"| node_store
node_calendar -->|"reads events"| node_store
node_calendar -.->|"opens timeline"| node_timeline
node_calendar -->|"opens editor"| node_eventeditor
node_header -->|"reads state"| node_store
node_store -->|"loads schedule"| node_queries
node_queries -->|"queries through"| node_supabase
node_supabase -.->|"accesses"| node_database
node_adminuser -->|"opens"| node_adminpage
node_adminpage -->|"posts credentials"| node_authapi
node_adminpage -->|"renders after login"| node_schedulepage
node_eventeditor -->|"saves events"| node_adminactions
node_adminactions -->|"writes records"| node_database
node_visitor -.->|"requests calendar"| node_icsapi
node_icsapi -->|"fetches events"| node_supabase

click node_schedulepage "https://github.com/taachii/class-schedule/blob/main/app/page.tsx"
click node_yearpicker "https://github.com/taachii/class-schedule/blob/main/components/HomeSelector/HomeSelector.tsx"
click node_groupselector "https://github.com/taachii/class-schedule/blob/main/components/GroupSelector/GroupSelector.tsx"
click node_filters "https://github.com/taachii/class-schedule/blob/main/components/SubjectFilters/SubjectFilters.tsx"
click node_calendar "https://github.com/taachii/class-schedule/blob/main/components/CalendarView/CalendarView.tsx"
click node_timeline "https://github.com/taachii/class-schedule/blob/main/components/DailyTimelineModal/DailyTimelineModal.tsx"
click node_header "https://github.com/taachii/class-schedule/blob/main/components/Header/Header.tsx"
click node_pdf "https://github.com/taachii/class-schedule/blob/main/components/PdfExportView/PdfExportView.tsx"
click node_store "https://github.com/taachii/class-schedule/blob/main/store/scheduleStore.ts"
click node_queries "https://github.com/taachii/class-schedule/blob/main/lib/supabase/queries.ts"
click node_supabase "https://github.com/taachii/class-schedule/blob/main/lib/supabase/client.ts"
click node_eventeditor "https://github.com/taachii/class-schedule/blob/main/components/AdminEventModal/AdminEventModal.tsx"
click node_adminactions "https://github.com/taachii/class-schedule/blob/main/app/admin/actions.ts"
click node_adminpage "https://github.com/taachii/class-schedule/blob/main/app/admin/page.tsx"
click node_authapi "https://github.com/taachii/class-schedule/blob/main/app/api/auth/route.ts"
click node_icsapi "https://github.com/taachii/class-schedule/blob/main/app/api/calendar/route.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_schedulepage,node_yearpicker,node_groupselector,node_filters,node_calendar,node_timeline,node_header,node_pdf,node_visitor toneBlue
class node_eventeditor,node_adminactions,node_adminpage,node_authapi toneAmber
class node_store,node_queries,node_supabase,node_database toneMint
class node_icsapi toneRose
class node_adminuser toneIndigo
```

## Components

### Schedule browsing

- [Schedule page](https://github.com/taachii/class-schedule/blob/main/app/page.tsx): `app/page.tsx`
- [Year selector](https://github.com/taachii/class-schedule/blob/main/components/HomeSelector/HomeSelector.tsx): `components/HomeSelector/HomeSelector.tsx`
- [Group selector](https://github.com/taachii/class-schedule/blob/main/components/GroupSelector/GroupSelector.tsx): `components/GroupSelector/GroupSelector.tsx`
- [Subject filters](https://github.com/taachii/class-schedule/blob/main/components/SubjectFilters/SubjectFilters.tsx): `components/SubjectFilters/SubjectFilters.tsx`
- [Calendar view](https://github.com/taachii/class-schedule/blob/main/components/CalendarView/CalendarView.tsx): `components/CalendarView/CalendarView.tsx`
- [Daily timeline](https://github.com/taachii/class-schedule/blob/main/components/DailyTimelineModal/DailyTimelineModal.tsx): `components/DailyTimelineModal/DailyTimelineModal.tsx`
- [Schedule header](https://github.com/taachii/class-schedule/blob/main/components/Header/Header.tsx): `components/Header/Header.tsx`
- [PDF view](https://github.com/taachii/class-schedule/blob/main/components/PdfExportView/PdfExportView.tsx): `components/PdfExportView/PdfExportView.tsx`

### Administration

- [Event editor](https://github.com/taachii/class-schedule/blob/main/components/AdminEventModal/AdminEventModal.tsx): `components/AdminEventModal/AdminEventModal.tsx`
- [Admin actions](https://github.com/taachii/class-schedule/blob/main/app/admin/actions.ts): `app/admin/actions.ts`
- [Admin login](https://github.com/taachii/class-schedule/blob/main/app/admin/page.tsx): `app/admin/page.tsx`
- [Authentication API](https://github.com/taachii/class-schedule/blob/main/app/api/auth/route.ts): `app/api/auth/route.ts`

### Schedule data

- [Schedule state](https://github.com/taachii/class-schedule/blob/main/store/scheduleStore.ts): `store/scheduleStore.ts`
- [Schedule queries](https://github.com/taachii/class-schedule/blob/main/lib/supabase/queries.ts): `lib/supabase/queries.ts`
- [Supabase client](https://github.com/taachii/class-schedule/blob/main/lib/supabase/client.ts): `lib/supabase/client.ts`
- **Supabase database**

### Calendar export

- [ICS export API](https://github.com/taachii/class-schedule/blob/main/app/api/calendar/route.ts): `app/api/calendar/route.ts`

### Other components

- **Schedule user**
- **Administrator**

## Connections

- Schedule user → Schedule page: opens (evidence: `app/page.tsx`)
- Schedule page → Year selector: renders (evidence: `app/page.tsx`)
- Schedule page → Group selector: renders (evidence: `app/page.tsx`)
- Schedule page → Subject filters: renders (evidence: `app/page.tsx`)
- Schedule page → Calendar view: renders (evidence: `app/page.tsx`)
- Schedule page → Schedule header: renders (evidence: `app/page.tsx`)
- Schedule page → PDF view: renders (evidence: `app/page.tsx`)
- Schedule page → Schedule state: reads state (evidence: `app/page.tsx`)
- Year selector → Schedule queries: fetches semesters (evidence: `components/HomeSelector/HomeSelector.tsx`)
- Group selector → Schedule state: updates selection (evidence: `components/GroupSelector/GroupSelector.tsx`)
- Subject filters → Schedule state: reads state (evidence: `components/SubjectFilters/SubjectFilters.tsx`)
- Calendar view → Schedule state: reads events (evidence: `components/CalendarView/CalendarView.tsx`)
- Calendar view → Daily timeline: opens timeline (evidence: `components/CalendarView/CalendarView.tsx`)
- Calendar view → Event editor: opens editor (evidence: `components/CalendarView/CalendarView.tsx`)
- Schedule header → Schedule state: reads state (evidence: `components/Header/Header.tsx`)
- Schedule state → Schedule queries: loads schedule (evidence: `store/scheduleStore.ts`)
- Schedule queries → Supabase client: queries through (evidence: `lib/supabase/queries.ts`)
- Supabase client → Supabase database: accesses
- Administrator → Admin login: opens (evidence: `app/admin/page.tsx`)
- Admin login → Authentication API: posts credentials (evidence: `app/admin/page.tsx`)
- Admin login → Schedule page: renders after login (evidence: `app/admin/page.tsx`)
- Event editor → Admin actions: saves events (evidence: `components/AdminEventModal/AdminEventModal.tsx`)
- Admin actions → Supabase database: writes records (evidence: `app/admin/actions.ts`)
- Schedule user → ICS export API: requests calendar
- ICS export API → Supabase client: fetches events (evidence: `app/api/calendar/route.ts`)
