# cjtarre/cmsc128-lab1_crud_sumergido-tarre architecture

> Architecture diagram of the GitHub repository cjtarre/cmsc128-lab1_crud_sumergido-tarre, 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/cjtarre/cmsc128-lab1_crud_sumergido-tarre
- Repository: https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre

## Overview

StudyBoard is a task-management web app. Users manage tasks in the dashboard (including CRUD, completion/status, search, filtering, sorting, pagination, and undo-delete), or view scheduled tasks in the calendar. The frontend context loads task and tag data; dashboard handlers and task hooks call frontend services, which communicate with Express routes and controllers backed by Supabase/PostgreSQL. The README documents the broader feature set; unsampled profile/settings and some UI details are not expanded. Edges reflect sampled calls or documented architecture, not an inspection of every module.

Main entry points: [`frontend/src/pages/Dashboard.jsx`](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/pages/Dashboard.jsx) (Task dashboard), [`frontend/src/shared/context/TaskContext.jsx`](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/shared/context/TaskContext.jsx) (Task context), [`backend/app.js`](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/app.js) (Express app), [`frontend/src/routes/AppRoutes.jsx`](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/routes/AppRoutes.jsx) (Page routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Frontend experience"]
  node_app["React app<br/>[App.jsx]"]
  node_routes["Page routes<br/>[AppRoutes.jsx]"]
  node_dashboard["Task dashboard<br/>[Dashboard.jsx]"]
  node_calendar["Calendar view<br/>[Calendar.jsx]"]
  node_taskui["Task forms and views"]
  node_calendarwidget["Calendar widget<br/>[CalendarWidget.jsx]"]
end

subgraph group_state["Task state and actions"]
  node_taskcontext["Task context<br/>[TaskContext.jsx]"]
  node_handlers["Task handlers<br/>[taskHandlers.js]"]
  node_taskhook["Task operations<br/>[useTasks.js]"]
  node_filters["Search and filters<br/>[taskFilters.js]"]
  node_tags["Tag catalog<br/>[tagService.js]"]
end

subgraph group_api["Backend API"]
  node_taskservice["Task API service<br/>[taskService.js]"]
  node_tagservice["Tag API service<br/>[tagService.js]"]
  node_express["Express app<br/>[app.js]"]
  node_taskroutes["Task routes<br/>[taskRoutes.js]"]
  node_tagroutes["Tag routes<br/>[tagRoutes.js]"]
  node_taskcontroller["Task controller<br/>[taskController.js]"]
  node_tagcontroller["Tag controller<br/>[tagController.js]"]
end

subgraph group_storage["Persistent data"]
  node_supabase["Supabase client<br/>[supabaseClient.js]"]
  node_postgres[("PostgreSQL data")]
end

node_user(("User"))

node_user -->|"uses"| node_app
node_app -->|"renders"| node_routes
node_routes -->|"routes to"| node_dashboard
node_routes -->|"routes to"| node_calendar
node_dashboard -->|"reads state"| node_taskcontext
node_dashboard -->|"creates handlers"| node_handlers
node_dashboard -->|"filters tasks"| node_filters
node_dashboard -->|"renders task UI"| node_taskui
node_dashboard -->|"renders widget"| node_calendarwidget
node_handlers -->|"invokes actions"| node_taskhook
node_taskhook -->|"calls API"| node_taskservice
node_taskcontext -->|"loads tasks"| node_taskservice
node_taskcontext -->|"loads tags"| node_tagservice
node_calendar -->|"reads state"| node_taskcontext
node_calendarwidget -->|"receives tasks"| node_taskcontext
node_express -->|"mounts routes"| node_taskroutes
node_express -->|"mounts routes"| node_tagroutes
node_taskroutes -->|"dispatches"| node_taskcontroller
node_tagroutes -->|"dispatches"| node_tagcontroller
node_taskservice -->|"HTTP requests"| node_express
node_tagservice -.->|"HTTP requests"| node_express
node_taskcontroller -->|"queries"| node_supabase
node_tagcontroller -->|"queries"| node_supabase
node_supabase -->|"persists data"| node_postgres
node_taskcontroller -->|"reads tag associations"| node_tags

click node_app "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/App.jsx"
click node_routes "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/routes/AppRoutes.jsx"
click node_dashboard "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/pages/Dashboard.jsx"
click node_calendar "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/pages/Calendar.jsx"
click node_taskui "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/tree/main/frontend/src/shared/components"
click node_taskcontext "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/shared/context/TaskContext.jsx"
click node_handlers "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/handlers/taskHandlers.js"
click node_taskhook "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/hooks/useTasks.js"
click node_filters "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/shared/utils/taskFilters.js"
click node_calendarwidget "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/shared/components/calendar/CalendarWidget.jsx"
click node_taskservice "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/services/taskService.js"
click node_tagservice "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/services/tagService.js"
click node_express "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/app.js"
click node_taskroutes "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/routes/taskRoutes.js"
click node_tagroutes "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/routes/tagRoutes.js"
click node_taskcontroller "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/controllers/taskController.js"
click node_tagcontroller "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/controllers/tagController.js"
click node_supabase "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/config/supabaseClient.js"
click node_tags "https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/services/tagService.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_app,node_routes,node_dashboard,node_calendar,node_taskui,node_calendarwidget,node_user toneBlue
class node_taskcontext,node_handlers,node_taskhook,node_filters,node_tags toneAmber
class node_taskservice,node_tagservice,node_express,node_taskroutes,node_tagroutes,node_taskcontroller,node_tagcontroller toneMint
class node_supabase,node_postgres toneRose
```

## Components

### Frontend experience

- [React app](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Page routes](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/routes/AppRoutes.jsx): `frontend/src/routes/AppRoutes.jsx`
- [Task dashboard](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Calendar view](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/pages/Calendar.jsx): `frontend/src/pages/Calendar.jsx`
- [Task forms and views](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/tree/main/frontend/src/shared/components): `frontend/src/shared/components`
- [Calendar widget](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/shared/components/calendar/CalendarWidget.jsx): `frontend/src/shared/components/calendar/CalendarWidget.jsx`

### Task state and actions

- [Task context](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/shared/context/TaskContext.jsx): `frontend/src/shared/context/TaskContext.jsx`
- [Task handlers](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/handlers/taskHandlers.js): `frontend/src/handlers/taskHandlers.js`
- [Task operations](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/hooks/useTasks.js): `frontend/src/hooks/useTasks.js`
- [Search and filters](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/shared/utils/taskFilters.js): `frontend/src/shared/utils/taskFilters.js`
- [Tag catalog](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/services/tagService.js): `frontend/src/services/tagService.js`

### Backend API

- [Task API service](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/services/taskService.js): `frontend/src/services/taskService.js`
- [Tag API service](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/frontend/src/services/tagService.js): `frontend/src/services/tagService.js`
- [Express app](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/app.js): `backend/app.js`
- [Task routes](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/routes/taskRoutes.js): `backend/routes/taskRoutes.js`
- [Tag routes](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/routes/tagRoutes.js): `backend/routes/tagRoutes.js`
- [Task controller](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/controllers/taskController.js): `backend/controllers/taskController.js`
- [Tag controller](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/controllers/tagController.js): `backend/controllers/tagController.js`

### Persistent data

- [Supabase client](https://github.com/cjtarre/cmsc128-lab1_crud_sumergido-tarre/blob/main/backend/config/supabaseClient.js): `backend/config/supabaseClient.js`
- **PostgreSQL data**

### Other components

- **User**

## Connections

- User → React app: uses (evidence: `README.md`)
- React app → Page routes: renders (evidence: `frontend/src/App.jsx`)
- Page routes → Task dashboard: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Page routes → Calendar view: routes to (evidence: `frontend/src/routes/AppRoutes.jsx`)
- Task dashboard → Task context: reads state (evidence: `frontend/src/pages/Dashboard.jsx`)
- Task dashboard → Task handlers: creates handlers (evidence: `frontend/src/pages/Dashboard.jsx`)
- Task dashboard → Search and filters: filters tasks (evidence: `frontend/src/pages/Dashboard.jsx`)
- Task dashboard → Task forms and views: renders task UI (evidence: `frontend/src/pages/Dashboard.jsx`)
- Task dashboard → Calendar widget: renders widget (evidence: `frontend/src/pages/Dashboard.jsx`)
- Task handlers → Task operations: invokes actions (evidence: `frontend/src/pages/Dashboard.jsx`)
- Task operations → Task API service: calls API (evidence: `frontend/src/hooks/useTasks.js`)
- Task context → Task API service: loads tasks (evidence: `frontend/src/shared/context/TaskContext.jsx`)
- Task context → Tag API service: loads tags (evidence: `frontend/src/shared/context/TaskContext.jsx`)
- Calendar view → Task context: reads state (evidence: `frontend/src/pages/Calendar.jsx`)
- Calendar widget → Task context: receives tasks (evidence: `frontend/src/pages/Dashboard.jsx`)
- Express app → Task routes: mounts routes (evidence: `backend/app.js`)
- Express app → Tag routes: mounts routes (evidence: `backend/app.js`)
- Task routes → Task controller: dispatches (evidence: `backend/routes/taskRoutes.js`)
- Tag routes → Tag controller: dispatches (evidence: `backend/routes/tagRoutes.js`)
- Task API service → Express app: HTTP requests (evidence: `frontend/src/services/taskService.js`)
- Tag API service → Express app: HTTP requests
- Task controller → Supabase client: queries (evidence: `backend/controllers/taskController.js`)
- Tag controller → Supabase client: queries (evidence: `backend/controllers/tagController.js`)
- Supabase client → PostgreSQL data: persists data (evidence: `README.md`)
- Task controller → Tag catalog: reads tag associations (evidence: `backend/controllers/taskController.js`)
