# kayaladurgaeswar/procurax architecture

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

- Interactive diagram: https://gitdiagram.com/kayaladurgaeswar/procurax
- Repository: https://github.com/kayaladurgaeswar/procurax

## Overview

ProcuraX turns an enterprise user's natural-language request into a Beckn-backed procurement: extract intent, discover and score offers, negotiate, obtain policy or human approval, and confirm and track an order. The Angular dashboard also exposes analytics, bulk import, templates, reports, history, and audit views. Edges reflect shown calls, indexed imports, or README-documented capabilities; unsampled details are represented by subsystem paths rather than inferred internal wiring.

Main entry points: [`backend/src/services/agent/procurementAgent.js`](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/agent/procurementAgent.js) (Procurement agent), [`frontend/src/app/app.component.ts`](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/app.component.ts) (Dashboard shell), [`backend/src/routes/procurementRoutes.js`](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/routes/procurementRoutes.js) (Procurement API), [`backend/src/db/database.js`](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/db/database.js) (Database access)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Procurement experience"]
  node_dashboard["Dashboard shell<br/>[app.component.ts]"]
  node_client["Procurement client"]
  node_models["Procurement models"]
  node_analytics["Analytics dashboard"]
  node_bulk["Bulk import"]
  node_approvalui["Approval interface"]
  node_auditui["Audit timeline"]
  node_offersui["Offer comparison"]
  node_workflowui["Workflow views"]
end

subgraph group_workflow["Agent workflow"]
  node_agent["Procurement agent"]
  node_intent["Intent extraction<br/>[llmProvider.js]"]
  node_comparison["Offer scoring"]
  node_negotiation["Negotiation engine"]
  node_memory["Vendor memory<br/>[memoryService.js]"]
end

subgraph group_commerce["Commerce and policy"]
  node_approval["Approval policy<br/>[approvalEngine.js]"]
  node_provider["Beckn provider<br/>[becknProvider.js]"]
  node_network["Network providers<br/>[commerceNetwork.js]"]
end

subgraph group_platform["API and persistence"]
  node_api["Procurement API"]
  node_becknapi["Beckn callbacks<br/>[becknRoutes.js]"]
  node_audit["Audit service<br/>[auditService.js]"]
  node_db["Database access<br/>[database.js]"]
  node_modelsdb["MongoDB models<br/>[mongoModels.js]"]
  node_mongo[("MongoDB")]
  node_config["Runtime policies<br/>[index.js]"]
end

node_lead(("Procurement lead"))
node_external{{"Beckn network"}}

node_lead -->|"uses"| node_dashboard
node_dashboard -->|"uses"| node_client
node_dashboard -->|"renders"| node_analytics
node_dashboard -->|"renders"| node_bulk
node_dashboard -->|"renders"| node_approvalui
node_dashboard -->|"renders"| node_auditui
node_dashboard -->|"renders"| node_offersui
node_dashboard -->|"renders"| node_workflowui
node_client -->|"calls REST"| node_api
node_client -->|"uses types"| node_models
node_api -->|"starts workflow"| node_agent
node_api -->|"reads records"| node_db
node_api -->|"tracks orders"| node_provider
node_api -->|"reads patterns"| node_memory
node_becknapi -->|"handles callbacks"| node_external
node_agent -->|"persists workflow"| node_db
node_agent -->|"extracts intent"| node_intent
node_agent -->|"searches and orders"| node_provider
node_agent -->|"scores offers"| node_comparison
node_agent -->|"negotiates"| node_negotiation
node_agent -->|"evaluates approval"| node_approval
node_agent -->|"logs events"| node_audit
node_agent -->|"uses insights"| node_memory
node_provider -->|"selects provider"| node_network
node_network -.->|"discovers sellers"| node_external
node_memory -->|"reads and updates"| node_db
node_audit -->|"stores events"| node_db
node_db -->|"maps collections"| node_modelsdb
node_modelsdb -.->|"stores documents"| node_mongo
node_comparison -->|"loads weights"| node_config
node_approval -->|"loads thresholds"| node_config

