# game9xz/organizationproject architecture

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

- Interactive diagram: https://gitdiagram.com/game9xz/organizationproject
- Repository: https://github.com/game9xz/organizationproject

## Overview

This is an event-planning and operations application: users can manage event records and status, explore event and package details, track inventory and budgets, and use a 3D-design feature. The frontend routes users through these screens; its API client supports user registration, login, and lookup. The Express backend mounts user, event, activity, booking, borrowing, reset, inventory, and 3D-project endpoints, with controllers and route handlers using a MySQL pool. README documentation only covers how to run the client and server; connections beyond shown imports and mounts are not assumed.

Main entry points: [`frontend/src/App.jsx`](https://github.com/game9xz/organizationproject/blob/main/frontend/src/App.jsx) (App routes), [`backend/server.js`](https://github.com/game9xz/organizationproject/blob/main/backend/server.js) (Express server), [`backend/config/db.js`](https://github.com/game9xz/organizationproject/blob/main/backend/config/db.js) (MySQL pool), [`frontend/src/components/Workrecord.jsx`](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Workrecord.jsx) (Work records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web application"]
  node_app["App routes<br/>[App.jsx]"]
  node_auth["Authentication screens<br/>[LoginForm.jsx]"]
  node_api["API client<br/>[apiService.js]"]
end

subgraph group_planning["Event planning"]
  node_workrecord["Work records<br/>[Workrecord.jsx]"]
  node_workdetail["Work record detail"]
  node_workstatus["Work status<br/>[WorkStatus.jsx]"]
  node_eventdetails["Event details<br/>[EventDetail.jsx]"]
  node_eventpackages["Event packages<br/>[WeddingDetail.jsx]"]
  node_budget["Budget<br/>[Budget.jsx]"]
  node_workcontext["Work context<br/>[WorkContextBase.js]"]
end

subgraph group_operations["Operations"]
  node_inventory["Inventory<br/>[Inventory.jsx]"]
  node_inventorystatus["Inventory status"]
  node_design["3D design screen<br/>[Design3D.jsx]"]
  node_mapview["Location map<br/>[LocationMap.jsx]"]
  node_maphook["Map readiness hook<br/>[useLongdoMap.js]"]
end

subgraph group_server["Backend API"]
  node_server["Express server<br/>[server.js]"]
  node_useroutes["User routes<br/>[userRoutes.js]"]
  node_eventroutes["Event routes<br/>[eventRoutes.js]"]
  node_activityroutes["Activity routes<br/>[activityRoutes.js]"]
  node_bookingroutes["Booking routes<br/>[bookingRoutes.js]"]
  node_borrowroutes["Borrow routes<br/>[borrowRoutes.js]"]
  node_resetroutes["Reset routes<br/>[resetRoutes.js]"]
  node_inventoryroutes["Inventory routes<br/>[inventoryRoutes.js]"]
  node_designroutes["3D project routes<br/>[design3dRoutes.js]"]
  node_usercontroller["User controller<br/>[userController.js]"]
  node_eventcontroller["Event controller<br/>[eventController.js]"]
  node_activitycontroller["Activity controller"]
  node_bookingcontroller["Booking controller"]
  node_borrowcontroller["Borrow controller"]
  node_resetcontroller["Reset controller<br/>[resetController.js]"]
  node_inventorycontroller["Inventory controller"]
end

subgraph group_persistence["Persistence and maps"]
  node_database[("MySQL pool<br/>[db.js]")]
end

node_user(("User"))
node_longdo{{"Longdo map service"}}

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_auth
node_auth -->|"calls"| node_api
node_app -->|"routes to"| node_workrecord
node_app -->|"routes to"| node_workdetail
node_app -->|"routes to"| node_workstatus
node_app -->|"routes to"| node_eventdetails
node_app -->|"routes to"| node_eventpackages
node_app -->|"routes to"| node_budget
node_app -->|"routes to"| node_inventory
node_app -->|"routes to"| node_inventorystatus
node_app -->|"routes to"| node_design
node_workrecord -->|"reads context"| node_workcontext
node_workstatus -->|"reads context"| node_workcontext
node_budget -->|"reads context"| node_workcontext
node_workrecord -->|"renders"| node_mapview
node_workstatus -->|"renders"| node_mapview
node_workrecord -->|"uses"| node_maphook
node_workstatus -->|"uses"| node_maphook
node_maphook -.->|"checks readiness"| node_longdo
node_api -.->|"sends API requests"| node_server
node_server -->|"mounts"| node_useroutes
node_server -->|"mounts"| node_eventroutes
node_server -->|"mounts"| node_activityroutes
node_server -->|"mounts"| node_bookingroutes
node_server -->|"mounts"| node_borrowroutes
node_server -->|"mounts"| node_resetroutes
node_server -->|"mounts"| node_inventoryroutes
node_server -->|"mounts"| node_designroutes
node_useroutes -->|"dispatches"| node_usercontroller
node_eventroutes -->|"dispatches"| node_eventcontroller
node_activityroutes -->|"dispatches"| node_activitycontroller
node_bookingroutes -->|"dispatches"| node_bookingcontroller
node_borrowroutes -->|"dispatches"| node_borrowcontroller
node_resetroutes -->|"dispatches"| node_resetcontroller
node_inventoryroutes -->|"dispatches"| node_inventorycontroller
node_eventcontroller -->|"queries"| node_database
node_activitycontroller -->|"queries"| node_database
node_bookingcontroller -->|"queries"| node_database
node_borrowcontroller -->|"queries"| node_database
node_resetcontroller -->|"queries"| node_database
node_usercontroller -->|"queries"| node_database
node_inventorycontroller -->|"queries"| node_database
node_designroutes -->|"queries"| node_database

click node_app "https://github.com/game9xz/organizationproject/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/game9xz/organizationproject/blob/main/frontend/src/auth/LoginForm.jsx"
click node_api "https://github.com/game9xz/organizationproject/blob/main/frontend/src/api/apiService.js"
click node_workrecord "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Workrecord.jsx"
click node_workdetail "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/WorkRecordDetail.jsx"
click node_workstatus "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/WorkStatus.jsx"
click node_eventdetails "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/EventDetail.jsx"
click node_eventpackages "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/WeddingDetail.jsx"
click node_budget "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Budget.jsx"
click node_workcontext "https://github.com/game9xz/organizationproject/blob/main/frontend/src/context/WorkContextBase.js"
click node_inventory "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Inventory.jsx"
click node_inventorystatus "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/InventoryStatus.jsx"
click node_design "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Design3D.jsx"
click node_mapview "https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/LocationMap.jsx"
click node_maphook "https://github.com/game9xz/organizationproject/blob/main/frontend/src/hooks/useLongdoMap.js"
click node_server "https://github.com/game9xz/organizationproject/blob/main/backend/server.js"
click node_useroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/userRoutes.js"
click node_eventroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/eventRoutes.js"
click node_activityroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/activityRoutes.js"
click node_bookingroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/bookingRoutes.js"
click node_borrowroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/borrowRoutes.js"
click node_resetroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/resetRoutes.js"
click node_inventoryroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/inventoryRoutes.js"
click node_designroutes "https://github.com/game9xz/organizationproject/blob/main/backend/routes/design3dRoutes.js"
click node_usercontroller "https://github.com/game9xz/organizationproject/blob/main/backend/controllers/userController.js"
click node_eventcontroller "https://github.com/game9xz/organizationproject/blob/main/backend/controllers/eventController.js"
click node_activitycontroller "https://github.com/game9xz/organizationproject/blob/main/backend/controllers/activityController.js"
click node_bookingcontroller "https://github.com/game9xz/organizationproject/blob/main/backend/controllers/bookingController.js"
click node_borrowcontroller "https://github.com/game9xz/organizationproject/blob/main/backend/controllers/borrowController.js"
click node_resetcontroller "https://github.com/game9xz/organizationproject/blob/main/backend/controllers/resetController.js"
click node_inventorycontroller "https://github.com/game9xz/organizationproject/blob/main/backend/controllers/InventoryController.js"
click node_database "https://github.com/game9xz/organizationproject/blob/main/backend/config/db.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_auth,node_api,node_user toneBlue
class node_workrecord,node_workdetail,node_workstatus,node_eventdetails,node_eventpackages,node_budget,node_workcontext toneAmber
class node_inventory,node_inventorystatus,node_design,node_mapview,node_maphook toneMint
class node_server,node_useroutes,node_eventroutes,node_activityroutes,node_bookingroutes,node_borrowroutes,node_resetroutes,node_inventoryroutes,node_designroutes,node_usercontroller,node_eventcontroller,node_activitycontroller,node_bookingcontroller,node_borrowcontroller,node_resetcontroller,node_inventorycontroller toneRose
class node_database,node_longdo toneIndigo
```

## Components

### Web application

- [App routes](https://github.com/game9xz/organizationproject/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Authentication screens](https://github.com/game9xz/organizationproject/blob/main/frontend/src/auth/LoginForm.jsx): `frontend/src/auth/LoginForm.jsx`
- [API client](https://github.com/game9xz/organizationproject/blob/main/frontend/src/api/apiService.js): `frontend/src/api/apiService.js`

### Event planning

- [Work records](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Workrecord.jsx): `frontend/src/components/Workrecord.jsx`
- [Work record detail](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/WorkRecordDetail.jsx): `frontend/src/components/WorkRecordDetail.jsx`
- [Work status](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/WorkStatus.jsx): `frontend/src/components/WorkStatus.jsx`
- [Event details](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/EventDetail.jsx): `frontend/src/components/EventDetail.jsx`
- [Event packages](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/WeddingDetail.jsx): `frontend/src/components/WeddingDetail.jsx`
- [Budget](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Budget.jsx): `frontend/src/components/Budget.jsx`
- [Work context](https://github.com/game9xz/organizationproject/blob/main/frontend/src/context/WorkContextBase.js): `frontend/src/context/WorkContextBase.js`

### Operations

- [Inventory](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Inventory.jsx): `frontend/src/components/Inventory.jsx`
- [Inventory status](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/InventoryStatus.jsx): `frontend/src/components/InventoryStatus.jsx`
- [3D design screen](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/Design3D.jsx): `frontend/src/components/Design3D.jsx`
- [Location map](https://github.com/game9xz/organizationproject/blob/main/frontend/src/components/LocationMap.jsx): `frontend/src/components/LocationMap.jsx`
- [Map readiness hook](https://github.com/game9xz/organizationproject/blob/main/frontend/src/hooks/useLongdoMap.js): `frontend/src/hooks/useLongdoMap.js`

### Backend API

- [Express server](https://github.com/game9xz/organizationproject/blob/main/backend/server.js): `backend/server.js`
- [User routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Event routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/eventRoutes.js): `backend/routes/eventRoutes.js`
- [Activity routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/activityRoutes.js): `backend/routes/activityRoutes.js`
- [Booking routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/bookingRoutes.js): `backend/routes/bookingRoutes.js`
- [Borrow routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/borrowRoutes.js): `backend/routes/borrowRoutes.js`
- [Reset routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/resetRoutes.js): `backend/routes/resetRoutes.js`
- [Inventory routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/inventoryRoutes.js): `backend/routes/inventoryRoutes.js`
- [3D project routes](https://github.com/game9xz/organizationproject/blob/main/backend/routes/design3dRoutes.js): `backend/routes/design3dRoutes.js`
- [User controller](https://github.com/game9xz/organizationproject/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Event controller](https://github.com/game9xz/organizationproject/blob/main/backend/controllers/eventController.js): `backend/controllers/eventController.js`
- [Activity controller](https://github.com/game9xz/organizationproject/blob/main/backend/controllers/activityController.js): `backend/controllers/activityController.js`
- [Booking controller](https://github.com/game9xz/organizationproject/blob/main/backend/controllers/bookingController.js): `backend/controllers/bookingController.js`
- [Borrow controller](https://github.com/game9xz/organizationproject/blob/main/backend/controllers/borrowController.js): `backend/controllers/borrowController.js`
- [Reset controller](https://github.com/game9xz/organizationproject/blob/main/backend/controllers/resetController.js): `backend/controllers/resetController.js`
- [Inventory controller](https://github.com/game9xz/organizationproject/blob/main/backend/controllers/InventoryController.js): `backend/controllers/InventoryController.js`

### Persistence and maps

- [MySQL pool](https://github.com/game9xz/organizationproject/blob/main/backend/config/db.js): `backend/config/db.js`

### Other components

- **User**
- **Longdo map service**

## Connections

- User → App routes: uses (evidence: `frontend/src/App.jsx`)
- App routes → Authentication screens: routes to (evidence: `frontend/src/App.jsx`)
- Authentication screens → API client: calls (evidence: `frontend/src/auth/LoginForm.jsx`)
- App routes → Work records: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Work record detail: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Work status: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Event details: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Event packages: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Budget: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Inventory: routes to (evidence: `frontend/src/App.jsx`)
- App routes → Inventory status: routes to (evidence: `frontend/src/App.jsx`)
- App routes → 3D design screen: routes to (evidence: `frontend/src/App.jsx`)
- Work records → Work context: reads context (evidence: `frontend/src/components/Workrecord.jsx`)
- Work status → Work context: reads context (evidence: `frontend/src/components/WorkStatus.jsx`)
- Budget → Work context: reads context (evidence: `frontend/src/components/Budget.jsx`)
- Work records → Location map: renders (evidence: `frontend/src/components/Workrecord.jsx`)
- Work status → Location map: renders (evidence: `frontend/src/components/WorkStatus.jsx`)
- Work records → Map readiness hook: uses (evidence: `frontend/src/components/Workrecord.jsx`)
- Work status → Map readiness hook: uses (evidence: `frontend/src/components/WorkStatus.jsx`)
- Map readiness hook → Longdo map service: checks readiness (evidence: `frontend/src/hooks/useLongdoMap.js`)
- API client → Express server: sends API requests
- Express server → User routes: mounts (evidence: `backend/server.js`)
- Express server → Event routes: mounts (evidence: `backend/server.js`)
- Express server → Activity routes: mounts (evidence: `backend/server.js`)
- Express server → Booking routes: mounts (evidence: `backend/server.js`)
- Express server → Borrow routes: mounts (evidence: `backend/server.js`)
- Express server → Reset routes: mounts (evidence: `backend/server.js`)
- Express server → Inventory routes: mounts (evidence: `backend/server.js`)
- Express server → 3D project routes: mounts (evidence: `backend/server.js`)
- User routes → User controller: dispatches (evidence: `backend/routes/userRoutes.js`)
- Event routes → Event controller: dispatches (evidence: `backend/routes/eventRoutes.js`)
- Activity routes → Activity controller: dispatches (evidence: `backend/routes/activityRoutes.js`)
- Booking routes → Booking controller: dispatches (evidence: `backend/routes/bookingRoutes.js`)
- Borrow routes → Borrow controller: dispatches (evidence: `backend/routes/borrowRoutes.js`)
- Reset routes → Reset controller: dispatches (evidence: `backend/routes/resetRoutes.js`)
- Inventory routes → Inventory controller: dispatches (evidence: `backend/routes/inventoryRoutes.js`)
- Event controller → MySQL pool: queries (evidence: `backend/controllers/eventController.js`)
- Activity controller → MySQL pool: queries (evidence: `backend/controllers/activityController.js`)
- Booking controller → MySQL pool: queries (evidence: `backend/controllers/bookingController.js`)
- Borrow controller → MySQL pool: queries (evidence: `backend/controllers/borrowController.js`)
- Reset controller → MySQL pool: queries (evidence: `backend/controllers/resetController.js`)
- User controller → MySQL pool: queries (evidence: `backend/controllers/userController.js`)
- Inventory controller → MySQL pool: queries (evidence: `backend/controllers/InventoryController.js`)
- 3D project routes → MySQL pool: queries (evidence: `backend/routes/design3dRoutes.js`)
