How kartiksood10/acme-migration-backend works
ACME is a Spring Boot control plane for asynchronous API-contract migrations: clients submit a migration request, the backend records its job and delegates execution to the Python worker, then the worker posts results back for persistence and client polling. It also exposes a historical-run dashboard summary and standardized error responses. The README documents these product-level flows, but no source excerpts were provided, so class-level call ownership cannot be verified; edges below reflect only documented relationships.
Main entry points: MigrationController.java Migration API · MigrationService.java Migration Coordination · MigrationWebhookService.java Webhook Handling · repository Data Repositories
Components 11
Client API
- Migration API
src/main/java/com/acme/migration/controller/MigrationController.java - API Payloads
src/main/java/com/acme/migration/dto - Error Responses
src/main/java/com/acme/migration/exception/GlobalExceptionHandler.java
Migration Control
- Migration Coordination
src/main/java/com/acme/migration/service/MigrationService.java - Webhook Handling
src/main/java/com/acme/migration/service/MigrationWebhookService.java
Job Persistence
- Migration Jobs
src/main/java/com/acme/migration/entity/MigrationJobs.java - Migration Results
src/main/java/com/acme/migration/entity - Data Repositories
src/main/java/com/acme/migration/repository
External Systems
- PostgreSQL
- Python Worker
Other components
- API Client
Connections 14
- API Client → Migration API: submits or polls
README.md - Migration API → API Payloads: exchanges payloads
README.md - Migration API → Migration Coordination: delegates migration
README.md - Migration Coordination → Migration Jobs: records job state
README.md - Migration Coordination → Python Worker: forwards request
README.md - Python Worker → Migration API: posts callback
README.md - Migration API → Webhook Handling: receives callback
README.md - Webhook Handling → Migration Results: records results
README.md - Migration Coordination → Data Repositories: persists and queries
README.md - Webhook Handling → Data Repositories: updates results
README.md - Data Repositories → PostgreSQL: reads and writes
README.md - Migration API → Error Responses: formats errors
README.md - Migration API → Migration Jobs: serves job status
README.md - Migration API → Migration Results: serves migration details
README.md