How viraj012/ledgersync works
LedgerSync accepts Stripe payment and refund webhooks, records each event and its order changes idempotently, and creates durable ERP-sync jobs. A background worker claims jobs, calls the ERP over HTTP, and retries failures; reconciliation compares local orders with ERP records and reports mismatches. The API also exposes order/job status, reconciliation reports, statistics, and mock-ERP fault controls. Relationships below follow the excerpts and README; some documented controllers and services were not sampled in full.
Main entry points: ReconciliationService.java Reconciliation run · SyncJobRepository.java Sync jobs · SyncWorker.java Sync worker · OrderRepository.java Orders
Components 24
Webhook ingestion
- Webhook endpoint
src/main/java/com/ledgersync/webhook/StripeWebhookController.java - Event mapper
src/main/java/com/ledgersync/webhook/StripeEventMapper.java - Webhook processing
src/main/java/com/ledgersync/webhook/WebhookService.java
ERP synchronization
- Sync scheduler
src/main/java/com/ledgersync/sync/SyncScheduler.java - Sync worker
src/main/java/com/ledgersync/sync/SyncWorker.java - Retry backoff
src/main/java/com/ledgersync/sync/Backoff.java - ERP HTTP client
src/main/java/com/ledgersync/sync/ErpClient.java - Mock ERP API
src/main/java/com/ledgersync/erp/MockErpController.java - ERP fault controls
src/main/java/com/ledgersync/erp/MockErpFaults.java
Reconciliation
- Reconciliation schedule
src/main/java/com/ledgersync/reconciliation/ReconciliationScheduler.java - Reconciliation API
src/main/java/com/ledgersync/reconciliation/ReconciliationController.java - Reconciliation run
src/main/java/com/ledgersync/reconciliation/ReconciliationService.java - Mismatch rules
src/main/java/com/ledgersync/reconciliation/ReconciliationRules.java - Run reports
src/main/java/com/ledgersync/reconciliation/ReconciliationRepository.java
Ledger data
- Stripe event store
src/main/java/com/ledgersync/webhook/StripeEventRepository.java - Orders
src/main/java/com/ledgersync/order/OrderRepository.java - Sync jobs
src/main/java/com/ledgersync/sync/SyncJobRepository.java - PostgreSQL
src/main/resources/db/migration/V1__init.sql - ERP records
src/main/java/com/ledgersync/erp/ErpRecordRepository.java
Query and controls
- Order lookup API
src/main/java/com/ledgersync/order/OrderController.java - Job management API
src/main/java/com/ledgersync/sync/SyncJobController.java - Statistics API
src/main/java/com/ledgersync/stats/StatsController.java
Other components
- Stripe
- API caller
Connections 33
- Stripe → Webhook endpoint: sends webhook
README.md - Webhook endpoint → Event mapper: maps event
src/main/java/com/ledgersync/webhook/StripeWebhookController.java - Webhook endpoint → Webhook processing: handles action
src/main/java/com/ledgersync/webhook/StripeWebhookController.java - Webhook processing → Stripe event store: deduplicates event
src/main/java/com/ledgersync/webhook/WebhookService.java - Webhook processing → Orders: updates order
src/main/java/com/ledgersync/webhook/WebhookService.java - Webhook processing → Sync jobs: queues sync
src/main/java/com/ledgersync/webhook/WebhookService.java - Stripe event store → PostgreSQL: writes events
- Orders → PostgreSQL: reads and writes
src/main/java/com/ledgersync/order/OrderRepository.java - Sync jobs → PostgreSQL: claims and updates
src/main/java/com/ledgersync/sync/SyncJobRepository.java - Sync scheduler → Sync worker: schedules work
src/main/java/com/ledgersync/sync/SyncScheduler.java - Sync worker → Sync jobs: claims and records outcomes
src/main/java/com/ledgersync/sync/SyncWorker.java - Sync worker → Orders: loads order
src/main/java/com/ledgersync/sync/SyncWorker.java - Sync worker → ERP HTTP client: sends sync
src/main/java/com/ledgersync/sync/SyncWorker.java - Sync worker → Retry backoff: calculates retry delay
src/main/java/com/ledgersync/sync/SyncWorker.java - ERP HTTP client → Mock ERP API: calls over HTTP
README.md - Mock ERP API → ERP records: stores ERP records
src/main/java/com/ledgersync/erp/MockErpController.java - Mock ERP API → ERP fault controls: applies fault settings
src/main/java/com/ledgersync/erp/MockErpController.java - ERP records → PostgreSQL: reads and writes
src/main/java/com/ledgersync/erp/ErpRecordRepository.java - Reconciliation schedule → Reconciliation run: starts scheduled run
src/main/java/com/ledgersync/reconciliation/ReconciliationScheduler.java - Reconciliation API → Reconciliation run: runs or reports
src/main/java/com/ledgersync/reconciliation/ReconciliationController.java - Reconciliation run → Orders: loads orders
src/main/java/com/ledgersync/reconciliation/ReconciliationService.java - Reconciliation run → ERP records: loads ERP records
src/main/java/com/ledgersync/reconciliation/ReconciliationService.java - Reconciliation run → Sync jobs: checks open jobs
src/main/java/com/ledgersync/reconciliation/ReconciliationService.java - Reconciliation run → Mismatch rules: compares records
src/main/java/com/ledgersync/reconciliation/ReconciliationService.java - Reconciliation run → Run reports: saves run and issues
src/main/java/com/ledgersync/reconciliation/ReconciliationService.java - API caller → Order lookup API: queries orders
README.md - API caller → Job management API: manages retries
README.md - API caller → Reconciliation API: requests report
README.md - API caller → Statistics API: checks counts
README.md - API caller → Mock ERP API: configures faults
README.md - Order lookup API → Orders: reads order
src/main/java/com/ledgersync/order/OrderController.java - Order lookup API → Sync jobs: loads order jobs
src/main/java/com/ledgersync/order/OrderController.java - Job management API → Sync jobs: lists and retries
src/main/java/com/ledgersync/sync/SyncJobController.java