# nnq1610/cuu_ho_xe architecture

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

- Interactive diagram: https://gitdiagram.com/nnq1610/cuu_ho_xe
- Repository: https://github.com/nnq1610/cuu_ho_xe

## Overview

This is a Vietnamese-language rescue-services API. Its visible workflow is HTTP request routing into access, rescue, or review controllers, then service operations that return responses and use MongoDB-backed models; access also issues JWTs, while rescue listings can use uploaded images. The README gives only the product name, so broader product capabilities and some wiring are uncertain. Edges below are limited to relationships shown in excerpts or the source index; dashed edges indicate the external API entry point is inferred.

Main entry points: [`src/routes/index.js`](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/index.js) (Route mounts), [`src/services/access.service.js`](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/services/access.service.js) (Access service), [`src/routes/rescue/index.js`](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/rescue/index.js) (Rescue routes), [`src/app.js`](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/app.js) (Express app)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["API runtime"]
  node_server["HTTP server<br/>[server.js]"]
  node_app["Express app<br/>[app.js]"]
  node_routes["Route mounts<br/>[index.js]"]
  node_dbinit["Database init<br/>[init.mongodb.js]"]
  node_responses["Response format"]
end

subgraph group_access["Accounts"]
  node_authroutes["Access routes<br/>[index.js]"]
  node_accessctl["Access controller"]
  node_accesssvc["Access service<br/>[access.service.js]"]
  node_jwt["JWT guard<br/>[checkJWT.js]"]
  node_users[("User model<br/>[user.model.js]")]
end

subgraph group_rescue["Rescue services"]
  node_rescuepaths["Rescue routes<br/>[index.js]"]
  node_rescuectl["Rescue controller"]
  node_rescuesvc["Rescue service<br/>[rescue.service.js]"]
  node_rescuemodel[("Rescue unit model")]
  node_upload["Image upload<br/>[upload.js]"]
  node_cloudinary["Cloudinary"]
end

subgraph group_reviews["Reviews"]
  node_reviewpaths["Review routes<br/>[index.js]"]
  node_reviewctl["Review controller"]
  node_reviewsvc["Review service<br/>[review.service.js]"]
  node_reviewmodel[("Review model<br/>[review.model.js]")]
end

node_caller(("API client"))
node_mongodb[("MongoDB")]

node_caller -.->|"sends requests"| node_app
node_server -->|"starts"| node_app
node_app -->|"mounts"| node_routes
node_app -->|"loads"| node_dbinit
node_routes -->|"mounts"| node_authroutes
node_routes -->|"mounts"| node_rescuepaths
node_routes -->|"mounts"| node_reviewpaths
node_authroutes -->|"dispatches"| node_accessctl
node_authroutes -->|"checks"| node_jwt
node_rescuepaths -->|"dispatches"| node_rescuectl
node_rescuepaths -->|"checks"| node_jwt
node_rescuepaths -->|"uploads"| node_upload
node_reviewpaths -->|"dispatches"| node_reviewctl
node_accessctl -->|"calls"| node_accesssvc
node_accessctl -->|"formats"| node_responses
node_rescuectl -->|"calls"| node_rescuesvc
node_rescuectl -->|"formats"| node_responses
node_reviewctl -->|"calls"| node_reviewsvc
node_reviewctl -->|"formats"| node_responses
node_accesssvc -->|"reads/writes"| node_users
node_accesssvc -->|"deletes"| node_reviewmodel
node_accesssvc -->|"deletes"| node_rescuemodel
node_rescuesvc -->|"reads/writes"| node_rescuemodel
node_rescuesvc -->|"uses"| node_cloudinary
node_reviewsvc -->|"reads/writes"| node_reviewmodel
node_reviewsvc -->|"checks services"| node_rescuemodel
node_upload -->|"uploads to"| node_cloudinary
node_dbinit -.->|"initializes"| node_mongodb

