# saaaarath/ai-incident-intelligence-platform architecture

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

- Interactive diagram: https://gitdiagram.com/saaaarath/ai-incident-intelligence-platform
- Repository: https://github.com/saaaarath/ai-incident-intelligence-platform

## Overview

This monorepo combines order, payment, and inventory services with shared operational logging and a log-processing service; it also contains incident-analysis, knowledge-retrieval, and operator-dashboard modules. The primary documented business flow is an order request that synchronously creates a payment and reserves inventory, while service events are logged to Kafka and persisted by the processor. The tree and sampled files show broader analysis and dashboard subsystems, though the README’s stated current-status section says those capabilities are not yet functional; their internal wiring is therefore shown only where supported.

Main entry points: [`common/operational-logging/src/main/java/com/aiincident/logging/StructuredLogger.java`](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/common/operational-logging/src/main/java/com/aiincident/logging/StructuredLogger.java) (Structured logging), [`services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java`](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java) (Order workflow), [`dashboard/src/services/api.js`](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/dashboard/src/services/api.js) (Dashboard API client), [`services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java`](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java) (Order API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_business["Business services"]
  node_order_api["Order API"]
  node_order_service["Order workflow<br/>[OrderService.java]"]
  node_payment["Payment service"]
  node_inventory["Inventory service"]
end

subgraph group_telemetry["Operational signals"]
  node_structured["Structured logging"]
  node_trace["Request tracing<br/>[TraceFilter.java]"]
  node_failure["Failure injection"]
  node_kafka["Kafka topics"]
end

subgraph group_processing["Incident processing"]
  node_log_consumer["Log consumers"]
  node_log_store[("Persisted events")]
  node_metrics["Metrics aggregation"]
  node_anomaly["Anomaly detection"]
  node_incident["Incident correlation"]
end

subgraph group_knowledge["Knowledge and analysis"]
  node_knowledge_api["Knowledge APIs"]
  node_embedding_pipeline["Embedding pipeline"]
  node_embedding_store[("Document embeddings")]
  node_semantic_search["Semantic retrieval"]
  node_incident_retrieval["Incident context"]
  node_rca["Root cause analysis<br/>[LlmRcaEngine.java]"]
end

subgraph group_operator["Operator dashboard"]
  node_dashboard["Operator interface<br/>[App.jsx]"]
  node_dashboard_api["Dashboard API client<br/>[api.js]"]
end

node_client(("API client"))

node_client -->|"submits order"| node_order_api
node_order_api -.->|"handles request"| node_order_service
node_order_service -->|"creates payment"| node_payment
node_order_service -->|"reserves stock"| node_inventory
node_order_service -->|"logs outcome"| node_structured
node_payment -->|"logs outcome"| node_structured
node_inventory -->|"logs outcome"| node_structured
node_structured -->|"publishes events"| node_kafka
node_trace -->|"returns trace ID"| node_client
node_failure -->|"logs injected failures"| node_structured
node_kafka -->|"delivers events"| node_log_consumer
node_log_consumer -->|"persists events"| node_log_store
node_log_store -->|"aggregates events"| node_metrics
node_metrics -.->|"evaluates metrics"| node_anomaly
node_anomaly -.->|"creates incidents"| node_incident
node_knowledge_api -->|"starts indexing"| node_embedding_pipeline
node_embedding_pipeline -->|"saves vectors"| node_embedding_store
node_semantic_search -.->|"reads vectors"| node_embedding_store
node_incident_retrieval -->|"searches context"| node_semantic_search
node_incident_retrieval -->|"loads incident evidence"| node_incident
node_dashboard -->|"uses API client"| node_dashboard_api
node_dashboard_api -.->|"requests data"| node_knowledge_api
node_dashboard_api -.->|"requests service data"| node_order_api

click node_order_api "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java"
click node_order_service "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java"
click node_payment "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/payment-service/src/main/java/com/aiincident/paymentservice/service/PaymentService.java"
click node_inventory "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/inventory-service/src/main/java/com/aiincident/inventoryservice/service/InventoryService.java"
click node_structured "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/common/operational-logging/src/main/java/com/aiincident/logging/StructuredLogger.java"
click node_trace "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/common/operational-logging/src/main/java/com/aiincident/logging/trace/TraceFilter.java"
click node_failure "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/common/operational-logging/src/main/java/com/aiincident/failure/FailureInjectionService.java"
click node_log_consumer "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/consumer/LogEventConsumer.java"
click node_log_store "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/entity/ProcessedLogEvent.java"
click node_metrics "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/metrics/MetricsAggregationService.java"
click node_anomaly "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/anomaly/AnomalyDetectionService.java"
click node_incident "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/incident/IncidentCorrelationService.java"
click node_knowledge_api "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/controller/EmbeddingController.java"
click node_embedding_pipeline "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/EmbeddingPipelineService.java"
click node_embedding_store "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/DocumentEmbedding.java"
click node_semantic_search "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/SemanticRetrievalService.java"
click node_incident_retrieval "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java"
click node_rca "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/rca/LlmRcaEngine.java"
click node_dashboard "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/dashboard/src/App.jsx"
click node_dashboard_api "https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/dashboard/src/services/api.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_order_api,node_order_service,node_payment,node_inventory,node_client toneBlue
class node_structured,node_trace,node_failure,node_kafka toneAmber
class node_log_consumer,node_log_store,node_metrics,node_anomaly,node_incident toneMint
class node_knowledge_api,node_embedding_pipeline,node_embedding_store,node_semantic_search,node_incident_retrieval,node_rca toneRose
class node_dashboard,node_dashboard_api toneIndigo
```

## Components

### Business services

- [Order API](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java): `services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java`
- [Order workflow](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java): `services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java`
- [Payment service](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/payment-service/src/main/java/com/aiincident/paymentservice/service/PaymentService.java): `services/payment-service/src/main/java/com/aiincident/paymentservice/service/PaymentService.java`
- [Inventory service](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/services/inventory-service/src/main/java/com/aiincident/inventoryservice/service/InventoryService.java): `services/inventory-service/src/main/java/com/aiincident/inventoryservice/service/InventoryService.java`

### Operational signals

- [Structured logging](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/common/operational-logging/src/main/java/com/aiincident/logging/StructuredLogger.java): `common/operational-logging/src/main/java/com/aiincident/logging/StructuredLogger.java`
- [Request tracing](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/common/operational-logging/src/main/java/com/aiincident/logging/trace/TraceFilter.java): `common/operational-logging/src/main/java/com/aiincident/logging/trace/TraceFilter.java`
- [Failure injection](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/common/operational-logging/src/main/java/com/aiincident/failure/FailureInjectionService.java): `common/operational-logging/src/main/java/com/aiincident/failure/FailureInjectionService.java`
- **Kafka topics**

### Incident processing

- [Log consumers](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/consumer/LogEventConsumer.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/consumer/LogEventConsumer.java`
- [Persisted events](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/entity/ProcessedLogEvent.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/entity/ProcessedLogEvent.java`
- [Metrics aggregation](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/metrics/MetricsAggregationService.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/metrics/MetricsAggregationService.java`
- [Anomaly detection](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/anomaly/AnomalyDetectionService.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/anomaly/AnomalyDetectionService.java`
- [Incident correlation](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/incident/IncidentCorrelationService.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/incident/IncidentCorrelationService.java`

### Knowledge and analysis

- [Knowledge APIs](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/controller/EmbeddingController.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/controller/EmbeddingController.java`
- [Embedding pipeline](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/EmbeddingPipelineService.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/EmbeddingPipelineService.java`
- [Document embeddings](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/DocumentEmbedding.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/DocumentEmbedding.java`
- [Semantic retrieval](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/SemanticRetrievalService.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/SemanticRetrievalService.java`
- [Incident context](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java`
- [Root cause analysis](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/rca/LlmRcaEngine.java): `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/rca/LlmRcaEngine.java`

### Operator dashboard

- [Operator interface](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/dashboard/src/App.jsx): `dashboard/src/App.jsx`
- [Dashboard API client](https://github.com/saaaarath/ai-incident-intelligence-platform/blob/main/dashboard/src/services/api.js): `dashboard/src/services/api.js`

### Other components

- **API client**

## Connections

- API client → Order API: submits order (evidence: `README.md`)
- Order API → Order workflow: handles request (evidence: `services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java`)
- Order workflow → Payment service: creates payment (evidence: `services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java`)
- Order workflow → Inventory service: reserves stock (evidence: `services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java`)
- Order workflow → Structured logging: logs outcome (evidence: `services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java`)
- Payment service → Structured logging: logs outcome (evidence: `services/payment-service/src/main/java/com/aiincident/paymentservice/service/PaymentService.java`)
- Inventory service → Structured logging: logs outcome (evidence: `services/inventory-service/src/main/java/com/aiincident/inventoryservice/service/InventoryService.java`)
- Structured logging → Kafka topics: publishes events (evidence: `README.md`)
- Request tracing → API client: returns trace ID (evidence: `README.md`)
- Failure injection → Structured logging: logs injected failures (evidence: `common/operational-logging/src/main/java/com/aiincident/failure/FailureInjectionService.java`)
- Kafka topics → Log consumers: delivers events (evidence: `README.md`)
- Log consumers → Persisted events: persists events (evidence: `README.md`)
- Persisted events → Metrics aggregation: aggregates events (evidence: `README.md`)
- Metrics aggregation → Anomaly detection: evaluates metrics (evidence: `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/anomaly/AnomalyDetectionService.java`)
- Anomaly detection → Incident correlation: creates incidents
- Knowledge APIs → Embedding pipeline: starts indexing (evidence: `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/controller/EmbeddingController.java`)
- Embedding pipeline → Document embeddings: saves vectors (evidence: `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/EmbeddingPipelineService.java`)
- Semantic retrieval → Document embeddings: reads vectors (evidence: `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/SemanticRetrievalService.java`)
- Incident context → Semantic retrieval: searches context (evidence: `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java`)
- Incident context → Incident correlation: loads incident evidence (evidence: `incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java`)
- Operator interface → Dashboard API client: uses API client (evidence: `dashboard/src/App.jsx`)
- Dashboard API client → Knowledge APIs: requests data
- Dashboard API client → Order API: requests service data