click node_dashboard "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/app.component.ts"
click node_client "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/services/procurement.service.ts"
click node_models "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/models/procurement.model.ts"
click node_analytics "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/analytics-dashboard/analytics-dashboard.component.ts"
click node_bulk "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/bulk-import/bulk-import.component.ts"
click node_approvalui "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/approval-card/approval-card.component.ts"
click node_auditui "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/audit-timeline/audit-timeline.component.ts"
click node_offersui "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/offers-matrix/offers-matrix.component.ts"
click node_workflowui "https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/stepper/stepper.component.ts"
click node_api "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/routes/procurementRoutes.js"
click node_becknapi "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/routes/becknRoutes.js"
click node_agent "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/agent/procurementAgent.js"
click node_intent "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/ai/llmProvider.js"
click node_comparison "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/comparison/comparisonEngine.js"
click node_negotiation "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/negotiation/negotiationEngine.js"
click node_approval "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/approval/approvalEngine.js"
click node_provider "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/beckn/becknProvider.js"
click node_network "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/beckn/commerceNetwork.js"
click node_memory "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/memory/memoryService.js"
click node_audit "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/audit/auditService.js"
click node_db "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/db/database.js"
click node_modelsdb "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/models/mongoModels.js"
click node_config "https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/config/index.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_dashboard,node_client,node_models,node_analytics,node_bulk,node_approvalui,node_auditui,node_offersui,node_workflowui toneBlue
class node_agent,node_intent,node_comparison,node_negotiation,node_memory toneAmber
class node_approval,node_provider,node_network toneMint
class node_api,node_becknapi,node_audit,node_db,node_modelsdb,node_mongo,node_config toneRose
class node_lead,node_external toneIndigo
```

## Components

### Procurement experience

- [Dashboard shell](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/app.component.ts): `frontend/src/app/app.component.ts`
- [Procurement client](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/services/procurement.service.ts): `frontend/src/app/services/procurement.service.ts`
- [Procurement models](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/models/procurement.model.ts): `frontend/src/app/models/procurement.model.ts`
- [Analytics dashboard](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/analytics-dashboard/analytics-dashboard.component.ts): `frontend/src/app/components/analytics-dashboard/analytics-dashboard.component.ts`
- [Bulk import](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/bulk-import/bulk-import.component.ts): `frontend/src/app/components/bulk-import/bulk-import.component.ts`
- [Approval interface](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/approval-card/approval-card.component.ts): `frontend/src/app/components/approval-card/approval-card.component.ts`
- [Audit timeline](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/audit-timeline/audit-timeline.component.ts): `frontend/src/app/components/audit-timeline/audit-timeline.component.ts`
- [Offer comparison](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/offers-matrix/offers-matrix.component.ts): `frontend/src/app/components/offers-matrix/offers-matrix.component.ts`
- [Workflow views](https://github.com/kayaladurgaeswar/procurax/blob/main/frontend/src/app/components/stepper/stepper.component.ts): `frontend/src/app/components/stepper/stepper.component.ts`

### Agent workflow

- [Procurement agent](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/agent/procurementAgent.js): `backend/src/services/agent/procurementAgent.js`
- [Intent extraction](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/ai/llmProvider.js): `backend/src/services/ai/llmProvider.js`
- [Offer scoring](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/comparison/comparisonEngine.js): `backend/src/services/comparison/comparisonEngine.js`
- [Negotiation engine](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/negotiation/negotiationEngine.js): `backend/src/services/negotiation/negotiationEngine.js`
- [Vendor memory](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/memory/memoryService.js): `backend/src/services/memory/memoryService.js`

### Commerce and policy

- [Approval policy](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/approval/approvalEngine.js): `backend/src/services/approval/approvalEngine.js`
- [Beckn provider](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/beckn/becknProvider.js): `backend/src/services/beckn/becknProvider.js`
- [Network providers](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/beckn/commerceNetwork.js): `backend/src/services/beckn/commerceNetwork.js`

### API and persistence

- [Procurement API](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/routes/procurementRoutes.js): `backend/src/routes/procurementRoutes.js`
- [Beckn callbacks](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/routes/becknRoutes.js): `backend/src/routes/becknRoutes.js`
- [Audit service](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/services/audit/auditService.js): `backend/src/services/audit/auditService.js`
- [Database access](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/db/database.js): `backend/src/db/database.js`
- [MongoDB models](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/models/mongoModels.js): `backend/src/models/mongoModels.js`
- **MongoDB**
- [Runtime policies](https://github.com/kayaladurgaeswar/procurax/blob/main/backend/src/config/index.js): `backend/src/config/index.js`

### Other components

- **Procurement lead**
- **Beckn network**

## Connections

- Procurement lead → Dashboard shell: uses (evidence: `README.md`)
- Dashboard shell → Procurement client: uses (evidence: `frontend/src/app/app.component.ts`)
- Dashboard shell → Analytics dashboard: renders (evidence: `frontend/src/app/app.component.ts`)
- Dashboard shell → Bulk import: renders (evidence: `frontend/src/app/app.component.ts`)
- Dashboard shell → Approval interface: renders (evidence: `frontend/src/app/app.component.ts`)
- Dashboard shell → Audit timeline: renders (evidence: `frontend/src/app/app.component.ts`)
- Dashboard shell → Offer comparison: renders (evidence: `frontend/src/app/app.component.ts`)
- Dashboard shell → Workflow views: renders (evidence: `frontend/src/app/app.component.ts`)
- Procurement client → Procurement API: calls REST (evidence: `README.md`)
- Procurement client → Procurement models: uses types (evidence: `frontend/src/app/services/procurement.service.ts`)
- Procurement API → Procurement agent: starts workflow (evidence: `backend/src/routes/procurementRoutes.js`)
- Procurement API → Database access: reads records (evidence: `backend/src/routes/procurementRoutes.js`)
- Procurement API → Beckn provider: tracks orders (evidence: `backend/src/routes/procurementRoutes.js`)
- Procurement API → Vendor memory: reads patterns (evidence: `backend/src/routes/procurementRoutes.js`)
- Beckn callbacks → Beckn network: handles callbacks (evidence: `backend/src/routes/becknRoutes.js`)
- Procurement agent → Database access: persists workflow (evidence: `backend/src/services/agent/procurementAgent.js`)
- Procurement agent → Intent extraction: extracts intent (evidence: `backend/src/services/agent/procurementAgent.js`)
- Procurement agent → Beckn provider: searches and orders (evidence: `backend/src/services/agent/procurementAgent.js`)
- Procurement agent → Offer scoring: scores offers (evidence: `backend/src/services/agent/procurementAgent.js`)
- Procurement agent → Negotiation engine: negotiates (evidence: `backend/src/services/agent/procurementAgent.js`)
- Procurement agent → Approval policy: evaluates approval (evidence: `backend/src/services/agent/procurementAgent.js`)
- Procurement agent → Audit service: logs events (evidence: `backend/src/services/agent/procurementAgent.js`)
- Procurement agent → Vendor memory: uses insights (evidence: `backend/src/services/agent/procurementAgent.js`)
- Beckn provider → Network providers: selects provider (evidence: `backend/src/services/beckn/becknProvider.js`)
- Network providers → Beckn network: discovers sellers (evidence: `README.md`)
- Vendor memory → Database access: reads and updates (evidence: `backend/src/services/memory/memoryService.js`)
- Audit service → Database access: stores events (evidence: `backend/src/services/audit/auditService.js`)
- Database access → MongoDB models: maps collections (evidence: `backend/src/db/database.js`)
- MongoDB models → MongoDB: stores documents
- Offer scoring → Runtime policies: loads weights (evidence: `backend/src/services/comparison/comparisonEngine.js`)
- Approval policy → Runtime policies: loads thresholds (evidence: `backend/src/services/approval/approvalEngine.js`)
