How saaaarath/ai-incident-intelligence-platform works
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: StructuredLogger.java Structured logging · OrderService.java Order workflow · api.js Dashboard API client · OrderController.java Order API
Components 22
Business services
- Order API
services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java - Order workflow
services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java - Payment service
services/payment-service/src/main/java/com/aiincident/paymentservice/service/PaymentService.java - Inventory service
services/inventory-service/src/main/java/com/aiincident/inventoryservice/service/InventoryService.java
Operational signals
- Structured logging
common/operational-logging/src/main/java/com/aiincident/logging/StructuredLogger.java - Request tracing
common/operational-logging/src/main/java/com/aiincident/logging/trace/TraceFilter.java - Failure injection
common/operational-logging/src/main/java/com/aiincident/failure/FailureInjectionService.java - Kafka topics
Incident processing
- Log consumers
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/consumer/LogEventConsumer.java - Persisted events
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/entity/ProcessedLogEvent.java - Metrics aggregation
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/metrics/MetricsAggregationService.java - Anomaly detection
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/anomaly/AnomalyDetectionService.java - Incident correlation
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/incident/IncidentCorrelationService.java
Knowledge and analysis
- Knowledge APIs
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/controller/EmbeddingController.java - Embedding pipeline
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/EmbeddingPipelineService.java - Document embeddings
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/DocumentEmbedding.java - Semantic retrieval
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/SemanticRetrievalService.java - Incident context
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java - Root cause analysis
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/rca/LlmRcaEngine.java
Operator dashboard
- Operator interface
dashboard/src/App.jsx - Dashboard API client
dashboard/src/services/api.js
Other components
- API client
Connections 23
- API client → Order API: submits order
README.md - Order API → Order workflow: handles request
services/order-service/src/main/java/com/aiincident/orderservice/controller/OrderController.java - Order workflow → Payment service: creates payment
services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java - Order workflow → Inventory service: reserves stock
services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java - Order workflow → Structured logging: logs outcome
services/order-service/src/main/java/com/aiincident/orderservice/service/OrderService.java - Payment service → Structured logging: logs outcome
services/payment-service/src/main/java/com/aiincident/paymentservice/service/PaymentService.java - Inventory service → Structured logging: logs outcome
services/inventory-service/src/main/java/com/aiincident/inventoryservice/service/InventoryService.java - Structured logging → Kafka topics: publishes events
README.md - Request tracing → API client: returns trace ID
README.md - Failure injection → Structured logging: logs injected failures
common/operational-logging/src/main/java/com/aiincident/failure/FailureInjectionService.java - Kafka topics → Log consumers: delivers events
README.md - Log consumers → Persisted events: persists events
README.md - Persisted events → Metrics aggregation: aggregates events
README.md - Metrics aggregation → Anomaly detection: evaluates metrics
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
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/controller/EmbeddingController.java - Embedding pipeline → Document embeddings: saves vectors
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/EmbeddingPipelineService.java - Semantic retrieval → Document embeddings: reads vectors
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/SemanticRetrievalService.java - Incident context → Semantic retrieval: searches context
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java - Incident context → Incident correlation: loads incident evidence
incident-engine/log-processor/src/main/java/com/aiincident/logprocessor/historical/embedding/IncidentRetrievalService.java - Operator interface → Dashboard API client: uses API client
dashboard/src/App.jsx - Dashboard API client → Knowledge APIs: requests data
- Dashboard API client → Order API: requests service data