# afffroz1/customer-and-employee-support-ai architecture

> Architecture diagram of the GitHub repository afffroz1/customer-and-employee-support-ai, 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/afffroz1/customer-and-employee-support-ai
- Repository: https://github.com/afffroz1/customer-and-employee-support-ai

## Overview

This repository is the backend for a customer/employee support system with a knowledge-grounded AI assistant. Users authenticate and interact with ticketing, attachments, and CSAI through REST APIs; the AI chat path maintains conversation context, retrieves and ranks approved knowledge, builds a prompt, and returns a generated answer. The graph includes the documented account, ticket, and attachment capabilities as well as the sampled CSAI internals. Some CSAI persistence and AI-provider details are documented but their implementations were not sampled, so those links are marked unverified.

Main entry points: [`src/routes/index.js`](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/index.js) (API route registry), [`src/csai/Services/support.service.js`](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/support.service.js) (Conversation orchestration), [`src/middlewares/auth.middleware.js`](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/middlewares/auth.middleware.js) (JWT authentication), [`src/routes/auth.routes.js`](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/auth.routes.js) (Authentication routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and Access"]
  node_api["Express API<br/>[app.js]"]
  node_api_routes["API route registry<br/>[index.js]"]
end

subgraph group_accounts["Identity"]
  node_auth_routes["Authentication routes<br/>[auth.routes.js]"]
  node_auth_ctrl["Account management<br/>[auth.controller.js]"]
  node_auth_mw["JWT authentication<br/>[auth.middleware.js]"]
  node_user_store[("User records<br/>[user.model.js]")]
end

subgraph group_tickets["Support Operations"]
  node_ticket_routes["Ticket routes<br/>[ticket.routes.js]"]
  node_ticket_ctrl["Ticket handling"]
  node_ticket_store[("Ticket records<br/>[ticket.model.js]")]
  node_message_routes["Ticket message routes"]
  node_message_ctrl["Ticket messages"]
  node_activity_routes["Activity routes<br/>[activity.routes.js]"]
  node_activity_ctrl["Activity logging"]
  node_file_routes["Attachment routes<br/>[binFile.routes.js]"]
  node_file_ctrl["Attachment handling"]
  node_file_store[("Attachment records<br/>[BinFile.model.js]")]
end

subgraph group_csai["AI Support"]
  node_support_routes["AI support routes<br/>[support.routes.js]"]
  node_support_ctrl["Chat controller"]
  node_support_service["Conversation orchestration<br/>[support.service.js]"]
  node_chat_repo["Conversation storage<br/>[Chat.repository.js]"]
  node_msg_repo["Chat message storage"]
  node_memory["Conversation memory<br/>[memory.service.js]"]
  node_prompt["Prompt construction<br/>[prompt.service.js]"]
  node_validator["Response validation"]
  node_ai_service["Gemini integration<br/>[ai.service.js]"]
end

subgraph group_knowledge["Knowledge Retrieval"]
  node_knowledge_routes["Knowledge routes"]
  node_knowledge_ctrl["Knowledge management"]
  node_knowledge_service["Search and ranking"]
  node_knowledge_repo["Knowledge repository"]
  node_knowledge_store[("Approved knowledge<br/>[Knowledge.model.js]")]
end

node_client(("Client or employee"))
node_gemini["Google Gemini"]
node_mongo[("MongoDB")]

node_client -->|"sends requests"| node_api
node_api -->|"mounts routes"| node_api_routes
node_api_routes -->|"registers"| node_auth_routes
node_api_routes -->|"registers"| node_ticket_routes
node_api_routes -->|"registers"| node_message_routes
node_api_routes -->|"registers"| node_activity_routes
node_api_routes -->|"registers"| node_file_routes
node_api_routes -->|"registers"| node_support_routes
node_api_routes -.->|"registers"| node_knowledge_routes
node_auth_routes -->|"routes requests"| node_auth_ctrl
node_auth_routes -->|"protects routes"| node_auth_mw
node_auth_ctrl -->|"reads and updates"| node_user_store
node_auth_mw -->|"loads user"| node_user_store
node_ticket_routes -->|"protects routes"| node_auth_mw
node_ticket_routes -->|"routes requests"| node_ticket_ctrl
node_ticket_ctrl -->|"reads and updates"| node_ticket_store
node_message_routes -->|"routes requests"| node_message_ctrl
node_message_ctrl -.->|"persists messages"| node_mongo
node_activity_routes -->|"routes requests"| node_activity_ctrl
node_activity_ctrl -.->|"persists activity"| node_mongo
node_file_routes -->|"routes requests"| node_file_ctrl
node_file_ctrl -->|"reads and writes"| node_file_store
node_support_routes -->|"protects routes"| node_auth_mw
node_support_routes -->|"routes requests"| node_support_ctrl
node_support_ctrl -->|"delegates chat"| node_support_service
node_support_service -->|"uses conversation storage"| node_chat_repo
node_support_service -->|"uses message storage"| node_msg_repo
node_support_service -->|"loads context"| node_memory
node_support_service -->|"searches knowledge"| node_knowledge_service
node_support_service -->|"builds prompt"| node_prompt
node_support_service -->|"requests generation"| node_ai_service
node_support_service -->|"validates answer"| node_validator
node_ai_service -.->|"calls model"| node_gemini
node_knowledge_routes -->|"routes requests"| node_knowledge_ctrl
node_knowledge_routes -->|"protects routes"| node_auth_mw
node_knowledge_ctrl -->|"delegates CRUD"| node_knowledge_service
node_knowledge_service -->|"loads records"| node_knowledge_repo
node_knowledge_repo -->|"reads and writes"| node_knowledge_store
node_knowledge_store -.->|"stored in"| node_mongo

click node_api "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/app.js"
click node_api_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/index.js"
click node_auth_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/auth.routes.js"
click node_auth_ctrl "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/auth.controller.js"
click node_auth_mw "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/middlewares/auth.middleware.js"
click node_user_store "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/models/user.model.js"
click node_ticket_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/ticket.routes.js"
click node_ticket_ctrl "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/ticket.controller.js"
click node_ticket_store "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/models/ticket.model.js"
click node_message_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/ticketMessage.routes.js"
click node_message_ctrl "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/ticketMessage.controller.js"
click node_activity_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/activity.routes.js"
click node_activity_ctrl "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/activity.controller.js"
click node_file_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/binFile.routes.js"
click node_file_ctrl "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/binFile.controller.js"
click node_file_store "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/models/BinFile.model.js"
click node_support_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Routes/support.routes.js"
click node_support_ctrl "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Controller/support.controller.js"
click node_support_service "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/support.service.js"
click node_chat_repo "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Repository/Chat.repository.js"
click node_msg_repo "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Repository/Message.repository.js"
click node_memory "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/memory.service.js"
click node_prompt "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/prompt.service.js"
click node_validator "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/responseValidator.js"
click node_ai_service "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/ai.service.js"
click node_knowledge_routes "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Routes/knowledge.routes.js"
click node_knowledge_ctrl "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Controller/knowledge.controller.js"
click node_knowledge_service "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/knowledge.service.js"
click node_knowledge_repo "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Repository/knowledge.repository.js"
click node_knowledge_store "https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Model/Knowledge.model.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_api,node_api_routes,node_client toneBlue
class node_auth_routes,node_auth_ctrl,node_auth_mw,node_user_store,node_mongo toneAmber
class node_ticket_routes,node_ticket_ctrl,node_ticket_store,node_message_routes,node_message_ctrl,node_activity_routes,node_activity_ctrl,node_file_routes,node_file_ctrl,node_file_store toneMint
class node_support_routes,node_support_ctrl,node_support_service,node_chat_repo,node_msg_repo,node_memory,node_prompt,node_validator,node_ai_service toneRose
class node_knowledge_routes,node_knowledge_ctrl,node_knowledge_service,node_knowledge_repo,node_knowledge_store,node_gemini toneIndigo
```

## Components

### API and Access

- [Express API](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/app.js): `src/app.js`
- [API route registry](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/index.js): `src/routes/index.js`

### Identity

- [Authentication routes](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/auth.routes.js): `src/routes/auth.routes.js`
- [Account management](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/auth.controller.js): `src/controllers/auth.controller.js`
- [JWT authentication](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/middlewares/auth.middleware.js): `src/middlewares/auth.middleware.js`
- [User records](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/models/user.model.js): `src/models/user.model.js`

### Support Operations

- [Ticket routes](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/ticket.routes.js): `src/routes/ticket.routes.js`
- [Ticket handling](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/ticket.controller.js): `src/controllers/ticket.controller.js`
- [Ticket records](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/models/ticket.model.js): `src/models/ticket.model.js`
- [Ticket message routes](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/ticketMessage.routes.js): `src/routes/ticketMessage.routes.js`
- [Ticket messages](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/ticketMessage.controller.js): `src/controllers/ticketMessage.controller.js`
- [Activity routes](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/activity.routes.js): `src/routes/activity.routes.js`
- [Activity logging](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/activity.controller.js): `src/controllers/activity.controller.js`
- [Attachment routes](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/routes/binFile.routes.js): `src/routes/binFile.routes.js`
- [Attachment handling](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/controllers/binFile.controller.js): `src/controllers/binFile.controller.js`
- [Attachment records](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/models/BinFile.model.js): `src/models/BinFile.model.js`

### AI Support

- [AI support routes](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Routes/support.routes.js): `src/csai/Routes/support.routes.js`
- [Chat controller](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Controller/support.controller.js): `src/csai/Controller/support.controller.js`
- [Conversation orchestration](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/support.service.js): `src/csai/Services/support.service.js`
- [Conversation storage](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Repository/Chat.repository.js): `src/csai/Repository/Chat.repository.js`
- [Chat message storage](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Repository/Message.repository.js): `src/csai/Repository/Message.repository.js`
- [Conversation memory](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/memory.service.js): `src/csai/Services/memory.service.js`
- [Prompt construction](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/prompt.service.js): `src/csai/Services/prompt.service.js`
- [Response validation](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/responseValidator.js): `src/csai/Services/responseValidator.js`
- [Gemini integration](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/ai.service.js): `src/csai/Services/ai.service.js`

### Knowledge Retrieval

- [Knowledge routes](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Routes/knowledge.routes.js): `src/csai/Routes/knowledge.routes.js`
- [Knowledge management](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Controller/knowledge.controller.js): `src/csai/Controller/knowledge.controller.js`
- [Search and ranking](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Services/knowledge.service.js): `src/csai/Services/knowledge.service.js`
- [Knowledge repository](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Repository/knowledge.repository.js): `src/csai/Repository/knowledge.repository.js`
- [Approved knowledge](https://github.com/afffroz1/customer-and-employee-support-ai/blob/main/src/csai/Model/Knowledge.model.js): `src/csai/Model/Knowledge.model.js`

### Other components

- **Client or employee**
- **Google Gemini**
- **MongoDB**

## Connections

- Client or employee → Express API: sends requests (evidence: `src/app.js`)
- Express API → API route registry: mounts routes (evidence: `src/app.js`)
- API route registry → Authentication routes: registers (evidence: `src/routes/index.js`)
- API route registry → Ticket routes: registers (evidence: `src/routes/index.js`)
- API route registry → Ticket message routes: registers (evidence: `src/routes/index.js`)
- API route registry → Activity routes: registers (evidence: `src/routes/index.js`)
- API route registry → Attachment routes: registers (evidence: `src/routes/index.js`)
- API route registry → AI support routes: registers (evidence: `src/routes/index.js`)
- API route registry → Knowledge routes: registers
- Authentication routes → Account management: routes requests (evidence: `src/routes/auth.routes.js`)
- Authentication routes → JWT authentication: protects routes (evidence: `src/routes/auth.routes.js`)
- Account management → User records: reads and updates (evidence: `src/controllers/auth.controller.js`)
- JWT authentication → User records: loads user (evidence: `src/middlewares/auth.middleware.js`)
- Ticket routes → JWT authentication: protects routes (evidence: `src/routes/ticket.routes.js`)
- Ticket routes → Ticket handling: routes requests (evidence: `src/routes/ticket.routes.js`)
- Ticket handling → Ticket records: reads and updates (evidence: `src/controllers/ticket.controller.js`)
- Ticket message routes → Ticket messages: routes requests (evidence: `src/routes/ticketMessage.routes.js`)
- Ticket messages → MongoDB: persists messages
- Activity routes → Activity logging: routes requests (evidence: `src/routes/activity.routes.js`)
- Activity logging → MongoDB: persists activity
- Attachment routes → Attachment handling: routes requests (evidence: `src/routes/binFile.routes.js`)
- Attachment handling → Attachment records: reads and writes (evidence: `src/controllers/binFile.controller.js`)
- AI support routes → JWT authentication: protects routes (evidence: `src/csai/Routes/support.routes.js`)
- AI support routes → Chat controller: routes requests (evidence: `src/csai/Routes/support.routes.js`)
- Chat controller → Conversation orchestration: delegates chat (evidence: `src/csai/Controller/support.controller.js`)
- Conversation orchestration → Conversation storage: uses conversation storage (evidence: `src/csai/Services/support.service.js`)
- Conversation orchestration → Chat message storage: uses message storage (evidence: `src/csai/Services/support.service.js`)
- Conversation orchestration → Conversation memory: loads context (evidence: `src/csai/Services/support.service.js`)
- Conversation orchestration → Search and ranking: searches knowledge (evidence: `src/csai/Services/support.service.js`)
- Conversation orchestration → Prompt construction: builds prompt (evidence: `src/csai/Services/support.service.js`)
- Conversation orchestration → Gemini integration: requests generation (evidence: `src/csai/Services/support.service.js`)
- Conversation orchestration → Response validation: validates answer (evidence: `src/csai/Services/support.service.js`)
- Gemini integration → Google Gemini: calls model
- Knowledge routes → Knowledge management: routes requests (evidence: `src/csai/Routes/knowledge.routes.js`)
- Knowledge routes → JWT authentication: protects routes (evidence: `src/csai/Routes/knowledge.routes.js`)
- Knowledge management → Search and ranking: delegates CRUD (evidence: `src/csai/Controller/knowledge.controller.js`)
- Search and ranking → Knowledge repository: loads records (evidence: `src/csai/Services/knowledge.service.js`)
- Knowledge repository → Approved knowledge: reads and writes (evidence: `src/csai/Repository/knowledge.repository.js`)
- Approved knowledge → MongoDB: stored in
