# derekgan08/caseace-law-firm-management-system-backend architecture

> Architecture diagram of the GitHub repository derekgan08/caseace-law-firm-management-system-backend, 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/derekgan08/caseace-law-firm-management-system-backend
- Repository: https://github.com/derekgan08/caseace-law-firm-management-system-backend

## Overview

CaseAce is a law-firm case-management backend. Staff and clients enter through HTTP routes or authenticated case-chat sockets; route handlers implement identity/CRM, cases, documents, tasks, appointments, and dashboard statistics, with Mongo-backed models and notification helpers supporting those workflows. The README also describes client ratings and calendar reminders, but the sampled evidence does not establish their implementation details. Edges reflect the app wiring, route references, and source-index imports; some storage and integration behavior is therefore not expanded beyond what those sources show.

Main entry points: [`app.js`](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/app.js) (HTTP and Socket Server), [`controllers/documentController.js`](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/documentController.js) (Document Management), [`middlewares/authMiddleware.js`](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/middlewares/authMiddleware.js) (Access Middleware), [`models/user.js`](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/user.js) (User Records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Backend Runtime"]
  node_app["HTTP and Socket Server<br/>[app.js]"]
  node_auth_mw["Access Middleware<br/>[authMiddleware.js]"]
  node_auth_routes["Auth Routes<br/>[auth.js]"]
  node_crm_routes["CRM Routes<br/>[crm.js]"]
  node_case_routes["Case Routes<br/>[case.js]"]
  node_doc_routes["Document Routes<br/>[document.js]"]
  node_task_routes["Task Routes<br/>[task.js]"]
  node_appt_routes["Appointment Routes<br/>[appointment.js]"]
  node_stats_routes["Statistics Routes<br/>[statistic.js]"]
end

subgraph group_identity["Identity and CRM"]
  node_auth["Authentication<br/>[authController.js]"]
  node_crm["Client and Staff CRM<br/>[crmController.js]"]
end

subgraph group_legal["Casework Operations"]
  node_cases["Case Management<br/>[caseController.js]"]
  node_documents["Document Management"]
  node_tasks["Task Management<br/>[taskController.js]"]
  node_appointments["Appointment Scheduling"]
  node_statistics["Dashboard Statistics"]
end

subgraph group_collaboration["Collaboration"]
  node_chat["Case Chat"]
  node_notify["Notification Helper"]
end

subgraph group_data["Data and Integrations"]
  node_user_model[("User Records<br/>[user.js]")]
  node_case_model[("Case Records<br/>[case.js]")]
  node_doc_model[("Document Records<br/>[document.js]")]
  node_task_model[("Task Records<br/>[task.js]")]
  node_appt_model[("Appointment Records<br/>[appointment.js]")]
  node_message_model[("Message Records<br/>[message.js]")]
  node_notification_model[("Notification Records<br/>[notification.js]")]
  node_drive["Google Drive Utility<br/>[googleDrive.js]"]
  node_cloudinary["Cloudinary Setup<br/>[cloudinary.js]"]
end

node_staff(("Firm staff"))
node_clients(("Clients"))
node_mongo[("MongoDB")]

node_staff -->|"use API"| node_app
node_clients -->|"use API"| node_app
node_app -->|"mounts"| node_auth_routes
node_app -->|"mounts"| node_crm_routes
node_app -->|"mounts"| node_case_routes
node_app -->|"mounts"| node_doc_routes
node_app -->|"mounts"| node_task_routes
node_app -->|"mounts"| node_appt_routes
node_app -->|"mounts"| node_stats_routes
node_app -->|"uses middleware"| node_auth_mw
node_app -->|"registers handler"| node_chat
node_app -->|"connects"| node_mongo
node_auth_routes -->|"routes to"| node_auth
node_crm_routes -->|"routes to"| node_crm
node_crm_routes -->|"uses middleware"| node_auth_mw
node_case_routes -->|"routes to"| node_cases
node_case_routes -->|"uses middleware"| node_auth_mw
node_doc_routes -->|"routes to"| node_documents
node_doc_routes -->|"uses middleware"| node_auth_mw
node_task_routes -->|"routes to"| node_tasks
node_task_routes -->|"uses middleware"| node_auth_mw
node_appt_routes -->|"routes to"| node_appointments
node_appt_routes -->|"uses middleware"| node_auth_mw
node_stats_routes -->|"routes to"| node_statistics
node_stats_routes -->|"uses middleware"| node_auth_mw
node_auth -->|"reads and writes"| node_user_model
node_crm -->|"reads and writes"| node_user_model
node_crm -->|"reads cases"| node_case_model
node_crm -->|"uses utility"| node_drive
node_crm -->|"uses setup"| node_cloudinary
node_cases -->|"reads and writes"| node_case_model
node_cases -->|"uses messages"| node_message_model
node_documents -->|"reads and writes"| node_doc_model
node_documents -->|"checks case access"| node_case_model
node_documents -->|"updates messages"| node_message_model
node_documents -->|"reads user details"| node_user_model
node_documents -->|"sends alerts"| node_notify
node_documents -->|"uses utility"| node_drive
node_documents -->|"uses setup"| node_cloudinary
node_tasks -->|"reads and writes"| node_task_model
node_tasks -->|"reads user details"| node_user_model
node_tasks -->|"sends alerts"| node_notify
node_appointments -->|"reads and writes"| node_appt_model
node_appointments -->|"reads user details"| node_user_model
node_appointments -->|"sends alerts"| node_notify
node_statistics -->|"queries"| node_case_model
node_statistics -->|"queries"| node_doc_model
node_statistics -->|"queries"| node_user_model

click node_app "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/app.js"
click node_auth_mw "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/middlewares/authMiddleware.js"
click node_auth_routes "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/auth.js"
click node_crm_routes "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/crm.js"
click node_case_routes "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/case.js"
click node_doc_routes "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/document.js"
click node_task_routes "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/task.js"
click node_appt_routes "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/appointment.js"
click node_stats_routes "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/statistic.js"
click node_auth "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/authController.js"
click node_crm "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/crmController.js"
click node_cases "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/caseController.js"
click node_documents "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/documentController.js"
click node_tasks "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/taskController.js"
click node_appointments "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/appointmentController.js"
click node_statistics "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/statisticController.js"
click node_chat "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/socketHandler/caseMessageHandlers.js"
click node_notify "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/helpers/saveNotification.js"
click node_user_model "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/user.js"
click node_case_model "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/case.js"
click node_doc_model "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/document.js"
click node_task_model "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/task.js"
click node_appt_model "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/appointment.js"
click node_message_model "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/message.js"
click node_notification_model "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/notification.js"
click node_drive "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/utils/googleDrive.js"
click node_cloudinary "https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/config/cloudinary.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_auth_mw,node_auth_routes,node_crm_routes,node_case_routes,node_doc_routes,node_task_routes,node_appt_routes,node_stats_routes,node_clients toneBlue
class node_auth,node_crm,node_mongo toneAmber
class node_cases,node_documents,node_tasks,node_appointments,node_statistics toneMint
class node_chat,node_notify toneRose
class node_user_model,node_case_model,node_doc_model,node_task_model,node_appt_model,node_message_model,node_notification_model,node_drive,node_cloudinary,node_staff toneIndigo
```

## Components

### Backend Runtime

- [HTTP and Socket Server](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/app.js): `app.js`
- [Access Middleware](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/middlewares/authMiddleware.js): `middlewares/authMiddleware.js`
- [Auth Routes](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/auth.js): `routes/auth.js`
- [CRM Routes](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/crm.js): `routes/crm.js`
- [Case Routes](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/case.js): `routes/case.js`
- [Document Routes](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/document.js): `routes/document.js`
- [Task Routes](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/task.js): `routes/task.js`
- [Appointment Routes](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/appointment.js): `routes/appointment.js`
- [Statistics Routes](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/routes/statistic.js): `routes/statistic.js`

### Identity and CRM

- [Authentication](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/authController.js): `controllers/authController.js`
- [Client and Staff CRM](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/crmController.js): `controllers/crmController.js`

### Casework Operations

- [Case Management](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/caseController.js): `controllers/caseController.js`
- [Document Management](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/documentController.js): `controllers/documentController.js`
- [Task Management](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/taskController.js): `controllers/taskController.js`
- [Appointment Scheduling](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/appointmentController.js): `controllers/appointmentController.js`
- [Dashboard Statistics](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/controllers/statisticController.js): `controllers/statisticController.js`

### Collaboration

- [Case Chat](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/socketHandler/caseMessageHandlers.js): `socketHandler/caseMessageHandlers.js`
- [Notification Helper](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/helpers/saveNotification.js): `helpers/saveNotification.js`

### Data and Integrations

- [User Records](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/user.js): `models/user.js`
- [Case Records](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/case.js): `models/case.js`
- [Document Records](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/document.js): `models/document.js`
- [Task Records](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/task.js): `models/task.js`
- [Appointment Records](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/appointment.js): `models/appointment.js`
- [Message Records](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/message.js): `models/message.js`
- [Notification Records](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/models/notification.js): `models/notification.js`
- [Google Drive Utility](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/utils/googleDrive.js): `utils/googleDrive.js`
- [Cloudinary Setup](https://github.com/derekgan08/caseace-law-firm-management-system-backend/blob/main/config/cloudinary.js): `config/cloudinary.js`

### Other components

- **Firm staff**
- **Clients**
- **MongoDB**

## Connections

- Firm staff → HTTP and Socket Server: use API (evidence: `README.md`)
- Clients → HTTP and Socket Server: use API (evidence: `README.md`)
- HTTP and Socket Server → Auth Routes: mounts (evidence: `app.js`)
- HTTP and Socket Server → CRM Routes: mounts (evidence: `app.js`)
- HTTP and Socket Server → Case Routes: mounts (evidence: `app.js`)
- HTTP and Socket Server → Document Routes: mounts (evidence: `app.js`)
- HTTP and Socket Server → Task Routes: mounts (evidence: `app.js`)
- HTTP and Socket Server → Appointment Routes: mounts (evidence: `app.js`)
- HTTP and Socket Server → Statistics Routes: mounts (evidence: `app.js`)
- HTTP and Socket Server → Access Middleware: uses middleware (evidence: `app.js`)
- HTTP and Socket Server → Case Chat: registers handler (evidence: `app.js`)
- HTTP and Socket Server → MongoDB: connects (evidence: `app.js`)
- Auth Routes → Authentication: routes to (evidence: `routes/auth.js`)
- CRM Routes → Client and Staff CRM: routes to (evidence: `routes/crm.js`)
- CRM Routes → Access Middleware: uses middleware (evidence: `routes/crm.js`)
- Case Routes → Case Management: routes to (evidence: `routes/case.js`)
- Case Routes → Access Middleware: uses middleware (evidence: `routes/case.js`)
- Document Routes → Document Management: routes to (evidence: `routes/document.js`)
- Document Routes → Access Middleware: uses middleware (evidence: `routes/document.js`)
- Task Routes → Task Management: routes to (evidence: `routes/task.js`)
- Task Routes → Access Middleware: uses middleware (evidence: `routes/task.js`)
- Appointment Routes → Appointment Scheduling: routes to (evidence: `routes/appointment.js`)
- Appointment Routes → Access Middleware: uses middleware (evidence: `routes/appointment.js`)
- Statistics Routes → Dashboard Statistics: routes to (evidence: `routes/statistic.js`)
- Statistics Routes → Access Middleware: uses middleware (evidence: `routes/statistic.js`)
- Authentication → User Records: reads and writes (evidence: `controllers/authController.js`)
- Client and Staff CRM → User Records: reads and writes (evidence: `controllers/crmController.js`)
- Client and Staff CRM → Case Records: reads cases (evidence: `controllers/crmController.js`)
- Client and Staff CRM → Google Drive Utility: uses utility (evidence: `controllers/crmController.js`)
- Client and Staff CRM → Cloudinary Setup: uses setup (evidence: `controllers/crmController.js`)
- Case Management → Case Records: reads and writes (evidence: `controllers/caseController.js`)
- Case Management → Message Records: uses messages (evidence: `controllers/caseController.js`)
- Document Management → Document Records: reads and writes (evidence: `controllers/documentController.js`)
- Document Management → Case Records: checks case access (evidence: `controllers/documentController.js`)
- Document Management → Message Records: updates messages (evidence: `controllers/documentController.js`)
- Document Management → User Records: reads user details (evidence: `controllers/documentController.js`)
- Document Management → Notification Helper: sends alerts (evidence: `controllers/documentController.js`)
- Document Management → Google Drive Utility: uses utility (evidence: `controllers/documentController.js`)
- Document Management → Cloudinary Setup: uses setup (evidence: `controllers/documentController.js`)
- Task Management → Task Records: reads and writes (evidence: `controllers/taskController.js`)
- Task Management → User Records: reads user details (evidence: `controllers/taskController.js`)
- Task Management → Notification Helper: sends alerts (evidence: `controllers/taskController.js`)
- Appointment Scheduling → Appointment Records: reads and writes (evidence: `controllers/appointmentController.js`)
- Appointment Scheduling → User Records: reads user details (evidence: `controllers/appointmentController.js`)
- Appointment Scheduling → Notification Helper: sends alerts (evidence: `controllers/appointmentController.js`)
- Dashboard Statistics → Case Records: queries (evidence: `controllers/statisticController.js`)
- Dashboard Statistics → Document Records: queries (evidence: `controllers/statisticController.js`)
- Dashboard Statistics → User Records: queries (evidence: `controllers/statisticController.js`)
