# saadahmed17/infrasentinel architecture

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

- Interactive diagram: https://gitdiagram.com/saadahmed17/infrasentinel
- Repository: https://github.com/saadahmed17/infrasentinel

## Overview

InfraSentinel is a multi-tenant infrastructure monitoring and operational intelligence platform. Agents send server metrics and security events to the API; the dashboard manages servers and organizations and presents alerts and incidents. The API persists telemetry, evaluates SIEM rules, and coordinates per-server anomaly detection and incident creation. The RAG assistant retrieves tenant-scoped incident context to answer operator questions. The README documents these major capabilities, but several detailed API and UI connections are not shown in source excerpts; those documented relationships are cited to the README.

Main entry points: [`apps/web/src/lib/api-client.ts`](https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/lib/api-client.ts) (Web API client), [`apps/api/src/prisma/prisma.service.ts`](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/prisma/prisma.service.ts) (Postgres and pgvector), [`apps/api/src/servers/servers.service.ts`](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/servers/servers.service.ts) (Server management), [`apps/ai-service/rag.py`](https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/rag.py) (Incident retrieval assistant)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_collection["Telemetry collection"]
  node_agent["Monitoring agent<br/>[agent.py]"]
  node_sshagent["SSH event agent<br/>[ssh_log_agent.py]"]
end

subgraph group_backend["API and operations"]
  node_ingest["Agent ingestion"]
  node_servers["Server management<br/>[servers.service.ts]"]
  node_events["Event tracking<br/>[events.service.ts]"]
  node_auth["Authentication and RBAC<br/>[auth.service.ts]"]
  node_organizations["Organizations"]
  node_database[("Postgres and pgvector<br/>[prisma.service.ts]")]
end

subgraph group_detection["Detection and incidents"]
  node_rules["SIEM rule engine"]
  node_incidentapi["Incident management"]
  node_anomalyapi["Anomaly coordination<br/>[anomaly.service.ts]"]
end

subgraph group_intelligence["AI services"]
  node_trainingdata["Metric training data<br/>[data_pipeline.py]"]
  node_preprocess["Metric preprocessing<br/>[preprocess.py]"]
  node_training["Model training<br/>[train.py]"]
  node_inference["Anomaly inference<br/>[inference.py]"]
  node_ragapi["RAG API proxy<br/>[rag.service.ts]"]
  node_ragengine["Incident retrieval assistant<br/>[rag.py]"]
end

subgraph group_console["Operator console"]
  node_dashboard["Monitoring dashboard<br/>[page.tsx]"]
  node_serverui["Server console<br/>[page.tsx]"]
  node_rulesui["Rules console<br/>[page.tsx]"]
  node_incidentsui["Incident console<br/>[page.tsx]"]
  node_assistantui["Assistant chat<br/>[page.tsx]"]
  node_webclient["Web API client<br/>[api-client.ts]"]
end

node_operator(("Operator"))
node_llm["Groq LLM"]

node_agent -->|"pushes metrics"| node_ingest
node_sshagent -->|"pushes events"| node_ingest
node_ingest -->|"dispatches ingestion"| node_servers
node_servers -->|"persists telemetry"| node_database
node_servers -->|"records events"| node_events
node_auth -->|"reads and writes"| node_database
node_organizations -->|"manages tenant data"| node_database
node_servers -.->|"feeds SIEM events"| node_rules
node_rules -.->|"creates alerts"| node_incidentapi
node_trainingdata -->|"loads metrics"| node_database
node_trainingdata -->|"provides metrics"| node_preprocess
node_preprocess -.->|"builds sequences"| node_training
node_training -.->|"supplies model"| node_inference
node_anomalyapi -.->|"requests scores"| node_inference
node_anomalyapi -.->|"creates anomaly alerts"| node_incidentapi
node_incidentapi -.->|"indexes incidents"| node_ragapi
node_ragapi -->|"forwards query"| node_ragengine
node_ragengine -.->|"retrieves incidents"| node_database
node_ragengine -.->|"generates answer"| node_llm
node_operator -->|"views status"| node_dashboard
node_operator -->|"manages servers"| node_serverui
node_operator -->|"configures rules"| node_rulesui
node_operator -->|"reviews incidents"| node_incidentsui
node_operator -->|"asks questions"| node_assistantui
node_dashboard -.->|"requests data"| node_webclient
node_serverui -.->|"requests data"| node_webclient
node_rulesui -.->|"requests data"| node_webclient
node_incidentsui -.->|"requests data"| node_webclient
node_assistantui -.->|"sends queries"| node_webclient
node_webclient -.->|"calls API"| node_auth
node_webclient -.->|"queries assistant"| node_ragapi

