# b-acharekar/clustria-backend architecture

> Architecture diagram of the GitHub repository b-acharekar/clustria-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/b-acharekar/clustria-backend
- Repository: https://github.com/b-acharekar/clustria-backend

## Overview

Clustria is an Express API for authenticated file and folder management, with accounts, sharing, trash, payments, and security endpoints. The main workflow routes a user request through authentication and a domain controller, which operates on MongoDB-backed records and, for file operations, Azure Blob Storage. AI uploads extract text, classify it, and may auto-organize into folders. The README also describes encryption and notification integrations. Some controllers and route files were not excerpted; their documented or indexed links are shown only where supported, and unsampled details are not inferred.

Main entry points: [`controllers/fileController.js`](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/fileController.js) (File Operations), [`app.js`](https://github.com/b-acharekar/clustria-backend/blob/main/app.js) (Express API), [`middlewares/authMiddlewares.js`](https://github.com/b-acharekar/clustria-backend/blob/main/middlewares/authMiddlewares.js) (JWT Guard), [`controllers/authController.js`](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/authController.js) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and Access"]
  node_app["Express API<br/>[app.js]"]
  node_file_routes["File Routes<br/>[fileRoutes.js]"]
  node_folder_routes["Folder Routes<br/>[folderRoutes.js]"]
  node_user_routes["Account Routes<br/>[userRoutes.js]"]
  node_payment_routes["Payment Routes<br/>[paymentRoute.js]"]
  node_security_routes["Security Routes<br/>[securityRoutes.js]"]
  node_trash_routes["Trash Routes<br/>[trashRoutes.js]"]
end

subgraph group_identity["Accounts"]
  node_auth["Authentication<br/>[authController.js]"]
  node_auth_middleware["JWT Guard<br/>[authMiddlewares.js]"]
  node_user_model[("User Records<br/>[User.js]")]
end

subgraph group_files["File Workspace"]
  node_file_controller["File Operations<br/>[fileController.js]"]
  node_folder_controller["Folder Operations"]
  node_trash_controller["Trash Operations<br/>[trashController.js]"]
  node_payment_controller["Payment Logic"]
  node_security_controller["Security Logic"]
  node_file_model[("File Records<br/>[File.js]")]
  node_folder_model[("Folder Records<br/>[Folder.js]")]
  node_trash_model[("Trash Records<br/>[Trash.js]")]
  node_payment_model[("Payment Records<br/>[Payment.js]")]
end

subgraph group_integrations["Storage and Services"]
  node_azure["Azure Blob Storage<br/>[azureUpload.js]"]
  node_text_extract["Text Extraction<br/>[extractText.js]"]
  node_ai_client["AI Classification<br/>[aiClient.js]"]
  node_mailer["Email Delivery<br/>[mailer.js]"]
  node_encryption["Encryption Service"]
end

node_client(("API Client"))
node_groq{{"Groq API"}}
node_email_service{{"Email Service"}}
node_mongo[("MongoDB")]

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_file_routes
node_app -->|"mounts routes"| node_user_routes
node_app -->|"mounts routes"| node_folder_routes
node_app -->|"mounts routes"| node_security_routes
node_app -->|"mounts routes"| node_payment_routes
node_app -->|"mounts routes"| node_trash_routes
node_app -->|"connects to"| node_mongo
node_file_routes -->|"dispatches to"| node_file_controller
node_file_routes -->|"guards routes"| node_auth_middleware
node_folder_routes -->|"dispatches to"| node_folder_controller
node_folder_routes -->|"guards routes"| node_auth_middleware
node_user_routes -->|"dispatches to"| node_auth
node_user_routes -->|"guards routes"| node_auth_middleware
node_payment_routes -->|"dispatches to"| node_payment_controller
node_payment_routes -->|"guards routes"| node_auth_middleware
node_security_routes -->|"dispatches to"| node_security_controller
node_security_routes -->|"guards routes"| node_auth_middleware
node_trash_routes -->|"dispatches to"| node_trash_controller
node_trash_routes -->|"guards routes"| node_auth_middleware
node_auth -->|"reads and writes"| node_user_model
node_auth -->|"creates defaults"| node_folder_controller
node_auth -->|"sends messages"| node_mailer
node_auth -.->|"delivers email"| node_email_service
node_auth_middleware -->|"loads user"| node_user_model
node_file_controller -->|"reads and writes"| node_file_model
node_file_controller -->|"reads and writes"| node_folder_model
node_file_controller -->|"uses records"| node_trash_model
node_file_controller -->|"uploads and fetches"| node_azure
node_file_controller -->|"extracts text"| node_text_extract
node_file_controller -->|"classifies text"| node_ai_client
node_ai_client -->|"requests classification"| node_groq
node_file_controller -->|"sends sharing email"| node_mailer
node_mailer -.->|"delivers messages"| node_email_service
node_folder_controller -->|"reads and writes"| node_folder_model
node_folder_controller -->|"reads and writes"| node_file_model
node_folder_controller -->|"moves items"| node_trash_model
node_trash_controller -->|"reads and writes"| node_trash_model
node_trash_controller -->|"restores files"| node_file_model
node_trash_controller -->|"restores folders"| node_folder_model
node_trash_controller -->|"deletes blobs"| node_azure
node_payment_controller -->|"uses records"| node_payment_model
node_security_controller -->|"uses records"| node_file_model
node_encryption -.->|"supports encryption"| node_file_controller

click node_app "https://github.com/b-acharekar/clustria-backend/blob/main/app.js"
click node_file_routes "https://github.com/b-acharekar/clustria-backend/blob/main/routes/fileRoutes.js"
click node_folder_routes "https://github.com/b-acharekar/clustria-backend/blob/main/routes/folderRoutes.js"
click node_user_routes "https://github.com/b-acharekar/clustria-backend/blob/main/routes/userRoutes.js"
click node_payment_routes "https://github.com/b-acharekar/clustria-backend/blob/main/routes/paymentRoute.js"
click node_security_routes "https://github.com/b-acharekar/clustria-backend/blob/main/routes/securityRoutes.js"
click node_trash_routes "https://github.com/b-acharekar/clustria-backend/blob/main/routes/trashRoutes.js"
click node_auth "https://github.com/b-acharekar/clustria-backend/blob/main/controllers/authController.js"
click node_auth_middleware "https://github.com/b-acharekar/clustria-backend/blob/main/middlewares/authMiddlewares.js"
click node_user_model "https://github.com/b-acharekar/clustria-backend/blob/main/models/User.js"
click node_file_controller "https://github.com/b-acharekar/clustria-backend/blob/main/controllers/fileController.js"
click node_folder_controller "https://github.com/b-acharekar/clustria-backend/blob/main/controllers/folderController.js"
click node_trash_controller "https://github.com/b-acharekar/clustria-backend/blob/main/controllers/trashController.js"
click node_payment_controller "https://github.com/b-acharekar/clustria-backend/blob/main/controllers/paymentController.js"
click node_security_controller "https://github.com/b-acharekar/clustria-backend/blob/main/controllers/securityController.js"
click node_file_model "https://github.com/b-acharekar/clustria-backend/blob/main/models/File.js"
click node_folder_model "https://github.com/b-acharekar/clustria-backend/blob/main/models/Folder.js"
click node_trash_model "https://github.com/b-acharekar/clustria-backend/blob/main/models/Trash.js"
click node_payment_model "https://github.com/b-acharekar/clustria-backend/blob/main/models/Payment.js"
click node_azure "https://github.com/b-acharekar/clustria-backend/blob/main/utils/azureUpload.js"
click node_text_extract "https://github.com/b-acharekar/clustria-backend/blob/main/utils/extractText.js"
click node_ai_client "https://github.com/b-acharekar/clustria-backend/blob/main/utils/aiClient.js"
click node_mailer "https://github.com/b-acharekar/clustria-backend/blob/main/utils/mailer.js"
click node_encryption "https://github.com/b-acharekar/clustria-backend/blob/main/services/encryptionService.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_file_routes,node_folder_routes,node_user_routes,node_payment_routes,node_security_routes,node_trash_routes,node_client toneBlue
class node_auth,node_auth_middleware,node_user_model,node_mongo toneAmber
class node_file_controller,node_folder_controller,node_trash_controller,node_payment_controller,node_security_controller,node_file_model,node_folder_model,node_trash_model,node_payment_model,node_groq toneMint
class node_azure,node_text_extract,node_ai_client,node_mailer,node_encryption toneRose
class node_email_service toneIndigo
```

## Components

### API and Access

- [Express API](https://github.com/b-acharekar/clustria-backend/blob/main/app.js): `app.js`
- [File Routes](https://github.com/b-acharekar/clustria-backend/blob/main/routes/fileRoutes.js): `routes/fileRoutes.js`
- [Folder Routes](https://github.com/b-acharekar/clustria-backend/blob/main/routes/folderRoutes.js): `routes/folderRoutes.js`
- [Account Routes](https://github.com/b-acharekar/clustria-backend/blob/main/routes/userRoutes.js): `routes/userRoutes.js`
- [Payment Routes](https://github.com/b-acharekar/clustria-backend/blob/main/routes/paymentRoute.js): `routes/paymentRoute.js`
- [Security Routes](https://github.com/b-acharekar/clustria-backend/blob/main/routes/securityRoutes.js): `routes/securityRoutes.js`
- [Trash Routes](https://github.com/b-acharekar/clustria-backend/blob/main/routes/trashRoutes.js): `routes/trashRoutes.js`

### Accounts

- [Authentication](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/authController.js): `controllers/authController.js`
- [JWT Guard](https://github.com/b-acharekar/clustria-backend/blob/main/middlewares/authMiddlewares.js): `middlewares/authMiddlewares.js`
- [User Records](https://github.com/b-acharekar/clustria-backend/blob/main/models/User.js): `models/User.js`

### File Workspace

- [File Operations](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/fileController.js): `controllers/fileController.js`
- [Folder Operations](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/folderController.js): `controllers/folderController.js`
- [Trash Operations](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/trashController.js): `controllers/trashController.js`
- [Payment Logic](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/paymentController.js): `controllers/paymentController.js`
- [Security Logic](https://github.com/b-acharekar/clustria-backend/blob/main/controllers/securityController.js): `controllers/securityController.js`
- [File Records](https://github.com/b-acharekar/clustria-backend/blob/main/models/File.js): `models/File.js`
- [Folder Records](https://github.com/b-acharekar/clustria-backend/blob/main/models/Folder.js): `models/Folder.js`
- [Trash Records](https://github.com/b-acharekar/clustria-backend/blob/main/models/Trash.js): `models/Trash.js`
- [Payment Records](https://github.com/b-acharekar/clustria-backend/blob/main/models/Payment.js): `models/Payment.js`

### Storage and Services

- [Azure Blob Storage](https://github.com/b-acharekar/clustria-backend/blob/main/utils/azureUpload.js): `utils/azureUpload.js`
- [Text Extraction](https://github.com/b-acharekar/clustria-backend/blob/main/utils/extractText.js): `utils/extractText.js`
- [AI Classification](https://github.com/b-acharekar/clustria-backend/blob/main/utils/aiClient.js): `utils/aiClient.js`
- [Email Delivery](https://github.com/b-acharekar/clustria-backend/blob/main/utils/mailer.js): `utils/mailer.js`
- [Encryption Service](https://github.com/b-acharekar/clustria-backend/blob/main/services/encryptionService.js): `services/encryptionService.js`

### Other components

- **API Client**
- **Groq API**
- **Email Service**
- **MongoDB**

## Connections

- API Client → Express API: sends requests (evidence: `README.md`)
- Express API → File Routes: mounts routes (evidence: `app.js`)
- Express API → Account Routes: mounts routes (evidence: `app.js`)
- Express API → Folder Routes: mounts routes (evidence: `app.js`)
- Express API → Security Routes: mounts routes (evidence: `app.js`)
- Express API → Payment Routes: mounts routes (evidence: `app.js`)
- Express API → Trash Routes: mounts routes (evidence: `app.js`)
- Express API → MongoDB: connects to (evidence: `app.js`)
- File Routes → File Operations: dispatches to (evidence: `routes/fileRoutes.js`)
- File Routes → JWT Guard: guards routes (evidence: `routes/fileRoutes.js`)
- Folder Routes → Folder Operations: dispatches to (evidence: `routes/folderRoutes.js`)
- Folder Routes → JWT Guard: guards routes (evidence: `routes/folderRoutes.js`)
- Account Routes → Authentication: dispatches to (evidence: `routes/userRoutes.js`)
- Account Routes → JWT Guard: guards routes (evidence: `routes/userRoutes.js`)
- Payment Routes → Payment Logic: dispatches to (evidence: `routes/paymentRoute.js`)
- Payment Routes → JWT Guard: guards routes (evidence: `routes/paymentRoute.js`)
- Security Routes → Security Logic: dispatches to (evidence: `routes/securityRoutes.js`)
- Security Routes → JWT Guard: guards routes (evidence: `routes/securityRoutes.js`)
- Trash Routes → Trash Operations: dispatches to (evidence: `routes/trashRoutes.js`)
- Trash Routes → JWT Guard: guards routes (evidence: `routes/trashRoutes.js`)
- Authentication → User Records: reads and writes (evidence: `controllers/authController.js`)
- Authentication → Folder Operations: creates defaults (evidence: `controllers/authController.js`)
- Authentication → Email Delivery: sends messages (evidence: `controllers/authController.js`)
- Authentication → Email Service: delivers email
- JWT Guard → User Records: loads user (evidence: `middlewares/authMiddlewares.js`)
- File Operations → File Records: reads and writes (evidence: `controllers/fileController.js`)
- File Operations → Folder Records: reads and writes (evidence: `controllers/fileController.js`)
- File Operations → Trash Records: uses records (evidence: `controllers/fileController.js`)
- File Operations → Azure Blob Storage: uploads and fetches (evidence: `controllers/fileController.js`)
- File Operations → Text Extraction: extracts text (evidence: `controllers/fileController.js`)
- File Operations → AI Classification: classifies text (evidence: `controllers/fileController.js`)
- AI Classification → Groq API: requests classification (evidence: `utils/aiClient.js`)
- File Operations → Email Delivery: sends sharing email (evidence: `controllers/fileController.js`)
- Email Delivery → Email Service: delivers messages
- Folder Operations → Folder Records: reads and writes (evidence: `controllers/folderController.js`)
- Folder Operations → File Records: reads and writes (evidence: `controllers/folderController.js`)
- Folder Operations → Trash Records: moves items (evidence: `controllers/folderController.js`)
- Trash Operations → Trash Records: reads and writes (evidence: `controllers/trashController.js`)
- Trash Operations → File Records: restores files (evidence: `controllers/trashController.js`)
- Trash Operations → Folder Records: restores folders (evidence: `controllers/trashController.js`)
- Trash Operations → Azure Blob Storage: deletes blobs (evidence: `controllers/trashController.js`)
- Payment Logic → Payment Records: uses records (evidence: `controllers/paymentController.js`)
- Security Logic → File Records: uses records (evidence: `controllers/securityController.js`)
- Encryption Service → File Operations: supports encryption
