# codie-ds/razorpay-recoverai architecture

> Architecture diagram of the GitHub repository codie-ds/razorpay-recoverai, 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/codie-ds/razorpay-recoverai
- Repository: https://github.com/codie-ds/razorpay-recoverai

## Overview

RecoverAI diagnoses failed payments, ranks recovery options, applies deterministic policy, executes approved actions, and measures outcomes. Its React dashboard exposes transaction, incident, command-center, and human-review views. The README describes the end-to-end product flow; sampled backend routes and service excerpts support selected links, while the source index identifies additional substantial modules. In particular, the webhook excerpt shows payment-link outcome updates; the README’s broader event-processing flow is documented but not fully verifiable from sampled source.

Main entry points: [`backend/src/services/recoveryDecisionEngine.js`](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/recoveryDecisionEngine.js) (Recovery Ranking), [`backend/src/server.js`](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/server.js) (Express API), [`frontend/src/services/api.js`](https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/services/api.js) (API Client), [`backend/src/db/models`](https://github.com/codie-ds/razorpay-recoverai/tree/main/backend/src/db/models) (MongoDB Models)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ingest["Payment Intake"]
  node_webhook["Payment Webhook<br/>[webhooks.js]"]
  node_incident["Incident Detection"]
end

subgraph group_decision["Recovery Decisions"]
  node_rootcause["Root-Cause Inference<br/>[mlInference.js]"]
  node_pythonml["ML Models<br/>[inference.py]"]
  node_recoverybrain["Recovery Ranking"]
end

subgraph group_governance["Execution &amp; Outcomes"]
  node_policy["Policy Engine<br/>[policyEngine.js]"]
  node_approval["Human Approval<br/>[approvals.js]"]
  node_executor["Payment Execution"]
  node_outcome["Outcome Measurement<br/>[webhooks.js]"]
  node_explain["Decision Explanation"]
  node_simulator["Recovery Simulation<br/>[simulator.js]"]
end

subgraph group_data["Persistence &amp; API"]
  node_audit["Audit Records<br/>[auditLogs.js]"]
  node_models[("MongoDB Models")]
  node_api["Express API<br/>[server.js]"]
  node_transactions["Transaction API<br/>[transactions.js]"]
  node_incidents["Incident API<br/>[incidents.js]"]
  node_metrics["Recovery Metrics<br/>[metrics.js]"]
end

subgraph group_ui["Operations Dashboard"]
  node_frontend["React Dashboard<br/>[App.jsx]"]
  node_client["API Client<br/>[api.js]"]
  node_command["Command Center<br/>[CommandCenter.jsx]"]
  node_stories["Transaction Stories"]
  node_incidentview["Incident View<br/>[Incidents.jsx]"]
  node_review["Human Review View<br/>[HumanReview.jsx]"]
end

node_razorpay(("Razorpay"))

node_razorpay -->|"sends events"| node_webhook
node_webhook -->|"updates outcome"| node_models
node_razorpay -->|"executes payment"| node_executor
node_incident -->|"provides context"| node_recoverybrain
node_recoverybrain -->|"requests inference"| node_rootcause
node_rootcause -->|"invokes model"| node_pythonml
node_recoverybrain -->|"scores candidates"| node_pythonml
node_recoverybrain -->|"recommends action"| node_policy
node_policy -->|"routes review"| node_approval
node_policy -->|"approves action"| node_executor
node_approval -.->|"authorizes execution"| node_executor
node_executor -->|"calls payment API"| node_razorpay
node_webhook -->|"reports payment"| node_outcome
node_outcome -->|"persists results"| node_models
node_recoverybrain -.->|"supplies decision evidence"| node_explain
node_api -->|"mounts route"| node_transactions
node_api -->|"mounts route"| node_incidents
node_api -->|"mounts route"| node_approval
node_api -->|"mounts route"| node_webhook
node_incidents -->|"runs detection"| node_incident
node_transactions -->|"reads transactions"| node_models
node_incidents -->|"reads incidents"| node_models
node_metrics -->|"reads metrics"| node_models
node_frontend -->|"routes to"| node_command
node_frontend -->|"routes to"| node_stories
node_frontend -->|"routes to"| node_incidentview
node_frontend -->|"routes to"| node_review
node_command -->|"requests dashboard data"| node_client
node_stories -->|"requests transactions"| node_client
node_incidentview -->|"requests incidents"| node_client
node_review -->|"requests approvals"| node_client
node_client -->|"calls REST routes"| node_api
node_simulator -.->|"evaluates scenarios"| node_recoverybrain

click node_webhook "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/webhooks.js"
click node_incident "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/incidentDetector.js"
click node_rootcause "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/mlInference.js"
click node_pythonml "https://github.com/codie-ds/razorpay-recoverai/blob/main/ml/inference.py"
click node_recoverybrain "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/recoveryDecisionEngine.js"
click node_policy "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/policyEngine.js"
click node_approval "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/approvals.js"
click node_executor "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/razorpayExecutor.js"
click node_outcome "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/webhooks.js"
click node_explain "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/llmExplainability.js"
click node_audit "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/auditLogs.js"
click node_models "https://github.com/codie-ds/razorpay-recoverai/tree/main/backend/src/db/models"
click node_api "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/server.js"
click node_transactions "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/transactions.js"
click node_incidents "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/incidents.js"
click node_metrics "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/metrics.js"
click node_simulator "https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/simulator.js"
click node_frontend "https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/App.jsx"
click node_client "https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/services/api.js"
click node_command "https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/CommandCenter.jsx"
click node_stories "https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/TransactionStories.jsx"
click node_incidentview "https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/Incidents.jsx"
click node_review "https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/HumanReview.jsx"

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_webhook,node_incident toneBlue
class node_rootcause,node_pythonml,node_recoverybrain toneAmber
class node_policy,node_approval,node_executor,node_outcome,node_explain,node_simulator toneMint
class node_audit,node_models,node_api,node_transactions,node_incidents,node_metrics toneRose
class node_frontend,node_client,node_command,node_stories,node_incidentview,node_review,node_razorpay toneIndigo
```

## Components

### Payment Intake

- [Payment Webhook](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/webhooks.js): `backend/src/api/webhooks.js`
- [Incident Detection](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/incidentDetector.js): `backend/src/services/incidentDetector.js`

### Recovery Decisions

- [Root-Cause Inference](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/mlInference.js): `backend/src/services/mlInference.js`
- [ML Models](https://github.com/codie-ds/razorpay-recoverai/blob/main/ml/inference.py): `ml/inference.py`
- [Recovery Ranking](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/recoveryDecisionEngine.js): `backend/src/services/recoveryDecisionEngine.js`

### Execution & Outcomes

- [Policy Engine](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/policyEngine.js): `backend/src/services/policyEngine.js`
- [Human Approval](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/approvals.js): `backend/src/api/approvals.js`
- [Payment Execution](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/razorpayExecutor.js): `backend/src/services/razorpayExecutor.js`
- [Outcome Measurement](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/webhooks.js): `backend/src/api/webhooks.js`
- [Decision Explanation](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/llmExplainability.js): `backend/src/services/llmExplainability.js`
- [Recovery Simulation](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/services/simulator.js): `backend/src/services/simulator.js`

### Persistence & API

- [Audit Records](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/auditLogs.js): `backend/src/api/auditLogs.js`
- [MongoDB Models](https://github.com/codie-ds/razorpay-recoverai/tree/main/backend/src/db/models): `backend/src/db/models`
- [Express API](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/server.js): `backend/src/server.js`
- [Transaction API](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/transactions.js): `backend/src/api/transactions.js`
- [Incident API](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/incidents.js): `backend/src/api/incidents.js`
- [Recovery Metrics](https://github.com/codie-ds/razorpay-recoverai/blob/main/backend/src/api/metrics.js): `backend/src/api/metrics.js`

### Operations Dashboard

- [React Dashboard](https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API Client](https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/services/api.js): `frontend/src/services/api.js`
- [Command Center](https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/CommandCenter.jsx): `frontend/src/pages/CommandCenter.jsx`
- [Transaction Stories](https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/TransactionStories.jsx): `frontend/src/pages/TransactionStories.jsx`
- [Incident View](https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/Incidents.jsx): `frontend/src/pages/Incidents.jsx`
- [Human Review View](https://github.com/codie-ds/razorpay-recoverai/blob/main/frontend/src/pages/HumanReview.jsx): `frontend/src/pages/HumanReview.jsx`

### Other components

- **Razorpay**

## Connections

- Razorpay → Payment Webhook: sends events
- Payment Webhook → MongoDB Models: updates outcome (evidence: `backend/src/api/webhooks.js`)
- Razorpay → Payment Execution: executes payment
- Incident Detection → Recovery Ranking: provides context
- Recovery Ranking → Root-Cause Inference: requests inference (evidence: `backend/src/services/recoveryDecisionEngine.js`)
- Root-Cause Inference → ML Models: invokes model (evidence: `backend/src/services/mlInference.js`)
- Recovery Ranking → ML Models: scores candidates (evidence: `backend/src/services/recoveryDecisionEngine.js`)
- Recovery Ranking → Policy Engine: recommends action
- Policy Engine → Human Approval: routes review
- Policy Engine → Payment Execution: approves action
- Human Approval → Payment Execution: authorizes execution
- Payment Execution → Razorpay: calls payment API
- Payment Webhook → Outcome Measurement: reports payment (evidence: `backend/src/api/webhooks.js`)
- Outcome Measurement → MongoDB Models: persists results (evidence: `backend/src/api/webhooks.js`)
- Recovery Ranking → Decision Explanation: supplies decision evidence
- Express API → Transaction API: mounts route (evidence: `backend/src/server.js`)
- Express API → Incident API: mounts route (evidence: `backend/src/server.js`)
- Express API → Human Approval: mounts route (evidence: `backend/src/server.js`)
- Express API → Payment Webhook: mounts route (evidence: `backend/src/server.js`)
- Incident API → Incident Detection: runs detection (evidence: `backend/src/api/incidents.js`)
- Transaction API → MongoDB Models: reads transactions (evidence: `backend/src/api/transactions.js`)
- Incident API → MongoDB Models: reads incidents (evidence: `backend/src/api/incidents.js`)
- Recovery Metrics → MongoDB Models: reads metrics (evidence: `backend/src/api/metrics.js`)
- React Dashboard → Command Center: routes to (evidence: `frontend/src/App.jsx`)
- React Dashboard → Transaction Stories: routes to (evidence: `frontend/src/App.jsx`)
- React Dashboard → Incident View: routes to (evidence: `frontend/src/App.jsx`)
- React Dashboard → Human Review View: routes to (evidence: `frontend/src/App.jsx`)
- Command Center → API Client: requests dashboard data (evidence: `frontend/src/pages/CommandCenter.jsx`)
- Transaction Stories → API Client: requests transactions (evidence: `frontend/src/pages/TransactionStories.jsx`)
- Incident View → API Client: requests incidents (evidence: `frontend/src/pages/Incidents.jsx`)
- Human Review View → API Client: requests approvals (evidence: `frontend/src/pages/HumanReview.jsx`)
- API Client → Express API: calls REST routes (evidence: `frontend/src/services/api.js`)
- Recovery Simulation → Recovery Ranking: evaluates scenarios
