# noob0074/hashchatbackend architecture

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

- Interactive diagram: https://gitdiagram.com/noob0074/hashchatbackend
- Repository: https://github.com/noob0074/hashchatbackend

## Overview

This is the backend for a chat application with guest and registered accounts, public/private rooms and direct messages, persistent messaging, and real-time presence and updates. The main workflow is an HTTP request authenticated by JWT middleware, routed to a controller, and handled against user, room, message, or limit models; socket events provide a parallel real-time messaging path. Controllers also manage media uploads and cleanup. The README is empty, so product capabilities and relationships here are grounded in the supplied source index and excerpts; unsampled route and cleanup details are kept limited.

Main entry points: [`server.js`](https://github.com/noob0074/hashchatbackend/blob/main/server.js) (HTTP server), [`controllers/roomController.js`](https://github.com/noob0074/hashchatbackend/blob/main/controllers/roomController.js) (Room workflows), [`controllers/messageController.js`](https://github.com/noob0074/hashchatbackend/blob/main/controllers/messageController.js) (Message workflows), [`socket/index.js`](https://github.com/noob0074/hashchatbackend/blob/main/socket/index.js) (Socket events)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["HTTP and realtime entry"]
  node_server["HTTP server<br/>[server.js]"]
  node_auth_routes["Auth routes<br/>[auth.js]"]
  node_user_routes["User routes<br/>[users.js]"]
  node_room_routes["Room routes<br/>[rooms.js]"]
  node_message_routes["Message routes<br/>[messages.js]"]
  node_file_routes["File routes<br/>[files.js]"]
  node_config_routes["Config routes<br/>[config.js]"]
  node_socket["Socket events<br/>[index.js]"]
end

subgraph group_identity["Identity and policy"]
  node_auth_mw["JWT middleware<br/>[auth.js]"]
  node_deleted_mw["Deleted-account guard<br/>[checkDeleted.js]"]
  node_auth_controller["Account workflows<br/>[authController.js]"]
  node_user_controller["User workflows<br/>[userController.js]"]
  node_user_model["User records<br/>[User.js]"]
  node_verification_model["Verification records<br/>[Verification.js]"]
  node_limit_model["Rate-limit records<br/>[Limit.js]"]
  node_rate_limiter["Rate limiting<br/>[rateLimiter.js]"]
  node_sanitize["Input sanitization<br/>[sanitize.js]"]
  node_email["Email delivery<br/>[email.js]"]
end

subgraph group_chat["Chat domain"]
  node_room_controller["Room workflows<br/>[roomController.js]"]
  node_message_controller["Message workflows"]
  node_room_model["Room records<br/>[Room.js]"]
  node_message_model["Message records<br/>[Message.js]"]
end

subgraph group_media["Media and operations"]
  node_file_controller["Upload signing and deletion<br/>[fileController.js]"]
  node_cloudinary["Cloudinary config<br/>[cloudinary.js]"]
  node_cleanup["Data cleanup<br/>[cleanup.js]"]
end

node_client(("Chat client"))
node_email_service["Email provider"]
node_cloudinary_service["Cloudinary"]

node_client -->|"sends requests"| node_server
node_server -->|"mounts routes"| node_auth_routes
node_server -->|"mounts routes"| node_user_routes
node_server -->|"mounts routes"| node_room_routes
node_server -->|"mounts routes"| node_message_routes
node_server -->|"mounts routes"| node_file_routes
node_server -->|"mounts routes"| node_config_routes
node_server -->|"initializes"| node_socket
node_auth_routes -->|"applies"| node_auth_mw
node_user_routes -->|"applies"| node_auth_mw
node_room_routes -->|"applies"| node_auth_mw
node_message_routes -->|"applies"| node_auth_mw
node_file_routes -->|"applies"| node_auth_mw
node_auth_routes -->|"applies"| node_deleted_mw
node_user_routes -->|"applies"| node_deleted_mw
node_room_routes -->|"applies"| node_deleted_mw
node_message_routes -->|"applies"| node_deleted_mw
node_file_routes -->|"applies"| node_deleted_mw
node_auth_routes -->|"dispatches"| node_auth_controller
node_user_routes -->|"dispatches"| node_user_controller
node_room_routes -->|"dispatches"| node_room_controller
node_message_routes -->|"dispatches"| node_message_controller
node_file_routes -->|"dispatches"| node_file_controller
node_config_routes -.->|"serves config"| node_server
node_auth_mw -->|"loads account"| node_user_model
node_auth_controller -->|"reads and writes"| node_user_model
node_auth_controller -->|"manages tokens"| node_verification_model
node_auth_controller -->|"checks limits"| node_rate_limiter
node_auth_controller -->|"sends messages"| node_email
node_auth_controller -.->|"delivers email"| node_email_service
node_user_controller -->|"manages accounts"| node_user_model
node_user_controller -->|"uses verification"| node_verification_model
node_user_controller -->|"notifies users"| node_socket
node_room_controller -->|"manages rooms"| node_room_model
node_room_controller -->|"reads and deletes"| node_message_model
node_room_controller -->|"loads members"| node_user_model
node_room_controller -->|"checks limits"| node_rate_limiter
node_room_controller -->|"emits updates"| node_socket
node_room_controller -->|"deletes media"| node_file_controller
node_message_controller -->|"queries messages"| node_message_model
node_message_controller -->|"checks rooms"| node_room_model
node_message_controller -->|"checks users"| node_user_model
node_message_controller -->|"sanitizes input"| node_sanitize
node_message_controller -->|"broadcasts updates"| node_socket
node_message_controller -->|"deletes media"| node_file_controller
node_socket -->|"stores messages"| node_message_model
node_socket -->|"checks room access"| node_room_model
node_socket -->|"checks accounts"| node_user_model

click node_server "https://github.com/noob0074/hashchatbackend/blob/main/server.js"
click node_auth_routes "https://github.com/noob0074/hashchatbackend/blob/main/routes/auth.js"
click node_user_routes "https://github.com/noob0074/hashchatbackend/blob/main/routes/users.js"
click node_room_routes "https://github.com/noob0074/hashchatbackend/blob/main/routes/rooms.js"
click node_message_routes "https://github.com/noob0074/hashchatbackend/blob/main/routes/messages.js"
click node_file_routes "https://github.com/noob0074/hashchatbackend/blob/main/routes/files.js"
click node_config_routes "https://github.com/noob0074/hashchatbackend/blob/main/routes/config.js"
click node_socket "https://github.com/noob0074/hashchatbackend/blob/main/socket/index.js"
click node_auth_mw "https://github.com/noob0074/hashchatbackend/blob/main/middleware/auth.js"
click node_deleted_mw "https://github.com/noob0074/hashchatbackend/blob/main/middleware/checkDeleted.js"
click node_auth_controller "https://github.com/noob0074/hashchatbackend/blob/main/controllers/authController.js"
click node_user_controller "https://github.com/noob0074/hashchatbackend/blob/main/controllers/userController.js"
click node_user_model "https://github.com/noob0074/hashchatbackend/blob/main/models/User.js"
click node_verification_model "https://github.com/noob0074/hashchatbackend/blob/main/models/Verification.js"
click node_room_controller "https://github.com/noob0074/hashchatbackend/blob/main/controllers/roomController.js"
click node_message_controller "https://github.com/noob0074/hashchatbackend/blob/main/controllers/messageController.js"
click node_room_model "https://github.com/noob0074/hashchatbackend/blob/main/models/Room.js"
click node_message_model "https://github.com/noob0074/hashchatbackend/blob/main/models/Message.js"
click node_limit_model "https://github.com/noob0074/hashchatbackend/blob/main/models/Limit.js"
click node_rate_limiter "https://github.com/noob0074/hashchatbackend/blob/main/utils/rateLimiter.js"
click node_sanitize "https://github.com/noob0074/hashchatbackend/blob/main/utils/sanitize.js"
click node_file_controller "https://github.com/noob0074/hashchatbackend/blob/main/controllers/fileController.js"
click node_cloudinary "https://github.com/noob0074/hashchatbackend/blob/main/config/cloudinary.js"
click node_cleanup "https://github.com/noob0074/hashchatbackend/blob/main/utils/cleanup.js"
click node_email "https://github.com/noob0074/hashchatbackend/blob/main/utils/email.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_auth_routes,node_user_routes,node_room_routes,node_message_routes,node_file_routes,node_config_routes,node_socket,node_client toneBlue
class node_auth_mw,node_deleted_mw,node_auth_controller,node_user_controller,node_user_model,node_verification_model,node_limit_model,node_rate_limiter,node_sanitize,node_email toneAmber
class node_room_controller,node_message_controller,node_room_model,node_message_model toneMint
class node_file_controller,node_cloudinary,node_cleanup toneRose
class node_email_service,node_cloudinary_service toneIndigo
```

## Components

### HTTP and realtime entry

- [HTTP server](https://github.com/noob0074/hashchatbackend/blob/main/server.js): `server.js`
- [Auth routes](https://github.com/noob0074/hashchatbackend/blob/main/routes/auth.js): `routes/auth.js`
- [User routes](https://github.com/noob0074/hashchatbackend/blob/main/routes/users.js): `routes/users.js`
- [Room routes](https://github.com/noob0074/hashchatbackend/blob/main/routes/rooms.js): `routes/rooms.js`
- [Message routes](https://github.com/noob0074/hashchatbackend/blob/main/routes/messages.js): `routes/messages.js`
- [File routes](https://github.com/noob0074/hashchatbackend/blob/main/routes/files.js): `routes/files.js`
- [Config routes](https://github.com/noob0074/hashchatbackend/blob/main/routes/config.js): `routes/config.js`
- [Socket events](https://github.com/noob0074/hashchatbackend/blob/main/socket/index.js): `socket/index.js`

### Identity and policy

- [JWT middleware](https://github.com/noob0074/hashchatbackend/blob/main/middleware/auth.js): `middleware/auth.js`
- [Deleted-account guard](https://github.com/noob0074/hashchatbackend/blob/main/middleware/checkDeleted.js): `middleware/checkDeleted.js`
- [Account workflows](https://github.com/noob0074/hashchatbackend/blob/main/controllers/authController.js): `controllers/authController.js`
- [User workflows](https://github.com/noob0074/hashchatbackend/blob/main/controllers/userController.js): `controllers/userController.js`
- [User records](https://github.com/noob0074/hashchatbackend/blob/main/models/User.js): `models/User.js`
- [Verification records](https://github.com/noob0074/hashchatbackend/blob/main/models/Verification.js): `models/Verification.js`
- [Rate-limit records](https://github.com/noob0074/hashchatbackend/blob/main/models/Limit.js): `models/Limit.js`
- [Rate limiting](https://github.com/noob0074/hashchatbackend/blob/main/utils/rateLimiter.js): `utils/rateLimiter.js`
- [Input sanitization](https://github.com/noob0074/hashchatbackend/blob/main/utils/sanitize.js): `utils/sanitize.js`
- [Email delivery](https://github.com/noob0074/hashchatbackend/blob/main/utils/email.js): `utils/email.js`

### Chat domain

- [Room workflows](https://github.com/noob0074/hashchatbackend/blob/main/controllers/roomController.js): `controllers/roomController.js`
- [Message workflows](https://github.com/noob0074/hashchatbackend/blob/main/controllers/messageController.js): `controllers/messageController.js`
- [Room records](https://github.com/noob0074/hashchatbackend/blob/main/models/Room.js): `models/Room.js`
- [Message records](https://github.com/noob0074/hashchatbackend/blob/main/models/Message.js): `models/Message.js`

### Media and operations

- [Upload signing and deletion](https://github.com/noob0074/hashchatbackend/blob/main/controllers/fileController.js): `controllers/fileController.js`
- [Cloudinary config](https://github.com/noob0074/hashchatbackend/blob/main/config/cloudinary.js): `config/cloudinary.js`
- [Data cleanup](https://github.com/noob0074/hashchatbackend/blob/main/utils/cleanup.js): `utils/cleanup.js`

### Other components

- **Chat client**
- **Email provider**
- **Cloudinary**

## Connections

- Chat client → HTTP server: sends requests (evidence: `server.js`)
- HTTP server → Auth routes: mounts routes (evidence: `server.js`)
- HTTP server → User routes: mounts routes (evidence: `server.js`)
- HTTP server → Room routes: mounts routes (evidence: `server.js`)
- HTTP server → Message routes: mounts routes (evidence: `server.js`)
- HTTP server → File routes: mounts routes (evidence: `server.js`)
- HTTP server → Config routes: mounts routes (evidence: `server.js`)
- HTTP server → Socket events: initializes (evidence: `server.js`)
- Auth routes → JWT middleware: applies (evidence: `routes/auth.js`)
- User routes → JWT middleware: applies (evidence: `routes/users.js`)
- Room routes → JWT middleware: applies (evidence: `routes/rooms.js`)
- Message routes → JWT middleware: applies (evidence: `routes/messages.js`)
- File routes → JWT middleware: applies (evidence: `routes/files.js`)
- Auth routes → Deleted-account guard: applies (evidence: `routes/auth.js`)
- User routes → Deleted-account guard: applies (evidence: `routes/users.js`)
- Room routes → Deleted-account guard: applies (evidence: `routes/rooms.js`)
- Message routes → Deleted-account guard: applies (evidence: `routes/messages.js`)
- File routes → Deleted-account guard: applies (evidence: `routes/files.js`)
- Auth routes → Account workflows: dispatches (evidence: `routes/auth.js`)
- User routes → User workflows: dispatches (evidence: `routes/users.js`)
- Room routes → Room workflows: dispatches (evidence: `routes/rooms.js`)
- Message routes → Message workflows: dispatches (evidence: `routes/messages.js`)
- File routes → Upload signing and deletion: dispatches (evidence: `routes/files.js`)
- Config routes → HTTP server: serves config (evidence: `server.js`)
- JWT middleware → User records: loads account (evidence: `middleware/auth.js`)
- Account workflows → User records: reads and writes (evidence: `controllers/authController.js`)
- Account workflows → Verification records: manages tokens (evidence: `controllers/authController.js`)
- Account workflows → Rate limiting: checks limits (evidence: `controllers/authController.js`)
- Account workflows → Email delivery: sends messages (evidence: `controllers/authController.js`)
- Account workflows → Email provider: delivers email
- User workflows → User records: manages accounts (evidence: `controllers/userController.js`)
- User workflows → Verification records: uses verification (evidence: `controllers/userController.js`)
- User workflows → Socket events: notifies users (evidence: `controllers/userController.js`)
- Room workflows → Room records: manages rooms (evidence: `controllers/roomController.js`)
- Room workflows → Message records: reads and deletes (evidence: `controllers/roomController.js`)
- Room workflows → User records: loads members (evidence: `controllers/roomController.js`)
- Room workflows → Rate limiting: checks limits (evidence: `controllers/roomController.js`)
- Room workflows → Socket events: emits updates (evidence: `controllers/roomController.js`)
- Room workflows → Upload signing and deletion: deletes media (evidence: `controllers/roomController.js`)
- Message workflows → Message records: queries messages (evidence: `controllers/messageController.js`)
- Message workflows → Room records: checks rooms (evidence: `controllers/messageController.js`)
- Message workflows → User records: checks users (evidence: `controllers/messageController.js`)
- Message workflows → Input sanitization: sanitizes input (evidence: `controllers/messageController.js`)
- Message workflows → Socket events: broadcasts updates (evidence: `controllers/messageController.js`)
- Message workflows → Upload signing and deletion: deletes media (evidence: `controllers/messageController.js`)
- Socket events → Message records: stores messages (evidence: `socket/index.js`)
- Socket events → Room records: checks room access (evidence: `socket/index.js`)
- Socket events → User records: checks accounts (evidence: `socket/index.js`)
