two-phase-commit
Setup instruction
- To generate stubs from proto files.
cd contracts
andbuf generate proto
- Setup database
docker run -p 13454:5432 -e POSTGRES_USER=postgres -e POSTGRES_PASSWORD=postgres -e POSTGRES_DB=postgres postgres:12
- Setup schema and data using
goose -dir ./db/migrations postgres 'postgres://postgres:postgres@localhost:13454/postgres?sslmode=disable' up
- Run delivery service
go run delivery/main.go
- Run store service
go run store/main.go
- Run order service
go run order/main.go
Overall flow
sequenceDiagram
autonumber
actor u as user
participant o as order
participant s as store
participant d as delivery
u -->> o: place an order
rect rgb(191, 223, 255)
note right of o: Reserve/plan phase
o ->> s: reserve food
note over s: start timer
o ->> d: reserve a delivery agent
note over d: start timer
end
rect rgb(200, 150, 255)
note right of o: commit phase
o ->> s: order the food
o ->> d: assign the delivery agent
end
o -->> u: order confirmed
- Reserve phase: Reserve all the required resources with a timer. If the timer expires, release the resource.
- Commit phase: Book/commit the reserved resource. The probability of failure during the commit phase should be minimal, ideally occurring only in exceptional scenarios such as network failure, store , or delivery service disruption. In the event of such failure, the commit phase can be retried.