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.
What you will build, step by step
- Phase 0 · Setup and orientation
- Phase 1 · Requirements, threats and user stories
- Phase 2 · Design: architecture, money, concurrency, database schema, API contract
- Phase 3 · Implementation in five milestones
- Phase 4 · Testing: integration, security and concurrency tests, coverage gate
- Phase 5 · Continuous integration with GitHub Actions
- Phase 6 · Containerise, deliver and (optionally) deploy
- Phase 7 · Observability and maintenance (v1.1.0)
- Phase 8 · Retrospective and portfolio