ShopFlow: E-commerce Backend with Idempotent Checkout, Payments and AI Search

Over nine phases you build ShopFlow like a professional team: requirements and threats, design with ADRs, a test-first implementation of a product catalog with full-text search, a server-side cart with coupons, money as integer paise, checkout with an Idempotency-Key and a guarded stock decrement that cannot oversell, orders with a state machine, HMAC-signed and de-duplicated payment webhooks, a transactional outbox, AI search assist and product description drafts with offline fallbacks, CI/CD with GitHub Actions, Docker, optional free-tier deployment, observability, a payment-window migration and a retrospective. Pick Java, Python or TypeScript; the spec, database and tests are shared. Everything runs on your laptop, and the AI features work offline.

intermediateJavaPythonTypeScriptSpring BootFastAPIFastifyPostgreSQLJWTbcryptHMAC-SHA256DockerGitHub ActionsOpenAPI

What you will build, step by step

  1. Phase 0 · Setup and orientation
  2. Phase 1 · Requirements, threats and user stories
  3. Phase 2 · Design: architecture, money, concurrency, database schema, API contract
  4. Phase 3 · Implementation in five milestones
  5. Phase 4 · Testing: integration, security and concurrency tests, coverage gate
  6. Phase 5 · Continuous integration with GitHub Actions
  7. Phase 6 · Containerise, deliver and (optionally) deploy
  8. Phase 7 · Observability and maintenance (v1.1.0)
  9. Phase 8 · Retrospective and portfolio