How srmk-2005/agentic-commerce-platform works
This platform combines merchant-facing commerce operations and growth recommendations with machine-readable commerce APIs for external buyers. A typical buyer flow discovers a merchant and catalog, searches and verifies stock, creates an order, then proposes payment; merchant payment approval and Razorpay verification gate execution. Merchant growth actions also pass through safety and human approval governance. The README documents these capabilities; arrows below are limited to relationships visible in excerpts, the SOURCE INDEX references, or README statements, so several unsampled routes and agent stages are shown without speculative call chains.
Main entry points: payment_service.py Payment orchestration · App.tsx React application · service.py Agent commerce orchestration · agent.py AI buyer pipeline
Components 26
Merchant and Buyer UI
- React application
frontend/src/App.tsx - Buyer sandbox
frontend/src/pages/AiBuyerPage.tsx - Payment approval
frontend/src/pages/PaymentApprovalPage.tsx - Commerce demo
frontend/src/pages/JudgeDemoPage.tsx - Growth workspace
frontend/src/pages/AiAssistantPage.tsx - Frontend API client
frontend/src/services/api.ts - Buyer API service
frontend/src/services/buyerService.ts - Payment API service
frontend/src/services/paymentService.ts
AI Commerce
- AI buyer pipeline
backend/app/ai_buyer/agent.py - Agent commerce protocol
backend/app/agent_commerce/protocol.py - Agent commerce orchestration
backend/app/agent_commerce/service.py - Merchant discovery
backend/app/agent_commerce/discovery.py
Commerce Operations
- AI catalog and orders
backend/app/commerce/service.py - Catalog search
backend/app/commerce/catalog.py - Order creation
backend/app/commerce/order_service.py - Payment orchestration
backend/app/payments/payment_service.py - Razorpay adapter
backend/app/payments/razorpay_service.py
Growth and Governance
- Growth analysis agent
backend/app/agent/nodes.py - Growth actions
backend/app/services/growth_service.py - Safety policies
backend/app/services/safety_service.py - Audit ledger
backend/app/services/audit_service.py
Backend and Persistence
- FastAPI application
backend/app/main.py - Relational database
backend/app/db/models.py
Other components
- Merchant operator
- External AI buyer
- Razorpay test service
Connections 34
- Merchant operator → React application: uses
- External AI buyer → AI catalog and orders: discovers and orders
- React application → Buyer sandbox: routes to
frontend/src/App.tsx - React application → Payment approval: routes to
frontend/src/App.tsx - React application → Commerce demo: routes to
frontend/src/App.tsx - React application → Growth workspace: routes to
frontend/src/App.tsx - Buyer sandbox → Buyer API service: calls
frontend/src/pages/AiBuyerPage.tsx - Commerce demo → Payment API service: calls
frontend/src/pages/JudgeDemoPage.tsx - Payment approval → Payment API service: calls
frontend/src/pages/PaymentApprovalPage.tsx - Buyer API service → Frontend API client: requests through
- Payment API service → Frontend API client: requests through
frontend/src/services/paymentService.ts - Frontend API client → FastAPI application: HTTP requests
frontend/src/services/api.ts - FastAPI application → AI catalog and orders: registers routes
backend/app/main.py - FastAPI application → Agent commerce orchestration: registers routes
backend/app/main.py - FastAPI application → Payment orchestration: registers routes
backend/app/main.py - AI buyer pipeline → Merchant discovery: discovers capabilities
- AI buyer pipeline → Catalog search: queries catalog
- AI buyer pipeline → Order creation: creates order
- AI buyer pipeline → Payment orchestration: proposes payment
- Agent commerce orchestration → Merchant discovery: loads contract
backend/app/agent_commerce/service.py - Agent commerce orchestration → Catalog search: searches products
backend/app/agent_commerce/service.py - Agent commerce orchestration → Order creation: creates orders
backend/app/agent_commerce/service.py - Agent commerce orchestration → Payment orchestration: proposes payment
backend/app/agent_commerce/service.py - AI catalog and orders → Catalog search: uses catalog
backend/app/commerce/service.py - AI catalog and orders → Relational database: reads commerce data
backend/app/commerce/service.py - Order creation → Relational database: writes orders and stock
backend/app/commerce/order_service.py - Growth analysis agent → Growth actions: proposes actions
- Growth actions → Safety policies: checks actions
backend/app/services/growth_service.py - Growth actions → Audit ledger: records events
backend/app/services/growth_service.py - Payment orchestration → Razorpay adapter: creates and verifies orders
backend/app/payments/payment_service.py - Razorpay adapter → Razorpay test service: test-mode requests
- Payment orchestration → Audit ledger: records decisions
backend/app/payments/payment_service.py - Payment orchestration → Relational database: reads and updates payments
backend/app/payments/payment_service.py - Audit ledger → Relational database: persists events
backend/app/services/audit_service.py