How runbookagent-incidentmanagement/runbook_mcp works
AuraCommerce combines a storefront and commerce APIs with an event-oriented business layer, plus a separate AI incident-response platform. The customer workflow spans catalog discovery, cart and order management, payment, and notifications; the incident workflow accepts an event, runs analysis and remediation, and can invoke Kubernetes or Jira tools. Service code and selected AI modules were sampled; some commerce and incident relationships are documented in the README rather than verified from implementation excerpts.
Main entry points: App.jsx Storefront UI · database.py Commerce Database · runbook_agent.py Runbook Agent · main.py Notification Service
Components 21
Storefront
- Storefront UI
frontend/src/App.jsx - Authentication UI
frontend/src/auth/AuthContext.jsx - API Client
frontend/src/services/api.js
Commerce Services
- Auth Service
backend/auth_service/app/main.py - Product Catalog
backend/product_service/app/main.py - Product Model
backend/product_service/app/models.py - Cart Service
backend/cart_service/app/main.py - Order Service
backend/order_service/app/main.py - Payment Service
backend/payment_service/app/main.py - Notification Service
backend/notification_service/app/main.py
Shared Runtime
- Commerce Database
backend/shared/database.py - Event Schema
backend/shared/events.py - Event Consumer
backend/shared/events/consumers/event_consumer.py
Incident Management
- Runbook Runner
services/runbook-runner/app/main.py - Runbook Agent
ai-agents/langgraph/runbook_agent.py - LLM Classifier
ai-agents/llm_classifier.py - Runbook Catalog
ai-agents/catalog_parser.py - MCP Tool Client
ai-agents/mcp_client.py - Kubernetes Tools
mcp-servers/kubernetes_mcp_server.py - Jira Tools
mcp-servers/jira_mcp_server.py
Other components
- Customer
Connections 23
- Customer → Storefront UI: uses
README.md - Storefront UI → Authentication UI: renders
frontend/src/App.jsx - Storefront UI → API Client: uses
frontend/src/App.jsx - Authentication UI → Auth Service: requests auth
frontend/src/auth/AuthContext.jsx - Storefront UI → Product Catalog: browses catalog
README.md - Storefront UI → Cart Service: manages cart
README.md - Storefront UI → Order Service: views orders
README.md - Product Catalog → Product Model: queries
backend/product_service/app/main.py - Product Catalog → Commerce Database: reads/writes
backend/product_service/app/main.py - Cart Service → Commerce Database: reads/writes
backend/cart_service/app/main.py - Order Service → Commerce Database: reads/writes
backend/order_service/app/main.py - Payment Service → Commerce Database: reads/writes
README.md - Notification Service → Commerce Database: reads/writes
backend/notification_service/app/main.py - Order Service → Event Schema: publishes event
backend/order_service/app/main.py - Payment Service → Event Schema: publishes events
README.md - Notification Service → Event Consumer: receives events
README.md - Notification Service → Runbook Runner: routes incidents
backend/notification_service/app/main.py - Runbook Runner → Runbook Agent: orchestrates
services/runbook-runner/app/main.py - Runbook Agent → Runbook Catalog: loads catalog
ai-agents/langgraph/runbook_agent.py - Runbook Agent → LLM Classifier: classifies
ai-agents/langgraph/runbook_agent.py - Runbook Agent → MCP Tool Client: executes tools
ai-agents/langgraph/runbook_agent.py - MCP Tool Client → Kubernetes Tools: calls tools
ai-agents/mcp_client.py - MCP Tool Client → Jira Tools: calls tools
ai-agents/mcp_client.py