How the-parvez-16/arx-01 works
ARX-01 is a recurring-payment recovery system with an operations dashboard. The operator reviews payment and recovery activity, simulates a failure, creates a recovery case, and can execute or cancel recovery. Recovery orchestration obtains payment context, requests an AI recommendation, applies deterministic policy limits, retries eligible payments, and records lifecycle events for audit review. The README documents PostgreSQL-backed services and Groq inference; the sampled sources confirm the recovery, payment, decision, and audit calls. Gateway routes and frontend API wiring are represented at the documented service boundary; their detailed routing was not sampled.
Main entry points: RecoveryApplicationService.java Recovery orchestration · ApiGatewayApplication.java API gateway · api.ts Frontend API client · PaymentController.java Payment API
Components 24
Operations console
- Operations dashboard
client/src/app/page.tsx - Recovery detail
client/src/app/recovery/[caseId]/page.tsx - Console views
client/src/components/RecoveryDetailView.tsx - Frontend API client
client/src/lib/api.ts
API entry
- API gateway
services/api-gateway/src/main/java/com/arx01/gateway/ApiGatewayApplication.java
Recovery workflow
- Recovery API
services/recovery-service/src/main/java/com/arx01/recovery/presentation/RecoveryController.java - Recovery orchestration
services/recovery-service/src/main/java/com/arx01/recovery/application/RecoveryApplicationService.java - Policy guardrails
services/recovery-service/src/main/java/com/arx01/recovery/policy/RecoveryPolicyEngine.java - Recovery repositories
services/recovery-service/src/main/java/com/arx01/recovery/domain/repository/RecoveryCaseRepository.java - Payment service client
services/recovery-service/src/main/java/com/arx01/recovery/infrastructure/client/PaymentServiceClient.java - Decision service client
services/recovery-service/src/main/java/com/arx01/recovery/infrastructure/client/DecisionServiceClient.java - Audit service client
services/recovery-service/src/main/java/com/arx01/recovery/infrastructure/client/AuditServiceClient.java
Payment service
- Payment API
services/payment-service/src/main/java/com/arx01/payment/presentation/PaymentController.java - Payment operations
services/payment-service/src/main/java/com/arx01/payment/application/PaymentApplicationService.java - Payment repositories
services/payment-service/src/main/java/com/arx01/payment/domain/repository/PaymentRepository.java
Decision and audit
- Decision API
services/decision-service/src/main/java/com/arx01/decision/presentation/DecisionController.java - Decision application
services/decision-service/src/main/java/com/arx01/decision/application/DecisionApplicationService.java - Groq decision client
services/decision-service/src/main/java/com/arx01/decision/infrastructure/GroqDecisionClient.java - Audit API
services/audit-service/src/main/java/com/arx01/audit/presentation/AuditController.java - Audit application
services/audit-service/src/main/java/com/arx01/audit/application/AuditApplicationService.java - Audit event repository
services/audit-service/src/main/java/com/arx01/audit/domain/repository/AuditEventRepository.java
Other components
- Merchant operator
- Groq inference
- PostgreSQL
Connections 28
- Merchant operator → Operations dashboard: uses
- Merchant operator → Recovery detail: inspects
- Operations dashboard → Frontend API client: requests data
- Recovery detail → Console views: renders
- Console views → Frontend API client: requests actions
- Frontend API client → API gateway: sends requests
- API gateway → Recovery API: routes requests
- API gateway → Payment API: routes requests
- API gateway → Audit API: routes requests
- Recovery API → Recovery orchestration: invokes
- Recovery orchestration → Payment service client: gets payment; retries
- Payment service client → Payment API: calls
- Payment API → Payment operations: invokes
- Payment operations → Payment repositories: reads and writes
- Payment repositories → PostgreSQL: persists
- Recovery orchestration → Decision service client: requests decision
- Decision service client → Decision API: calls
- Decision API → Decision application: invokes
- Decision application → Groq decision client: requests inference
- Groq decision client → Groq inference: sends prompt
- Recovery orchestration → Policy guardrails: checks eligibility
- Recovery orchestration → Recovery repositories: reads and writes
- Recovery repositories → PostgreSQL: persists
- Recovery orchestration → Audit service client: sends events
- Audit service client → Audit API: calls
- Audit API → Audit application: invokes
- Audit application → Audit event repository: appends and reads
- Audit event repository → PostgreSQL: persists