How nageshgarje/mandate works
MandateHQ Core is a mandate-management service. Its main user-facing path enters through the API server and reaches mandate and customer operations; related services handle payment/execution state and issuer-specific integrations. The repository also includes hosted-card authentication, IIN lookup, notifications, webhooks, and background workers. Edges below are limited to registrations or dependencies visible in the supplied excerpts and SOURCE INDEX; unsampled runtime wiring is not inferred.
Main entry points: service/server.go Mandate operations · main.go API bootstrap · service/server.go Customer operations · server/server.go HTTP and gRPC server
Components 18
API and customer operations
- API bootstrap
cmd/api/main.go - HTTP and gRPC server
internal/server/server.go - Customer operations
internal/customer/service/server.go - Card authentication
internal/acs/service/server.go - IIN lookup
internal/iin/service/server.go - Card instruments
internal/instruments/server.go
Mandate lifecycle
- Mandate operations
internal/mandates/service/server.go - Execution tracking
internal/execution/service/server.go - Payment state
internal/payment/service/server.go
Issuer integrations
- RuPay integration
internal/rupay_integration/service/server.go - Hub interoperability
internal/hub_interoperability/service/server.go - SIHub integration
internal/sihub/service/server.go - Issuer adapters
internal/issuer_api/server.go
Notifications and workers
- Notification service
internal/notification/service/server.go - Mandate webhooks
internal/mandate_webhook/server.go - Background worker runtime
pkg/worker/manager.go - Queue backends
pkg/worker/queue/queue_manager.go
Other components
- API client
Connections 15
- API client → HTTP and gRPC server: sends requests
internal/server/server.go - API bootstrap → HTTP and gRPC server: starts server
cmd/api/main.go - API bootstrap → Mandate operations: registers API
cmd/api/main.go - API bootstrap → Customer operations: constructs service
cmd/api/main.go - API bootstrap → Card authentication: constructs service
cmd/api/main.go - API bootstrap → IIN lookup: registers API
cmd/api/main.go - HTTP and gRPC server → Mandate operations: routes requests
internal/server/server.go - Customer operations → Mandate operations: fetches mandate
internal/customer/service/server.go - Customer operations → RuPay integration: delegates RuPay
internal/customer/service/server.go - Mandate operations → Execution tracking: reads execution
internal/mandates/service/server.go - Mandate operations → Payment state: uses payment state
- RuPay integration → Mandate operations: reads mandate
internal/rupay_integration/service/server.go - Hub interoperability → Mandate operations: fetches mandate
internal/hub_interoperability/service/server.go - SIHub integration → Payment state: creates payment
- Background worker runtime → Queue backends: enqueues jobs
pkg/worker/manager.go