Home

An original implementation of the Distributed Saga pattern across independent microservices — order placement, payment settlement, and fulfillment, coordinated with compensating transactions instead of a shared database transaction. Not a fork of any existing project — the module boundaries and general shape of the problem are common territory for this class of system, but the code and decisions here are original.

This wiki is a set of short pointers, not a duplicate of the real documentation — each page states one thing worth knowing and links to the authoritative source (the diagram pages, docs/, todo.md) rather than repeating it. For the full picture, start with README.md and todo.md in the main repo.

Architecture

• Architecture Overview — the module map, the two transports (gRPC + Kafka), and real bugs found by running this repo, not reading it
• Saga Flow — how a single order moves through all five saga-participating services, happy path and compensation
• Testing Strategy — four test layers run together, plus the JDK-25-vs-tooling gotchas that shaped them

Services

User Contract · User Service · Order Service · Payment Service · Restaurant Service · API Gateway Service

Elsewhere

• Diagram pages — the primary architecture reference the pages above point to (system architecture, saga flow, services reference, testing strategy)
• Consolidated test report — redeployed on every push to main
• Portfolio page
• GitHub Project board
• Milestones — the high-level build timeline, in todo.md