Skip to content

User manual: guided tour for judges, verified against the live app (+ Place order fix) - #23

Merged
jeevanv-exp merged 1 commit into
mainfrom
docs/judge-user-manual
Oct 16, 2026
Merged

jeevanv-exp merged 1 commit into
mainfrom
docs/judge-user-manual

Conversation

@alameen1999

@alameen1999 alameen1999 commented Oct 16, 2026 •

Copy link
Copy Markdown
Collaborator

What this changes

User manual (https://quickbite-5cde0-landing.web.app/manual, already deployed from this branch)

  • Guided tour & scripts (/manual/tour):
    • the dashboard test login with copy buttons and a QR code for the phone;
    • a 5-minute path;
    • Script A (covert call) and Script B (open call, being followed), as When Mia asks / You say / On the dashboard tables using Mia's real lines;
    • step-by-step click & order, delivery instructions and heart SOS.
  • Responder dashboard (/manual/dashboard): annotated Live queue and incident page, the side panel, what each way in shows, and the severity rules.
  • Feature pages corrected against the code, each with an On the responder dashboard box, a Try it link and real screenshots.
  • Code table generated from shared/codes.ts + web/src/data/menu.ts, so it can't drift again (the old table had 5 of 11 meanings wrong). It notes that more coded foods can be added later.
  • The practice (demo) call and the AI-caller links are deliberately not in the manual.

landing/scripts/capture-manual-shots.mjs (npm run shots, adds the puppeteer-core dev dependency)

  • Takes the screenshots and checks the manual's claims against production: all 11 coded-item meanings, the flows, and two full AI-caller calls.
  • Steps that create incidents need --with-incidents; the cleanup step resolves them. All test incidents from this work are resolved.

Fix: web/src/pages/CheckoutPage.tsx

  • On production, Place order lands on the home screen instead of Order placed!, so the order status that follows the responder is never seen.
  • Cause: React Router 7 runs the navigation as a transition, so cart.clear() renders first and checkout's empty-cart redirect wins.
  • One-line fix: don't redirect while an order is being placed, the same guard native already has.
  • Verified on a local build: Order placed!, then Rider assigned → On the way → Delivered following the dashboard.

Needs action

  • Jeevan: please deploy production web after merging. The web env on Ameen's machine lacks the Gemini keys and one Apps Script URL, so it can't deploy safely. The manual already describes the fixed behaviour.
  • Other findings (simulated-GPS calls never connect on production, a few Mia wording issues, dashboard text for paused features) are listed in status/person_b_jeevan.md.

Not included

The deck changes on Ameen's working tree (deck/…_v2.pptx deleted, …_COMPLIANT_DRAFT.pptx added) are left out of this PR.

Summary by CodeRabbit

  • New Features

    • Added a guided tour, responder dashboard guide, and code table to the manual, with screenshots, helpful links, and copyable details.
    • Updated manual navigation and added clearer instructions for key app features.
  • Bug Fixes

    • Fixed checkout redirecting away from the order confirmation screen while an order is being placed.

User manual (covert_call/landing, /manual):
- New "Guided tour & scripts" page: test login with copy buttons, QR code,
  5-minute path, Script A (covert call) and Script B (open call, being
  followed) as "When Mia asks / You say / On the dashboard" tables quoting
  Mia's real lines, plus step-by-step click & order, delivery instructions
  and heart SOS.
- New "Responder dashboard" page: annotated queue and incident page, side
  panel, what each way in shows, severity rules.
- Feature pages corrected against the code, each with an "On the responder
  dashboard" box, a "Try it" link and real screenshots.
- Code table generated from shared/codes.ts and web/src/data/menu.ts (the
  old table had 5 of 11 meanings wrong); notes that more coded foods can be
  added later.
- Practice (demo) call and AI-caller links removed from the manual.

scripts/capture-manual-shots.mjs (npm run shots): takes the screenshots and
checks the manual's claims against production; steps that create incidents
need --with-incidents and are resolved by the cleanup step.

fix(web): Place order showed the home screen instead of "Order placed!".
React Router runs the navigation as a transition, so cart.clear() rendered
first and checkout's empty-cart redirect won. Don't redirect while an order
is being placed (same guard as native). Needs a production web deploy.

README links the guided tour; status file updated.
@coderabbitai

coderabbitai Bot commented Oct 16, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

ℹ️ Recent review info
⚙️ Run configuration
  • Configuration used: defaults
  • Review profile: CHILL
  • Plan: Free
  • Run ID: 3f4c7b4c-8877-4d4b-bd45-35e34126b6d0
📥 Commits

Reviewing files that changed from the base of the PR and between 7a1c57f and 5d98c9e.

⛔ Files ignored due to path filters: 2
  • covert_call/landing/public/shots/manual/qr-quickbite.svg is excluded by !**/*.svg
  • covert_call/package-lock.json is excluded by !**/package-lock.json
📒 Files selected for processing: 27
  • README.md
  • covert_call/landing/package.json
  • covert_call/landing/public/shots/manual/dash-analytics.webp
  • covert_call/landing/public/shots/manual/dash-board.webp
  • covert_call/landing/public/shots/manual/dash-casefile.webp
  • covert_call/landing/public/shots/manual/dash-coded-order.webp
  • covert_call/landing/public/shots/manual/dash-conversation.webp
  • covert_call/landing/public/shots/manual/dash-queue.webp
  • covert_call/landing/public/shots/manual/dash-route.webp
  • covert_call/landing/public/shots/manual/dash-scene.webp
  • covert_call/landing/public/shots/manual/dash-silent-tap.webp
  • covert_call/landing/public/shots/manual/qb-addons.webp
  • covert_call/landing/public/shots/manual/qb-call.webp
  • covert_call/landing/public/shots/manual/qb-checkout.webp
  • covert_call/landing/public/shots/manual/qb-home.webp
  • covert_call/landing/public/shots/manual/qb-instructions-hold.webp
  • covert_call/landing/public/shots/manual/qb-item-meaning.webp
  • covert_call/landing/public/shots/manual/qb-mic-help.webp
  • covert_call/landing/public/shots/manual/qb-order-on-the-way.webp
  • covert_call/landing/public/shots/manual/qb-order-placed.webp
  • covert_call/landing/scripts/capture-manual-shots.mjs
  • covert_call/landing/src/components/Manual.tsx
  • covert_call/landing/src/components/ManualGuides.tsx
  • covert_call/landing/src/components/ManualShot.tsx
  • covert_call/landing/src/styles.css
  • covert_call/web/src/pages/CheckoutPage.tsx
  • status/person_b_jeevan.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

📝 Walkthrough

The landing manual now includes grouped guides, updated feature instructions, code references, and screenshot support. A Puppeteer script captures and checks phone and dashboard flows. The web checkout guard handles an empty cart differently while an order is being placed.

Changes: Manual and checkout updates

Layer / File(s) Summary
Manual navigation and page structure
README.md, covert_call/landing/src/components/Manual.tsx, covert_call/landing/src/styles.css, status/person_b_jeevan.md
The manual adds grouped navigation, page routing, hash-aware scrolling, and compact permission notices. The README links to the guided tour. The status log also records a comparison-table edit.
Guide content and screenshot presentation
covert_call/landing/src/components/Manual.tsx, covert_call/landing/src/components/ManualGuides.tsx, covert_call/landing/src/components/ManualShot.tsx, covert_call/landing/src/styles.css, status/person_b_jeevan.md
The manual adds tour, dashboard, and code-reference pages and revises feature instructions. Screenshot components render versioned images with captions and legends. The status log records content removals and redeployment checks.
Screenshot capture and live checks
covert_call/landing/package.json, covert_call/landing/scripts/capture-manual-shots.mjs, status/person_b_jeevan.md
A new command runs the Puppeteer capture script. The script checks phone and dashboard flows, saves screenshots, and supports optional incident-creating steps and cleanup.
Checkout order-placement transition
covert_call/web/src/pages/CheckoutPage.tsx, status/person_b_jeevan.md
When the cart is empty during order placement, checkout renders nothing instead of redirecting home. The status log records the related navigation issue.

Estimated code review effort: 4 (Complex) | ~45 minutes

Sequence Diagram(s)

sequenceDiagram
  participant CaptureScript
  participant PhoneApp
  participant Dashboard
  participant ScreenshotFiles
  CaptureScript->>PhoneApp: Open manual test steps
  PhoneApp-->>CaptureScript: Return rendered phone states
  CaptureScript->>Dashboard: Sign in and inspect incident states
  Dashboard-->>CaptureScript: Return dashboard states and case evidence
  CaptureScript->>ScreenshotFiles: Save captured images and outputs
Loading
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Note

🎁 Summarized by CodeRabbit Free

Your organization is on the Free plan. CodeRabbit will generate a high-level summary and a walkthrough for each pull request. For a comprehensive line-by-line review, please upgrade your subscription to CodeRabbit Essentials by visiting https://app.coderabbit.ai/settings/billing.

Comment @coderabbitai help to get the list of available commands.

@jeevanv-exp
jeevanv-exp merged commit ddcde7b into main Oct 16, 2026
3 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants