entrega-clara
Brazil-first food-delivery platform: the customer-to-delivery operation made visible, measurable, and replaceable.
A production-shaped scaffold whose implemented demo story is a lunch-rush scenario: a seeded order replays atomically from placed through rated — restaurant preparation, courier state and location updates, notifications, and a deterministic clock — while the web Demo Mode inspects, advances, and resets the running API scenario. Role-based surfaces cover Customer, Restaurant, Courier, and Admin, and routing sits behind a solver-independent baseline. Brazil is the default market (pt-BR, BRL, PIX, LGPD-aware privacy copy) with locale, currency, payments, and legal copy configuration-driven for future markets.
Why it matters
The portfolio thesis is operational transparency: the customer-to-delivery pipeline is modeled as a measurable, replayable system rather than a black box — with a routing baseline a future solver can replace without touching the domain state machine. Money is integer minor units plus currency; time is stored canonically and rendered in the active market time zone.
Deterministic by design
Seed data and demo scenarios are deterministic and replayable; make check runs the full gate set (lint, typecheck, tests) and make demo-preview previews the offline seed without contacting the API. Docs carry the architecture, ADRs, requirements, and runbooks alongside the code.
Repo facts
Public since 2026-08-30. Honest status: this is not a production payment platform, logistics company, or identity provider — payments, roles, GPS updates, and notifications are seeded or simulated, and customer checkout, operational role workflows, and production integrations remain explicitly deferred scaffold scope.