# sanju1098/incident-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/sanju1098/incident-management-system
- Repository: https://github.com/sanju1098/incident-management-system

## Overview

This is an Express/Mongoose incident-management API. Clients authenticate or submit protected requests; route modules apply validation and access middleware, controllers invoke domain services, and those services manage incidents, teams, users, comments, and timelines. Authentication, uploads, and administrative user management are distinct capabilities. The README documents the broader API, while sampled source and the SOURCE INDEX establish only the cited wiring; unsampled integrations are shown cautiously.

Main entry points: [`src/routes/index.js`](https://github.com/sanju1098/incident-management-system/blob/main/src/routes/index.js) (API router), [`src/middleware/auth.middleware.js`](https://github.com/sanju1098/incident-management-system/blob/main/src/middleware/auth.middleware.js) (Authentication), [`src/modules/auth/auth.routes.js`](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/auth.routes.js) (Auth routes), [`src/modules/comments/comment.service.js`](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.service.js) (Comment service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API entry"]
  node_app["Express app<br/>[app.js]"]
  node_router["API router<br/>[index.js]"]
end

subgraph group_identity["Identity and access"]
  node_auth_routes["Auth routes<br/>[auth.routes.js]"]
  node_auth_controller["Auth controller<br/>[auth.controller.js]"]
  node_auth_service["Auth service<br/>[auth.service.js]"]
  node_auth_models[("User and token records<br/>[user.models.js]")]
  node_auth_middleware["Authentication<br/>[auth.middleware.js]"]
  node_authorize["Role authorization"]
end

subgraph group_operations["Incident collaboration"]
  node_incident_routes["Incident routes<br/>[incident.routes.js]"]
  node_incident_controller["Incident controller"]
  node_incident_service["Incident service"]
  node_incident_model[("Incident records<br/>[incident.model.js]")]
  node_comment_routes["Comment routes<br/>[comment.routes.js]"]
  node_comment_controller["Comment controller"]
  node_comment_service["Comment service<br/>[comment.service.js]"]
  node_comment_model[("Comment records<br/>[comment.model.js]")]
  node_timeline_routes["Timeline routes<br/>[timeline.routes.js]"]
  node_timeline_controller["Timeline controller"]
  node_timeline_service["Timeline service"]
  node_timeline_model[("Timeline records<br/>[timeline.model.js]")]
end

subgraph group_administration["People and teams"]
  node_users_routes["User routes<br/>[user.routes.js]"]
  node_users_controller["User controller<br/>[user.controller.js]"]
  node_users_service["User service<br/>[user.service.js]"]
  node_teams_routes["Team routes<br/>[team.routes.js]"]
  node_teams_controller["Team controller<br/>[team.controller.js]"]
  node_teams_service["Team service<br/>[team.services.js]"]
  node_teams_model[("Team records<br/>[team.model.js]")]
end

subgraph group_platform["Shared infrastructure"]
  node_upload_routes["Upload routes<br/>[upload.routes.js]"]
  node_upload_controller["Upload controller"]
  node_upload_service["Upload service<br/>[upload.service.js]"]
  node_validation["Request validation"]
  node_database[("MongoDB connection<br/>[db.js]")]
end

node_client(("API client"))
node_cloudinary["Cloudinary"]

node_client -->|"sends requests"| node_app
node_app -->|"mounts routes"| node_router
node_router -->|"mounts"| node_auth_routes
node_router -->|"mounts"| node_users_routes
node_router -->|"mounts"| node_teams_routes
node_router -->|"mounts"| node_incident_routes
node_router -->|"mounts"| node_comment_routes
node_router -->|"mounts"| node_timeline_routes
node_router -->|"mounts"| node_upload_routes
node_auth_routes -->|"dispatches"| node_auth_controller
node_auth_controller -->|"invokes"| node_auth_service
node_auth_service -->|"reads and writes"| node_auth_models
node_auth_routes -->|"validates"| node_validation
node_auth_routes -->|"protects routes"| node_auth_middleware
node_auth_middleware -->|"loads user"| node_auth_models
node_incident_routes -->|"dispatches"| node_incident_controller
node_incident_controller -->|"invokes"| node_incident_service
node_incident_service -->|"reads and writes"| node_incident_model
node_comment_routes -->|"dispatches"| node_comment_controller
node_comment_controller -->|"invokes"| node_comment_service
node_comment_service -->|"reads and writes"| node_comment_model
node_comment_service -->|"uses incident data"| node_incident_model
node_comment_service -->|"records activity"| node_timeline_service
node_timeline_routes -->|"dispatches"| node_timeline_controller
node_timeline_controller -->|"uses records"| node_timeline_model
node_incident_service -->|"records activity"| node_timeline_service
node_users_routes -->|"dispatches"| node_users_controller
node_users_controller -->|"invokes"| node_users_service
node_users_routes -->|"protects routes"| node_auth_middleware
node_users_routes -->|"checks roles"| node_authorize
node_teams_routes -->|"dispatches"| node_teams_controller
node_teams_controller -->|"invokes"| node_teams_service
node_teams_service -->|"reads and writes"| node_teams_model
node_teams_routes -->|"protects routes"| node_auth_middleware
node_teams_routes -->|"checks roles"| node_authorize
node_upload_routes -->|"dispatches"| node_upload_controller
node_upload_controller -->|"invokes"| node_upload_service
node_upload_routes -->|"protects routes"| node_auth_middleware
node_upload_service -.->|"uploads files"| node_cloudinary
node_app -->|"connects at startup"| node_database

click node_app "https://github.com/sanju1098/incident-management-system/blob/main/src/app.js"
click node_router "https://github.com/sanju1098/incident-management-system/blob/main/src/routes/index.js"
click node_auth_routes "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/auth.routes.js"
click node_auth_controller "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/auth.controller.js"
click node_auth_service "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/auth.service.js"
click node_auth_models "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/models/user.models.js"
click node_auth_middleware "https://github.com/sanju1098/incident-management-system/blob/main/src/middleware/auth.middleware.js"
click node_authorize "https://github.com/sanju1098/incident-management-system/blob/main/src/middleware/authorize.middleware.js"
click node_incident_routes "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.routes.js"
click node_incident_controller "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.controller.js"
click node_incident_service "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.service.js"
click node_incident_model "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.model.js"
click node_comment_routes "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.routes.js"
click node_comment_controller "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.controller.js"
click node_comment_service "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.service.js"
click node_comment_model "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.model.js"
click node_timeline_routes "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.routes.js"
click node_timeline_controller "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.controller.js"
click node_timeline_service "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.service.js"
click node_timeline_model "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.model.js"
click node_users_routes "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/users/user.routes.js"
click node_users_controller "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/users/user.controller.js"
click node_users_service "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/users/user.service.js"
click node_teams_routes "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.routes.js"
click node_teams_controller "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.controller.js"
click node_teams_service "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.services.js"
click node_teams_model "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.model.js"
click node_upload_routes "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/uploads/upload.routes.js"
click node_upload_controller "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/uploads/upload.controller.js"
click node_upload_service "https://github.com/sanju1098/incident-management-system/blob/main/src/modules/uploads/upload.service.js"
click node_validation "https://github.com/sanju1098/incident-management-system/blob/main/src/middleware/validate.middleware.js"
click node_database "https://github.com/sanju1098/incident-management-system/blob/main/src/config/db.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_router,node_client toneBlue
class node_auth_routes,node_auth_controller,node_auth_service,node_auth_models,node_auth_middleware,node_authorize toneAmber
class node_incident_routes,node_incident_controller,node_incident_service,node_incident_model,node_comment_routes,node_comment_controller,node_comment_service,node_comment_model,node_timeline_routes,node_timeline_controller,node_timeline_service,node_timeline_model toneMint
class node_users_routes,node_users_controller,node_users_service,node_teams_routes,node_teams_controller,node_teams_service,node_teams_model toneRose
class node_upload_routes,node_upload_controller,node_upload_service,node_validation,node_database,node_cloudinary toneIndigo
```

## Components

### API entry

- [Express app](https://github.com/sanju1098/incident-management-system/blob/main/src/app.js): `src/app.js`
- [API router](https://github.com/sanju1098/incident-management-system/blob/main/src/routes/index.js): `src/routes/index.js`

### Identity and access

- [Auth routes](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/auth.routes.js): `src/modules/auth/auth.routes.js`
- [Auth controller](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/auth.controller.js): `src/modules/auth/auth.controller.js`
- [Auth service](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/auth.service.js): `src/modules/auth/auth.service.js`
- [User and token records](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/auth/models/user.models.js): `src/modules/auth/models/user.models.js`
- [Authentication](https://github.com/sanju1098/incident-management-system/blob/main/src/middleware/auth.middleware.js): `src/middleware/auth.middleware.js`
- [Role authorization](https://github.com/sanju1098/incident-management-system/blob/main/src/middleware/authorize.middleware.js): `src/middleware/authorize.middleware.js`

### Incident collaboration

- [Incident routes](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.routes.js): `src/modules/incidents/incident.routes.js`
- [Incident controller](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.controller.js): `src/modules/incidents/incident.controller.js`
- [Incident service](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.service.js): `src/modules/incidents/incident.service.js`
- [Incident records](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/incidents/incident.model.js): `src/modules/incidents/incident.model.js`
- [Comment routes](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.routes.js): `src/modules/comments/comment.routes.js`
- [Comment controller](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.controller.js): `src/modules/comments/comment.controller.js`
- [Comment service](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.service.js): `src/modules/comments/comment.service.js`
- [Comment records](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/comments/comment.model.js): `src/modules/comments/comment.model.js`
- [Timeline routes](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.routes.js): `src/modules/timeline/timeline.routes.js`
- [Timeline controller](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.controller.js): `src/modules/timeline/timeline.controller.js`
- [Timeline service](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.service.js): `src/modules/timeline/timeline.service.js`
- [Timeline records](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/timeline/timeline.model.js): `src/modules/timeline/timeline.model.js`

### People and teams

- [User routes](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/users/user.routes.js): `src/modules/users/user.routes.js`
- [User controller](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/users/user.controller.js): `src/modules/users/user.controller.js`
- [User service](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/users/user.service.js): `src/modules/users/user.service.js`
- [Team routes](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.routes.js): `src/modules/teams/team.routes.js`
- [Team controller](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.controller.js): `src/modules/teams/team.controller.js`
- [Team service](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.services.js): `src/modules/teams/team.services.js`
- [Team records](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/teams/team.model.js): `src/modules/teams/team.model.js`

### Shared infrastructure

- [Upload routes](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/uploads/upload.routes.js): `src/modules/uploads/upload.routes.js`
- [Upload controller](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/uploads/upload.controller.js): `src/modules/uploads/upload.controller.js`
- [Upload service](https://github.com/sanju1098/incident-management-system/blob/main/src/modules/uploads/upload.service.js): `src/modules/uploads/upload.service.js`
- [Request validation](https://github.com/sanju1098/incident-management-system/blob/main/src/middleware/validate.middleware.js): `src/middleware/validate.middleware.js`
- [MongoDB connection](https://github.com/sanju1098/incident-management-system/blob/main/src/config/db.js): `src/config/db.js`

### Other components

- **API client**
- **Cloudinary**

## Connections

- API client → Express app: sends requests (evidence: `README.md`)
- Express app → API router: mounts routes (evidence: `src/app.js`)
- API router → Auth routes: mounts (evidence: `src/routes/index.js`)
- API router → User routes: mounts (evidence: `src/routes/index.js`)
- API router → Team routes: mounts (evidence: `src/routes/index.js`)
- API router → Incident routes: mounts (evidence: `src/routes/index.js`)
- API router → Comment routes: mounts (evidence: `src/routes/index.js`)
- API router → Timeline routes: mounts (evidence: `src/routes/index.js`)
- API router → Upload routes: mounts (evidence: `src/routes/index.js`)
- Auth routes → Auth controller: dispatches (evidence: `src/modules/auth/auth.routes.js`)
- Auth controller → Auth service: invokes (evidence: `src/modules/auth/auth.controller.js`)
- Auth service → User and token records: reads and writes (evidence: `src/modules/auth/auth.service.js`)
- Auth routes → Request validation: validates (evidence: `src/modules/auth/auth.routes.js`)
- Auth routes → Authentication: protects routes (evidence: `src/modules/auth/auth.routes.js`)
- Authentication → User and token records: loads user (evidence: `src/middleware/auth.middleware.js`)
- Incident routes → Incident controller: dispatches (evidence: `src/modules/incidents/incident.routes.js`)
- Incident controller → Incident service: invokes (evidence: `src/modules/incidents/incident.controller.js`)
- Incident service → Incident records: reads and writes (evidence: `src/modules/incidents/incident.service.js`)
- Comment routes → Comment controller: dispatches (evidence: `src/modules/comments/comment.routes.js`)
- Comment controller → Comment service: invokes (evidence: `src/modules/comments/comment.controller.js`)
- Comment service → Comment records: reads and writes (evidence: `src/modules/comments/comment.service.js`)
- Comment service → Incident records: uses incident data (evidence: `src/modules/comments/comment.service.js`)
- Comment service → Timeline service: records activity (evidence: `src/modules/comments/comment.service.js`)
- Timeline routes → Timeline controller: dispatches (evidence: `src/modules/timeline/timeline.routes.js`)
- Timeline controller → Timeline records: uses records (evidence: `src/modules/timeline/timeline.controller.js`)
- Incident service → Timeline service: records activity (evidence: `src/modules/incidents/incident.service.js`)
- User routes → User controller: dispatches (evidence: `src/modules/users/user.routes.js`)
- User controller → User service: invokes (evidence: `src/modules/users/user.controller.js`)
- User routes → Authentication: protects routes (evidence: `src/modules/users/user.routes.js`)
- User routes → Role authorization: checks roles (evidence: `src/modules/users/user.routes.js`)
- Team routes → Team controller: dispatches (evidence: `src/modules/teams/team.routes.js`)
- Team controller → Team service: invokes (evidence: `src/modules/teams/team.controller.js`)
- Team service → Team records: reads and writes (evidence: `src/modules/teams/team.services.js`)
- Team routes → Authentication: protects routes (evidence: `src/modules/teams/team.routes.js`)
- Team routes → Role authorization: checks roles (evidence: `src/modules/teams/team.routes.js`)
- Upload routes → Upload controller: dispatches (evidence: `src/modules/uploads/upload.routes.js`)
- Upload controller → Upload service: invokes (evidence: `src/modules/uploads/upload.controller.js`)
- Upload routes → Authentication: protects routes (evidence: `src/modules/uploads/upload.routes.js`)
- Upload service → Cloudinary: uploads files
- Express app → MongoDB connection: connects at startup (evidence: `src/server.js`)