click node_server "https://github.com/nnq1610/cuu_ho_xe/blob/backend/server.js"
click node_app "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/app.js"
click node_routes "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/index.js"
click node_dbinit "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/dbs/init.mongodb.js"
click node_authroutes "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/access/index.js"
click node_accessctl "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/controllers/access.controller.js"
click node_accesssvc "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/services/access.service.js"
click node_jwt "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/middlewares/checkJWT.js"
click node_users "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/models/user.model.js"
click node_rescuepaths "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/rescue/index.js"
click node_rescuectl "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/controllers/rescue.controller.js"
click node_rescuesvc "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/services/rescue.service.js"
click node_rescuemodel "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/models/rescueUnit.model.js"
click node_upload "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/middlewares/upload.js"
click node_cloudinary "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/configs/cloudinary.config.js"
click node_reviewpaths "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/review/index.js"
click node_reviewctl "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/controllers/review.controller.js"
click node_reviewsvc "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/services/review.service.js"
click node_reviewmodel "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/models/review.model.js"
click node_responses "https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/core/success.response.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_server,node_app,node_routes,node_dbinit,node_responses,node_caller toneBlue
class node_authroutes,node_accessctl,node_accesssvc,node_jwt,node_users,node_mongodb toneAmber
class node_rescuepaths,node_rescuectl,node_rescuesvc,node_rescuemodel,node_upload,node_cloudinary toneMint
class node_reviewpaths,node_reviewctl,node_reviewsvc,node_reviewmodel toneRose
```

## Components

### API runtime

- [HTTP server](https://github.com/nnq1610/cuu_ho_xe/blob/backend/server.js): `server.js`
- [Express app](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/app.js): `src/app.js`
- [Route mounts](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/index.js): `src/routes/index.js`
- [Database init](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/dbs/init.mongodb.js): `src/dbs/init.mongodb.js`
- [Response format](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/core/success.response.js): `src/core/success.response.js`

### Accounts

- [Access routes](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/access/index.js): `src/routes/access/index.js`
- [Access controller](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/controllers/access.controller.js): `src/controllers/access.controller.js`
- [Access service](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/services/access.service.js): `src/services/access.service.js`
- [JWT guard](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/middlewares/checkJWT.js): `src/middlewares/checkJWT.js`
- [User model](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/models/user.model.js): `src/models/user.model.js`

### Rescue services

- [Rescue routes](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/rescue/index.js): `src/routes/rescue/index.js`
- [Rescue controller](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/controllers/rescue.controller.js): `src/controllers/rescue.controller.js`
- [Rescue service](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/services/rescue.service.js): `src/services/rescue.service.js`
- [Rescue unit model](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/models/rescueUnit.model.js): `src/models/rescueUnit.model.js`
- [Image upload](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/middlewares/upload.js): `src/middlewares/upload.js`
- [Cloudinary](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/configs/cloudinary.config.js): `src/configs/cloudinary.config.js`

### Reviews

- [Review routes](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/routes/review/index.js): `src/routes/review/index.js`
- [Review controller](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/controllers/review.controller.js): `src/controllers/review.controller.js`
- [Review service](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/services/review.service.js): `src/services/review.service.js`
- [Review model](https://github.com/nnq1610/cuu_ho_xe/blob/backend/src/models/review.model.js): `src/models/review.model.js`

### Other components

- **API client**
- **MongoDB**

## Connections

- API client → Express app: sends requests
- HTTP server → Express app: starts (evidence: `server.js`)
- Express app → Route mounts: mounts (evidence: `src/app.js`)
- Express app → Database init: loads (evidence: `src/app.js`)
- Route mounts → Access routes: mounts (evidence: `src/routes/index.js`)
- Route mounts → Rescue routes: mounts (evidence: `src/routes/index.js`)
- Route mounts → Review routes: mounts (evidence: `src/routes/index.js`)
- Access routes → Access controller: dispatches (evidence: `src/routes/access/index.js`)
- Access routes → JWT guard: checks (evidence: `src/routes/access/index.js`)
- Rescue routes → Rescue controller: dispatches (evidence: `src/routes/rescue/index.js`)
- Rescue routes → JWT guard: checks (evidence: `src/routes/rescue/index.js`)
- Rescue routes → Image upload: uploads (evidence: `src/routes/rescue/index.js`)
- Review routes → Review controller: dispatches (evidence: `src/routes/review/index.js`)
- Access controller → Access service: calls (evidence: `src/controllers/access.controller.js`)
- Access controller → Response format: formats (evidence: `src/controllers/access.controller.js`)
- Rescue controller → Rescue service: calls (evidence: `src/controllers/rescue.controller.js`)
- Rescue controller → Response format: formats (evidence: `src/controllers/rescue.controller.js`)
- Review controller → Review service: calls (evidence: `src/controllers/review.controller.js`)
- Review controller → Response format: formats (evidence: `src/controllers/review.controller.js`)
- Access service → User model: reads/writes (evidence: `src/services/access.service.js`)
- Access service → Review model: deletes (evidence: `src/services/access.service.js`)
- Access service → Rescue unit model: deletes (evidence: `src/services/access.service.js`)
- Rescue service → Rescue unit model: reads/writes (evidence: `src/services/rescue.service.js`)
- Rescue service → Cloudinary: uses (evidence: `src/services/rescue.service.js`)
- Review service → Review model: reads/writes (evidence: `src/services/review.service.js`)
- Review service → Rescue unit model: checks services (evidence: `src/services/review.service.js`)
- Image upload → Cloudinary: uploads to (evidence: `src/middlewares/upload.js`)
- Database init → MongoDB: initializes
