# sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot architecture

> Architecture diagram of the GitHub repository sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot
- Repository: https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot

## Overview

OpsPilot is an AI-assisted incident response copilot: operators use the web console or chat to investigate incidents, gather operational and knowledge evidence, assess risk, and review proposed remediation. The README documents tool-based investigation, grounded RAG, ticket workflows, human approval, RBAC, and auditing; those capabilities are represented where their source paths are supported. Excerpts show the API/frontend entry points, knowledge ingestion and retrieval, investigation persistence, and safe adapter dispatch, but not the full graph/tool orchestration or all service wiring, so uncertain links are omitted.

Main entry points: [`backend/app/main.py`](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/main.py) (REST API), [`frontend/src/App.jsx`](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/App.jsx) (OpsPilot console), [`backend/app/services/investigation_service.py`](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/services/investigation_service.py) (Investigation workflow), [`backend/app/ai/rag/retrieval/service.py`](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/retrieval/service.py) (Access-aware retrieval)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operator experience"]
  node_app["OpsPilot console<br/>[App.jsx]"]
  node_auth["Persona authentication<br/>[AuthContext.jsx]"]
  node_incident_view["Incident workspace"]
  node_remediation_view["Remediation portal"]
end

subgraph group_api["API and workflows"]
  node_api_server["REST API<br/>[main.py]"]
  node_investigation_api["Investigation endpoints<br/>[investigations.py]"]
  node_incident_api["Incident endpoints<br/>[incidents.py]"]
  node_investigation["Investigation workflow"]
end

subgraph group_ai["Investigation intelligence"]
  node_chat["Chat orchestration<br/>[chat_graph.py]"]
  node_investigation_graph["Investigation graph"]
  node_tool_registry["Approved tool registry<br/>[registry.py]"]
  node_risk["Incident risk prediction<br/>[predictor.py]"]
end

subgraph group_knowledge["Knowledge retrieval"]
  node_knowledge_api["Knowledge document API"]
  node_ingestion["Document ingestion<br/>[service.py]"]
  node_retrieval["Access-aware retrieval<br/>[service.py]"]
  node_rerank["Result reranking<br/>[service.py]"]
  node_vectorstore[("Vector index<br/>[pinecone.py]")]
  node_knowledge_repo[("Knowledge metadata")]
end

subgraph group_actions["Governed operations"]
  node_remediation_api["Remediation endpoints<br/>[remediations.py]"]
  node_remediation_service["Approval workflow"]
  node_execution["Safe action engine<br/>[engine.py]"]
  node_adapters["Action adapters<br/>[restart.py]"]
  node_audit["Immutable audit trail"]
end

node_operator(("Operations engineer"))

node_operator -->|"uses"| node_app
node_app -->|"provides context"| node_auth
node_app -->|"opens"| node_incident_view
node_app -->|"opens"| node_remediation_view
node_auth -->|"authenticates"| node_api_server
node_app -.->|"requests data"| node_api_server
node_api_server -->|"routes"| node_investigation_api
node_api_server -->|"routes"| node_incident_api
node_api_server -->|"routes"| node_knowledge_api
node_api_server -->|"routes"| node_remediation_api
node_investigation_api -.->|"delegates"| node_investigation
node_investigation -.->|"runs analysis"| node_investigation_graph
node_investigation_graph -.->|"dispatches tools"| node_tool_registry
node_investigation_graph -.->|"assesses risk"| node_risk
node_investigation -.->|"uses knowledge"| node_retrieval
node_knowledge_api -.->|"ingests documents"| node_ingestion
node_ingestion -->|"writes metadata"| node_knowledge_repo
node_ingestion -->|"writes chunks"| node_vectorstore
node_retrieval -->|"checks versions"| node_knowledge_repo
node_retrieval -.->|"ranks candidates"| node_rerank
node_retrieval -->|"searches vectors"| node_vectorstore
node_remediation_api -.->|"delegates"| node_remediation_service
node_remediation_service -.->|"executes approved action"| node_execution
node_execution -->|"dispatches action"| node_adapters
node_remediation_service -.->|"records decisions"| node_audit
node_investigation -->|"records investigation"| node_audit

