This document defines the Baskit backend: Baskit Ops, built on CodeIgniter 4 with Shield (authentication, user access, and user management), running as an Azure Container App against PostgreSQL. It is where everything talks to: both Flutter apps, the scraper, the payment gateway, and the operations team all meet here. Shield carries authentication, user access, and user management — a proven base, so the build effort goes into Baskit-specific logic rather than plumbing.
It has two halves. Section 03 is the complete API catalog (53 endpoints across two surfaces) — the contract both apps and the scraper are built against. Section 05 is the complete screen checklist — every screen, drill-down, and confirming modal. Sections 06–10 show the primary screens as mockups.
Every endpoint in the project. The application surface serves the customer and picker apps under JWT; the ingestion surface is scraper-only under a service key. Payload-level contracts live in the build scope Section 06 and, for the picker group, the Picker API Contract packet.
| Method | Endpoint | What the client uses it for |
|---|---|---|
| POST | /api/v1/auth/register | Create an account |
| POST | /api/v1/auth/login | Email and password login; returns JWT + refresh |
| POST | /api/v1/auth/social | Apple or Google sign-in |
| POST | /api/v1/auth/refresh | Rotate the access token |
| GET | /api/v1/me | Profile and saved preferences |
| POST | /api/v1/me/addresses | Manage delivery addresses (list, add, edit, remove) |
| POST | /api/v1/me/addresses:validate | Confirm an address is inside the 7 km radius |
| Method | Endpoint | What the client uses it for |
|---|---|---|
| GET | /api/v1/catalog/aisles | Category list for the home grid |
| GET | /api/v1/catalog/products | Paginated compact product cards (best price only) |
| GET | /api/v1/catalog/products/{id} | Full detail with per-retailer comparison |
| GET | /api/v1/search/suggest | Type-ahead suggestions |
| GET | /api/v1/deals | Best and sponsored deals for the home screen |
| Method | Endpoint | What the client uses it for |
|---|---|---|
| GET | /api/v1/basket | Current basket, compact lines |
| POST | /api/v1/basket/items | Add an item |
| PATCH | /api/v1/basket/items/{id} | Change quantity |
| DELETE | /api/v1/basket/items/{id} | Remove an item |
| POST | /api/v1/basket/optimize | Run Smart Split; returns the split and the saving |
| GET | /api/v1/basket/compare | Split versus single-store summary |
| Method | Endpoint | What the client uses it for |
|---|---|---|
| GET | /api/v1/checkout/delivery-windows | Available delivery windows |
| POST | /api/v1/checkout/quote | Final priced quote: fees, delivery, total |
| POST | /api/v1/orders | Place the order; returns order + payment intent |
| GET | /api/v1/wallet | Wallet balance |
| POST | /api/v1/wallet/topup | Top up the wallet through the gateway |
| GET | /api/v1/wallet/transactions | Wallet ledger view |
| POST | /api/v1/payments/peach/intent | Create a Peach payment intent (3DS) |
| POST | /api/v1/payments/peach/webhook | Gateway callback (server to server) |
| Method | Endpoint | What the client uses it for |
|---|---|---|
| GET | /api/v1/orders | Order history, compact |
| GET | /api/v1/orders/{id} | Order detail with per-store legs |
| GET | /api/v1/orders/{id}/tracking | Light tracking payload for polling |
| POST | /api/v1/orders/{id}:repeat | Rebuild a basket from a past order |
| Method | Endpoint | What the client uses it for |
|---|---|---|
| PATCH | /api/v1/picker/status | Go on or off duty and push current location |
| GET | /api/v1/picker/jobs | Job feed: available, active, today (compact) |
| POST | /api/v1/picker/jobs/{id}:accept | Claim a job (claim-lock) |
| POST | /api/v1/picker/jobs/{id}:decline | Pass a job |
| GET | /api/v1/picker/jobs/{id} | Job detail, items grouped by aisle |
| POST | /api/v1/picker/jobs/{id}/items/{itemId}:pick | Mark an item picked |
| POST | /api/v1/picker/jobs/{id}/items/{itemId}:substitute | Record a substitution |
| POST | /api/v1/picker/jobs/{id}/items/{itemId}:refund | Refund and skip an item |
| POST | /api/v1/picker/jobs/{id}:spend | Record actual card spend and the receipt |
| POST | /api/v1/picker/jobs/{id}:handoff | Release the order against the handoff code |
| GET | /api/v1/picker/earnings | Earnings summary |
| Method | Endpoint | What the client uses it for |
|---|---|---|
| POST | /api/v1/devices | Register a push token (customer or picker) |
| GET | /api/v1/config | Fee configuration and feature flags |
| GET | /api/v1/placements | Active ad per requested slot |
| POST | /api/v1/placements/{id}/events | Log an impression or click |
| Method | Endpoint | What the client uses it for |
|---|---|---|
| POST | /ingest/v1/runs | Open an ingestion run for a retailer; returns run_id |
| POST | /ingest/v1/products:batch | Upsert a batch of normalized product records |
| POST | /ingest/v1/prices:batch | Upsert a batch of price observations |
| POST | /ingest/v1/availability:batch | Update in-stock status per store |
| POST | /ingest/v1/runs/{run_id}:close | Close the run and log the full accounting |
| GET | /ingest/v1/runs | List runs with timings and volume stats (the audit log) |
| GET | /ingest/v1/runs/{run_id}/rejected | Records not uploaded, with the reason for each |
| GET | /ingest/v1/products/unmatched | Products awaiting manual equivalence mapping |
The complete screen set for Baskit Ops. Every ListView clicks through to a detail; the mockups for each follow in Sections 06–11. Screens are Shield-permission gated per group.
| Route | Type | Purpose | Click-through |
|---|---|---|---|
/admin | Dashboard | Today at a glance: orders, GMV, pick performance, alerts | — |
/admin/orders | ListView | All orders with filters by status, store, and date | /admin/orders/{id} |
/admin/orders/{id} | Detail | Per-store legs, item pick states, spend versus target, handoff — the full answer to whether the picker finished | — |
/admin/pickers | ListView | Picker management: duty state, picks, rating, earnings | /admin/pickers/{id} |
/admin/pickers/{id} | Detail | One picker: jobs, shifts, earnings, prepaid card, approval | — |
/admin/products | ListView | Catalog management with search, retailer coverage, best price | /admin/products/{id} |
/admin/products/{id} | Detail / Form | Edit product, per-retailer price and availability, substitution group, tags | — |
/admin/ingest/runs | ListView | Scrape run log: every run with timings and volumes | /admin/ingest/runs/{id} |
/admin/ingest/runs/{id} | Detail | Full run accounting: fetched, applied, unchanged, skipped, rejected with reasons | — |
/admin/ads | ListView | Ad placements by slot with schedule, delivery, and status | /admin/ads/{id} |
/admin/ads/{id} | Detail / Form | Placement editor: slot, creative, schedule, delivery, in-frame preview | — |
/admin/reports | Dashboard | Orders by store and suburb, picker leaderboard, daily KPI series | drill-down filters |
/admin/users | ListView / Form | Console users, Shield groups and permissions, invitations | /admin/users/{id} |
/admin/settings | Form | Fees, delivery windows, service radius, feature flags | — |
The exhaustive build checklist for the console: every list, detail, tab, form, report, and — explicitly — every confirming or ending modal behind each drill-down. A screen is not required to have a mockup to be required; when the build starts, this is the coverage list to tick off. Modules marked here that have mockups in Sections 06–11 reference them by M-number.
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | AUT-01 | Sign in | Form | Shield session login for console users |
| ☐ | AUT-02 | Forgot password | Form | Request reset link by email |
| ☐ | AUT-03 | Reset password | Form | Set a new password from the link |
| ☐ | AUT-04 | My profile | Form | Own name, email, password change, sessions |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | DSH-01 | Dashboard | Dashboard | Today’s KPIs, live order queue, pickers on duty; every figure clicks through to its filtered list |
| ☐ | DSH-02 | Alerts drawer | Panel | Unreconciled runs, stuck orders, pack-by breaches, failed webhooks |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | CUS-01 | Customers list | List | All accounts with status, orders, last active; filter by beta status |
| ☐ | CUS-02 | Beta application queue | List | Founding-household applications awaiting review |
| ☐ | CUS-03 | Approve / decline application | Modal | Confirm decision; approval sends the invite |
| ☐ | CUS-04 | Customer detail | Detail | Profile, addresses (radius check), preferences, devices |
| ☐ | CUS-05 | Customer orders tab | Tab | Order history for this customer with click-through to order detail |
| ☐ | CUS-06 | Customer wallet tab | Tab | Balance and ledger; credits and adjustments |
| ☐ | CUS-07 | Wallet adjustment | Modal | Credit or debit with reason; audit-logged |
| ☐ | CUS-08 | Suspend / reactivate customer | Modal | Confirm with reason |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | ORD-01 | Orders list | List | Every order; filters by status, store, date, customer |
| ☐ | ORD-02 | Order detail | Detail | Header, totals, Smart Split saving, per-store legs — the ‘did the picker finish’ view |
| ☐ | ORD-03 | Store-leg detail | Detail | One leg: picker, pack-by, item states, spend vs target, receipt, handoff |
| ☐ | ORD-04 | Order item drill | Detail | One line: pick event history, substitution decision, price delta |
| ☐ | ORD-05 | Live tracking view | Map | Legs and driver ETAs as the customer sees them |
| ☐ | ORD-06 | Order timeline | Tab | Full event audit: placed, claimed, picked, spent, handed off, delivered |
| ☐ | ORD-07 | Assign / reassign picker | Modal | Pick a picker for a leg; confirms claim transfer |
| ☐ | ORD-08 | Cancel order / leg | Modal | Confirm with reason; triggers refund path |
| ☐ | ORD-09 | Refund & adjustment | Form | Line-level or amount refund with reason codes |
| ☐ | ORD-10 | Confirm refund | Modal | Final confirmation showing customer impact |
| ☐ | ORD-11 | Add internal note | Modal | Ops note on the order, audit-logged |
| ☐ | ORD-12 | Delivery handoff record | Detail | Third-party delivery reference, driver, proof |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | PIK-01 | Pickers list | List | Duty state, picks, on-time, rating, earnings |
| ☐ | PIK-02 | Picker applications | List | New pickers awaiting approval |
| ☐ | PIK-03 | Approve picker | Modal | Confirm approval; creates picker role + card eligibility |
| ☐ | PIK-04 | Picker detail — overview | Detail | Identity, status, lifetime stats, current job |
| ☐ | PIK-05 | Jobs tab | Tab | All jobs with outcome, spend vs target, payout |
| ☐ | PIK-06 | Job drill | Detail | One job: item-by-item event timeline, substitutions, spend, handoff |
| ☐ | PIK-07 | Shifts tab | Tab | On/off duty periods, hours, location trail summary |
| ☐ | PIK-08 | Earnings tab | Tab | Base, tips, batch bonuses per job; weekly totals |
| ☐ | PIK-09 | Payout statement | Detail | Period statement for payroll or gig payout |
| ☐ | PIK-10 | Prepaid card tab | Tab | Assigned card, balance, till transactions vs recorded spends |
| ☐ | PIK-11 | Assign / replace card | Modal | Bind a card to the picker; confirm replacement |
| ☐ | PIK-12 | Edit picker | Form | Contact details, store coverage, vehicle/on-foot |
| ☐ | PIK-13 | Suspend / deactivate picker | Modal | Confirm with reason; blocks the feed |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | PRO-01 | Products list | List | Search, category, retailer coverage, best price, freshness, status |
| ☐ | PRO-02 | Product detail | Detail | Everything the app reads: identity, images, tags, per-retailer prices |
| ☐ | PRO-03 | Create product | Form | New product with required comparison fields (size/weight) |
| ☐ | PRO-04 | Edit product | Form | Name, brand, size, category, image, tags |
| ☐ | PRO-05 | Archive / restore product | Modal | Confirm; archived items leave the app catalog |
| ☐ | PRO-06 | Per-retailer prices view | Tab | Current price and availability per retailer and store |
| ☐ | PRO-07 | Price history drill | Detail | Observed price series per retailer (30/90 days) |
| ☐ | PRO-08 | Availability drill | Detail | In-stock status per store with last-observed time |
| ☐ | PRO-09 | Substitution group editor | Detail | Members, ordering, customer-preference defaults |
| ☐ | PRO-10 | Add / remove group member | Modal | Confirm membership change |
| ☐ | PRO-11 | Equivalence mapping screen | Detail | Side-by-side candidate matching across retailers |
| ☐ | PRO-12 | Confirm match / reject match | Modal | Lock an equivalence or send back to unmatched |
| ☐ | PRO-13 | Unmatched queue | List | Products from scrape runs awaiting mapping (feeds PRO-11) |
| ☐ | PRO-14 | Categories & aisles manager | List + Form | The home-grid taxonomy the app shows |
| ☐ | PRO-15 | Tags manager | List + Form | Vegan, gluten-free, budget, essential and similar |
| ☐ | PRO-16 | Image upload | Modal | Upload or replace product imagery |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | RUN-01 | Runs list | List | Every run: retailer, timings, fetched, applied, rejected, status |
| ☐ | RUN-02 | Run detail | Detail | Reconciled accounting: fetched = created + updated + unchanged + skipped + rejected |
| ☐ | RUN-03 | Rejected records drill | List | Each rejected record with its reason |
| ☐ | RUN-04 | Skipped records drill | List | Each skipped record with its reason |
| ☐ | RUN-05 | Applied changes drill | List | Created and updated records in this run (what was updated) |
| ☐ | RUN-06 | Abort running run | Modal | Confirm stop of an in-flight run |
| ☐ | RUN-07 | Schedule view | Detail | Per-retailer schedule of Azure Container Apps Jobs; last and next run |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | REP-01 | Reports home | Dashboard | Entry cards to every report with headline figures |
| ☐ | REP-02 | Daily KPI series | Report | Business plan §10.2 metrics day by day |
| ☐ | REP-03 | Orders by store | Report | Volume and value mix across the four retailers |
| ☐ | REP-04 | Orders by suburb | Report + Map | Where it is ordered most inside the 7 km radius |
| ☐ | REP-05 | Picker performance | Report | Leaderboard: picks, on-time, substitution and refund rates, earnings |
| ☐ | REP-06 | SKU performance | Report | Top movers, slow movers, out-of-stock leaders |
| ☐ | REP-07 | Savings report | Report | How much Smart Split is saving: per order, aggregate, and vs single-store baseline |
| ☐ | REP-08 | Substitution & OOS report | Report | Out-of-stock rate and substitution acceptance by store and SKU |
| ☐ | REP-09 | Refunds & adjustments report | Report | Refund value and rate with reason breakdown |
| ☐ | REP-10 | Export | Modal | CSV export of any report with the active filters |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | PAY-01 | Reconciliation queue | List | Legs awaiting spend-vs-charge reconciliation |
| ☐ | PAY-02 | Reconciliation detail | Detail | Receipt image beside items, card transaction, customer charge |
| ☐ | PAY-03 | Mark reconciled | Modal | Confirm the leg balances |
| ☐ | PAY-04 | Flag discrepancy | Modal | Route a mismatch with reason to follow-up |
| ☐ | PAY-05 | Prepaid cards list | List | All cards: assignment, balance, status |
| ☐ | PAY-06 | Card detail & ledger | Detail | Loads, till transactions, recorded spends per card |
| ☐ | PAY-07 | Load funds | Modal | Confirm card top-up |
| ☐ | PAY-08 | Customer wallet ledger | List | Credits, debits, refunds across customers |
| ☐ | PAY-09 | Gateway webhook log | List | Peach callbacks with status and payload drill |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | MED-01 | Placements list | List | All placements by slot (hero, deals, search, last-minute) and status |
| ☐ | MED-02 | Placement editor | Form | Slot, creative, product links, schedule, sponsor label |
| ☐ | MED-03 | Creative preview | Detail | How the placement renders in the app slot |
| ☐ | MED-04 | Schedule calendar | Detail | Bookings across slots and dates |
| ☐ | MED-05 | Placement performance | Report | Impressions and clicks per placement |
| ☐ | MED-06 | Pause / end placement | Modal | Confirm stop; slot returns to organic content |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | USR-01 | Console users list | List | All console accounts with group and last activity |
| ☐ | USR-02 | Invite user | Modal | Email invite into a Shield group |
| ☐ | USR-03 | User detail / edit | Form | Group membership, status, forced sign-out |
| ☐ | USR-04 | Groups & permission matrix | Detail | Which group can see and do what, per module |
| ☐ | USR-05 | Deactivate user | Modal | Confirm removal of access |
| ☐ | USR-06 | Audit log | List | Every console mutation: who, what, when |
| ☐ | USR-07 | Audit entry drill | Detail | Before and after values for one change |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | SET-01 | Fees & service settings | Form | Service fee, delivery fee rules, minimums |
| ☐ | SET-02 | Delivery windows editor | Form | Windows offered at checkout |
| ☐ | SET-03 | Service radius editor | Map + Form | The 7 km boundary used by address validation |
| ☐ | SET-04 | Feature flags | Form | Toggles the app reads from /config |
| ☐ | SET-05 | Retailers & stores manager | List + Form | Participating stores, hours, active status |
| ID | Screen | Type | What it must show / do | |
|---|---|---|---|---|
| ☐ | SUP-01 | Issue log | List | Operational issues by order, picker, or run |
| ☐ | SUP-02 | Issue detail | Detail | Timeline, linked records, resolution state |
| ☐ | SUP-03 | Customer feedback list | List | In-app and WhatsApp-channel feedback capture |
| Latest orders | Stores | Total | Status |
|---|---|---|---|
| #BK-2841 · T. Mokoena | PnP + Sixty60 | R 645.89 | Picking |
| #BK-2840 · L. van Wyk | Woolworths | R 512.40 | Ready |
| #BK-2839 · N. Petersen | Sixty60 + Spar | R 891.15 | Delivered |
| Pickers on duty | Active job | Picks today |
|---|---|---|
| Sipho M. On duty | #BK-2841-P | 9 |
| Ayesha K. On duty | — | 7 |
| Daniel R. Off duty | — | 5 |
| User | Shield group | Last active | Status |
|---|---|---|---|
| Jacob · jacob@silicon... | owner — full access | 5 min ago | Active |
| Ops lead · ops@baskit... | ops — orders, pickers, products, runs | 22 min ago | Active |
| Support · help@baskit... | support — orders read, refunds propose | 1 h ago | Active |
| Finance · fin@baskit... | finance — reconciliation, payouts, reports | Yesterday | Active |
| New picker manager | picker-manager — pickers, cards, earnings | Invitation sent | Pending |
Groups and permissions are Shield groups; every console action checks a permission, and every change is audit-logged.
These screens manage the people using the picker app: approval, duty, jobs, earnings, and the prepaid card. The picker detail is the console mirror of the picker app — every event the app sends (accept, pick, substitute, spend, handoff) lands here.
| Picker | Duty | Picks today | On-time | Rating | Earnings today | |
|---|---|---|---|---|---|---|
| Sipho M. · Constantia | On duty | 9 | 96% | 4.92 | R 432.00 | Open |
| Ayesha K. · Constantia | On duty | 7 | 93% | 4.88 | R 356.00 | Open |
| Daniel R. · Constantia | Off duty | 5 | 91% | 4.75 | R 240.00 | Open |
| New applicant · — | Awaiting approval | — | — | — | — | Review |
| Job | Store | Items | Outcome | Spend vs target | Payout |
|---|---|---|---|---|---|
| #BK-2841-P | PnP Constantia Village | 6 | Picking · 2/6 | — | R 50.00 |
| #BK-2836-P | PnP Constantia Village | 5 | Handed off 11:42 | R 204.11 / R 209.95 | R 48.00 |
| #BK-2833-C | Sixty60 Constantia | 9 | Handed off 10:15 | R 371.94 / R 371.94 | R 62.00 |
| #BK-2829-W | Woolworths Constantia | 4 | 1 refund · done | R 89.98 / R 118.97 | R 40.00 |
| Order | Customer | Stores | Items | Total | Placed | Status | |
|---|---|---|---|---|---|---|---|
| #BK-2841 | T. Mokoena | PnP + Sixty60 | 7 | R 645.89 | 12:04 | Picking | Open |
| #BK-2840 | L. van Wyk | Woolworths | 5 | R 512.40 | 11:47 | Ready for handoff | Open |
| #BK-2839 | N. Petersen | Sixty60 + Spar | 11 | R 891.15 | 11:12 | Delivered 12:20 | Open |
| #BK-2838 | B. Dlamini | PnP | 6 | R 402.75 | 10:58 | Delivered 11:55 | Open |
| #BK-2837 | S. Naidoo | Sixty60 | 8 | R 566.20 | 10:31 | Refund pending | Open |
| Item | Qty | State | Price |
|---|---|---|---|
| Bananas 1kg | 1 | Picked | R 19.99 |
| Avocados 4 pack | 1 | Substituted → brown bread | R 39.99 |
| White Bread Loaf 700g | 1 | Pending | R 18.99 |
| Full Cream Milk 2L | 2 | Pending | R 65.98 |
| Mature Cheddar 300g | 1 | Pending | R 64.99 |
| Picker | Picks | On-time | Subs rate | Refund rate | Earnings |
|---|---|---|---|---|---|
| Sipho M. | 41 | 96% | 8% | 1.2% | R 2,840 |
| Ayesha K. | 36 | 93% | 11% | 2.0% | R 2,410 |
| Daniel R. | 28 | 91% | 9% | 3.1% | R 1,905 |
The daily KPI series follows the business plan Section 10.2: orders placed, completed, cancelled; GMV; average order value; fees; picking and delivery time; out-of-stock rate; substitution acceptance; refund value; repeat orders; multi-store percentage; gross contribution per order.
The run log is the audit trail of the ingestion surface: every run, what was fetched, what was updated, what was not uploaded and why. The unmatched queue flows into product management, where equivalence mapping is what makes cross-retailer comparison — and therefore Smart Split — work.
| Run | Retailer | Started | Duration | Fetched | Applied | Unchanged | Rejected | Status |
|---|---|---|---|---|---|---|---|---|
| #R-3122 | Pick n Pay | 06:00 | 14 m 20 s | 1,180 | 916 | 251 | 4 | Closed clean |
| #R-3121 | Sixty60 | 05:30 | 11 m 05 s | 1,043 | 887 | 149 | 7 | Closed clean |
| #R-3120 | Woolworths | 05:00 | 9 m 41 s | 742 | 705 | 33 | 4 | Closed · warnings |
| #R-3119 | Spar | 04:30 | 8 m 02 s | 611 | 598 | 13 | 0 | Closed clean |
| #R-3118 | Pick n Pay | Yesterday 18:00 | — | 312 | 0 | 0 | 0 | Aborted · blocked |
| Record | Reason |
|---|---|
| SKU 8801 · ‘Melk Vol Room 2L’ | No match in equivalence map — queued for manual mapping |
| SKU 4417 · price R 0.00 | Failed validation: zero price |
| SKU 9905 · missing size | Failed validation: size/weight required for comparison |
| SKU 7223 · duplicate in batch | Duplicate key within the same batch |
| Product | Category | Retailers | Best price | Updated | Status | |
|---|---|---|---|---|---|---|
| Full Cream Milk · Clover · 2L | Dairy & eggs | 4 of 4 | R 32.99 · PnP | 12 min ago | Live | Open |
| White Bread Loaf · Sasko · 700g | Bakery | 4 of 4 | R 17.99 · Spar | 12 min ago | Live | Open |
| Krönung Instant Coffee · Jacobs · 200g | Pantry | 3 of 4 | R 87.99 · Sixty60 | 25 min ago | Live | Open |
| Melk Vol Room · 2L | — | 1 of 4 | — | 06:14 | Unmatched — map it | Map |
| Retailer | Price | In stock | Last observed |
|---|---|---|---|
| Pick n Pay | R 32.99 best | Yes | 12 min ago |
| Checkers Sixty60 | R 33.99 | Yes | 25 min ago |
| Spar | R 34.50 | Yes | 41 min ago |
| Woolworths | R 38.99 | Low | 33 min ago |
The console side of the in-app media framework: manually managed Tier 1 placements across the four slots — home hero, Today’s Best Deals positions, sponsored search positions, and Last-Minute Items. The app reads these through GET /api/v1/placements and reports delivery through POST /api/v1/placements/{id}/events. Checklist coverage is the MED module (MED-01 to MED-06).
| Placement | Slot | Sponsor | Schedule | Impressions | Clicks | Status | |
|---|---|---|---|---|---|---|---|
| Krönung 200g launch | Home · hero banner (WEBM) | Jacobs | 1–14 Jul | 12,480 | 342 | Live | Open |
| Sasko winter promo | Today’s Best Deals · position 1 | Sasko | 8–21 Jul | 4,112 | 96 | Live | Open |
| Clover milk feature | Search ‘milk’ · top position | Clover | 15–31 Jul | — | — | Scheduled | Open |
| Nulaid eggs push | Basket · Last-Minute Items | Nulaid | 24 Jun–7 Jul | 9,870 | 201 | Ended | Open |
Slots follow the media placement framework: home hero, Today’s Best Deals positions 1–2, sponsored search positions, and Last-Minute Items at the basket. All placements carry the Sponsored label in the app.
| ID | Requirement | Priority |
|---|---|---|
| BE-01 | Serve every endpoint in the API catalog (Section 03) under the stated authentication for each surface. | Must |
| BE-02 | Authentication and user management through Shield: customer and picker identities, console users in Shield groups (owner, ops, support, finance, picker-manager), permission checks on every console action. | Must |
| BE-03 | Smart Split optimization, quotes, order placement, wallet, and Peach payment flow as specified in the build scope. | Must |
| BE-04 | Picker dispatch with claim-lock, per-item pick state machine, substitutions, spend capture, handoff verification, and earnings. | Must |
| BE-05 | Ingestion surface with per-run accounting that reconciles fetched = created + updated + unchanged + skipped + rejected, and a rejected-record reason log. | Must |
| BE-06 | Console: Dashboard with today’s KPIs and live order and picker queues. | Must |
| BE-07 | Console: Orders ListView with filters and an order detail showing per-leg, per-item pick states, spend versus target, and handoff status. | Must |
| BE-08 | Console: Picker management — approval, duty state, jobs, shifts, earnings, prepaid card assignment. | Must |
| BE-09 | Console: Product management — catalog CRUD, per-retailer price and availability, substitution groups, equivalence mapping, unmatched queue. | Must |
| BE-10 | Console: Scrape run log ListView and run detail with full accounting and rejected reasons. | Must |
| BE-11 | Console: Reports — orders by store and suburb, picker performance leaderboard, daily KPI series, CSV export. | Should |
| BE-12 | Console: Settings for fees, delivery windows, service radius, and feature flags. | Should |
| BE-13 | Audit log on every console mutation (who, what, when, before and after). | Must |
| BE-14 | Push notification fan-out to customer and picker devices. | Should |
| BE-15 | Console: Ads management — placement CRUD per slot, creative upload with preview, scheduling, sponsored labeling, pause and end actions, delivery reporting. | Should |