Home

Customer Management

A reactive Spring Boot (WebFlux) API + React (MUI) SPA, served from one origin and deployed to Google Cloud Run.

🔗 Live demo: https://customer-management-hj57iqzdmq-nw.a.run.app — sign in with admin / admin123.

👉 Getting started

New here? Head to the Setup guide — how to run the project locally, with Docker, and how to deploy it.

For how it works under the hood — request flow, the filter chain, services, and the folder structure — see Architecture.

Pages

Getting started

• Setup — run it locally, with Docker, or deploy it

How it works

• Architecture — request flow, the filter chain, services, folder structure
• Authentication and JWT — login, token claims, roles, password change
• Rate Limiting — token-bucket limiting, tiers, backends
• Data Migrations and Auditing — R2DBC + Flyway on H2, the audit trail

Operations

• Deployment — Cloud Run + Terraform
• CI/CD Pipeline — GitHub Actions + keyless deploy
• Configuration and Environments — profiles & environment variables

Reference

• Testing and Quality — tests, coverage, Newman
• Design Decisions — why it's built this way
• Troubleshooting — common gotchas

More

• README — overview & architecture
• API docs (Swagger)
• AI_USAGE — how the project was built