GroupBuy

marketplace · Last updated Jun 20, 2026

All notable changes to this app are recorded here. Newest entries on top.

Added a Watch/Read tab on the tutorial page — every lesson now has a written version alongside the video for users who prefer to read.

Initial scaffold. A shared workspace where buyers from anywhere pool orders into a single Onitsha-market shipment, and the truck cost is split fairly across every order in the load.
Agents (verified Onitsha-based curators) open shipments with a fixed transport cost and a truck capacity. As more buyers join, each buyer's share of the transport cost goes down — until the truck is full and ordering closes automatically.
Buyers see their delivery share update live before they check out. Once the truck closes, the share locks in so it can never change retroactively.
Three roles: admin (platform staff), agent (Onitsha curator), buyer (everyone else, the default). Buyers apply through an admin-approval queue to become agents — the brief specifies Onitsha-only curation and that needs vetting.
Shipments move through a 5-stage status: Loading → In Transit → Arrived → Ready for Pickup → Complete. Buyers can track by shipment or by order.
Public tracking links: /p/{agentUuid}/groupbuy/shipment?id=... for any shipment, /p/{buyerUuid}/groupbuy/track?token=... for one buyer's order.

Shared-DB app. One DB at data/shared/groupbuy.db with members(pancho_user_id PK, role, status) as the workspace gate.
helpers.php adds three workhorses: groupbuy_recompute_capacity_used(), groupbuy_recompute_provisional_delivery_share(), and groupbuy_close_ordering_if_full(). The provisional / final delivery-share split is preserved as two columns on orders — provisional shifts as new buyers join; final is set once when the truck closes and never recomputed (audit trail).
API code uses (string) $member['pancho_user_id'] everywhere — does not inherit RealtyCast's stale (int) cast pattern that pre-dates the identity migration.