Documentation

Technical documentation for the OrderSync platform.

Recommended Orders System — How It Works Under the Hood

The Recommended Orders system identifies groups of marketplace orders that can be delivered together along an efficient route, saving the driver travel time and...

How the Cash Back Program Works (Plain-English Guide)

> A non-technical overview of the cash back / wallet feature in the OrderSync > app, written for non-developers: how customers earn money back, how they use > i...

Cash Back Engine — Wallet, Credits, Redemption & Campaigns

> End-to-end cash back feature for the OrderSync food-delivery platform: decimal EGP > customer wallet balances, a credits ledger, admin audit trail, redemption...

Discount System — Extended

> Extended version of the legacy discount system with new features. > See legacy-discount-system.md(./legacy-discount-system.md) for the original implementation...

ETA (Estimated Time to Arrive) — Order Tracking

This document describes how the customer-facing Estimated Time to Arrive (ETA) is calculated and displayed in the order tracking sidebar of customerapp. The ETA...

ERRREQUIREESM on Vercel — firebase-admin × jose Mismatch

This document describes a production-only crash in customerapp (order placement) caused by a CJS/ESM mismatch inside the firebase-admin dependency tree, the roo...

Discount System — Code Format Reference

FORMAT: {TYPE}-{VALUE} - FIXED-10 — Fixed discount, subtracts $10 from price - If result ≤ 0.4, price becomes 0 - P-50 — Percentage discount, 50% off - Valu...

Discount System — Legacy businessmanager

The discount system allowed restaurant managers to apply price reductions to individual menu items, with optional conditions restricting which customers qualify...

Orders Alerting System

This document describes the order alerting mechanisms in ordersapp (restaurant/manager side) and driverapp (driver side). The web alerting system is client-side...

PWA (Serwist) Infinite Rerender / Reload Loop — customerapp

This document describes a recurring infinite reload ("page rerender") loop caused by the Serwist PWA service worker in customerapp, its root cause, the fix appl...

Blurry Images in Chrome — Responsive Images and GPU-Composited Containers

This document explains a common cause of blurry images in Chrome-based browsers when responsive images are displayed inside animated, transformed, or composited...