click node_agent "https://github.com/saadahmed17/infrasentinel/blob/main/apps/agent/agent.py"
click node_sshagent "https://github.com/saadahmed17/infrasentinel/blob/main/apps/agent/ssh_log_agent.py"
click node_ingest "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/servers/metrics-ingestion.controller.ts"
click node_servers "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/servers/servers.service.ts"
click node_events "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/events/events.service.ts"
click node_auth "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/auth/auth.service.ts"
click node_organizations "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/organizations/organizations.service.ts"
click node_database "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/prisma/prisma.service.ts"
click node_rules "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/rules/rule-engine.service.ts"
click node_incidentapi "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/incidents/incidents.service.ts"
click node_anomalyapi "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/anomaly/anomaly.service.ts"
click node_trainingdata "https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/data_pipeline.py"
click node_preprocess "https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/preprocess.py"
click node_training "https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/train.py"
click node_inference "https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/inference.py"
click node_ragapi "https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/rag/rag.service.ts"
click node_ragengine "https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/rag.py"
click node_dashboard "https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/dashboard/page.tsx"
click node_serverui "https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/servers/page.tsx"
click node_rulesui "https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/rules/page.tsx"
click node_incidentsui "https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/incidents/page.tsx"
click node_assistantui "https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/assistant/page.tsx"
click node_webclient "https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/lib/api-client.ts"

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_agent,node_sshagent toneBlue
class node_ingest,node_servers,node_events,node_auth,node_organizations,node_database toneAmber
class node_rules,node_incidentapi,node_anomalyapi toneMint
class node_trainingdata,node_preprocess,node_training,node_inference,node_ragapi,node_ragengine toneRose
class node_dashboard,node_serverui,node_rulesui,node_incidentsui,node_assistantui,node_webclient,node_operator,node_llm toneIndigo
```

## Components

### Telemetry collection

- [Monitoring agent](https://github.com/saadahmed17/infrasentinel/blob/main/apps/agent/agent.py): `apps/agent/agent.py`
- [SSH event agent](https://github.com/saadahmed17/infrasentinel/blob/main/apps/agent/ssh_log_agent.py): `apps/agent/ssh_log_agent.py`

### API and operations

- [Agent ingestion](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/servers/metrics-ingestion.controller.ts): `apps/api/src/servers/metrics-ingestion.controller.ts`
- [Server management](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/servers/servers.service.ts): `apps/api/src/servers/servers.service.ts`
- [Event tracking](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/events/events.service.ts): `apps/api/src/events/events.service.ts`
- [Authentication and RBAC](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/auth/auth.service.ts): `apps/api/src/auth/auth.service.ts`
- [Organizations](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/organizations/organizations.service.ts): `apps/api/src/organizations/organizations.service.ts`
- [Postgres and pgvector](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/prisma/prisma.service.ts): `apps/api/src/prisma/prisma.service.ts`

### Detection and incidents

- [SIEM rule engine](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/rules/rule-engine.service.ts): `apps/api/src/rules/rule-engine.service.ts`
- [Incident management](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/incidents/incidents.service.ts): `apps/api/src/incidents/incidents.service.ts`
- [Anomaly coordination](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/anomaly/anomaly.service.ts): `apps/api/src/anomaly/anomaly.service.ts`

### AI services

- [Metric training data](https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/data_pipeline.py): `apps/ai-service/data_pipeline.py`
- [Metric preprocessing](https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/preprocess.py): `apps/ai-service/preprocess.py`
- [Model training](https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/train.py): `apps/ai-service/train.py`
- [Anomaly inference](https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/inference.py): `apps/ai-service/inference.py`
- [RAG API proxy](https://github.com/saadahmed17/infrasentinel/blob/main/apps/api/src/rag/rag.service.ts): `apps/api/src/rag/rag.service.ts`
- [Incident retrieval assistant](https://github.com/saadahmed17/infrasentinel/blob/main/apps/ai-service/rag.py): `apps/ai-service/rag.py`

### Operator console

- [Monitoring dashboard](https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/dashboard/page.tsx): `apps/web/src/app/dashboard/page.tsx`
- [Server console](https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/servers/page.tsx): `apps/web/src/app/servers/page.tsx`
- [Rules console](https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/rules/page.tsx): `apps/web/src/app/rules/page.tsx`
- [Incident console](https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/incidents/page.tsx): `apps/web/src/app/incidents/page.tsx`
- [Assistant chat](https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/app/assistant/page.tsx): `apps/web/src/app/assistant/page.tsx`
- [Web API client](https://github.com/saadahmed17/infrasentinel/blob/main/apps/web/src/lib/api-client.ts): `apps/web/src/lib/api-client.ts`

### Other components

- **Operator**
- **Groq LLM**

## Connections

- Monitoring agent → Agent ingestion: pushes metrics
- SSH event agent → Agent ingestion: pushes events
- Agent ingestion → Server management: dispatches ingestion (evidence: `apps/api/src/servers/metrics-ingestion.controller.ts`)
- Server management → Postgres and pgvector: persists telemetry (evidence: `apps/api/src/servers/servers.service.ts`)
- Server management → Event tracking: records events (evidence: `apps/api/src/servers/servers.service.ts`)
- Authentication and RBAC → Postgres and pgvector: reads and writes (evidence: `apps/api/src/auth/auth.service.ts`)
- Organizations → Postgres and pgvector: manages tenant data (evidence: `apps/api/src/organizations/organizations.service.ts`)
- Server management → SIEM rule engine: feeds SIEM events
- SIEM rule engine → Incident management: creates alerts
- Metric training data → Postgres and pgvector: loads metrics (evidence: `apps/ai-service/data_pipeline.py`)
- Metric training data → Metric preprocessing: provides metrics (evidence: `apps/ai-service/preprocess.py`)
- Metric preprocessing → Model training: builds sequences
- Model training → Anomaly inference: supplies model
- Anomaly coordination → Anomaly inference: requests scores
- Anomaly coordination → Incident management: creates anomaly alerts
- Incident management → RAG API proxy: indexes incidents
- RAG API proxy → Incident retrieval assistant: forwards query (evidence: `apps/api/src/rag/rag.service.ts`)
- Incident retrieval assistant → Postgres and pgvector: retrieves incidents
- Incident retrieval assistant → Groq LLM: generates answer
- Operator → Monitoring dashboard: views status
- Operator → Server console: manages servers
- Operator → Rules console: configures rules
- Operator → Incident console: reviews incidents
- Operator → Assistant chat: asks questions
- Monitoring dashboard → Web API client: requests data
- Server console → Web API client: requests data
- Rules console → Web API client: requests data
- Incident console → Web API client: requests data
- Assistant chat → Web API client: sends queries
- Web API client → Authentication and RBAC: calls API
- Web API client → RAG API proxy: queries assistant
