How manojcloud/tidewater-link2build works
Settle is a daily merchant settlement service: an API accepts settlement requests, queues jobs, and a worker calculates amounts and sends idempotent payouts to a bank. PostgreSQL stores settlement and payout state; Redis backs the job queue. The repository also documents health checks, reports, metrics, migrations, and operational dashboards and alerts. The graph emphasizes runtime behavior and those product capabilities; observability wiring is documented at the subsystem level, while unsampled deployment details are not expanded.
Main entry points: worker.py Settlement worker · api.py Settlement API · metrics.py Service metrics · logging_setup.py Structured logging
Components 13
API and reporting
- Settlement API
app/settle/api.py - Daily reports
app/settle/api.py
Settlement processing
- Settlement worker
app/settle/worker.py - Bank service
- Mock bank
app/settle/mockbank.py
State and dependencies
- PostgreSQL
- Redis queue
- Migration runner
app/settle/migrate.py
Operations and observability
- Runtime configuration
app/settle/config.py - Structured logging
app/settle/logging_setup.py - Service metrics
app/settle/metrics.py - Dashboards and alerts
observability
Other components
- Merchant client
Connections 17
- Merchant client → Settlement API: submits requests
README.md - Settlement API → Redis queue: enqueues jobs
app/settle/api.py - Settlement worker → Redis queue: claims jobs
app/settle/worker.py - Settlement worker → PostgreSQL: reads and records payouts
app/settle/worker.py - Settlement worker → Bank service: requests payout
app/settle/worker.py - Settlement worker → Mock bank: may target locally
- Settlement API → PostgreSQL: reads settlements
app/settle/api.py - Daily reports → PostgreSQL: aggregates settlements
app/settle/api.py - Migration runner → PostgreSQL: applies schema changes
app/settle/migrate.py - Settlement API → Runtime configuration: uses settings
app/settle/api.py - Settlement worker → Runtime configuration: uses settings
app/settle/worker.py - Settlement API → Structured logging: sets up logging
app/settle/api.py - Settlement worker → Structured logging: sets up logging
app/settle/worker.py - Migration runner → Structured logging: sets up logging
app/settle/migrate.py - Settlement API → Service metrics: records and serves
app/settle/api.py - Settlement worker → Service metrics: records job metrics
app/settle/worker.py - Service metrics → Dashboards and alerts: feeds dashboards
README.md