# javersser/csi_icasino_support_intelligence architecture

> Architecture diagram of the GitHub repository javersser/csi_icasino_support_intelligence, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/javersser/csi_icasino_support_intelligence
- Repository: https://github.com/javersser/csi_icasino_support_intelligence

## Overview

CSI is an internal casino-technician support platform. Technicians use its React interface to find system and issue information, get knowledge-grounded AI answers with safe fallback guidance, track follow-ups, and work with QA, videos, and email intelligence; the frontend calls an Express API backed by local JSON data. Distinct branches cover operational support, AI knowledge/assistance, scheduling and learning, and Outlook integrations. Relationships are limited to README documentation and shown imports/calls; some unsampled feature wiring is therefore omitted.

Main entry points: [`backend/src/repositories/index.js`](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/repositories/index.js) (JSON repositories), [`backend/src/agent/agentService.js`](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/agentService.js) (Rule-based agent), [`backend/server.js`](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/server.js) (Express server), [`backend/src/services/kcRetrievalService.js`](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/kcRetrievalService.js) (Knowledge retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Technician workspace"]
  node_web["Web application<br/>[App.jsx]"]
  node_api_client["API client<br/>[api.js]"]
  node_ai_workspace["AI workspace"]
  node_outlook_ui["Outlook workspace<br/>[OutlookPage.jsx]"]
end

subgraph group_api["API and operations"]
  node_server["Express server<br/>[server.js]"]
  node_routes["API routes<br/>[index.js]"]
  node_repositories[("JSON repositories<br/>[index.js]")]
  node_auth_users["Login users"]
end

subgraph group_support["Support knowledge"]
  node_issues["Issue tracking<br/>[issuesService.js]"]
  node_knowledge["Knowledge retrieval"]
  node_knowledge_settings["Knowledge settings"]
  node_embeddings["Embedding service"]
  node_knowledge_admin["Knowledge management"]
  node_applications["Application catalog"]
end

subgraph group_intelligence["AI assistance"]
  node_rule_agent["Rule-based agent<br/>[agentService.js]"]
  node_capabilities["Agent capabilities"]
  node_entity_extractor["Entity extraction<br/>[entityExtractor.js]"]
  node_help_topics["Help topics<br/>[helpTopics.js]"]
  node_llm_agent["LLM agent<br/>[llmAgentService.js]"]
  node_llm_tools["LLM tools<br/>[tools.js]"]
  node_ollama["Ollama service<br/>[ollamaService.js]"]
end

subgraph group_extensions["Workflows and integrations"]
  node_outlook_ews["EWS mail service<br/>[ewsMailService.js]"]
  node_schedule["Technician scheduling<br/>[schedule.routes.js]"]
  node_team_notifications["Team notifications"]
  node_other_capabilities["QA, videos, follow-ups"]
end

node_technician(("Technician"))
node_graph_mail{{"Microsoft Graph"}}
node_exchange{{"Exchange server"}}

node_technician -->|"uses"| node_web
node_web -->|"requests through"| node_api_client
node_api_client -->|"calls REST API"| node_server
node_server -->|"mounts routes"| node_routes
node_routes -.->|"serves data via"| node_repositories
node_issues -.->|"stores records"| node_repositories
node_knowledge -->|"reads chunks"| node_repositories
node_knowledge -->|"loads settings"| node_knowledge_settings
node_knowledge -->|"ranks embeddings"| node_embeddings
node_knowledge_admin -->|"manages applications"| node_applications
node_knowledge_admin -.->|"manages knowledge"| node_repositories
node_rule_agent -->|"checks permissions"| node_capabilities
node_rule_agent -->|"extracts entities"| node_entity_extractor
node_rule_agent -->|"matches topics"| node_help_topics
node_rule_agent -->|"falls back to"| node_llm_agent
node_llm_agent -->|"requests completion"| node_ollama
node_llm_agent -->|"dispatches tools"| node_llm_tools
node_ai_workspace -.->|"uses API"| node_api_client
node_outlook_ui -->|"reads mail"| node_graph_mail
node_outlook_ui -->|"uses backend for EWS"| node_server
node_outlook_ews -->|"requests mail"| node_exchange
node_schedule -.->|"persists schedule"| node_repositories
node_server -->|"starts scheduler"| node_team_notifications
node_technician -.->|"uses"| node_other_capabilities

click node_web "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/my-project/src/App.jsx"
click node_api_client "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/my-project/src/lib/api.js"
click node_ai_workspace "https://github.com/javersser/csi_icasino_support_intelligence/tree/main/my-project/src/features/ai"
click node_outlook_ui "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/my-project/src/pages/OutlookPage.jsx"
click node_server "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/server.js"
click node_routes "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/routes/index.js"
click node_repositories "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/repositories/index.js"
click node_issues "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/issuesService.js"
click node_knowledge "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/kcRetrievalService.js"
click node_knowledge_settings "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/kcSettingsService.js"
click node_embeddings "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/embeddingService.js"
click node_rule_agent "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/agentService.js"
click node_capabilities "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/capabilityRegistry.js"
click node_entity_extractor "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/entityExtractor.js"
click node_help_topics "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/helpTopics.js"
click node_llm_agent "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/llmAgent/llmAgentService.js"
click node_llm_tools "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/llmAgent/tools.js"
click node_ollama "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/ollamaService.js"
click node_knowledge_admin "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/controllers/aiKnowledgeController.js"
click node_applications "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/applicationsService.js"
click node_auth_users "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/authUsersService.js"
click node_outlook_ews "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/ews/ewsMailService.js"
click node_schedule "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/routes/schedule.routes.js"
click node_team_notifications "https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/teamNotificationsService.js"
click node_other_capabilities "https://github.com/javersser/csi_icasino_support_intelligence/tree/main/backend/src/services"

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_web,node_api_client,node_ai_workspace,node_outlook_ui toneBlue
class node_server,node_routes,node_repositories,node_auth_users toneAmber
class node_issues,node_knowledge,node_knowledge_settings,node_embeddings,node_knowledge_admin,node_applications,node_exchange toneMint
class node_rule_agent,node_capabilities,node_entity_extractor,node_help_topics,node_llm_agent,node_llm_tools,node_ollama toneRose
class node_outlook_ews,node_schedule,node_team_notifications,node_other_capabilities,node_technician,node_graph_mail toneIndigo
```

## Components

### Technician workspace

- [Web application](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/my-project/src/App.jsx): `my-project/src/App.jsx`
- [API client](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/my-project/src/lib/api.js): `my-project/src/lib/api.js`
- [AI workspace](https://github.com/javersser/csi_icasino_support_intelligence/tree/main/my-project/src/features/ai): `my-project/src/features/ai`
- [Outlook workspace](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/my-project/src/pages/OutlookPage.jsx): `my-project/src/pages/OutlookPage.jsx`

### API and operations

- [Express server](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/server.js): `backend/server.js`
- [API routes](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [JSON repositories](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/repositories/index.js): `backend/src/repositories/index.js`
- [Login users](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/authUsersService.js): `backend/src/services/authUsersService.js`

### Support knowledge

- [Issue tracking](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/issuesService.js): `backend/src/services/issuesService.js`
- [Knowledge retrieval](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/kcRetrievalService.js): `backend/src/services/kcRetrievalService.js`
- [Knowledge settings](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/kcSettingsService.js): `backend/src/services/kcSettingsService.js`
- [Embedding service](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/embeddingService.js): `backend/src/services/embeddingService.js`
- [Knowledge management](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/controllers/aiKnowledgeController.js): `backend/src/controllers/aiKnowledgeController.js`
- [Application catalog](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/applicationsService.js): `backend/src/services/applicationsService.js`

### AI assistance

- [Rule-based agent](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/agentService.js): `backend/src/agent/agentService.js`
- [Agent capabilities](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/capabilityRegistry.js): `backend/src/agent/capabilityRegistry.js`
- [Entity extraction](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/entityExtractor.js): `backend/src/agent/entityExtractor.js`
- [Help topics](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/agent/helpTopics.js): `backend/src/agent/helpTopics.js`
- [LLM agent](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/llmAgent/llmAgentService.js): `backend/src/llmAgent/llmAgentService.js`
- [LLM tools](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/llmAgent/tools.js): `backend/src/llmAgent/tools.js`
- [Ollama service](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/ollamaService.js): `backend/src/services/ollamaService.js`

### Workflows and integrations

- [EWS mail service](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/ews/ewsMailService.js): `backend/src/services/ews/ewsMailService.js`
- [Technician scheduling](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/routes/schedule.routes.js): `backend/src/routes/schedule.routes.js`
- [Team notifications](https://github.com/javersser/csi_icasino_support_intelligence/blob/main/backend/src/services/teamNotificationsService.js): `backend/src/services/teamNotificationsService.js`
- [QA, videos, follow-ups](https://github.com/javersser/csi_icasino_support_intelligence/tree/main/backend/src/services): `backend/src/services`

### Other components

- **Technician**
- **Microsoft Graph**
- **Exchange server**

## Connections

- Technician → Web application: uses
- Web application → API client: requests through
- API client → Express server: calls REST API
- Express server → API routes: mounts routes (evidence: `backend/server.js`)
- API routes → JSON repositories: serves data via
- Issue tracking → JSON repositories: stores records
- Knowledge retrieval → JSON repositories: reads chunks (evidence: `backend/src/services/kcRetrievalService.js`)
- Knowledge retrieval → Knowledge settings: loads settings (evidence: `backend/src/services/kcRetrievalService.js`)
- Knowledge retrieval → Embedding service: ranks embeddings (evidence: `backend/src/services/kcRetrievalService.js`)
- Knowledge management → Application catalog: manages applications (evidence: `backend/src/controllers/aiKnowledgeController.js`)
- Knowledge management → JSON repositories: manages knowledge
- Rule-based agent → Agent capabilities: checks permissions (evidence: `backend/src/agent/agentService.js`)
- Rule-based agent → Entity extraction: extracts entities (evidence: `backend/src/agent/agentService.js`)
- Rule-based agent → Help topics: matches topics (evidence: `backend/src/agent/agentService.js`)
- Rule-based agent → LLM agent: falls back to (evidence: `backend/src/agent/agentService.js`)
- LLM agent → Ollama service: requests completion (evidence: `backend/src/llmAgent/llmAgentService.js`)
- LLM agent → LLM tools: dispatches tools (evidence: `backend/src/llmAgent/llmAgentService.js`)
- AI workspace → API client: uses API
- Outlook workspace → Microsoft Graph: reads mail
- Outlook workspace → Express server: uses backend for EWS
- EWS mail service → Exchange server: requests mail
- Technician scheduling → JSON repositories: persists schedule
- Express server → Team notifications: starts scheduler (evidence: `backend/server.js`)
- Technician → QA, videos, follow-ups: uses
