# khievsothy/culture-back-end architecture

> Architecture diagram of the GitHub repository khievsothy/culture-back-end, 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/khievsothy/culture-back-end
- Repository: https://github.com/khievsothy/culture-back-end

## Overview

This is a Node/Express cultural-heritage API. Clients call the server’s mounted resource routes; route handlers delegate to controllers that implement account and heritage-resource operations, which use Mongoose models for persistence. Authentication includes password and Google OAuth flows; middleware provides JWT checks, validation, uploads, permissions, and response caching. The server also connects MongoDB and Redis and serves uploaded files. Several resource modules are represented from the tree and SOURCE INDEX, but their implementation details were not sampled, so the graph limits their internal links accordingly.

Main entry points: [`src/routes`](https://github.com/khievsothy/culture-back-end/tree/main/src/routes) (Resource routes), [`index.js`](https://github.com/khievsothy/culture-back-end/blob/main/index.js) (Express app), [`src/redis/index.js`](https://github.com/khievsothy/culture-back-end/blob/main/src/redis/index.js) (Redis client), [`src/models`](https://github.com/khievsothy/culture-back-end/tree/main/src/models) (Heritage models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_server["HTTP server"]
  node_app["Express app<br/>[index.js]"]
  node_resource_routes["Resource routes"]
  node_middleware["Request middleware<br/>[index.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_route["Auth routes<br/>[auth.js]"]
  node_auth_controller["Auth operations<br/>[auth.js]"]
  node_jwt_strategy["JWT strategy<br/>[jwt.js]"]
  node_jwt_signing["JWT signing<br/>[index.js]"]
  node_user_controller["User operations<br/>[user.js]"]
  node_user_model["User model<br/>[user.js]"]
end

subgraph group_heritage["Heritage resources"]
  node_event_controller["Event operations<br/>[event.js]"]
  node_historical_controller["Historic-site operations<br/>[historical_site.js]"]
  node_lost_controller["Lost-artifact operations<br/>[lost_artefact.js]"]
  node_museum_controller["Museum operations<br/>[museum.js]"]
  node_site_controller["Site operations<br/>[site.js]"]
  node_art_controller["Art operations<br/>[art.js]"]
  node_file_controller["File operations<br/>[file.js]"]
  node_heritage_models["Heritage models"]
end

subgraph group_infrastructure["Persistence and cache"]
  node_mongo_connector["Mongo connector<br/>[db.js]"]
  node_mongodb[("MongoDB")]
  node_redis_client["Redis client<br/>[index.js]"]
  node_redis[("Redis")]
end

node_client(("API client"))
node_google_oauth["Google OAuth"]

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_resource_routes
node_app -->|"mounts routes"| node_auth_route
node_app -->|"connects database"| node_mongo_connector
node_app -->|"connects cache"| node_redis_client
node_app -->|"registers handlers"| node_middleware
node_resource_routes -->|"dispatches to"| node_event_controller
node_resource_routes -->|"dispatches to"| node_historical_controller
node_resource_routes -->|"dispatches to"| node_lost_controller
node_resource_routes -->|"dispatches to"| node_museum_controller
node_resource_routes -->|"dispatches to"| node_site_controller
node_resource_routes -->|"dispatches to"| node_art_controller
node_resource_routes -->|"dispatches to"| node_file_controller
node_auth_route -->|"dispatches to"| node_auth_controller
node_auth_route -->|"validates signup"| node_middleware
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"signs tokens"| node_jwt_signing
node_auth_controller -->|"exchanges OAuth code"| node_google_oauth
node_jwt_strategy -->|"loads user"| node_user_model
node_middleware -->|"loads user"| node_user_model
node_middleware -->|"caches responses"| node_redis_client
node_resource_routes -->|"dispatches to"| node_user_controller
node_event_controller -->|"uses event model"| node_heritage_models
node_historical_controller -->|"uses site model"| node_heritage_models
node_lost_controller -->|"uses artifact model"| node_heritage_models
node_museum_controller -->|"uses museum model"| node_heritage_models
node_site_controller -->|"uses site model"| node_heritage_models
node_file_controller -->|"uses file model"| node_heritage_models
node_mongo_connector -->|"opens connection"| node_mongodb
node_event_controller -->|"uses cache"| node_redis_client
node_museum_controller -->|"uses cache"| node_redis_client
node_site_controller -->|"uses cache"| node_redis_client
node_redis_client -->|"connects to"| node_redis

click node_app "https://github.com/khievsothy/culture-back-end/blob/main/index.js"
click node_resource_routes "https://github.com/khievsothy/culture-back-end/tree/main/src/routes"
click node_auth_route "https://github.com/khievsothy/culture-back-end/blob/main/src/routes/auth.js"
click node_middleware "https://github.com/khievsothy/culture-back-end/blob/main/src/middlewares/index.js"
click node_auth_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/auth.js"
click node_jwt_strategy "https://github.com/khievsothy/culture-back-end/blob/main/src/common/strategy/jwt.js"
click node_jwt_signing "https://github.com/khievsothy/culture-back-end/blob/main/src/utils/index.js"
click node_user_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/user.js"
click node_user_model "https://github.com/khievsothy/culture-back-end/blob/main/src/models/user.js"
click node_event_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/event.js"
click node_historical_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/historical_site.js"
click node_lost_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/lost_artefact.js"
click node_museum_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/museum.js"
click node_site_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/site.js"
click node_art_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/art.js"
click node_file_controller "https://github.com/khievsothy/culture-back-end/blob/main/src/controller/file.js"
click node_heritage_models "https://github.com/khievsothy/culture-back-end/tree/main/src/models"
click node_mongo_connector "https://github.com/khievsothy/culture-back-end/blob/main/src/db/db.js"
click node_redis_client "https://github.com/khievsothy/culture-back-end/blob/main/src/redis/index.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_resource_routes,node_middleware,node_client toneBlue
class node_auth_route,node_auth_controller,node_jwt_strategy,node_jwt_signing,node_user_controller,node_user_model toneAmber
class node_event_controller,node_historical_controller,node_lost_controller,node_museum_controller,node_site_controller,node_art_controller,node_file_controller,node_heritage_models toneMint
class node_mongo_connector,node_mongodb,node_redis_client,node_redis toneRose
class node_google_oauth toneIndigo
```

## Components

### HTTP server

- [Express app](https://github.com/khievsothy/culture-back-end/blob/main/index.js): `index.js`
- [Resource routes](https://github.com/khievsothy/culture-back-end/tree/main/src/routes): `src/routes`
- [Request middleware](https://github.com/khievsothy/culture-back-end/blob/main/src/middlewares/index.js): `src/middlewares/index.js`

### Identity and access

- [Auth routes](https://github.com/khievsothy/culture-back-end/blob/main/src/routes/auth.js): `src/routes/auth.js`
- [Auth operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/auth.js): `src/controller/auth.js`
- [JWT strategy](https://github.com/khievsothy/culture-back-end/blob/main/src/common/strategy/jwt.js): `src/common/strategy/jwt.js`
- [JWT signing](https://github.com/khievsothy/culture-back-end/blob/main/src/utils/index.js): `src/utils/index.js`
- [User operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/user.js): `src/controller/user.js`
- [User model](https://github.com/khievsothy/culture-back-end/blob/main/src/models/user.js): `src/models/user.js`

### Heritage resources

- [Event operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/event.js): `src/controller/event.js`
- [Historic-site operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/historical_site.js): `src/controller/historical_site.js`
- [Lost-artifact operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/lost_artefact.js): `src/controller/lost_artefact.js`
- [Museum operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/museum.js): `src/controller/museum.js`
- [Site operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/site.js): `src/controller/site.js`
- [Art operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/art.js): `src/controller/art.js`
- [File operations](https://github.com/khievsothy/culture-back-end/blob/main/src/controller/file.js): `src/controller/file.js`
- [Heritage models](https://github.com/khievsothy/culture-back-end/tree/main/src/models): `src/models`

### Persistence and cache

- [Mongo connector](https://github.com/khievsothy/culture-back-end/blob/main/src/db/db.js): `src/db/db.js`
- **MongoDB**
- [Redis client](https://github.com/khievsothy/culture-back-end/blob/main/src/redis/index.js): `src/redis/index.js`
- **Redis**

### Other components

- **API client**
- **Google OAuth**

## Connections

- API client → Express app: sends requests
- Express app → Resource routes: mounts routes (evidence: `index.js`)
- Express app → Auth routes: mounts routes (evidence: `index.js`)
- Express app → Mongo connector: connects database (evidence: `index.js`)
- Express app → Redis client: connects cache (evidence: `index.js`)
- Express app → Request middleware: registers handlers (evidence: `index.js`)
- Resource routes → Event operations: dispatches to (evidence: `src/routes/event.js`)
- Resource routes → Historic-site operations: dispatches to (evidence: `src/routes/historical_site.js`)
- Resource routes → Lost-artifact operations: dispatches to (evidence: `src/routes/lost_artefact.js`)
- Resource routes → Museum operations: dispatches to (evidence: `src/routes/museum.js`)
- Resource routes → Site operations: dispatches to (evidence: `src/routes/site.js`)
- Resource routes → Art operations: dispatches to (evidence: `src/routes/art.js`)
- Resource routes → File operations: dispatches to (evidence: `src/routes/file.js`)
- Auth routes → Auth operations: dispatches to (evidence: `src/routes/auth.js`)
- Auth routes → Request middleware: validates signup (evidence: `src/routes/auth.js`)
- Auth operations → User model: reads and writes (evidence: `src/controller/auth.js`)
- Auth operations → JWT signing: signs tokens (evidence: `src/controller/auth.js`)
- Auth operations → Google OAuth: exchanges OAuth code (evidence: `src/controller/auth.js`)
- JWT strategy → User model: loads user (evidence: `src/common/strategy/jwt.js`)
- Request middleware → User model: loads user (evidence: `src/middlewares/index.js`)
- Request middleware → Redis client: caches responses (evidence: `src/middlewares/index.js`)
- Resource routes → User operations: dispatches to (evidence: `src/routes/user.js`)
- Event operations → Heritage models: uses event model (evidence: `src/controller/event.js`)
- Historic-site operations → Heritage models: uses site model (evidence: `src/controller/historical_site.js`)
- Lost-artifact operations → Heritage models: uses artifact model (evidence: `src/controller/lost_artefact.js`)
- Museum operations → Heritage models: uses museum model (evidence: `src/controller/museum.js`)
- Site operations → Heritage models: uses site model (evidence: `src/controller/site.js`)
- File operations → Heritage models: uses file model (evidence: `src/controller/file.js`)
- Mongo connector → MongoDB: opens connection (evidence: `src/db/db.js`)
- Event operations → Redis client: uses cache (evidence: `src/controller/event.js`)
- Museum operations → Redis client: uses cache (evidence: `src/controller/museum.js`)
- Site operations → Redis client: uses cache (evidence: `src/controller/site.js`)
- Redis client → Redis: connects to (evidence: `src/redis/index.js`)
