# zshebjtzs/qdezjds architecture

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

- Interactive diagram: https://gitdiagram.com/zshebjtzs/qdezjds
- Repository: https://github.com/zshebjtzs/qdezjds

## Overview

This is a Vue and Express club-management platform for public information, authenticated member profiles, forums, department file sharing, announcements, and administration. The main workflow runs from browser navigation through feature pages and API requests to Express routes and controllers, which apply domain services and persist data in MySQL. Forum activity and moderation can also generate notifications. README documentation establishes several feature links whose implementation was not sampled; those links are marked dashed where source-level calls were not shown.

Main entry points: [`src/router/index.js`](https://github.com/zshebjtzs/qdezjds/blob/main/src/router/index.js) (Page routing), [`server/config/db.js`](https://github.com/zshebjtzs/qdezjds/blob/main/server/config/db.js) (MySQL pool), [`server/controllers/forumController.js`](https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/forumController.js) (Forum operations), [`server/app.js`](https://github.com/zshebjtzs/qdezjds/blob/main/server/app.js) (Express application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_navigation["Page routing<br/>[index.js]"]
  node_public["Public pages<br/>[HomePage.vue]"]
  node_login["Login page<br/>[LoginPage.vue]"]
  node_forumui["Forum pages<br/>[ForumPage.vue]"]
  node_postdetail["Post detail<br/>[postSingle.vue]"]
  node_markdown["Markdown editor<br/>[editor.vue]"]
  node_adminui["Admin console"]
  node_noticeui["Notification page"]
end

subgraph group_identity["Identity and profiles"]
  node_userstate["User state<br/>[user.js]"]
  node_userapi["User API<br/>[auth.js]"]
  node_authcontroller["Authentication<br/>[authController.js]"]
  node_usercontroller["Profile management<br/>[userController.js]"]
  node_userdomain["User services<br/>[userService.js]"]
end

subgraph group_community["Forums and notices"]
  node_forumapi["Forum API<br/>[forum.js]"]
  node_forumcontroller["Forum operations<br/>[forumController.js]"]
  node_forumservices["Forum domain services<br/>[forumService.js]"]
  node_notifications["Notification services"]
end

subgraph group_resources["Files and announcements"]
  node_cloudui["Cloud pages<br/>[CloudPage.vue]"]
  node_cloudcontroller["Cloud operations<br/>[cloudController.js]"]
  node_cloudservices["Cloud services<br/>[cloudService.js]"]
  node_announcements["Announcements"]
  node_uploads[("Uploaded files<br/>[paths.js]")]
end

subgraph group_platform["API and persistence"]
  node_authroutes["Authentication routes<br/>[auth.js]"]
  node_forumroutes["Forum routes<br/>[forum.js]"]
  node_admincontroller["Administration<br/>[adminController.js]"]
  node_adminservices["Admin services<br/>[adminService.js]"]
  node_server["Express application<br/>[app.js]"]
  node_request["HTTP request client<br/>[request.js]"]
  node_database[("MySQL pool<br/>[db.js]")]
end

node_visitor(("Visitor or member"))

node_visitor -->|"opens pages"| node_navigation
node_navigation -->|"routes to"| node_public
node_navigation -->|"routes to"| node_login
node_navigation -->|"routes to"| node_forumui
node_navigation -->|"routes to"| node_postdetail
node_navigation -->|"routes to"| node_adminui
node_navigation -->|"routes to"| node_noticeui
node_navigation -->|"routes to"| node_cloudui
node_visitor -.->|"signs in"| node_login
node_userstate -->|"fetches bans"| node_request
node_request -.->|"sends API calls"| node_server
node_server -->|"mounts routes"| node_authroutes
node_server -->|"mounts routes"| node_forumroutes
node_forumroutes -->|"dispatches"| node_forumcontroller
node_adminui -->|"calls admin API"| node_request
node_postdetail -->|"loads forum data"| node_forumapi
node_forumapi -.->|"uses client"| node_request
node_forumcontroller -->|"calls domain services"| node_forumservices
node_forumcontroller -->|"creates notices"| node_notifications
node_forumcontroller -.->|"queries data"| node_database
node_admincontroller -->|"calls services"| node_adminservices
node_admincontroller -->|"creates notices"| node_notifications
node_adminui -.->|"manages users"| node_server
node_login -.->|"submits credentials"| node_userapi
node_userapi -.->|"requests authentication"| node_authroutes
node_authroutes -.->|"dispatches"| node_authcontroller
node_authcontroller -->|"looks up users"| node_userdomain
node_usercontroller -->|"calls user service"| node_userdomain
node_userdomain -->|"queries users"| node_database
node_forumservices -->|"queries forum data"| node_database
node_notifications -.->|"stores notices"| node_database
node_cloudcontroller -->|"calls cloud service"| node_cloudservices
node_cloudservices -->|"queries file records"| node_database
node_cloudcontroller -->|"handles file paths"| node_uploads
node_cloudui -.->|"uploads and downloads"| node_cloudcontroller
node_announcements -.->|"uses stored announcements"| node_database
node_admincontroller -.->|"publishes announcements"| node_announcements
node_noticeui -.->|"reads notifications"| node_notifications

click node_navigation "https://github.com/zshebjtzs/qdezjds/blob/main/src/router/index.js"
click node_public "https://github.com/zshebjtzs/qdezjds/blob/main/src/views/HomePage.vue"
click node_login "https://github.com/zshebjtzs/qdezjds/blob/main/src/views/LoginPage.vue"
click node_forumui "https://github.com/zshebjtzs/qdezjds/blob/main/src/views/ForumPage.vue"
click node_postdetail "https://github.com/zshebjtzs/qdezjds/blob/main/src/components/forum/postSingle.vue"
click node_markdown "https://github.com/zshebjtzs/qdezjds/blob/main/src/markdown/editor.vue"
click node_adminui "https://github.com/zshebjtzs/qdezjds/blob/main/src/components/admin/adminController.vue"
click node_userstate "https://github.com/zshebjtzs/qdezjds/blob/main/src/stores/user.js"
click node_userapi "https://github.com/zshebjtzs/qdezjds/blob/main/src/api/auth.js"
click node_authroutes "https://github.com/zshebjtzs/qdezjds/blob/main/server/routes/auth.js"
click node_authcontroller "https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/authController.js"
click node_usercontroller "https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/userController.js"
click node_userdomain "https://github.com/zshebjtzs/qdezjds/blob/main/server/services/userService.js"
click node_forumapi "https://github.com/zshebjtzs/qdezjds/blob/main/src/api/forum.js"
click node_forumroutes "https://github.com/zshebjtzs/qdezjds/blob/main/server/routes/forum.js"
click node_forumcontroller "https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/forumController.js"
click node_forumservices "https://github.com/zshebjtzs/qdezjds/blob/main/server/services/forumService.js"
click node_notifications "https://github.com/zshebjtzs/qdezjds/blob/main/server/services/notificationService.js"
click node_noticeui "https://github.com/zshebjtzs/qdezjds/blob/main/src/views/NotificationsPage.vue"
click node_cloudui "https://github.com/zshebjtzs/qdezjds/blob/main/src/views/CloudPage.vue"
click node_cloudcontroller "https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/cloudController.js"
click node_cloudservices "https://github.com/zshebjtzs/qdezjds/blob/main/server/services/cloudService.js"
click node_admincontroller "https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/adminController.js"
click node_adminservices "https://github.com/zshebjtzs/qdezjds/blob/main/server/services/adminService.js"
click node_announcements "https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/announcementController.js"
click node_server "https://github.com/zshebjtzs/qdezjds/blob/main/server/app.js"
click node_request "https://github.com/zshebjtzs/qdezjds/blob/main/src/api/request.js"
click node_database "https://github.com/zshebjtzs/qdezjds/blob/main/server/config/db.js"
click node_uploads "https://github.com/zshebjtzs/qdezjds/blob/main/server/config/paths.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_navigation,node_public,node_login,node_forumui,node_postdetail,node_markdown,node_adminui,node_noticeui toneBlue
class node_userstate,node_userapi,node_authcontroller,node_usercontroller,node_userdomain toneAmber
class node_forumapi,node_forumcontroller,node_forumservices,node_notifications toneMint
class node_cloudui,node_cloudcontroller,node_cloudservices,node_announcements,node_uploads toneRose
class node_authroutes,node_forumroutes,node_admincontroller,node_adminservices,node_server,node_request,node_database,node_visitor toneIndigo
```

## Components

### Web application

- [Page routing](https://github.com/zshebjtzs/qdezjds/blob/main/src/router/index.js): `src/router/index.js`
- [Public pages](https://github.com/zshebjtzs/qdezjds/blob/main/src/views/HomePage.vue): `src/views/HomePage.vue`
- [Login page](https://github.com/zshebjtzs/qdezjds/blob/main/src/views/LoginPage.vue): `src/views/LoginPage.vue`
- [Forum pages](https://github.com/zshebjtzs/qdezjds/blob/main/src/views/ForumPage.vue): `src/views/ForumPage.vue`
- [Post detail](https://github.com/zshebjtzs/qdezjds/blob/main/src/components/forum/postSingle.vue): `src/components/forum/postSingle.vue`
- [Markdown editor](https://github.com/zshebjtzs/qdezjds/blob/main/src/markdown/editor.vue): `src/markdown/editor.vue`
- [Admin console](https://github.com/zshebjtzs/qdezjds/blob/main/src/components/admin/adminController.vue): `src/components/admin/adminController.vue`
- [Notification page](https://github.com/zshebjtzs/qdezjds/blob/main/src/views/NotificationsPage.vue): `src/views/NotificationsPage.vue`

### Identity and profiles

- [User state](https://github.com/zshebjtzs/qdezjds/blob/main/src/stores/user.js): `src/stores/user.js`
- [User API](https://github.com/zshebjtzs/qdezjds/blob/main/src/api/auth.js): `src/api/auth.js`
- [Authentication](https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/authController.js): `server/controllers/authController.js`
- [Profile management](https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/userController.js): `server/controllers/userController.js`
- [User services](https://github.com/zshebjtzs/qdezjds/blob/main/server/services/userService.js): `server/services/userService.js`

### Forums and notices

- [Forum API](https://github.com/zshebjtzs/qdezjds/blob/main/src/api/forum.js): `src/api/forum.js`
- [Forum operations](https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/forumController.js): `server/controllers/forumController.js`
- [Forum domain services](https://github.com/zshebjtzs/qdezjds/blob/main/server/services/forumService.js): `server/services/forumService.js`
- [Notification services](https://github.com/zshebjtzs/qdezjds/blob/main/server/services/notificationService.js): `server/services/notificationService.js`

### Files and announcements

- [Cloud pages](https://github.com/zshebjtzs/qdezjds/blob/main/src/views/CloudPage.vue): `src/views/CloudPage.vue`
- [Cloud operations](https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/cloudController.js): `server/controllers/cloudController.js`
- [Cloud services](https://github.com/zshebjtzs/qdezjds/blob/main/server/services/cloudService.js): `server/services/cloudService.js`
- [Announcements](https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/announcementController.js): `server/controllers/announcementController.js`
- [Uploaded files](https://github.com/zshebjtzs/qdezjds/blob/main/server/config/paths.js): `server/config/paths.js`

### API and persistence

- [Authentication routes](https://github.com/zshebjtzs/qdezjds/blob/main/server/routes/auth.js): `server/routes/auth.js`
- [Forum routes](https://github.com/zshebjtzs/qdezjds/blob/main/server/routes/forum.js): `server/routes/forum.js`
- [Administration](https://github.com/zshebjtzs/qdezjds/blob/main/server/controllers/adminController.js): `server/controllers/adminController.js`
- [Admin services](https://github.com/zshebjtzs/qdezjds/blob/main/server/services/adminService.js): `server/services/adminService.js`
- [Express application](https://github.com/zshebjtzs/qdezjds/blob/main/server/app.js): `server/app.js`
- [HTTP request client](https://github.com/zshebjtzs/qdezjds/blob/main/src/api/request.js): `src/api/request.js`
- [MySQL pool](https://github.com/zshebjtzs/qdezjds/blob/main/server/config/db.js): `server/config/db.js`

### Other components

- **Visitor or member**

## Connections

- Visitor or member → Page routing: opens pages (evidence: `src/router/index.js`)
- Page routing → Public pages: routes to (evidence: `src/router/index.js`)
- Page routing → Login page: routes to (evidence: `src/router/index.js`)
- Page routing → Forum pages: routes to (evidence: `src/router/index.js`)
- Page routing → Post detail: routes to (evidence: `src/router/index.js`)
- Page routing → Admin console: routes to (evidence: `src/router/index.js`)
- Page routing → Notification page: routes to (evidence: `src/router/index.js`)
- Page routing → Cloud pages: routes to (evidence: `src/router/index.js`)
- Visitor or member → Login page: signs in (evidence: `README.md`)
- User state → HTTP request client: fetches bans (evidence: `src/stores/user.js`)
- HTTP request client → Express application: sends API calls (evidence: `README.md`)
- Express application → Authentication routes: mounts routes (evidence: `server/app.js`)
- Express application → Forum routes: mounts routes (evidence: `server/app.js`)
- Forum routes → Forum operations: dispatches (evidence: `server/routes/forum.js`)
- Admin console → HTTP request client: calls admin API (evidence: `src/components/admin/adminController.vue`)
- Post detail → Forum API: loads forum data (evidence: `src/components/forum/postSingle.vue`)
- Forum API → HTTP request client: uses client
- Forum operations → Forum domain services: calls domain services (evidence: `server/controllers/forumController.js`)
- Forum operations → Notification services: creates notices (evidence: `server/controllers/forumController.js`)
- Forum operations → MySQL pool: queries data (evidence: `server/controllers/forumController.js`)
- Administration → Admin services: calls services (evidence: `server/controllers/adminController.js`)
- Administration → Notification services: creates notices (evidence: `server/controllers/adminController.js`)
- Admin console → Express application: manages users (evidence: `README.md`)
- Login page → User API: submits credentials (evidence: `README.md`)
- User API → Authentication routes: requests authentication (evidence: `README.md`)
- Authentication routes → Authentication: dispatches
- Authentication → User services: looks up users (evidence: `server/controllers/authController.js`)
- Profile management → User services: calls user service (evidence: `server/controllers/userController.js`)
- User services → MySQL pool: queries users (evidence: `server/services/userService.js`)
- Forum domain services → MySQL pool: queries forum data (evidence: `server/services/forumService.js`)
- Notification services → MySQL pool: stores notices (evidence: `server/services/notificationService.js`)
- Cloud operations → Cloud services: calls cloud service (evidence: `server/controllers/cloudController.js`)
- Cloud services → MySQL pool: queries file records (evidence: `server/services/cloudService.js`)
- Cloud operations → Uploaded files: handles file paths (evidence: `server/controllers/cloudController.js`)
- Cloud pages → Cloud operations: uploads and downloads (evidence: `README.md`)
- Announcements → MySQL pool: uses stored announcements
- Administration → Announcements: publishes announcements (evidence: `README.md`)
- Notification page → Notification services: reads notifications (evidence: `README.md`)
