How chandanvura/payguard works
PayGuard’s central workflow accepts an idempotent payment request, persists it before calling a simulated provider, and records a definitive result or UNKNOWN; retries reuse the payment ID. A Java reconciliation worker checks uncertain outcomes and updates payment state. The repository also documents a Go health observer and Prometheus/Grafana and Alloy/Loki observability paths, plus SRE rules. Source excerpts establish Java call ownership; README statements support the wider monitoring relationships. Unsampled infrastructure wiring is represented only where the README documents it.
Main entry points: PaymentService.java Payment Service · PaymentController.java Payment Controller · prometheus.yml Prometheus · PaymentReconciliationWorker.java Reconciliation Worker
Components 19
Payment API
- Payment Controller
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentController.java - Payment Service
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentService.java - Payment Response
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentResponse.java
Payment Reliability
- Transaction Service
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentTransactionService.java - Payment Repository
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentRepository.java - Payment State
payment-service/src/main/java/com/payguard/payment_service/payment/Payment.java - Simulated Provider
payment-service/src/main/java/com/payguard/payment_service/provider/FakePaymentProvider.java - Provider Contract
payment-service/src/main/java/com/payguard/payment_service/provider/PaymentProvider.java - Reconciliation Worker
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentReconciliationWorker.java - PostgreSQL
Health Companion
- Go Health Observer
sidecar/main.go
Observability
- Prometheus
observability/prometheus/prometheus.yml - Grafana
observability/grafana - Alloy Log Collector
observability/alloy/config.alloy - Loki
observability/loki/loki-config.yml
SRE Operations
- SLI SLO Rules
observability/prometheus/rules/payguard-slo.yml - Terraform Setup
terraform/main.tf - Operational Verification
ansible/playbooks/verify-payguard.yml
Other components
- API Client
Connections 22
- API Client → Payment Controller: submits request
README.md - Payment Controller → Payment Service: calls
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentController.java - Payment Controller → Payment Response: maps result
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentController.java - Payment Service → Payment Repository: looks up
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentService.java - Payment Service → Transaction Service: creates or updates
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentService.java - Payment Service → Provider Contract: charges and checks
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentService.java - Simulated Provider → Provider Contract: implements
payment-service/src/main/java/com/payguard/payment_service/provider/FakePaymentProvider.java - Transaction Service → Payment Repository: saves
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentTransactionService.java - Payment Repository → Payment State: loads and stores
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentRepository.java - Payment Service → PostgreSQL: persists payment
README.md - Reconciliation Worker → Payment Service: reconciles through
payment-service/src/main/java/com/payguard/payment_service/payment/PaymentReconciliationWorker.java - Reconciliation Worker → PostgreSQL: loads and updates
README.md - Reconciliation Worker → Provider Contract: checks status
README.md - Go Health Observer → Payment Controller: probes health
README.md - Payment Controller → Prometheus: exports metrics
README.md - Go Health Observer → Prometheus: exposes metrics
README.md - Prometheus → Grafana: feeds dashboards
README.md - Alloy Log Collector → Loki: ships logs
README.md - Loki → Grafana: feeds log views
README.md - SLI SLO Rules → Prometheus: defines rules
README.md - Terraform Setup → PostgreSQL: isolated setup only
README.md - Operational Verification → PostgreSQL: verifies operations
README.md