# ztongg-str/group06_project_management architecture

> Architecture diagram of the GitHub repository ztongg-str/group06_project_management, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ztongg-str/group06_project_management
- Repository: https://github.com/ztongg-str/group06_project_management

## Overview

UniPulse is a campus events and community application with student, organizer, and admin experiences. The main workflow runs from browser pages through the shared API client to backend route handlers and domain services, which read or update MySQL-backed data; users can discover events, register, and manage their profiles and connections. Separate capabilities include achievements and activity history, admin operations, backups, and a protected SQL console. The excerpts establish several internal calls, but do not show backend app mounting or most module internals, so those connections are omitted or marked unverified.

Main entry points: [`front/src/services/api.js`](https://github.com/ztongg-str/group06_project_management/blob/main/front/src/services/api.js) (API client), [`front/src/App.jsx`](https://github.com/ztongg-str/group06_project_management/blob/main/front/src/App.jsx) (App router), [`back/src/modules/auth/auth.service.js`](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/auth/auth.service.js) (Authentication), [`back/src/config/database.js`](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/config/database.js) (MySQL connection pool)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_router["App router<br/>[App.jsx]"]
  node_authctx["Auth context<br/>[AuthContext.jsx]"]
  node_toast["Toast provider<br/>[ToastContext.jsx]"]
  node_apiclient["API client<br/>[api.js]"]
end

subgraph group_events["Events and participation"]
  node_eventpages["Event pages"]
  node_participation["Registration and history"]
  node_eventbackend["Event management"]
end

subgraph group_community["Accounts and community"]
  node_profilepages["Profile and friends"]
  node_userbackend["User accounts"]
  node_authbackend["Authentication<br/>[auth.service.js]"]
  node_socialbackend["Friends"]
  node_engagement["Achievements and activity"]
  node_historybackend["Event history"]
end

subgraph group_operations["Administration"]
  node_adminui["Admin portal"]
  node_roleadmin["Admin roles"]
  node_backup["Backup management"]
  node_queryui["Query console UI"]
  node_queryroutes["Query console routes"]
  node_querycontroller["Query console controller"]
  node_queryservice["Query execution and logs"]
end

subgraph group_backend["Backend infrastructure"]
  node_backendapp["Backend application<br/>[app.js]"]
  node_dbpool[("MySQL connection pool<br/>[database.js]")]
  node_activityservice["Activity log service"]
end

node_visitor(("Browser user"))

node_visitor -->|"uses"| node_router
node_router -->|"provides auth"| node_authctx
node_router -->|"provides toasts"| node_toast
node_router -->|"routes to"| node_eventpages
node_router -->|"routes to"| node_adminui
node_authctx -->|"calls auth API"| node_apiclient
node_eventpages -.->|"requests event data"| node_apiclient
node_profilepages -->|"requests profile data"| node_apiclient
node_adminui -->|"requests admin data"| node_apiclient
node_queryui -->|"executes queries"| node_apiclient
node_apiclient -->|"HTTP auth requests"| node_authbackend
node_apiclient -->|"HTTP event requests"| node_eventbackend
node_apiclient -->|"HTTP registration requests"| node_participation
node_apiclient -->|"HTTP friend requests"| node_socialbackend
node_apiclient -->|"HTTP achievement requests"| node_engagement
node_apiclient -->|"HTTP history requests"| node_historybackend
node_apiclient -->|"HTTP user requests"| node_userbackend
node_apiclient -->|"HTTP backup requests"| node_backup
node_apiclient -->|"HTTP console requests"| node_queryroutes
node_queryroutes -->|"dispatches"| node_querycontroller
node_querycontroller -->|"calls"| node_queryservice
node_queryservice -->|"runs SQL and logs"| node_dbpool
node_authbackend -->|"logs auth activity"| node_activityservice
node_authbackend -.->|"reads and writes"| node_dbpool
node_backendapp -.->|"configures backend data"| node_dbpool

click node_router "https://github.com/ztongg-str/group06_project_management/blob/main/front/src/App.jsx"
click node_authctx "https://github.com/ztongg-str/group06_project_management/blob/main/front/src/context/AuthContext.jsx"
click node_toast "https://github.com/ztongg-str/group06_project_management/blob/main/front/src/context/ToastContext.jsx"
click node_apiclient "https://github.com/ztongg-str/group06_project_management/blob/main/front/src/services/api.js"
click node_eventpages "https://github.com/ztongg-str/group06_project_management/tree/main/front/src/components/pages"
click node_participation "https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/registrations"
click node_eventbackend "https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/events"
click node_profilepages "https://github.com/ztongg-str/group06_project_management/tree/main/front/src/components/pages"
click node_userbackend "https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/users"
click node_authbackend "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/auth/auth.service.js"
click node_socialbackend "https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/friends"
click node_engagement "https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/achievements"
click node_historybackend "https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/history"
click node_adminui "https://github.com/ztongg-str/group06_project_management/tree/main/front/src/components/admin"
click node_roleadmin "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/admin-roles/admin-roles.controller.js"
click node_backup "https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/backup"
click node_queryui "https://github.com/ztongg-str/group06_project_management/blob/main/front/src/components/admin/AdminQueryConsole.jsx"
click node_queryroutes "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/queryConsole/queryConsole.routes.js"
click node_querycontroller "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/queryConsole/queryConsole.controller.js"
click node_queryservice "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/queryConsole/queryConsole.service.js"
click node_backendapp "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/app.js"
click node_dbpool "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/config/database.js"
click node_activityservice "https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/activityLogs/activityLogs.service.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_router,node_authctx,node_toast,node_apiclient,node_visitor toneBlue
class node_eventpages,node_participation,node_eventbackend toneAmber
class node_profilepages,node_userbackend,node_authbackend,node_socialbackend,node_engagement,node_historybackend toneMint
class node_adminui,node_roleadmin,node_backup,node_queryui,node_queryroutes,node_querycontroller,node_queryservice toneRose
class node_backendapp,node_dbpool,node_activityservice toneIndigo
```

## Components

### Web application

- [App router](https://github.com/ztongg-str/group06_project_management/blob/main/front/src/App.jsx): `front/src/App.jsx`
- [Auth context](https://github.com/ztongg-str/group06_project_management/blob/main/front/src/context/AuthContext.jsx): `front/src/context/AuthContext.jsx`
- [Toast provider](https://github.com/ztongg-str/group06_project_management/blob/main/front/src/context/ToastContext.jsx): `front/src/context/ToastContext.jsx`
- [API client](https://github.com/ztongg-str/group06_project_management/blob/main/front/src/services/api.js): `front/src/services/api.js`

### Events and participation

- [Event pages](https://github.com/ztongg-str/group06_project_management/tree/main/front/src/components/pages): `front/src/components/pages`
- [Registration and history](https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/registrations): `back/src/modules/registrations`
- [Event management](https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/events): `back/src/modules/events`

### Accounts and community

- [Profile and friends](https://github.com/ztongg-str/group06_project_management/tree/main/front/src/components/pages): `front/src/components/pages`
- [User accounts](https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/users): `back/src/modules/users`
- [Authentication](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/auth/auth.service.js): `back/src/modules/auth/auth.service.js`
- [Friends](https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/friends): `back/src/modules/friends`
- [Achievements and activity](https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/achievements): `back/src/modules/achievements`
- [Event history](https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/history): `back/src/modules/history`

### Administration

- [Admin portal](https://github.com/ztongg-str/group06_project_management/tree/main/front/src/components/admin): `front/src/components/admin`
- [Admin roles](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/admin-roles/admin-roles.controller.js): `back/src/modules/admin-roles/admin-roles.controller.js`
- [Backup management](https://github.com/ztongg-str/group06_project_management/tree/main/back/src/modules/backup): `back/src/modules/backup`
- [Query console UI](https://github.com/ztongg-str/group06_project_management/blob/main/front/src/components/admin/AdminQueryConsole.jsx): `front/src/components/admin/AdminQueryConsole.jsx`
- [Query console routes](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/queryConsole/queryConsole.routes.js): `back/src/modules/queryConsole/queryConsole.routes.js`
- [Query console controller](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/queryConsole/queryConsole.controller.js): `back/src/modules/queryConsole/queryConsole.controller.js`
- [Query execution and logs](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/queryConsole/queryConsole.service.js): `back/src/modules/queryConsole/queryConsole.service.js`

### Backend infrastructure

- [Backend application](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/app.js): `back/src/app.js`
- [MySQL connection pool](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/config/database.js): `back/src/config/database.js`
- [Activity log service](https://github.com/ztongg-str/group06_project_management/blob/main/back/src/modules/activityLogs/activityLogs.service.js): `back/src/modules/activityLogs/activityLogs.service.js`

### Other components

- **Browser user**

## Connections

- Browser user → App router: uses (evidence: `front/src/App.jsx`)
- App router → Auth context: provides auth (evidence: `front/src/App.jsx`)
- App router → Toast provider: provides toasts (evidence: `front/src/App.jsx`)
- App router → Event pages: routes to (evidence: `front/src/App.jsx`)
- App router → Admin portal: routes to (evidence: `front/src/App.jsx`)
- Auth context → API client: calls auth API (evidence: `front/src/context/AuthContext.jsx`)
- Event pages → API client: requests event data (evidence: `front/src/components/pages/Friends.jsx`)
- Profile and friends → API client: requests profile data (evidence: `front/src/components/pages/Profile.jsx`)
- Admin portal → API client: requests admin data (evidence: `front/src/components/admin/AdminSettings.jsx`)
- Query console UI → API client: executes queries (evidence: `front/src/components/admin/AdminQueryConsole.jsx`)
- API client → Authentication: HTTP auth requests (evidence: `front/src/services/api.js`)
- API client → Event management: HTTP event requests (evidence: `front/src/services/api.js`)
- API client → Registration and history: HTTP registration requests (evidence: `front/src/services/api.js`)
- API client → Friends: HTTP friend requests (evidence: `front/src/services/api.js`)
- API client → Achievements and activity: HTTP achievement requests (evidence: `front/src/services/api.js`)
- API client → Event history: HTTP history requests (evidence: `front/src/services/api.js`)
- API client → User accounts: HTTP user requests (evidence: `front/src/services/api.js`)
- API client → Backup management: HTTP backup requests (evidence: `front/src/services/api.js`)
- API client → Query console routes: HTTP console requests (evidence: `front/src/services/api.js`)
- Query console routes → Query console controller: dispatches (evidence: `back/src/modules/queryConsole/queryConsole.routes.js`)
- Query console controller → Query execution and logs: calls (evidence: `back/src/modules/queryConsole/queryConsole.controller.js`)
- Query execution and logs → MySQL connection pool: runs SQL and logs (evidence: `back/src/modules/queryConsole/queryConsole.service.js`)
- Authentication → Activity log service: logs auth activity (evidence: `back/src/modules/auth/auth.service.js`)
- Authentication → MySQL connection pool: reads and writes
- Backend application → MySQL connection pool: configures backend data
