# sudhir3116/enterprise-it-servicedesk architecture

> Architecture diagram of the GitHub repository sudhir3116/enterprise-it-servicedesk, 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/sudhir3116/enterprise-it-servicedesk
- Repository: https://github.com/sudhir3116/enterprise-it-servicedesk

## Overview

Product Support Portal is a multi-tenant SaaS ITSM platform. Its main workflow takes a merchant issue through ticket intake, routing and SLA tracking, support-engineer investigation, developer bug handling, and knowledge capture; a separate feedback portal supports product-roadmap requests. The graph combines documented product stages with relationships visible in the supplied excerpts and SOURCE INDEX. Several route/controller and background-job details were not sampled, so those links are omitted rather than inferred.

Main entry points: [`frontend/src/App.jsx`](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/App.jsx) (Portal SPA), [`backend/controllers/ticketController.js`](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/controllers/ticketController.js) (Ticket Workflow), [`backend/server.js`](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/server.js) (Express API), [`frontend/src/services/api.js`](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/services/api.js) (API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Role-Based Experience"]
  node_spa["Portal SPA<br/>[App.jsx]"]
  node_auth_context["Session Context<br/>[AuthContext.jsx]"]
  node_customer_pages["Customer Workspace<br/>[CreateTicket.jsx]"]
  node_engineer_pages["Engineer Workspace"]
  node_bug_pages["Bug Investigation"]
  node_api_client["API Client<br/>[api.js]"]
end

subgraph group_api["API and Workflows"]
  node_server["Express API<br/>[server.js]"]
  node_auth["Authentication<br/>[authService.js]"]
  node_user_store[("User Records<br/>[User.js]")]
end

subgraph group_operations["Support Operations"]
  node_ticket_controller["Ticket Workflow"]
  node_routing["Auto Routing<br/>[routingService.js]"]
  node_sla["SLA Engine<br/>[slaService.js]"]
  node_sla_monitor["SLA Monitor<br/>[slaMonitor.js]"]
  node_bug_service["Bug Lifecycle<br/>[bugService.js]"]
  node_ticket_store[("Ticket Records<br/>[Ticket.js]")]
  node_bug_store[("Bug Reports<br/>[BugReport.js]")]
end

subgraph group_knowledge["Knowledge and Product"]
  node_knowledge["Knowledge Base<br/>[kbController.js]"]
  node_article_store[("Knowledge Articles")]
  node_feedback["Product Feedback"]
end

node_merchant(("Merchant / Customer"))
node_support_staff(("Support Staff"))
node_developer(("Developer"))
node_database[("MongoDB")]

node_merchant -->|"uses portal"| node_spa
node_support_staff -->|"uses portal"| node_spa
node_developer -->|"uses portal"| node_spa
node_spa -->|"routes to"| node_customer_pages
node_spa -->|"routes to"| node_engineer_pages
node_spa -->|"routes to"| node_bug_pages
node_auth_context -->|"uses"| node_api_client
node_engineer_pages -->|"calls"| node_api_client
node_bug_pages -->|"requests API"| node_server
node_customer_pages -->|"requests API"| node_server
node_api_client -->|"sends REST requests"| node_server
node_server -.->|"routes auth requests"| node_auth
node_auth -->|"reads and updates"| node_user_store
node_server -.->|"routes ticket requests"| node_ticket_controller
node_ticket_controller -->|"reads and writes"| node_ticket_store
node_ticket_controller -.->|"uses for assignment"| node_routing
node_ticket_controller -.->|"uses SLA logic"| node_sla
node_sla_monitor -.->|"monitors deadlines"| node_ticket_store
node_ticket_controller -.->|"creates bug handoff"| node_bug_service
node_bug_service -.->|"manages reports"| node_bug_store
node_ticket_controller -.->|"converts resolution"| node_knowledge
node_knowledge -->|"reads and writes"| node_article_store
node_spa -.->|"offers feedback portal"| node_feedback
node_ticket_store -->|"persists in"| node_database
node_user_store -->|"persists in"| node_database
node_article_store -->|"persists in"| node_database
node_bug_store -->|"persists in"| node_database

click node_spa "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/App.jsx"
click node_auth_context "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/context/AuthContext.jsx"
click node_customer_pages "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/pages/CreateTicket.jsx"
click node_engineer_pages "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/pages/EngineerTickets.jsx"
click node_bug_pages "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/pages/EngineerBugInvestigation.jsx"
click node_api_client "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/services/api.js"
click node_server "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/server.js"
click node_auth "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/authService.js"
click node_ticket_controller "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/controllers/ticketController.js"
click node_routing "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/routingService.js"
click node_sla "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/slaService.js"
click node_sla_monitor "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/jobs/slaMonitor.js"
click node_bug_service "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/bugService.js"
click node_ticket_store "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/Ticket.js"
click node_knowledge "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/controllers/kbController.js"
click node_article_store "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/KnowledgeArticle.js"
click node_feedback "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/controllers/feedbackController.js"
click node_bug_store "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/BugReport.js"
click node_user_store "https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/User.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_spa,node_auth_context,node_customer_pages,node_engineer_pages,node_bug_pages,node_api_client toneBlue
class node_server,node_auth,node_user_store,node_database toneAmber
class node_ticket_controller,node_routing,node_sla,node_sla_monitor,node_bug_service,node_ticket_store,node_bug_store toneMint
class node_knowledge,node_article_store,node_feedback toneRose
class node_merchant,node_support_staff,node_developer toneIndigo
```

## Components

### Role-Based Experience

- [Portal SPA](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session Context](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Customer Workspace](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/pages/CreateTicket.jsx): `frontend/src/pages/CreateTicket.jsx`
- [Engineer Workspace](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/pages/EngineerTickets.jsx): `frontend/src/pages/EngineerTickets.jsx`
- [Bug Investigation](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/pages/EngineerBugInvestigation.jsx): `frontend/src/pages/EngineerBugInvestigation.jsx`
- [API Client](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`

### API and Workflows

- [Express API](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/server.js): `backend/server.js`
- [Authentication](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/authService.js): `backend/services/authService.js`
- [User Records](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/User.js): `backend/models/User.js`

### Support Operations

- [Ticket Workflow](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/controllers/ticketController.js): `backend/controllers/ticketController.js`
- [Auto Routing](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/routingService.js): `backend/services/routingService.js`
- [SLA Engine](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/slaService.js): `backend/services/slaService.js`
- [SLA Monitor](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/jobs/slaMonitor.js): `backend/jobs/slaMonitor.js`
- [Bug Lifecycle](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/services/bugService.js): `backend/services/bugService.js`
- [Ticket Records](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/Ticket.js): `backend/models/Ticket.js`
- [Bug Reports](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/BugReport.js): `backend/models/BugReport.js`

### Knowledge and Product

- [Knowledge Base](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/controllers/kbController.js): `backend/controllers/kbController.js`
- [Knowledge Articles](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/models/KnowledgeArticle.js): `backend/models/KnowledgeArticle.js`
- [Product Feedback](https://github.com/sudhir3116/enterprise-it-servicedesk/blob/main/backend/controllers/feedbackController.js): `backend/controllers/feedbackController.js`

### Other components

- **Merchant / Customer**
- **Support Staff**
- **Developer**
- **MongoDB**

## Connections

- Merchant / Customer → Portal SPA: uses portal (evidence: `README.md`)
- Support Staff → Portal SPA: uses portal (evidence: `README.md`)
- Developer → Portal SPA: uses portal (evidence: `README.md`)
- Portal SPA → Customer Workspace: routes to (evidence: `frontend/src/App.jsx`)
- Portal SPA → Engineer Workspace: routes to (evidence: `frontend/src/App.jsx`)
- Portal SPA → Bug Investigation: routes to (evidence: `frontend/src/App.jsx`)
- Session Context → API Client: uses (evidence: `frontend/src/context/AuthContext.jsx`)
- Engineer Workspace → API Client: calls (evidence: `frontend/src/pages/EngineerTickets.jsx`)
- Bug Investigation → Express API: requests API (evidence: `README.md`)
- Customer Workspace → Express API: requests API (evidence: `README.md`)
- API Client → Express API: sends REST requests (evidence: `README.md`)
- Express API → Authentication: routes auth requests
- Authentication → User Records: reads and updates (evidence: `backend/services/authService.js`)
- Express API → Ticket Workflow: routes ticket requests
- Ticket Workflow → Ticket Records: reads and writes (evidence: `backend/controllers/ticketController.js`)
- Ticket Workflow → Auto Routing: uses for assignment
- Ticket Workflow → SLA Engine: uses SLA logic
- SLA Monitor → Ticket Records: monitors deadlines
- Ticket Workflow → Bug Lifecycle: creates bug handoff
- Bug Lifecycle → Bug Reports: manages reports
- Ticket Workflow → Knowledge Base: converts resolution
- Knowledge Base → Knowledge Articles: reads and writes (evidence: `backend/controllers/kbController.js`)
- Portal SPA → Product Feedback: offers feedback portal (evidence: `README.md`)
- Ticket Records → MongoDB: persists in (evidence: `README.md`)
- User Records → MongoDB: persists in (evidence: `README.md`)
- Knowledge Articles → MongoDB: persists in (evidence: `README.md`)
- Bug Reports → MongoDB: persists in (evidence: `README.md`)
