ENGINEERING HUMRAAHI
One order.
One rightful claim.
A simple delivery needs careful engineering underneath. Here is what we tested, what we measured and what those results mean.
Correctness under contention.
- Concurrent vendors
- 100
- Successful claim
- 1
- Expected conflicts
- 99
All requests targeted the same order through the real HTTP handler. One returned success; the other 99 returned HTTP 409. Expected conflicts are part of this test’s correctness condition.
Measured, with the context attached.
Recorded 2026-11-04 UTC. These are local closed-loop observations, not production capacity guarantees. Percentiles include the full HTTP response after dispatch, including database-pool wait, and exclude generator queue time.
| Workload | In flight | Requests | Success / conflict | p95 | p99 |
|---|---|---|---|---|---|
| Unique order placement | 1 | 200 | 200 / 0 | 10.5 | 11.0 |
| Independent order claims | 1 | 200 | 200 / 0 | 7.3 | 9.6 |
| Unique order placement | 10 | 200 | 200 / 0 | 38.9 | 85.1 |
| Independent order claims | 10 | 200 | 200 / 0 | 24.1 | 27.6 |
| Unique order placement | 25 | 200 | 200 / 0 | 83.1 | 90.5 |
| Independent order claims | 25 | 200 | 200 / 0 | 53.9 | 61.8 |
| Same idempotency key | 50 | 100 | 100 / 0 | 115.4 | 121.9 |
| 100 vendors, one order | 100 | 100 | 1 / 99 | 259.9 | 268.1 |
| One vendor, 25 orders | 25 | 25 | 1 / 24 | 42.9 | 43.7 |
Normal workloads use 200 observations each; p99 selects the 198th sorted observation. Race workloads have different sample counts. A single successful race winner cannot establish a useful success-tail estimate.
Test conditions and limits
- Node v25.1.0; linux/x64; 16 CPU threads; 7.5 GiB RAM.
- PostgreSQL 16.15 (Ubuntu 16.15-0ubuntu0.24.04.1); pool maximum 10 connections.
- Loopback client and API shared one Node process. Logging was silent. TLS, realtime transport and FCM were excluded.
- Twenty placement/claim warmup pairs were excluded from measured workloads.
- Fixture schemas copied database definitions; this run did not establish a clean migration-from-scratch result.
Database verification recorded 647 orders and 622 claims, with 0 duplicate orders and 0 vendors holding multiple active orders.