# sandy-07-coder/enrollmate architecture

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

- Interactive diagram: https://gitdiagram.com/sandy-07-coder/enrollmate
- Repository: https://github.com/sandy-07-coder/enrollmate

## Overview

EnrollMate is a browser-based course timetable builder. Students load course data from an extension or paste enrollment text, select and filter course sections, review conflicts in a timetable, and export a PDF. The React frontend processes data locally; Zustand persists course state in localStorage. The graph follows documented workflow and source-index references. Some implementation details are unsampled, so uncertain relationships are omitted.

Main entry points: [`frontend/src/store/courseStore.js`](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/store/courseStore.js) (Course state), [`frontend/src/pages/HomePage.jsx`](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/pages/HomePage.jsx) (Planner page), [`frontend/src/components/Header.jsx`](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/components/Header.jsx) (Search and controls), [`frontend/src/App.jsx`](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/App.jsx) (App bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Entry and ingestion"]
  node_landing["Landing page<br/>[LandingPage.jsx]"]
  node_paste["Paste dialog<br/>[PasteDataModal.jsx]"]
  node_rawparser["Text parser"]
  node_extensiondata["Extension data parser"]
  node_app["App bootstrap<br/>[App.jsx]"]
end

subgraph group_planning["Schedule planning"]
  node_home["Planner page<br/>[HomePage.jsx]"]
  node_header["Search and controls<br/>[Header.jsx]"]
  node_filter["Course filters<br/>[Filter.Modal.jsx]"]
  node_selected["Selected courses"]
  node_conflicts["Conflict dialog"]
end

subgraph group_state["State and rules"]
  node_store["Course state<br/>[courseStore.js]"]
  node_persistence[("Browser storage")]
  node_conflictlogic["Conflict detection"]
  node_slotlogic["Time-slot rules<br/>[timeSlots.js]"]
  node_subjectlogic["Subject matching<br/>[hasSameSubject.js]"]
  node_filterlogic["Filter rules"]
  node_toast["User notifications"]
end

subgraph group_presentation["Views and export"]
  node_timetable["Timetable view<br/>[TimeTable.jsx]"]
  node_downloadmodal["Export dialog"]
  node_pdf["PDF generator<br/>[downloadPDF.js]"]
  node_theme["Theme state<br/>[themeStore.js]"]
end

node_student(("Student"))

node_student -->|"opens"| node_landing
node_landing -->|"opens paste"| node_paste
node_paste -->|"parses text"| node_rawparser
node_paste -->|"sets courses"| node_store
node_app -->|"loads extension data"| node_store
node_app -.->|"reads browser data"| node_extensiondata
node_app -->|"routes to"| node_home
node_home -->|"renders"| node_header
node_home -->|"renders"| node_timetable
node_home -->|"renders"| node_selected
node_home -->|"opens"| node_filter
node_home -->|"opens"| node_conflicts
node_home -->|"opens"| node_downloadmodal
node_header -->|"searches and selects"| node_store
node_header -->|"shows feedback"| node_toast
node_filter -->|"filters and selects"| node_store
node_filter -->|"shows feedback"| node_toast
node_store -->|"persists state"| node_persistence
node_store -->|"checks conflicts"| node_conflictlogic
node_store -->|"checks duplicates"| node_subjectlogic
node_store -->|"applies filters"| node_filterlogic
node_conflictlogic -->|"compares slots"| node_slotlogic
node_timetable -->|"reads selection"| node_store
node_timetable -->|"lays out slots"| node_slotlogic
node_selected -->|"reads selection"| node_store
node_downloadmodal -->|"reads selection"| node_store
node_downloadmodal -->|"generates PDF"| node_pdf
node_pdf -->|"downloads timetable"| node_student
node_header -->|"toggles theme"| node_theme

click node_landing "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/pages/LandingPage.jsx"
click node_paste "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/PasteDataModal.jsx"
click node_rawparser "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/parseRawCourseData.js"
click node_extensiondata "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/parseExtensionData.js"
click node_app "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/App.jsx"
click node_home "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/pages/HomePage.jsx"
click node_header "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/components/Header.jsx"
click node_filter "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/Filter.Modal.jsx"
click node_selected "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/components/SelectedCoursesBox.jsx"
click node_conflicts "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/ShowConflicts.Modal.jsx"
click node_store "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/store/courseStore.js"
click node_conflictlogic "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/findConfictingCourse.js"
click node_slotlogic "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/timeSlots.js"
click node_subjectlogic "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/hasSameSubject.js"
click node_filterlogic "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/filterByFreeDaysAndTimes.js"
click node_toast "https://github.com/sandy-07-coder/enrollmate/tree/main/frontend/src/utils/toasts"
click node_timetable "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/components/TimeTable.jsx"
click node_downloadmodal "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/DownloadPDF.Modal.jsx"
click node_pdf "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/libs/downloadPDF.js"
click node_theme "https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/store/themeStore.js"

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_landing,node_paste,node_rawparser,node_extensiondata,node_app toneBlue
class node_home,node_header,node_filter,node_selected,node_conflicts toneAmber
class node_store,node_persistence,node_conflictlogic,node_slotlogic,node_subjectlogic,node_filterlogic,node_toast toneMint
class node_timetable,node_downloadmodal,node_pdf,node_theme toneRose
class node_student toneIndigo
```

## Components

### Entry and ingestion

- [Landing page](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/pages/LandingPage.jsx): `frontend/src/pages/LandingPage.jsx`
- [Paste dialog](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/PasteDataModal.jsx): `frontend/src/Modals/PasteDataModal.jsx`
- [Text parser](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/parseRawCourseData.js): `frontend/src/utils/parseRawCourseData.js`
- [Extension data parser](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/parseExtensionData.js): `frontend/src/utils/parseExtensionData.js`
- [App bootstrap](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### Schedule planning

- [Planner page](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/pages/HomePage.jsx): `frontend/src/pages/HomePage.jsx`
- [Search and controls](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/components/Header.jsx): `frontend/src/components/Header.jsx`
- [Course filters](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/Filter.Modal.jsx): `frontend/src/Modals/Filter.Modal.jsx`
- [Selected courses](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/components/SelectedCoursesBox.jsx): `frontend/src/components/SelectedCoursesBox.jsx`
- [Conflict dialog](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/ShowConflicts.Modal.jsx): `frontend/src/Modals/ShowConflicts.Modal.jsx`

### State and rules

- [Course state](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/store/courseStore.js): `frontend/src/store/courseStore.js`
- **Browser storage**
- [Conflict detection](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/findConfictingCourse.js): `frontend/src/utils/findConfictingCourse.js`
- [Time-slot rules](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/timeSlots.js): `frontend/src/utils/timeSlots.js`
- [Subject matching](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/hasSameSubject.js): `frontend/src/utils/hasSameSubject.js`
- [Filter rules](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/utils/filterByFreeDaysAndTimes.js): `frontend/src/utils/filterByFreeDaysAndTimes.js`
- [User notifications](https://github.com/sandy-07-coder/enrollmate/tree/main/frontend/src/utils/toasts): `frontend/src/utils/toasts`

### Views and export

- [Timetable view](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/components/TimeTable.jsx): `frontend/src/components/TimeTable.jsx`
- [Export dialog](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/Modals/DownloadPDF.Modal.jsx): `frontend/src/Modals/DownloadPDF.Modal.jsx`
- [PDF generator](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/libs/downloadPDF.js): `frontend/src/libs/downloadPDF.js`
- [Theme state](https://github.com/sandy-07-coder/enrollmate/blob/main/frontend/src/store/themeStore.js): `frontend/src/store/themeStore.js`

### Other components

- **Student**

## Connections

- Student → Landing page: opens (evidence: `README.md`)
- Landing page → Paste dialog: opens paste (evidence: `frontend/src/pages/LandingPage.jsx`)
- Paste dialog → Text parser: parses text (evidence: `frontend/src/Modals/PasteDataModal.jsx`)
- Paste dialog → Course state: sets courses (evidence: `frontend/src/Modals/PasteDataModal.jsx`)
- App bootstrap → Course state: loads extension data (evidence: `frontend/src/App.jsx`)
- App bootstrap → Extension data parser: reads browser data
- App bootstrap → Planner page: routes to (evidence: `frontend/src/App.jsx`)
- Planner page → Search and controls: renders (evidence: `frontend/src/pages/HomePage.jsx`)
- Planner page → Timetable view: renders (evidence: `frontend/src/pages/HomePage.jsx`)
- Planner page → Selected courses: renders (evidence: `frontend/src/pages/HomePage.jsx`)
- Planner page → Course filters: opens (evidence: `frontend/src/pages/HomePage.jsx`)
- Planner page → Conflict dialog: opens (evidence: `frontend/src/pages/HomePage.jsx`)
- Planner page → Export dialog: opens (evidence: `frontend/src/pages/HomePage.jsx`)
- Search and controls → Course state: searches and selects (evidence: `frontend/src/components/Header.jsx`)
- Search and controls → User notifications: shows feedback (evidence: `frontend/src/components/Header.jsx`)
- Course filters → Course state: filters and selects (evidence: `frontend/src/Modals/Filter.Modal.jsx`)
- Course filters → User notifications: shows feedback (evidence: `frontend/src/Modals/Filter.Modal.jsx`)
- Course state → Browser storage: persists state (evidence: `README.md`)
- Course state → Conflict detection: checks conflicts (evidence: `frontend/src/store/courseStore.js`)
- Course state → Subject matching: checks duplicates (evidence: `frontend/src/store/courseStore.js`)
- Course state → Filter rules: applies filters (evidence: `frontend/src/store/courseStore.js`)
- Conflict detection → Time-slot rules: compares slots (evidence: `frontend/src/utils/findConfictingCourse.js`)
- Timetable view → Course state: reads selection (evidence: `frontend/src/components/TimeTable.jsx`)
- Timetable view → Time-slot rules: lays out slots (evidence: `frontend/src/components/TimeTable.jsx`)
- Selected courses → Course state: reads selection (evidence: `frontend/src/components/SelectedCoursesBox.jsx`)
- Export dialog → Course state: reads selection (evidence: `frontend/src/Modals/DownloadPDF.Modal.jsx`)
- Export dialog → PDF generator: generates PDF (evidence: `frontend/src/Modals/DownloadPDF.Modal.jsx`)
- PDF generator → Student: downloads timetable (evidence: `README.md`)
- Search and controls → Theme state: toggles theme (evidence: `frontend/src/components/Header.jsx`)
