# ebicsa-uhm/ebicsa architecture

> Architecture diagram of the GitHub repository ebicsa-uhm/ebicsa, 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/ebicsa-uhm/ebicsa
- Repository: https://github.com/ebicsa-uhm/ebicsa

## Overview

EBICSA is a UH Mānoa ICS course-planning web application. Students browse course offerings, explore degree-pathway information, generate schedules, and manage saved schedule choices; account creation and sign-in provide the authentication path. A chat widget supplies advising-style replies using placeholder responses. The sampled source supports the course-data, schedule-builder, saved-schedule, and authentication relationships shown; the README describes this repository as a Next.js template and adds no further product capabilities.

Main entry points: [`src/components/chat/ChatWidget.tsx`](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/ChatWidget.tsx) (Chat widget), [`src/lib/prisma.ts`](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/prisma.ts) (Prisma client), [`src/app/courses/page.tsx`](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/courses/page.tsx) (Course catalog), [`src/app/schedule-builder/page.tsx`](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/schedule-builder/page.tsx) (Schedule builder)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Course discovery"]
  node_course_catalog["Course catalog<br/>[page.tsx]"]
  node_course_data["ICS course data<br/>[icsCourses.ts]"]
end

subgraph group_planning["Schedule planning"]
  node_schedule_builder["Schedule builder<br/>[page.tsx]"]
  node_schedule_logic["Schedule generation"]
  node_my_schedules["My schedules<br/>[page.tsx]"]
  node_saved_logic["Saved schedules<br/>[saved-schedules.ts]"]
end

subgraph group_identity["Accounts and access"]
  node_signup["Sign up<br/>[page.tsx]"]
  node_db_actions["User actions<br/>[dbActions.ts]"]
  node_auth["Credentials auth<br/>[auth.ts]"]
  node_auth_route["Auth API route<br/>[route.ts]"]
  node_prisma["Prisma client<br/>[prisma.ts]"]
  node_postgres[("PostgreSQL<br/>[schema.prisma]")]
end

subgraph group_advising["Advising chat"]
  node_chat_widget["Chat widget<br/>[ChatWidget.tsx]"]
  node_placeholder_replies["Placeholder replies"]
  node_chat_message["Chat message<br/>[ChatMessage.tsx]"]
  node_course_card["Course card<br/>[CourseCard.tsx]"]
end

node_student(("Student"))

node_student -.->|"browses"| node_course_catalog
node_course_catalog -->|"reads courses"| node_course_data
node_student -.->|"plans schedule"| node_schedule_builder
node_schedule_builder -->|"generates options"| node_schedule_logic
node_schedule_logic -->|"searches courses"| node_course_data
node_student -.->|"manages schedules"| node_my_schedules
node_my_schedules -->|"reads and updates"| node_saved_logic
node_student -.->|"creates account"| node_signup
node_signup -->|"creates user"| node_db_actions
node_db_actions -->|"uses client"| node_prisma
node_student -.->|"authenticates"| node_auth_route
node_auth_route -->|"uses handlers"| node_auth
node_auth -->|"looks up user"| node_prisma
node_prisma -.->|"queries database"| node_postgres
node_student -.->|"asks questions"| node_chat_widget
node_chat_widget -->|"gets reply"| node_placeholder_replies
node_chat_widget -->|"renders messages"| node_chat_message
node_chat_message -->|"renders courses"| node_course_card