click node_app "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/App.jsx"
click node_auth "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/context/AuthContext.jsx"
click node_incident_view "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/pages/IncidentDetailPage.jsx"
click node_remediation_view "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/pages/RemediationsPage.jsx"
click node_api_server "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/main.py"
click node_investigation_api "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/investigations.py"
click node_incident_api "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/incidents.py"
click node_investigation "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/services/investigation_service.py"
click node_chat "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/graph/chat_graph.py"
click node_investigation_graph "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/graph/investigation_graph.py"
click node_tool_registry "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/tools/registry.py"
click node_risk "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/risk/predictor.py"
click node_knowledge_api "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/knowledge_documents.py"
click node_ingestion "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/ingestion/service.py"
click node_retrieval "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/retrieval/service.py"
click node_rerank "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/reranking/service.py"
click node_vectorstore "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/vectorstore/pinecone.py"
click node_knowledge_repo "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/repositories/knowledge_document_repository.py"
click node_remediation_api "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/remediations.py"
click node_remediation_service "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/services/remediation_service.py"
click node_execution "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/remediation/engine.py"
click node_adapters "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/remediation/adapters/restart.py"
click node_audit "https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/services/audit_log_service.py"

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,node_incident_view,node_remediation_view toneBlue
class node_api_server,node_investigation_api,node_incident_api,node_investigation toneAmber
class node_chat,node_investigation_graph,node_tool_registry,node_risk toneMint
class node_knowledge_api,node_ingestion,node_retrieval,node_rerank,node_vectorstore,node_knowledge_repo toneRose
class node_remediation_api,node_remediation_service,node_execution,node_adapters,node_audit,node_operator toneIndigo
```

## Components

### Operator experience

- [OpsPilot console](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Persona authentication](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Incident workspace](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/pages/IncidentDetailPage.jsx): `frontend/src/pages/IncidentDetailPage.jsx`
- [Remediation portal](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/frontend/src/pages/RemediationsPage.jsx): `frontend/src/pages/RemediationsPage.jsx`

### API and workflows

- [REST API](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/main.py): `backend/app/main.py`
- [Investigation endpoints](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/investigations.py): `backend/app/api/v1/investigations.py`
- [Incident endpoints](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/incidents.py): `backend/app/api/v1/incidents.py`
- [Investigation workflow](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/services/investigation_service.py): `backend/app/services/investigation_service.py`

### Investigation intelligence

- [Chat orchestration](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/graph/chat_graph.py): `backend/app/ai/graph/chat_graph.py`
- [Investigation graph](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/graph/investigation_graph.py): `backend/app/ai/graph/investigation_graph.py`
- [Approved tool registry](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/tools/registry.py): `backend/app/ai/tools/registry.py`
- [Incident risk prediction](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/risk/predictor.py): `backend/app/ai/risk/predictor.py`

### Knowledge retrieval

- [Knowledge document API](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/knowledge_documents.py): `backend/app/api/v1/knowledge_documents.py`
- [Document ingestion](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/ingestion/service.py): `backend/app/ai/rag/ingestion/service.py`
- [Access-aware retrieval](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/retrieval/service.py): `backend/app/ai/rag/retrieval/service.py`
- [Result reranking](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/reranking/service.py): `backend/app/ai/rag/reranking/service.py`
- [Vector index](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/ai/rag/vectorstore/pinecone.py): `backend/app/ai/rag/vectorstore/pinecone.py`
- [Knowledge metadata](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/repositories/knowledge_document_repository.py): `backend/app/repositories/knowledge_document_repository.py`

### Governed operations

- [Remediation endpoints](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/api/v1/remediations.py): `backend/app/api/v1/remediations.py`
- [Approval workflow](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/services/remediation_service.py): `backend/app/services/remediation_service.py`
- [Safe action engine](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/remediation/engine.py): `backend/app/remediation/engine.py`
- [Action adapters](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/remediation/adapters/restart.py): `backend/app/remediation/adapters/restart.py`
- [Immutable audit trail](https://github.com/sanhith30/opspilot-ai-powered-it-operations-incident-response-copilot/blob/main/backend/app/services/audit_log_service.py): `backend/app/services/audit_log_service.py`

### Other components

- **Operations engineer**

## Connections

- Operations engineer → OpsPilot console: uses (evidence: `README.md`)
- OpsPilot console → Persona authentication: provides context (evidence: `frontend/src/App.jsx`)
- OpsPilot console → Incident workspace: opens (evidence: `frontend/src/App.jsx`)
- OpsPilot console → Remediation portal: opens (evidence: `frontend/src/App.jsx`)
- Persona authentication → REST API: authenticates (evidence: `frontend/src/context/AuthContext.jsx`)
- OpsPilot console → REST API: requests data
- REST API → Investigation endpoints: routes (evidence: `backend/app/main.py`)
- REST API → Incident endpoints: routes (evidence: `backend/app/main.py`)
- REST API → Knowledge document API: routes (evidence: `backend/app/main.py`)
- REST API → Remediation endpoints: routes (evidence: `backend/app/main.py`)
- Investigation endpoints → Investigation workflow: delegates
- Investigation workflow → Investigation graph: runs analysis
- Investigation graph → Approved tool registry: dispatches tools
- Investigation graph → Incident risk prediction: assesses risk
- Investigation workflow → Access-aware retrieval: uses knowledge
- Knowledge document API → Document ingestion: ingests documents
- Document ingestion → Knowledge metadata: writes metadata (evidence: `backend/app/ai/rag/ingestion/service.py`)
- Document ingestion → Vector index: writes chunks (evidence: `backend/app/ai/rag/ingestion/service.py`)
- Access-aware retrieval → Knowledge metadata: checks versions (evidence: `backend/app/ai/rag/retrieval/service.py`)
- Access-aware retrieval → Result reranking: ranks candidates
- Access-aware retrieval → Vector index: searches vectors (evidence: `backend/app/ai/rag/retrieval/service.py`)
- Remediation endpoints → Approval workflow: delegates
- Approval workflow → Safe action engine: executes approved action
- Safe action engine → Action adapters: dispatches action (evidence: `backend/app/remediation/engine.py`)
- Approval workflow → Immutable audit trail: records decisions
- Investigation workflow → Immutable audit trail: records investigation (evidence: `backend/app/services/investigation_service.py`)
