How b-acharekar/clustria-backend works
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: fileController.js File Operations · app.js Express API · authMiddlewares.js JWT Guard · authController.js Authentication
Components 28
API and Access
- Express API
app.js - File Routes
routes/fileRoutes.js - Folder Routes
routes/folderRoutes.js - Account Routes
routes/userRoutes.js - Payment Routes
routes/paymentRoute.js - Security Routes
routes/securityRoutes.js - Trash Routes
routes/trashRoutes.js
Accounts
- Authentication
controllers/authController.js - JWT Guard
middlewares/authMiddlewares.js - User Records
models/User.js
File Workspace
- File Operations
controllers/fileController.js - Folder Operations
controllers/folderController.js - Trash Operations
controllers/trashController.js - Payment Logic
controllers/paymentController.js - Security Logic
controllers/securityController.js - File Records
models/File.js - Folder Records
models/Folder.js - Trash Records
models/Trash.js - Payment Records
models/Payment.js
Storage and Services
- Azure Blob Storage
utils/azureUpload.js - Text Extraction
utils/extractText.js - AI Classification
utils/aiClient.js - Email Delivery
utils/mailer.js - Encryption Service
services/encryptionService.js
Other components
- API Client
- Groq API
- Email Service
- MongoDB
Connections 44
- API Client → Express API: sends requests
README.md - Express API → File Routes: mounts routes
app.js - Express API → Account Routes: mounts routes
app.js - Express API → Folder Routes: mounts routes
app.js - Express API → Security Routes: mounts routes
app.js - Express API → Payment Routes: mounts routes
app.js - Express API → Trash Routes: mounts routes
app.js - Express API → MongoDB: connects to
app.js - File Routes → File Operations: dispatches to
routes/fileRoutes.js - File Routes → JWT Guard: guards routes
routes/fileRoutes.js - Folder Routes → Folder Operations: dispatches to
routes/folderRoutes.js - Folder Routes → JWT Guard: guards routes
routes/folderRoutes.js - Account Routes → Authentication: dispatches to
routes/userRoutes.js - Account Routes → JWT Guard: guards routes
routes/userRoutes.js - Payment Routes → Payment Logic: dispatches to
routes/paymentRoute.js - Payment Routes → JWT Guard: guards routes
routes/paymentRoute.js - Security Routes → Security Logic: dispatches to
routes/securityRoutes.js - Security Routes → JWT Guard: guards routes
routes/securityRoutes.js - Trash Routes → Trash Operations: dispatches to
routes/trashRoutes.js - Trash Routes → JWT Guard: guards routes
routes/trashRoutes.js - Authentication → User Records: reads and writes
controllers/authController.js - Authentication → Folder Operations: creates defaults
controllers/authController.js - Authentication → Email Delivery: sends messages
controllers/authController.js - Authentication → Email Service: delivers email
- JWT Guard → User Records: loads user
middlewares/authMiddlewares.js - File Operations → File Records: reads and writes
controllers/fileController.js - File Operations → Folder Records: reads and writes
controllers/fileController.js - File Operations → Trash Records: uses records
controllers/fileController.js - File Operations → Azure Blob Storage: uploads and fetches
controllers/fileController.js - File Operations → Text Extraction: extracts text
controllers/fileController.js - File Operations → AI Classification: classifies text
controllers/fileController.js - AI Classification → Groq API: requests classification
utils/aiClient.js - File Operations → Email Delivery: sends sharing email
controllers/fileController.js - Email Delivery → Email Service: delivers messages
- Folder Operations → Folder Records: reads and writes
controllers/folderController.js - Folder Operations → File Records: reads and writes
controllers/folderController.js - Folder Operations → Trash Records: moves items
controllers/folderController.js - Trash Operations → Trash Records: reads and writes
controllers/trashController.js - Trash Operations → File Records: restores files
controllers/trashController.js - Trash Operations → Folder Records: restores folders
controllers/trashController.js - Trash Operations → Azure Blob Storage: deletes blobs
controllers/trashController.js - Payment Logic → Payment Records: uses records
controllers/paymentController.js - Security Logic → File Records: uses records
controllers/securityController.js - Encryption Service → File Operations: supports encryption