# byter66/studypact architecture

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

## Overview

StudyPact is an accountability-focused study platform. The main evidenced journey is sign-in, protected dashboard access, joining a study room, and managing room-related activity; the Express API handles authentication, rooms, goals, tasks, and Pomodoro operations. The README also describes peer evaluation, doubt discussions, presence, chat, and image sharing, so these appear as documented product capabilities. Their backend implementation is not present in the supplied tree; those links are marked unverified or omitted. The map is based on the supplied excerpts, source index, and README, not a full inspection of every file.

Main entry points: [`Frontend/src/App.jsx`](https://github.com/byter66/studypact/blob/main/Frontend/src/App.jsx) (Route application), [`backend/src/app.ts`](https://github.com/byter66/studypact/blob/main/backend/src/app.ts) (Express application), [`backend/src/middleware/auth.middleware.ts`](https://github.com/byter66/studypact/blob/main/backend/src/middleware/auth.middleware.ts) (Auth middleware), [`Frontend/src/components/Studyroom/Studyroom.jsx`](https://github.com/byter66/studypact/blob/main/Frontend/src/components/Studyroom/Studyroom.jsx) (Study room)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web experience"]
  node_app["Route application<br/>[App.jsx]"]
  node_auth_ui["Sign-in and signup<br/>[Signin.jsx]"]
  node_dashboard["Study dashboard<br/>[Dashboard.jsx]"]
  node_mock["Mock evaluation<br/>[Mockroom.jsx]"]
  node_doubts["Doubt forum<br/>[Doubtforum.jsx]"]
end

subgraph group_identity["Identity and access"]
  node_auth_state["Session context<br/>[AuthContext.jsx]"]
  node_guard["Protected access<br/>[ProtectedRoute.jsx]"]
  node_auth_client["Auth client<br/>[authService.js]"]
  node_auth_routes["Auth routes<br/>[auth.routes.ts]"]
  node_auth_controller["Auth controller<br/>[auth.controller.ts]"]
  node_auth_middleware["Auth middleware<br/>[auth.middleware.ts]"]
  node_auth_service["Auth service<br/>[auth.service.ts]"]
  node_otp_service["OTP service<br/>[otp.service.ts]"]
end

subgraph group_rooms["Study rooms"]
  node_room_ui["Study room<br/>[Studyroom.jsx]"]
  node_room_card["Room card<br/>[RoomCard.jsx]"]
  node_room_client["Room client<br/>[roomService.js]"]
  node_room_routes["Room routes<br/>[room.routes.ts]"]
  node_room_controller["Room controller<br/>[room.controller.ts]"]
  node_room_service["Room service<br/>[room.service.ts]"]
end

subgraph group_accountability["Goals and timing"]
  node_pomodoro_client["Pomodoro client<br/>[pomodoroApi.js]"]
  node_task_client["Task client<br/>[userTaskService.js]"]
  node_daily_routes["Daily goal routes"]
  node_daily_controller["Daily goal controller"]
  node_daily_service["Goal and streak logic"]
  node_task_routes["Task routes<br/>[userTask.routes.ts]"]
  node_task_controller["Task controller"]
  node_task_service["Task service"]
  node_pomo_routes["Pomodoro routes<br/>[pomodoro.routes.ts]"]
  node_pomo_controller["Pomodoro controller"]
  node_pomo_service["Pomodoro service"]
end

subgraph group_platform["API and persistence"]
  node_supabase_front["Supabase browser client<br/>[supabaseClient.js]"]
  node_api_client["REST request client<br/>[apiClient.js]"]
  node_api_app["Express application<br/>[app.ts]"]
end

node_student(("Student"))

node_student -->|"opens"| node_app
node_app -->|"routes to"| node_auth_ui
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_room_ui
node_app -->|"routes to"| node_mock
node_app -->|"routes to"| node_doubts
node_app -->|"protects routes"| node_guard
node_guard -->|"checks session"| node_auth_state
node_auth_ui -->|"requests auth"| node_auth_client
node_auth_state -->|"loads session"| node_auth_client
node_auth_client -->|"sends requests"| node_api_client
node_dashboard -->|"loads rooms"| node_room_client
node_dashboard -->|"loads tasks"| node_task_client
node_dashboard -->|"renders"| node_room_card
node_room_ui -->|"uses"| node_room_client
node_room_ui -->|"uses"| node_pomodoro_client
node_room_ui -->|"uses"| node_task_client
node_room_ui -->|"uses"| node_supabase_front
node_room_client -->|"sends requests"| node_api_client
node_task_client -->|"sends requests"| node_api_client
node_pomodoro_client -.->|"sends requests"| node_api_client
node_api_client -->|"REST requests"| node_api_app
node_api_app -->|"mounts"| node_auth_routes
node_api_app -->|"mounts"| node_room_routes
node_api_app -->|"mounts"| node_daily_routes
node_api_app -->|"mounts"| node_task_routes
node_api_app -->|"mounts"| node_pomo_routes
node_auth_routes -->|"routes to"| node_auth_controller
node_auth_routes -->|"guards routes"| node_auth_middleware
node_auth_controller -->|"calls"| node_auth_service
node_auth_middleware -->|"validates user"| node_auth_service
node_auth_service -->|"uses OTP"| node_otp_service
node_room_routes -->|"routes to"| node_room_controller
node_room_routes -->|"guards routes"| node_auth_middleware
node_room_controller -->|"calls"| node_room_service
node_daily_routes -->|"routes to"| node_daily_controller
node_daily_routes -->|"guards routes"| node_auth_middleware
node_daily_controller -->|"calls"| node_daily_service
node_task_routes -->|"routes to"| node_task_controller
node_task_routes -->|"guards routes"| node_auth_middleware
node_task_controller -->|"calls"| node_task_service
node_pomo_routes -->|"routes to"| node_pomo_controller
node_pomo_routes -->|"guards routes"| node_auth_middleware
node_pomo_controller -->|"calls"| node_pomo_service
node_room_service -->|"uses streaks"| node_daily_service
node_room_service -->|"uses tasks"| node_task_service
node_mock -.->|"peer review workflow"| node_student
node_doubts -.->|"threaded questions"| node_student

click node_app "https://github.com/byter66/studypact/blob/main/Frontend/src/App.jsx"
click node_auth_ui "https://github.com/byter66/studypact/blob/main/Frontend/src/components/Signin/Signin.jsx"
click node_auth_state "https://github.com/byter66/studypact/blob/main/Frontend/src/context/AuthContext.jsx"
click node_guard "https://github.com/byter66/studypact/blob/main/Frontend/src/components/ProtectedRoute/ProtectedRoute.jsx"
click node_auth_client "https://github.com/byter66/studypact/blob/main/Frontend/src/services/authService.js"
click node_dashboard "https://github.com/byter66/studypact/blob/main/Frontend/src/components/Dashboard/Dashboard.jsx"
click node_room_ui "https://github.com/byter66/studypact/blob/main/Frontend/src/components/Studyroom/Studyroom.jsx"
click node_room_card "https://github.com/byter66/studypact/blob/main/Frontend/src/components/RoomCard/RoomCard.jsx"
click node_mock "https://github.com/byter66/studypact/blob/main/Frontend/src/components/Mockroom/Mockroom.jsx"
click node_doubts "https://github.com/byter66/studypact/blob/main/Frontend/src/components/Doubtforum/Doubtforum.jsx"
click node_room_client "https://github.com/byter66/studypact/blob/main/Frontend/src/services/roomService.js"
click node_pomodoro_client "https://github.com/byter66/studypact/blob/main/Frontend/src/services/pomodoroApi.js"
click node_task_client "https://github.com/byter66/studypact/blob/main/Frontend/src/services/userTaskService.js"
click node_supabase_front "https://github.com/byter66/studypact/blob/main/Frontend/src/services/supabaseClient.js"
click node_api_client "https://github.com/byter66/studypact/blob/main/Frontend/src/services/apiClient.js"
click node_api_app "https://github.com/byter66/studypact/blob/main/backend/src/app.ts"
click node_auth_routes "https://github.com/byter66/studypact/blob/main/backend/src/routes/auth.routes.ts"
click node_auth_controller "https://github.com/byter66/studypact/blob/main/backend/src/controllers/auth.controller.ts"
click node_auth_middleware "https://github.com/byter66/studypact/blob/main/backend/src/middleware/auth.middleware.ts"
click node_auth_service "https://github.com/byter66/studypact/blob/main/backend/src/services/auth.service.ts"
click node_otp_service "https://github.com/byter66/studypact/blob/main/backend/src/services/otp.service.ts"
click node_room_routes "https://github.com/byter66/studypact/blob/main/backend/src/routes/room.routes.ts"
click node_room_controller "https://github.com/byter66/studypact/blob/main/backend/src/controllers/room.controller.ts"
click node_room_service "https://github.com/byter66/studypact/blob/main/backend/src/services/room.service.ts"
click node_daily_routes "https://github.com/byter66/studypact/blob/main/backend/src/routes/dailyGoal.routes.ts"
click node_daily_controller "https://github.com/byter66/studypact/blob/main/backend/src/controllers/dailyGoal.controller.ts"
click node_daily_service "https://github.com/byter66/studypact/blob/main/backend/src/services/dailyGoal.service.ts"
click node_task_routes "https://github.com/byter66/studypact/blob/main/backend/src/routes/userTask.routes.ts"
click node_task_controller "https://github.com/byter66/studypact/blob/main/backend/src/controllers/userTask.controller.ts"
click node_task_service "https://github.com/byter66/studypact/blob/main/backend/src/services/userTask.service.ts"
click node_pomo_routes "https://github.com/byter66/studypact/blob/main/backend/src/routes/pomodoro.routes.ts"
click node_pomo_controller "https://github.com/byter66/studypact/blob/main/backend/src/controllers/pomodoro.controller.ts"
click node_pomo_service "https://github.com/byter66/studypact/blob/main/backend/src/services/pomodoro.service.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_auth_ui,node_dashboard,node_mock,node_doubts toneBlue
class node_auth_state,node_guard,node_auth_client,node_auth_routes,node_auth_controller,node_auth_middleware,node_auth_service,node_otp_service toneAmber
class node_room_ui,node_room_card,node_room_client,node_room_routes,node_room_controller,node_room_service toneMint
class node_pomodoro_client,node_task_client,node_daily_routes,node_daily_controller,node_daily_service,node_task_routes,node_task_controller,node_task_service,node_pomo_routes,node_pomo_controller,node_pomo_service toneRose
class node_supabase_front,node_api_client,node_api_app,node_student toneIndigo
```

## Components

### Web experience

- [Route application](https://github.com/byter66/studypact/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Sign-in and signup](https://github.com/byter66/studypact/blob/main/Frontend/src/components/Signin/Signin.jsx): `Frontend/src/components/Signin/Signin.jsx`
- [Study dashboard](https://github.com/byter66/studypact/blob/main/Frontend/src/components/Dashboard/Dashboard.jsx): `Frontend/src/components/Dashboard/Dashboard.jsx`
- [Mock evaluation](https://github.com/byter66/studypact/blob/main/Frontend/src/components/Mockroom/Mockroom.jsx): `Frontend/src/components/Mockroom/Mockroom.jsx`
- [Doubt forum](https://github.com/byter66/studypact/blob/main/Frontend/src/components/Doubtforum/Doubtforum.jsx): `Frontend/src/components/Doubtforum/Doubtforum.jsx`

### Identity and access

- [Session context](https://github.com/byter66/studypact/blob/main/Frontend/src/context/AuthContext.jsx): `Frontend/src/context/AuthContext.jsx`
- [Protected access](https://github.com/byter66/studypact/blob/main/Frontend/src/components/ProtectedRoute/ProtectedRoute.jsx): `Frontend/src/components/ProtectedRoute/ProtectedRoute.jsx`
- [Auth client](https://github.com/byter66/studypact/blob/main/Frontend/src/services/authService.js): `Frontend/src/services/authService.js`
- [Auth routes](https://github.com/byter66/studypact/blob/main/backend/src/routes/auth.routes.ts): `backend/src/routes/auth.routes.ts`
- [Auth controller](https://github.com/byter66/studypact/blob/main/backend/src/controllers/auth.controller.ts): `backend/src/controllers/auth.controller.ts`
- [Auth middleware](https://github.com/byter66/studypact/blob/main/backend/src/middleware/auth.middleware.ts): `backend/src/middleware/auth.middleware.ts`
- [Auth service](https://github.com/byter66/studypact/blob/main/backend/src/services/auth.service.ts): `backend/src/services/auth.service.ts`
- [OTP service](https://github.com/byter66/studypact/blob/main/backend/src/services/otp.service.ts): `backend/src/services/otp.service.ts`

### Study rooms

- [Study room](https://github.com/byter66/studypact/blob/main/Frontend/src/components/Studyroom/Studyroom.jsx): `Frontend/src/components/Studyroom/Studyroom.jsx`
- [Room card](https://github.com/byter66/studypact/blob/main/Frontend/src/components/RoomCard/RoomCard.jsx): `Frontend/src/components/RoomCard/RoomCard.jsx`
- [Room client](https://github.com/byter66/studypact/blob/main/Frontend/src/services/roomService.js): `Frontend/src/services/roomService.js`
- [Room routes](https://github.com/byter66/studypact/blob/main/backend/src/routes/room.routes.ts): `backend/src/routes/room.routes.ts`
- [Room controller](https://github.com/byter66/studypact/blob/main/backend/src/controllers/room.controller.ts): `backend/src/controllers/room.controller.ts`
- [Room service](https://github.com/byter66/studypact/blob/main/backend/src/services/room.service.ts): `backend/src/services/room.service.ts`

### Goals and timing

- [Pomodoro client](https://github.com/byter66/studypact/blob/main/Frontend/src/services/pomodoroApi.js): `Frontend/src/services/pomodoroApi.js`
- [Task client](https://github.com/byter66/studypact/blob/main/Frontend/src/services/userTaskService.js): `Frontend/src/services/userTaskService.js`
- [Daily goal routes](https://github.com/byter66/studypact/blob/main/backend/src/routes/dailyGoal.routes.ts): `backend/src/routes/dailyGoal.routes.ts`
- [Daily goal controller](https://github.com/byter66/studypact/blob/main/backend/src/controllers/dailyGoal.controller.ts): `backend/src/controllers/dailyGoal.controller.ts`
- [Goal and streak logic](https://github.com/byter66/studypact/blob/main/backend/src/services/dailyGoal.service.ts): `backend/src/services/dailyGoal.service.ts`
- [Task routes](https://github.com/byter66/studypact/blob/main/backend/src/routes/userTask.routes.ts): `backend/src/routes/userTask.routes.ts`
- [Task controller](https://github.com/byter66/studypact/blob/main/backend/src/controllers/userTask.controller.ts): `backend/src/controllers/userTask.controller.ts`
- [Task service](https://github.com/byter66/studypact/blob/main/backend/src/services/userTask.service.ts): `backend/src/services/userTask.service.ts`
- [Pomodoro routes](https://github.com/byter66/studypact/blob/main/backend/src/routes/pomodoro.routes.ts): `backend/src/routes/pomodoro.routes.ts`
- [Pomodoro controller](https://github.com/byter66/studypact/blob/main/backend/src/controllers/pomodoro.controller.ts): `backend/src/controllers/pomodoro.controller.ts`
- [Pomodoro service](https://github.com/byter66/studypact/blob/main/backend/src/services/pomodoro.service.ts): `backend/src/services/pomodoro.service.ts`

### API and persistence

- [Supabase browser client](https://github.com/byter66/studypact/blob/main/Frontend/src/services/supabaseClient.js): `Frontend/src/services/supabaseClient.js`
- [REST request client](https://github.com/byter66/studypact/blob/main/Frontend/src/services/apiClient.js): `Frontend/src/services/apiClient.js`
- [Express application](https://github.com/byter66/studypact/blob/main/backend/src/app.ts): `backend/src/app.ts`

### Other components

- **Student**

## Connections

- Student → Route application: opens (evidence: `Frontend/src/App.jsx`)
- Route application → Sign-in and signup: routes to (evidence: `Frontend/src/App.jsx`)
- Route application → Study dashboard: routes to (evidence: `Frontend/src/App.jsx`)
- Route application → Study room: routes to (evidence: `Frontend/src/App.jsx`)
- Route application → Mock evaluation: routes to (evidence: `Frontend/src/App.jsx`)
- Route application → Doubt forum: routes to (evidence: `Frontend/src/App.jsx`)
- Route application → Protected access: protects routes (evidence: `Frontend/src/App.jsx`)
- Protected access → Session context: checks session (evidence: `Frontend/src/components/ProtectedRoute/ProtectedRoute.jsx`)
- Sign-in and signup → Auth client: requests auth (evidence: `Frontend/src/components/Signin/Signin.jsx`)
- Session context → Auth client: loads session (evidence: `Frontend/src/context/AuthContext.jsx`)
- Auth client → REST request client: sends requests (evidence: `Frontend/src/services/authService.js`)
- Study dashboard → Room client: loads rooms (evidence: `Frontend/src/components/Dashboard/Dashboard.jsx`)
- Study dashboard → Task client: loads tasks (evidence: `Frontend/src/components/Dashboard/Dashboard.jsx`)
- Study dashboard → Room card: renders (evidence: `Frontend/src/components/Dashboard/Dashboard.jsx`)
- Study room → Room client: uses (evidence: `Frontend/src/components/Studyroom/Studyroom.jsx`)
- Study room → Pomodoro client: uses (evidence: `Frontend/src/components/Studyroom/Studyroom.jsx`)
- Study room → Task client: uses (evidence: `Frontend/src/components/Studyroom/Studyroom.jsx`)
- Study room → Supabase browser client: uses (evidence: `Frontend/src/components/Studyroom/Studyroom.jsx`)
- Room client → REST request client: sends requests (evidence: `Frontend/src/services/roomService.js`)
- Task client → REST request client: sends requests (evidence: `Frontend/src/services/userTaskService.js`)
- Pomodoro client → REST request client: sends requests
- REST request client → Express application: REST requests (evidence: `README.md`)
- Express application → Auth routes: mounts (evidence: `backend/src/app.ts`)
- Express application → Room routes: mounts (evidence: `backend/src/app.ts`)
- Express application → Daily goal routes: mounts (evidence: `backend/src/app.ts`)
- Express application → Task routes: mounts (evidence: `backend/src/app.ts`)
- Express application → Pomodoro routes: mounts (evidence: `backend/src/app.ts`)
- Auth routes → Auth controller: routes to (evidence: `backend/src/routes/auth.routes.ts`)
- Auth routes → Auth middleware: guards routes (evidence: `backend/src/routes/auth.routes.ts`)
- Auth controller → Auth service: calls (evidence: `backend/src/controllers/auth.controller.ts`)
- Auth middleware → Auth service: validates user (evidence: `backend/src/middleware/auth.middleware.ts`)
- Auth service → OTP service: uses OTP (evidence: `backend/src/services/auth.service.ts`)
- Room routes → Room controller: routes to (evidence: `backend/src/routes/room.routes.ts`)
- Room routes → Auth middleware: guards routes (evidence: `backend/src/routes/room.routes.ts`)
- Room controller → Room service: calls (evidence: `backend/src/controllers/room.controller.ts`)
- Daily goal routes → Daily goal controller: routes to (evidence: `backend/src/routes/dailyGoal.routes.ts`)
- Daily goal routes → Auth middleware: guards routes (evidence: `backend/src/routes/dailyGoal.routes.ts`)
- Daily goal controller → Goal and streak logic: calls (evidence: `backend/src/controllers/dailyGoal.controller.ts`)
- Task routes → Task controller: routes to (evidence: `backend/src/routes/userTask.routes.ts`)
- Task routes → Auth middleware: guards routes (evidence: `backend/src/routes/userTask.routes.ts`)
- Task controller → Task service: calls (evidence: `backend/src/controllers/userTask.controller.ts`)
- Pomodoro routes → Pomodoro controller: routes to (evidence: `backend/src/routes/pomodoro.routes.ts`)
- Pomodoro routes → Auth middleware: guards routes (evidence: `backend/src/routes/pomodoro.routes.ts`)
- Pomodoro controller → Pomodoro service: calls (evidence: `backend/src/controllers/pomodoro.controller.ts`)
- Room service → Goal and streak logic: uses streaks (evidence: `backend/src/services/room.service.ts`)
- Room service → Task service: uses tasks (evidence: `backend/src/services/room.service.ts`)
- Mock evaluation → Student: peer review workflow (evidence: `README.md`)
- Doubt forum → Student: threaded questions (evidence: `README.md`)