click node_course_catalog "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/courses/page.tsx"
click node_course_data "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/data/icsCourses.ts"
click node_schedule_builder "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/schedule-builder/page.tsx"
click node_schedule_logic "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/schedule-builder.ts"
click node_my_schedules "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/my-schedules/page.tsx"
click node_saved_logic "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/saved-schedules.ts"
click node_signup "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/auth/signup/page.tsx"
click node_db_actions "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/dbActions.ts"
click node_auth "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/auth.ts"
click node_auth_route "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/api/auth/%5B...nextauth%5D/route.ts"
click node_prisma "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/prisma.ts"
click node_postgres "https://github.com/ebicsa-uhm/ebicsa/blob/main/prisma/schema.prisma"
click node_chat_widget "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/ChatWidget.tsx"
click node_placeholder_replies "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/placeholderReplies.ts"
click node_chat_message "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/ChatMessage.tsx"
click node_course_card "https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/CourseCard.tsx"

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_course_catalog,node_course_data toneBlue
class node_schedule_builder,node_schedule_logic,node_my_schedules,node_saved_logic toneAmber
class node_signup,node_db_actions,node_auth,node_auth_route,node_prisma,node_postgres toneMint
class node_chat_widget,node_placeholder_replies,node_chat_message,node_course_card toneRose
class node_student toneIndigo
```

## Components

### Course discovery

- [Course catalog](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/courses/page.tsx): `src/app/courses/page.tsx`
- [ICS course data](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/data/icsCourses.ts): `src/data/icsCourses.ts`

### Schedule planning

- [Schedule builder](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/schedule-builder/page.tsx): `src/app/schedule-builder/page.tsx`
- [Schedule generation](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/schedule-builder.ts): `src/lib/schedule-builder.ts`
- [My schedules](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/my-schedules/page.tsx): `src/app/my-schedules/page.tsx`
- [Saved schedules](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/saved-schedules.ts): `src/lib/saved-schedules.ts`

### Accounts and access

- [Sign up](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/auth/signup/page.tsx): `src/app/auth/signup/page.tsx`
- [User actions](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/dbActions.ts): `src/lib/dbActions.ts`
- [Credentials auth](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Auth API route](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/app/api/auth/%5B...nextauth%5D/route.ts): `src/app/api/auth/[...nextauth]/route.ts`
- [Prisma client](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [PostgreSQL](https://github.com/ebicsa-uhm/ebicsa/blob/main/prisma/schema.prisma): `prisma/schema.prisma`

### Advising chat

- [Chat widget](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/ChatWidget.tsx): `src/components/chat/ChatWidget.tsx`
- [Placeholder replies](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/placeholderReplies.ts): `src/components/chat/placeholderReplies.ts`
- [Chat message](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/ChatMessage.tsx): `src/components/chat/ChatMessage.tsx`
- [Course card](https://github.com/ebicsa-uhm/ebicsa/blob/main/src/components/chat/CourseCard.tsx): `src/components/chat/CourseCard.tsx`

### Other components

- **Student**

## Connections

- Student → Course catalog: browses
- Course catalog → ICS course data: reads courses (evidence: `src/app/courses/page.tsx`)
- Student → Schedule builder: plans schedule
- Schedule builder → Schedule generation: generates options (evidence: `src/app/schedule-builder/page.tsx`)
- Schedule generation → ICS course data: searches courses (evidence: `src/lib/schedule-builder.ts`)
- Student → My schedules: manages schedules
- My schedules → Saved schedules: reads and updates (evidence: `src/app/my-schedules/page.tsx`)
- Student → Sign up: creates account
- Sign up → User actions: creates user (evidence: `src/app/auth/signup/page.tsx`)
- User actions → Prisma client: uses client (evidence: `src/lib/dbActions.ts`)
- Student → Auth API route: authenticates
- Auth API route → Credentials auth: uses handlers (evidence: `src/app/api/auth/[...nextauth]/route.ts`)
- Credentials auth → Prisma client: looks up user (evidence: `src/lib/auth.ts`)
- Prisma client → PostgreSQL: queries database
- Student → Chat widget: asks questions
- Chat widget → Placeholder replies: gets reply (evidence: `src/components/chat/ChatWidget.tsx`)
- Chat widget → Chat message: renders messages (evidence: `src/components/chat/ChatWidget.tsx`)
- Chat message → Course card: renders courses (evidence: `src/components/chat/ChatMessage.tsx`)
