63 KiB
Freshyo full-product validation test plan
Status: proposed — not executed.
Branch: MULTI_REGION_I2 (48 commits ahead of main).
Scope: backend tRPC/API, customer native + web, admin native + web, superadmin web, cache/jobs, and the cross-app order journey.
This is the automation-focused master plan: 311 cases across seven layers.
The exhaustive per-feature edge-case catalog lives in
docs/test-cases/; this file lists the cases that must be
automated and run for release. A test case is a user journey, an API contract, or
a cross-app invariant — not a component render or prop unit test.
For human reproduction of the app-visible cases, use the companion
full-product-validation-manual-testing-guide.md
or its self-contained HTML version.
The manual guide is written for non-technical testers and intentionally excludes
the backend/API, security, database and cache procedures.
1. Goals and boundaries
Must validate
- Every authorization boundary: anonymous, customer, staff A, staff B, superadmin.
- Every money path: cart preview → checkout → persisted order → customer detail → admin detail.
- Region/bound isolation: catalog, prices, stock, slots, orders, staff, caches.
- Global entities (stores/products/coupons) in every region, with independent market data.
- Cache publication: regional vs global regeneration, debounce, versions, bound discovery.
- COD-only checkout and the absence of online-payment routes/UI.
- The operational chain: superadmin setup → admin catalog/slots → customer order → admin fulfillment → customer status.
- Recovery: expired sessions, stale caches, offline, retries, double submits, failed mutations.
Explicitly out of scope
- Component-level unit tests, prop tests, renderer snapshots, and pure-helper tests (the shared pricing helpers are validated through API/UI money cases).
- Styling, animation, icon, and layout snapshots.
- Third-party internals (Expo, Cloudflare, D1, KV, R2, Maestro/Playwright drivers).
- Live SMS/OTP, real push broadcasts, real object-storage deletes outside staging, and online payment gateways.
- Drizzle migrations. Never run migrations as test setup. The user applies them.
- Production mutation tests. All mutation/notification cases use staging only.
apps/info-siteis a static marketing site: manual link/uptime smoke only, not part of this suite.
Definition of a valid case
A case passes only when the observable result is confirmed from the authoritative surface, not from a toast:
- Money:
goods − stored discount + delivery = payable, per sub-order and in total. - Cache: DB value, served version and elapsed time all agree within the deadline.
- Mutations: the intended rows exist and no unintended rows/assets changed.
- Rejections: correct 4xx contract and no partial writes.
- UI: the expected screen was actually open; a success toast alone is not evidence.
2. Automation layers
| Layer | Tool | What is real | Network | Location |
|---|---|---|---|---|
| L1 Backend API | Jest + ts-jest + tRPC HTTP client |
Backend worker, D1/KV/R2/DO | Real local HTTP | apps/backend/tests/api/ |
| L2 Customer UI | Jest + jest-expo + React Native Testing Library |
Screen, router, providers, stores, storage | Mocked tRPC/axios boundary | apps/user-ui/tests/flows/ |
| L3 Admin UI | Jest + jest-expo + RNTL |
Screen, router, providers, stores | Mocked tRPC/axios boundary | apps/admin-ui/tests/flows/ |
| L4 Customer web | Jest + jsdom + React Testing Library | Route, router, providers, localStorage | Mocked tRPC link | apps/web-ui/tests/flows/ |
| L5 Admin web | Jest + jsdom + React Testing Library | Route, router, providers, localStorage | Mocked tRPC link | apps/admin-web/tests/flows/ |
| L6 Superadmin | Vitest + jsdom + React Testing Library (already configured; the same cases run under Jest if the repo standardizes) | Route, router, providers | Mocked tRPC link | apps/superadmin-ui/src/**/*.test.tsx |
| L7 Cross-app E2E | Maestro (native) + Playwright (web) | Real backend, DB, cache, storage | Real | tests/e2e/, tests/e2e-web/ |
Rules for L2–L6:
- Mount the route/screen, not an isolated component.
- Exercise real navigation, state stores, query invalidation and persisted storage.
- Mock only the network boundary; keep the app's validation, guards and rendering real.
- Prefer
testID/ accessible roles over text that changes with copy. - One test = one user-visible outcome, not one assertion per element.
- No shallow rendering, no component prop matrices, no snapshots.
Rules for L1:
- Talk to a running backend over HTTP, exactly like the apps.
- Create fixtures through the API; add a sanctioned fixture/reset path only if API setup becomes too slow.
- Tests share data; run serially and use unique name/mobile prefixes.
- Never point a mutation test at production.
Rules for L7:
- Only the critical journeys below. Do not re-implement the full API suite in E2E.
- Native: Maestro flows with stable IDs; Web: Playwright Chromium.
- A coordinator carries region/product/SKU/slot/order IDs between apps.
- Assert persisted state through the UI plus one authoritative API read.
3. Environment and fixtures
Environment
- Isolated staging backend with its own D1/KV/R2/queue/DO namespace and object store.
- Local commands (for the future test harness; do not run while authoring):
- backend:
cd apps/backend && bun run dev(wrangler dev on:8787) - backend suite:
cd apps/backend && bun run test:api - native suites:
cd apps/user-ui && bun run test,cd apps/admin-ui && bun run test - web suites: add
bun testscripts toapps/web-ui,apps/admin-web,apps/superadmin-ui - E2E:
tests/e2e/run.sh(Maestro) andnpx playwright test(web)
- backend:
- Web/native unit suites must point at the same staging API version as the backend suite.
Shared fixtures
| Fixture | Required setup |
|---|---|
| Regions | A and B. A has bounds A1/A2 (priority 1/2, different fees); B has B1. Include interior, edge, overlap and outside points. |
| Identities | anonymous, U1 (addresses in A1/A2), U2 (B1), U0 (new, zero addresses), suspended user, staff A, staff B, superadmin. |
| Catalog | A-only product P with two SKUs; B-only Q; global G with independent A/B market rows; regular-only R; flash F; combo C with combo-only component K; deleted/OOS/suspended variants. |
| Stores | regional store A, regional store B, global store GS. |
| Slots | future S1/S2 in A, B slot; inactive, frozen, full, past and midnight-boundary slots. |
| Money | per-bound free-delivery threshold T and fee D; flash threshold/fee; T−0.01/T/T+0.01. |
| Coupons | regional A/B, global, percent, flat, targeted, whole-cart, capped, min-spend, exclusive, first-order, limited-use, personal, expired, invalidated, reserved. |
| Orders | pending COD, packaged, verified, delivered, cancelled, multi-slot group, flash, historical product-deleted. |
| Content | tags, groups, banners, upload assets, complaints, notifications, vendor snippets (conditional). |
| Notifications | sandbox queue and approved test recipients only. |
Data rules
- Unique run prefix for every created name/mobile/email/code.
- Never delete a region; neutralize throwaway regions by renaming/shrinking instead.
- Bounds are deletable only when the region has another bound and no addresses reference them.
- Product deletion is soft; order history must keep the original name and amount.
- Clean up only approved disposable rows/assets; keep failing fixtures for diagnosis.
- Record region/bound IDs, product/SKU IDs, slot IDs and order IDs in the run report.
4. Priorities and release gates
| Priority | Meaning | Gate |
|---|---|---|
| P0 | Authorization, money integrity, core purchasing, region isolation, data loss | Every P0 must pass before any release. |
| P1 | Normal feature behaviour, important edge cases, parity | Every P1 must pass or be explicitly waived. |
| P2 | Resilience, presentation, conditional/legacy coverage | Run before major releases; document N/A reasons. |
Release gate:
typecheckclean for touched apps/packages.- All P0 backend + frontend cases pass on the release candidate.
- All P1 cases pass or have a signed waiver.
- E2E critical journeys pass against staging.
- No P0/P1 open defect without a documented workaround.
5. Current-branch delta → required coverage
The branch changes are concentrated in multi-region support, global entities, bound-based discovery/pricing, cache publication and the COD-only conversion. Each change below has dedicated cases in §7.
| # | Change / fixed defect | Regression cases |
|---|---|---|
| 1 | Admin customer search must be region-scoped (or() grouping) |
BR-01, BE-ADMIN-15 |
| 2 | Web discovery must request essentialConsts({ boundId }) |
BR-02, CUST-01 |
| 3 | Global-product edit must preserve SKU IDs | BR-03, BE-SA-09 |
| 4 | Regional edit of a global store must not delete its image | BR-04, BE-ADMIN-08 |
| 5 | Global cache request must not be narrowed by a regional request | BR-05, BE-CACHE-04 |
| 6 | Web scheduled checkout must send each line's slot ID | BR-06, CUST-41 |
| 7 | New-region cache generation must be awaited | BR-07, BE-SA-05 |
| 8 | Global-product edit form must reset between create/edit | BR-08, SA-12 |
| 9 | Regional order list must paginate its own rows, not a global ID window | BR-09, BE-ORDER-23, ADM-06 |
| 10 | Startup region adoption must not wipe a persisted cart | BR-10 (known open) |
| 11 | Unrelated market edits must preserve regional suspension | BR-11, BE-ADMIN-05 |
| 12 | Coupon allocation must never make a sub-order negative | BR-12, CUST-33, BE-COUP-15 |
| 13 | Historical discount_amount backfill |
BR-13 (accepted limitation) |
| 14 | Switching a global coupon from percent to flat must clear percent | BR-14 (known open) |
| 15 | Admin-web reload must restore staff identity/region | BR-15, ADM-01, ADM-32 |
| 16 | Superadmin "Admin Notifs" must use a superadmin-guarded endpoint | BR-16, SA-18 |
| 17 | COD-only conversion (no online-payment routes/UI) | BR-17, BE-ORDER-01, CUST-42 |
| 18 | Per-slot web checkout validation (slotId non-null for scheduled) |
BR-18, BE-ORDER-08 |
| 19 | Bound-based pricing from the address, not the client region | BR-19, BE-ORDER-11, CUST-39 |
| 20 | Search/order pagination keyset stability | BR-20, BE-ORDER-23 |
6. Master case inventory
6.1 Backend API (L1)
Common discovery, regions and bounds
| ID | P | Case | Expected |
|---|---|---|---|
| BE-COM-01 | P0 | GET /api/health and common.healthCheck. |
200/ok; no secrets. |
| BE-COM-02 | P0 | common.listRegions as anonymous. |
Regions with public discovery metadata only; no staff/account data. |
| BE-COM-03 | P0 | resolveRegionByLocation for A1, A2, B1, overlap, polygon edge. |
Correct region/bound; priority wins on overlap; edge follows documented rule. |
| BE-COM-04 | P0 | resolveRegionByLocation outside every polygon and invalid coordinates. |
Outside → null; invalid → 400. |
| BE-COM-05 | P0 | resolveBound for a valid A point, an outside-A point, and a B point with regionId=A. |
A point → A bound; outside/foreign → 422; no cross-region fallback. |
| BE-COM-06 | P1 | activeBound signed-out, U1 with A1/A2, U1 with B-only addresses, U0 with none. |
Signed-out → effective bound; U1 → lowest-priority A bound; B addresses ignored; U0 → effective bound. |
| BE-COM-07 | P1 | regionSettings for A; region with no bounds; unknown region. |
Effective bound settings; 422 for no bounds; 422/404 for unknown. |
| BE-COM-08 | P0 | essentialConsts with boundId, missing boundId, unknown boundId. |
Merged global/region/bound payload for the bound; validation error when missing; 404 unknown. |
| BE-COM-09 | P2 | essentialConsts on a raw/mf host. |
Stale-client notice fields present and non-closable; normal hosts omit it. |
| BE-COM-10 | P1 | checkLocationInPolygon inside/outside/invalid. |
Boolean for valid points; validation error for invalid. |
| BE-COM-11 | P0 | getStoresSummary as staff A, staff B, customer. |
Staff A only A stores; staff B only B; customer denied. |
Customer authentication and profile
| ID | P | Case | Expected |
|---|---|---|---|
| BE-AUTH-01 | P0 | Register a new customer, then log in by mobile and by email. | One user row; both identifiers authenticate; token works. |
| BE-AUTH-02 | P0 | Duplicate mobile, duplicate email, malformed mobile/email, weak password. | Rejected; no partial user/credential rows. |
| BE-AUTH-03 | P1 | Login with wrong password/unknown identifier and retry correctly. | Rejected then succeeds; no session from the failure. |
| BE-AUTH-04 | P0 | Expired, tampered and malformed JWT on a protected query. | 401; no fallback identity/region. |
| BE-AUTH-05 | P1 | getSelfData, updateProfile, avatar change, relaunch/read-back. |
Values persist; no other user's data. |
| BE-AUTH-06 | P1 | updatePassword with wrong old password, then correct; login old/new. |
Wrong rejected; new works; old fails. |
| BE-AUTH-07 | P1 | deleteAccount with wrong confirmation, then correct. |
Wrong rejected; correct deletes/revokes access. |
| BE-AUTH-08 | P0 | Suspended customer places an order with an existing token; unsuspend; retry. | Blocked while suspended; allowed after unsuspend. |
| BE-AUTH-09 | P0 | User token calls admin/superadmin mutations; staff token calls user/superadmin. | Denied at the procedure; no writes. |
| BE-AUTH-10 | P0 | Two customers U1/U2 probe each other's profile/address/order/coupon IDs. | Ownership enforced on every surface. |
| BE-AUTH-11 | P0 | Customer with zero addresses attempts to place an order. | Rejected with a meaningful address error; no order. |
Addresses and region/bound attachment
| ID | P | Case | Expected |
|---|---|---|---|
| BE-ADDR-01 | P0 | Create an address with coordinates inside A1 and inside A2. | Correct region + derived bound; coordinates stored. |
| BE-ADDR-02 | P0 | Create with coordinates outside every A bound. | 422; no address row. |
| BE-ADDR-03 | P1 | Create without coordinates (legacy web) and with a Google Maps URL. | Fallback to region effective bound; URL coords parsed when present. |
| BE-ADDR-04 | P1 | Invalid phone (9 digits, starts 5), missing name/line/city/state. | Validation errors; no row. |
| BE-ADDR-05 | P1 | First address, then second address with isDefault=false, then set it default. |
First is default; setting default unsets the previous one. |
| BE-ADDR-06 | P0 | Update another user's address ID. | Not found/forbidden; no change. |
| BE-ADDR-07 | P1 | Update coordinates from A1 to A2; update region to B with B coordinates. | Bound re-derived; region/bound/address consistent. |
| BE-ADDR-08 | P1 | Delete an address used by an ongoing order vs a free address. | Ongoing-order address refused; free address deleted. |
| BE-ADDR-09 | P1 | Delete the default address while another exists; delete the last address. | Default policy remains coherent; address gate appears for zero addresses. |
| BE-ADDR-10 | P1 | Create/update address and inspect user_regions and notification credentials. |
Association inserted/reconciled; token region follows the address region. |
| BE-ADDR-11 | P0 | Cart/checkout and order use an address whose coordinates are in B while browsing A. | Order is scoped/priced by the address's B region/bound; browsing region unchanged. |
| BE-ADDR-12 | P1 | getDefaultAddress / getUserAddresses for U1 and U2. |
Only the caller's addresses; default flag correct. |
Catalog, stores, search, combos and slots
| ID | P | Case | Expected |
|---|---|---|---|
| BE-CAT-01 | P0 | Read A catalog containing A-only P, B-only Q and global G. | P and G only; Q absent; G uses A market data. |
| BE-CAT-02 | P0 | Read B catalog for the same fixture. | Q and G only; P absent; G uses B market data. |
| BE-CAT-03 | P1 | Product detail for P, Q, G in A and B. | Correct region/market price, flags and variants; foreign product not purchasable. |
| BE-CAT-04 | P1 | Search by name/tag/store in A. | Only A + global matches; no B results; case/whitespace behaviour documented. |
| BE-CAT-05 | P1 | Product list with deleted, OOS, globally suspended and regionally suspended SKUs. | Deleted hidden; OOS/suspended flags correct; no orderable invalid SKU. |
| BE-CAT-06 | P1 | Stores list/detail in A and B, including global store GS. | Regional isolation; GS visible in both; product counts/assets coherent. |
| BE-CAT-07 | P1 | Banners and tags in A/B. | Region-correct order/visibility; no foreign content. |
| BE-CAT-08 | P0 | getSlots without regionId, for A, for B. |
Missing → validation error; A/B return only future active slots for that region. |
| BE-CAT-09 | P1 | Slots that are full, frozen, past, inactive. | Excluded from customer lists; capacity/status correct. |
| BE-CAT-10 | P1 | Slot membership: SKU not assigned to a slot. | Not orderable into that slot; checkout rejects. |
| BE-CAT-11 | P1 | Combo C with component K; K unavailable/out of stock. | Combo composition/pricing correct; unavailable component prevents purchase. |
| BE-CAT-12 | P0 | Flash product F in A (enabled) and B (disabled). | Flash list/price only where enabled; disabled region cannot order. |
| BE-CAT-13 | P1 | Global product with different A/B market prices and suspension. | Each region sees its own price/stock/suspension only. |
| BE-CAT-14 | P1 | Product tags/group ordering and popular-items ordering. | Order matches admin configuration; region-scoped. |
| BE-CAT-15 | P2 | Empty region with no stores/products/slots. | Intentional empty payloads; no crash or cross-region fallback. |
| BE-CAT-16 | P0 | Catalog response inspection. | No customer/staff private data, addresses, tokens or internal notes. |
Coupons and pricing
| ID | P | Case | Expected |
|---|---|---|---|
| BE-COUP-01 | P0 | Eligible coupon list for U1 in A with regional/global/personal/expired/invalidated/used-up coupons. | Only visible eligible-or-disabled candidates; expired/invalidated/used-up/other-user hidden. |
| BE-COUP-02 | P0 | Apply a regional A coupon while ordering in B. | Rejected; no usage recorded. |
| BE-COUP-03 | P0 | First-order-only coupon for U0 and for U1 with an order. | U0 accepted; U1 rejected with the documented message. |
| BE-COUP-04 | P0 | minOrder below, equal and above the eligible subtotal. |
Below rejected; equal accepted; reason uses the eligible subtotal. |
| BE-COUP-05 | P0 | Targeted coupon whose SKUs are present, partially present and absent. | Discount only on targets; absent → no-applicable-items error. |
| BE-COUP-06 | P0 | Coupon at the per-user usage limit and one below it. | Limit enforced; one-time usage recorded. |
| BE-COUP-07 | P0 | Exclusive coupon combined with another coupon. | Combination rejected; exclusive alone works. |
| BE-COUP-08 | P0 | Stack 10% then ₹100 on ₹1000; reverse order. | 200 (800 payable) vs 190 (810 payable); order-sensitive result. |
| BE-COUP-09 | P0 | 15% on ₹999; 12.5% on ₹1000; exact .5 rounding. |
Discounts round to nearest rupee consistently client/server. |
| BE-COUP-10 | P1 | Percentage with maxValue after a prior coupon; flat above remaining. |
Cap applies to its own reduced base; discount clamped to remaining. |
| BE-COUP-11 | P0 | 100% and 150% coupons. | Goods never below zero; delivery may remain; no negative totals. |
| BE-COUP-12 | P0 | Delivery with a coupon that crosses the free-delivery threshold. | Coupon base excludes delivery; fee uses the defined post-discount goods subtotal. |
| BE-COUP-13 | P1 | Targeted + whole-cart coupons across two slots. | Per-sub-order discounts sum exactly; no unrelated goods discounted. |
| BE-COUP-14 | P0 | Coupon usage persists once per order group; cancellation restores it. | Usage row/one-time invariants correct; cancel frees usage when no sibling remains. |
| BE-COUP-15 | P0 | ₹101 sub-order ×2 with two ₹101 stackable coupons. | Per-sub-order discounts ≤ goods; totals never negative; exact reconciliation. |
| BE-COUP-16 | P1 | Coupon invalidated/deleted after being selected but before submit. | Submit rejects; no silently discounted order. |
| BE-COUP-17 | P1 | Global coupon authored by superadmin used in A and B. | Applies in both; regional coupon does not leak. |
| BE-COUP-18 | P1 | Global coupon switched from 20% to ₹50 in the superadmin form. | Percentage is cleared; pricing uses ₹50 only (BR-14, known open). |
Orders, cancellation and fulfillment
| ID | P | Case | Expected |
|---|---|---|---|
| BE-ORDER-01 | P0 | Valid scheduled COD order with address, slot, notes and coupon. | Correct rows/SKUs/qty/region/amount; COD only; no payment-gateway fields. |
| BE-ORDER-02 | P0 | Items assigned to S1 and S2 in one checkout. | One sub-order per slot in one group; one delivery fee on the primary; totals sum. |
| BE-ORDER-03 | P0 | Persisted order read back by customer and admin. | Same items, discount, delivery, total, region and status on both surfaces. |
| BE-ORDER-04 | P0 | Empty items, unknown SKU, invalid/negative/fractional quantity, duplicate lines. | No empty/invalid order; quantity/duplicate policy enforced. |
| BE-ORDER-05 | P0 | Foreign-region SKU, slot or address-bound pairing. | Rejected; no cross-region order or fee manipulation. |
| BE-ORDER-06 | P0 | Deleted, OOS, globally suspended and regionally suspended SKU. | Rejected server-side even with a stale client payload. |
| BE-ORDER-07 | P0 | Full, frozen, past, inactive or wrong-region slot. | Rejected with the appropriate 4xx; no order. |
| BE-ORDER-08 | P0 | Scheduled order with slotId: null (the old web bug). |
Rejected with "slot required"; valid per-line slot IDs succeed. |
| BE-ORDER-09 | P0 | Slot does not carry one of the ordered SKUs. | Rejected; no partial order. |
| BE-ORDER-10 | P0 | Address coordinates in B while the client sends regionId=A. |
Server derives B from coordinates; B pricing/slot/region used. |
| BE-ORDER-11 | P0 | Bound A1 vs A2 selected address with different fee/threshold. | Address bound drives the fee/threshold; client bound is ignored. |
| BE-ORDER-12 | P0 | Coupon becomes ineligible between selection and submit. | Server revalidates; rejection or documented repricing; no false success. |
| BE-ORDER-13 | P1 | User notes and admin notes round-trip. | Persisted and visible on the correct surfaces. |
| BE-ORDER-14 | P0 | Flash order with a flash price and null slot. | Flash price/flag/fee; no scheduled slot; admin sees flash order. |
| BE-ORDER-15 | P0 | Flash disabled in the address bound but enabled in the browsing region. | Rejected server-side. |
| BE-ORDER-16 | P1 | Rapid double tap / duplicate in-app submit. | One in-app request; no duplicate order. |
| BE-ORDER-17 | P1 | Raw concurrent API submits (characterization). | Record whether two orders are created; known lack of server idempotency is explicit. |
| BE-ORDER-18 | P1 | Historical order after product/variant/store soft delete. | History keeps original name, quantity and charged amount. |
| BE-ORDER-19 | P1 | Customer order list pagination and order detail by numeric ID. | Stable order; no duplicates/skips; readable ID rejected if not supported. |
| BE-ORDER-20 | P0 | U2 reads/cancels/notes U1's order; staff B reads A's order. | Denied; no private payload. |
| BE-ORDER-21 | P0 | Cancel with reason, without reason, by user and by staff. | Reason required; actor/status correct; coupon usage restoration correct. |
| BE-ORDER-22 | P1 | Cancel a delivered order; deliver a cancelled order; revert delivered. | Customer cancellation of a delivered order is rejected; staff transitions follow the approved policy. Current gaps (cancelled→delivered, delivered→undelivered) are pinned until the policy changes. |
| BE-ORDER-23 | P0 | Quiet region A with old orders while B creates many newer orders; page A. | A returns all its rows and a valid cursor; no global-ID window starvation. |
| BE-ORDER-24 | P1 | Admin marks packaged/verified/delivered; customer detail reflects it. | Status and timestamps agree; no partial item/order state. |
| BE-ORDER-25 | P1 | Admin removes the delivery charge; rebalances slots/items. | Totals reconcile; historic discount preserved; no duplicate fee. |
| BE-ORDER-26 | P1 | Admin delivery sequence for a slot and coordinate override. | Sequence/order correct; coordinates update the intended order only. |
| BE-ORDER-27 | P2 | Order-detail money after migration/backfill. | New orders store discount; historical rows may show 0 (accepted; see BR-13). |
Admin API and isolation
| ID | P | Case | Expected |
|---|---|---|---|
| BE-ADMIN-01 | P0 | Staff A/B login, me, region-scoped dashboard. |
Correct staff/region; no cross-region counters. |
| BE-ADMIN-02 | P0 | Staff B reads/writes A product, store, slot, tag, group, banner, coupon IDs. | Denied/not found; no writes. |
| BE-ADMIN-03 | P0 | Regional product CRUD and customer publication. | Created/updated product visible in A only; B unchanged. |
| BE-ADMIN-04 | P0 | Regional edit of a global product: price, stock, flash, suspension. | Only market rows for A change; global structure and B market untouched. |
| BE-ADMIN-05 | P0 | Suspend a global SKU in A, reopen/edit an unrelated price, save. | Suspension remains in A; B unaffected (BR-11). |
| BE-ADMIN-06 | P0 | Regional admin edits a global SKU's market data; superadmin edits the structure. | Existing SKU IDs preserved; no duplicate variants; market scope is A only. |
| BE-ADMIN-07 | P0 | Regional staff edits a global store. | Rejected; regional write never mutates global store data. |
| BE-ADMIN-08 | P0 | Failed regional edit of a global store with an old image. | Image is not deleted; object storage unchanged (BR-04). |
| BE-ADMIN-09 | P0 | Delete a product/store with dependent rows; delete a free one. | Protected deletes rejected; free deletes soft-delete/hide correctly. |
| BE-ADMIN-10 | P1 | Product SKU create/edit/delete, features, images, tags, groups, combos. | Correct relations; no orphan rows; duplicate SKU IDs not created. |
| BE-ADMIN-11 | P1 | Banner CRUD and active/order state; customer sees only active A banners. | Regional isolation and ordering. |
| BE-ADMIN-12 | P1 | Regional coupon CRUD, targeting, user targeting, invalidation. | Region/targets enforced; invalid coupon rejected for use. |
| BE-ADMIN-13 | P1 | Slot CRUD, SKU assignment, capacity, freeze/edit. | Customer discovery/checkout reflects changes; full slots disabled. |
| BE-ADMIN-14 | P1 | Product tags/groups/customize-app ordering in A. | Persisted order and popular/all-items output. |
| BE-ADMIN-15 | P0 | Search customers by name/mobile in A; same search in B. | Only customers with A/B orders respectively; no cross-region mobile leakage (BR-01). |
| BE-ADMIN-16 | P1 | Customer detail, order history, suspension/unsuspension, incidents. | Region-scoped; suspension blocks ordering; incident audit correct. |
| BE-ADMIN-17 | P0 | sendAdminNotification as staff, customer, anonymous. |
Staff allowed; customer/anonymous denied; no queue write on denial. |
| BE-ADMIN-18 | P1 | Vendor snippet CRUD, order/slot reads, packaging (conditional). | Scoped to staff region; unauthorized IDs denied. |
| BE-ADMIN-19 | P1 | Complaints list/reply/resolve in A; B complaint invisible. | Region isolation; customer sees the reply. |
| BE-ADMIN-20 | P1 | Region constants edit and propagation to A bounds. | A customer discovery/pricing changes; B unchanged. |
| BE-ADMIN-21 | P0 | getStaff, createStaffUser, getRoles, savePushToken as customer. |
Denied (protectedProcedure is not a staff guard — regression check). |
| BE-ADMIN-22 | P1 | Image upload URL generation and object round-trip. | Authorized contexts only; stored bytes match; no arbitrary-key delete. |
Superadmin API
| ID | P | Case | Expected |
|---|---|---|---|
| BE-SA-01 | P0 | Superadmin login/me; direct protected route access. | Correct principal; no staff/customer escalation. |
| BE-SA-02 | P0 | Staff/customer/anonymous calls every superadmin mutation. | Denied before DB/job writes. |
| BE-SA-03 | P0 | Region list/create/update; duplicate name/invalid bounds. | Valid region; clear conflict; no orphan rows. |
| BE-SA-04 | P1 | Bound create/update/delete: last bound, referenced bound, valid bound. | Last/referenced refused; valid delete succeeds. |
| BE-SA-05 | P0 | Create a region with global products present; inspect cache files. | Per-region market rows seeded; cache generation awaited and files exist (BR-07). |
| BE-SA-06 | P1 | Staff list/create/update/remove/roles and region assignment. | Region/role changes effective on next auth; removed staff denied. |
| BE-SA-07 | P1 | Global store CRUD and customer visibility in all regions. | Shared store visible; regional admin cannot edit it. |
| BE-SA-08 | P0 | Global product create/edit/delete with two SKUs. | Per-region market rows; customer sees it in A/B. |
| BE-SA-09 | P0 | Edit an existing global product's SKUs and save. | IDs preserved; no duplicate variants; suspension state coherent (BR-03). |
| BE-SA-10 | P1 | Elevate a regional product to global. | Region becomes null; market rows exist; former region keeps selling. |
| BE-SA-11 | P0 | Global product suspension/market edits. | Global structural suspension applies where intended; regional overrides independent. |
| BE-SA-12 | P1 | Global coupon create/edit/delete with percent, flat, targets, users. | Valid coupon; one discount type; superadmin-only. |
| BE-SA-13 | P1 | Global constants edit; customer discovery in A/B. | Global values propagate; regional/bound overrides win. |
| BE-SA-14 | P1 | Superadmin complaints list/reply. | Cross-region visibility per policy; no customer-private leakage beyond scope. |
| BE-SA-15 | P0 | superadmin.staff.sendAdminNotification as superadmin/staff/customer. |
Superadmin allowed; staff/customer denied; queue write only on success (BR-16). |
| BE-SA-16 | P1 | Region cache files after create/update; served version matches. | Files exist for the new region; no undefined/version-0 paths. |
| BE-SA-17 | P1 | Staff role/permission checks for global authoring. | Only intended roles can author; server-side enforcement. |
| BE-SA-18 | P2 | Region rename/priority changes while customers browse. | IDs stable; discovery refreshes within deadline; no data moves. |
Cache, jobs and health
| ID | P | Case | Expected |
|---|---|---|---|
| BE-CACHE-01 | P0 | Regional product/store/tag/banner change in A. | A cache files/version advance; B unchanged. |
| BE-CACHE-02 | P0 | Price/stock/offer/suspension edit in A. | Availability version/data correct; no stale orderable SKU. |
| BE-CACHE-03 | P0 | Slot create/update/full/freeze. | Slots/next-delivery/cart choices converge within 120s. |
| BE-CACHE-04 | P0 | Global change followed by a regional change in the debounce window. | All regions regenerate; regional request cannot narrow (BR-05). |
| BE-CACHE-05 | P1 | Rapid A/B edits in the same window. | Both pending regions publish; final write not lost. |
| BE-CACHE-06 | P1 | Several same-region writes while generation is running. | Final snapshot is current; no stale final write. |
| BE-CACHE-07 | P1 | Missing/corrupt discovery KV for a bound. | Rebuilt for the correct bound; no foreign fallback. |
| BE-CACHE-08 | P0 | Products file ready, availability old/missing/wrong region. | No unsafe zero-price/in-stock or mixed-region purchasable catalog. |
| BE-CACHE-09 | P1 | Object-storage failure during generation. | Failure recorded; version not falsely complete; retry/repair coherent. |
| BE-CACHE-10 | P1 | Fresh vs already-open client after publication. | Both converge; no restart/storage-clear requirement. |
| BE-CACHE-11 | P1 | Product soft-deleted while generation pending. | Live surfaces omit it; order history unaffected. |
| BE-CACHE-12 | P1 | Cache consistency: every availability entry maps to a product; slot products exist; store counts match. | All cross-file references valid. |
| BE-JOB-01 | P1 | Store initializer/startup and flash schedule job in an isolated scheduler. | Stores ready; flash enablement boundaries correct; no production cron touched. |
| BE-JOB-02 | P1 | Queue/notification job failure after order commit. | Order remains; job retryable; no duplicate order. |
| BE-JOB-03 | P1 | Health check with DB/KV/storage failures. | Explicit degraded status, not false healthy. |
| BE-UPL-01 | P1 | Upload URL contexts: review, product, store, complaint, profile, tags, notification. | Correct folder/key and MIME; no arbitrary path. |
| BE-UPL-02 | P0 | Unauthorized upload URL request. | Denied; no signed URL returned. |
| BE-UPL-03 | P2 | Unsupported MIME/context and oversized payload. | Validation error; no object written. |
6.2 Customer frontend flows (L2 native + L4 web)
Run each case on both user-ui and web-ui unless a platform note says otherwise.
The expected outcome must match; platform-specific mechanics are noted.
Startup, location and region
| ID | P | Case | Expected |
|---|---|---|---|
| CUST-01 | P0 | Cold start with GPS inside A; signed out, then signed in. | A resolves once; discovery/catalog/slots load; no bound/version errors. Web: saved region is validated against listRegions. |
| CUST-02 | P0 | GPS denied, off, outside service and timed out; with and without a default address. | Default address used when available; otherwise a usable manual chooser with the correct reason; no eternal spinner. |
| CUST-03 | P0 | Late GPS response after manually choosing B. | Manual choice wins; late response cannot overwrite it. |
| CUST-04 | P1 | Signed-in U1 with addresses in A1/A2; remove one; select an address. | Active bound is the lowest-priority A address bound; B addresses ignored; checkout uses selected address bound. |
| CUST-05 | P0 | Explicit region switch A→B: cancel, then confirm. | Cancel preserves region/carts; confirm clears A selections and loads B. |
| CUST-06 | P1 | Switch A→B→A with populated regular and flash carts. | Each region's cart is restored independently; no cross-region lines/prices. |
| CUST-07 | P1 | Cold-start adoption of the first region with a populated local cart. | Cart is preserved (known open if it is wiped — BR-10). |
| CUST-08 | P2 | Empty region and region with no slots. | Intentional empty states; no crash or fallback to another region. |
Authentication and account
| ID | P | Case | Expected |
|---|---|---|---|
| CUST-09 | P0 | Browse signed out, open Cart and Me. | Public browsing works; login walls shown without breaking other tabs. |
| CUST-10 | P0 | Log in from the cart wall, then from the Me wall; register a new account. | Returns to the originating screen; cart survives login; validation errors are clear. |
| CUST-11 | P0 | Wrong password/unknown identifier, then correct; logout and sign in as U2. | No session on failure; U2 cannot see U1 data; logout restores walls. |
| CUST-12 | P1 | Session restore after relaunch; expired token during a request. | Valid session restores; expiry forces re-login safely, preserving allowed state. |
| CUST-13 | P1 | Edit profile and avatar; relaunch; check admin customer detail. | Saved values/images agree. |
| CUST-14 | P1 | Change password, sign out, old vs new password. | New works; old fails; account data intact. |
| CUST-15 | P1 | Delete account with wrong/correct confirmation. | Wrong rejected; correct logs out and revokes access. |
| CUST-16 | P0 | Suspended customer tries to order; admin unsuspends; retry. | Blocked then allowed; no misleading success. |
Home, search, stores and product detail
| ID | P | Case | Expected |
|---|---|---|---|
| CUST-17 | P0 | Home in A vs B with regional/global products, tags, banners, stores and slots. | Only correct region + global content; no cross-region prices/assets. |
| CUST-18 | P1 | Empty/loading/error/refresh states on Home; pull-to-refresh. | Meaningful states; retry works; no duplicate/stale content. |
| CUST-19 | P1 | Search by product name/tag/store; no results. | Correct results for the region; clear empty state. |
| CUST-20 | P1 | Stores list and store detail; global store in both regions. | Correct products/counts; global store visible; no foreign store. |
| CUST-21 | P0 | Product detail P, Q, G, combo C, flash F. | Correct price/variants/stock/flags/composition; foreign product not reachable. |
| CUST-22 | P1 | Add to cart from Home, search, store, product detail, order-again. | Same SKU/quantity/price on every entry point. |
| CUST-23 | P1 | Variant/quantity dialog: minimum, increments, maximum, OOS. | Allowed quantities enforced; OOS cannot be added. |
| CUST-24 | P1 | Offers/tags/banners deep link to the intended product/store. | Correct destination; no broken/foreign target. |
| CUST-25 | P2 | Location bar / address switcher opening and closing. | Current location/address shown; selection updates the active bound. |
Cart and coupons
| ID | P | Case | Expected |
|---|---|---|---|
| CUST-26 | P0 | Add, re-add, update quantity, remove, cancel removal. | Merge vs set-quantity semantics correct; only the selected line changes. |
| CUST-27 | P0 | Populated cart cold start; regular and flash carts separately. | Both restore independently; no silent deletion or cross-cart leak. |
| CUST-28 | P1 | Assign/change slots; leave/re-enter/relaunch. | Selection persists per policy; no quantity duplication. |
| CUST-29 | P0 | One line becomes OOS/suspended/deleted; all lines invalid. | Invalid lines excluded from pricing/submit; all-invalid checkout blocked. |
| CUST-30 | P1 | Notes entered, checkout, back, edit; latest note submitted. | Latest value survives and is persisted. |
| CUST-31 | P0 | Coupon dropdown: eligible, wrong region, first-order-used, min-order short, no targets, expired, invalidated, used-up, personal. | Eligible first; disabled rows show the exact reason; hidden coupons never appear. |
| CUST-32 | P0 | Apply/remove stacked coupons; change quantities. | Marginal savings and totals recompute; no stale invalid discount. |
| CUST-33 | P0 | 10% then ₹100 vs ₹100 then 10%; 15% rounding; 100%+ coupon. | Order-sensitive totals; nearest-rupee rounding; no negative preview. |
| CUST-34 | P1 | "Products discount" row shown/hidden at >₹1 vs ≤₹1; coupons separate. | Correct label/visibility; bill lines sum to total. |
| CUST-35 | P0 | Checkout guard: item without slot, selected slot no longer offered, freeze passed, valid slots, flash cart. | Button disabled with the correct message for scheduled; flash exempt; recovery re-enables. |
| CUST-36 | P0 | Cart preview vs checkout vs persisted order totals. | All three agree: goods − discount + delivery = payable. |
| CUST-37 | P1 | Corrupt storage, storage full, slow price refresh. | Recoverable state; no phantom/zero-priced purchase; coherent loading. |
| CUST-38 | P1 | Logout/login U2 with U1's cart; account switch. | Agreed cart-retention policy; no U1 address/coupon/notes leakage. |
Checkout and order placement
| ID | P | Case | Expected |
|---|---|---|---|
| CUST-39 | P0 | Checkout with an address in A1 vs A2 vs B; inspect fee/threshold. | Selected address's bound/region drives pricing; browsing region does not override. |
| CUST-40 | P0 | Customer with zero addresses opens cart/checkout. | First-address gate appears before cart, even when empty; after saving, cart renders. |
| CUST-41 | P0 | Scheduled checkout with items assigned to S1/S2. | Each submitted line carries its own slot ID; no null scheduled slot (BR-06). |
| CUST-42 | P0 | Valid COD checkout; inspect payment UI. | COD succeeds; online option is disabled "coming soon"; no gateway invocation. |
| CUST-43 | P0 | Change coupons/address/slot/notes after returning from cart. | Latest state shown and submitted; no stale route params. |
| CUST-44 | P0 | Double-tap Place Order; pending rerender. | Synchronous guard sends one in-app request. |
| CUST-45 | P1 | Mutation fails, then retry; session expires mid-checkout. | Loading released, error shown, state preserved; login return safe. |
| CUST-46 | P1 | Response lost after commit. | History checked before retry; no false claim of server deduplication. |
| CUST-47 | P0 | Client tampers with price/discount/region/bound/slot. | Server ignores client money/region and uses authoritative values. |
| CUST-48 | P1 | Multi-sub-order success and zero-total success. | Success references valid orders/group; authoritative totals/zero handled. |
| CUST-49 | P1 | Flash checkout in A (enabled) vs B (disabled). | Flash price/fee/null slot in A; rejected in B even via direct route. |
| CUST-50 | P1 | Android back/iOS swipe/browser refresh/deep link to success. | No duplicate order, lost notes or wrong-order detail. |
Orders, profile and support
| ID | P | Case | Expected |
|---|---|---|---|
| CUST-51 | P0 | My Orders list: pending/delivered/cancelled, split group, pagination. | Correct rows/status/labels; no missing/duplicate pages. |
| CUST-52 | P1 | Order detail: items, address, slots, bill, status timeline, notes. | Matches persisted order/admin view; discount/delivery/total reconcile. |
| CUST-53 | P0 | Cancel a fresh order with a reason; cancel a delivered order. | Reason required; allowed/denied transitions correct; coupon restored when applicable. |
| CUST-54 | P1 | Order again / reorder; historical deleted product. | Valid lines re-added; unavailable lines handled; history remains readable. |
| CUST-55 | P1 | Raise a complaint with/without image; view admin reply. | Persisted, region-correct, visible reply; no cross-user access. |
| CUST-56 | P1 | Addresses: add with map coords, edit/default/delete, outside-area point. | Bound/region derived; errors clear; default policy correct. |
| CUST-57 | P1 | Coupons page: eligible/used/expired labels and empty state. | Agrees with eligibility rules; no hidden coupon shown as available. |
| CUST-58 | P1 | Push permission/token registration; region sync after address add; notification deep link. | Token stored for the address region; link opens the intended order/product. |
| CUST-59 | P2 | Offline/network failure on Home/cart/checkout. | Explicit error/retry; no false success; cart preserved. |
| CUST-60 | P2 | Keyboard, safe area, back navigation and accessibility labels on checkout/cart. | Usable on small screens; no hidden action; controls have accessible names. |
6.3 Admin frontend flows (L3 native + L5 web)
Run each case on admin-ui and admin-web; note platform-specific reload/storage behaviour.
| ID | P | Case | Expected |
|---|---|---|---|
| ADM-01 | P0 | Staff A login; reload; direct protected route. | Correct staff/region; session restores; no privileged flash before auth. |
| ADM-02 | P0 | Staff A vs B dashboard/orders/products. | Only own-region data; no B counts/rows. |
| ADM-03 | P0 | Logout, login as B; browser back to A route. | A data cleared; denied/redirected; no cached private content. |
| ADM-04 | P0 | Customer/anonymous token on admin mutations. | Denied; UI hiding is not the only guard. |
| ADM-05 | P0 | Orders list: filters, search, pagination, empty/error, delivered toggle. | Correct filtered rows and counts; keyset pagination stable. |
| ADM-06 | P0 | Quiet region A with old orders while B has newer orders; load more. | A paginates its own rows; no empty list/starvation (BR-09). |
| ADM-07 | P0 | Order detail: items, bill, address, notes, status, customer. | Matches persisted order; discount/delivery/total reconcile. |
| ADM-08 | P0 | Mark packaged/verified/delivered; customer sees the change. | Status/timestamps persist; no partial item state. |
| ADM-09 | P0 | Cancel with reason; cancel delivered; remove delivery charge. | Correct transitions; no duplicate fee; customer view reflects it. |
| ADM-10 | P1 | Rebalance slots/items; verify pricing and discount preservation. | Items move; totals recompute; historic discount/delivery preserved. |
| ADM-11 | P1 | Delivery sequence/map: order, coordinates, missing coords. | Stable sequence; coordinate edits scoped to the order. |
| ADM-12 | P1 | Admin notes and customer notes. | Persist on the correct order; visible to the intended audience. |
| ADM-13 | P0 | Products list/search/filter; open detail. | Region-correct products; OOS/suspended flags; no foreign items. |
| ADM-14 | P0 | Create a regional product with two SKUs, features, images, tags. | Product/SKUs persist; customer sees it in A only. |
| ADM-15 | P0 | Edit a regional product's SKU/price/stock/offer. | Updates one product; no duplicate SKUs; availability cache refreshes. |
| ADM-16 | P0 | Edit a global product's market price/stock/flash/suspension in A. | Only A market changes; structure/B untouched. |
| ADM-17 | P0 | Suspend a global SKU in A, reopen, change price, save. | Suspension preserved (BR-11). |
| ADM-18 | P0 | Edit/delete a product with dependent rows. | Delete guards correct; image/asset lifecycle safe. |
| ADM-19 | P1 | Prices overview and variant stock dialog. | Inline edits persist; invalid values rejected; cache updates. |
| ADM-20 | P1 | Product tags: create/edit/delete/order; assign products. | Persisted ordering/membership; customer order matches. |
| ADM-21 | P1 | Product groups: create/edit/delete/membership; assign to slot. | Group/slot semantics consistent; no orphan membership. |
| ADM-22 | P1 | Combos: create combo and components; check customer detail. | Composition/pricing/flags correct. |
| ADM-23 | P0 | Stores list/add/edit/delete; global store read-only. | Region isolation; global edit blocked; image preserved on failure. |
| ADM-24 | P0 | Slots: create with SKUs, edit, capacity, freeze, detail. | Customer discovery/checkout reflects it; full slot blocked. |
| ADM-25 | P1 | Coupons: list/create/edit/invalidate; targets/users. | Region/targets enforced; invalid coupon cannot be used. |
| ADM-26 | P1 | Banners: create/edit/delete/order/active. | Customer sees only active A banners in order. |
| ADM-27 | P1 | Customize app: popular items and all-items ordering. | Persisted order; customer home matches. |
| ADM-28 | P1 | Users: list, search by name/mobile, detail, suspend/unsuspend. | Search region-scoped; suspension blocks ordering; no cross-region leakage (BR-01). |
| ADM-29 | P0 | Search a U1 mobile from staff B; search same name with A/B customers. | B sees nothing/only B; A sees only A (BR-01). |
| ADM-30 | P1 | User incidents and notifications to selected users. | Incident audit correct; notification queued only for allowed recipients. |
| ADM-31 | P1 | Complaints list/reply/resolve. | Region-scoped; customer sees the reply. |
| ADM-32 | P1 | Vendor snippets: create/edit/delete, order/slot reads. | Region-scoped; slot picker works after reload (web, BR-15). |
| ADM-33 | P1 | Region constants edit. | A customer discovery/pricing changes; B unchanged. |
| ADM-34 | P1 | Upload product/store/banner images. | Upload succeeds; URL persisted; replaced image cleanup safe. |
| ADM-35 | P2 | Empty/loading/error states across dashboard routes. | Retry/back navigation works; no permanent spinner. |
6.4 Superadmin frontend flows (L6)
| ID | P | Case | Expected |
|---|---|---|---|
| SA-01 | P0 | Login/logout, reload, direct protected route. | Session restores; logout clears; no staff/customer access. |
| SA-02 | P0 | Regions list; create region with at least one bound. | Region appears; cache files generated; assignments possible. |
| SA-03 | P0 | Create region without bounds, duplicate priorities, malformed GeoJSON. | Validation/conflict; no half-created region. |
| SA-04 | P1 | Edit region name/metadata; add/edit/delete bounds. | Stable IDs; last/referenced bound refused; customers converge. |
| SA-05 | P0 | Region creation with global products. | Per-region market rows seeded; no zero-price sale. |
| SA-06 | P0 | Region cache generation on create/edit. | Files exist and are served; no v-undefined (BR-07). |
| SA-07 | P1 | Staff list/create/update/remove/roles. | Region/role assignment effective; removed staff denied. |
| SA-08 | P1 | Global stores CRUD. | Visible in all regions; regional admins read-only. |
| SA-09 | P0 | Global products list/create/edit/delete; two SKUs. | Per-region markets; customer sees in A/B. |
| SA-10 | P0 | Edit an existing global product; save twice. | SKU IDs preserved; no duplicate variants (BR-03). |
| SA-11 | P0 | Switch create→edit and edit→create in the form. | Form state resets/keyed; no draft bleed (BR-08). |
| SA-12 | P0 | Suspend/edit market data; regional admin view. | Global vs regional flags independent. |
| SA-13 | P1 | Elevate a regional product. | Region null, market rows, still purchasable. |
| SA-14 | P1 | Global coupons: create/edit/delete/targets/users. | Valid; one discount type; applies in both regions. |
| SA-15 | P0 | Change a global coupon from percent to flat and save. | Percent cleared; pricing uses flat only (BR-14, known open). |
| SA-16 | P1 | Global constants edit. | Propagates to A/B discovery; regional overrides win. |
| SA-17 | P1 | Complaints list/reply; admin notifications. | Correct scope; no private leakage. |
| SA-18 | P0 | "Admin Notifs": send as superadmin. | Success and queue write; no guard failure (BR-16). |
| SA-19 | P0 | Staff/customer token calls superadmin routes. | Denied; no data. |
| SA-20 | P1 | Empty/loading/error states and destructive confirmations. | No accidental delete; clear errors. |
| SA-21 | P1 | Upload global store/product images. | URL persists; shared asset not deleted by regional failure. |
| SA-22 | P2 | Region tabs and selected-region switching. | Correct context; stale labels refresh by ID. |
| SA-23 | P1 | Cache status after global edit. | All regions publish within deadline; no regional narrowing. |
6.5 Conditional and legacy surfaces
Run only when product/operations confirms support. N/A requires a reason.
| ID | P | Case | Expected |
|---|---|---|---|
| COND-01 | P2 | Vendor snippet page: login, list orders, open packaging. | Scoped to the snippet/staff region; packaging correct. |
| COND-02 | P2 | Reviews: create a review with image; admin response. | Persisted/visible if the feature is supported; otherwise N/A. |
| COND-03 | P2 | OTP login in an isolated provider sandbox. | Account created/authenticated once; no real SMS; otherwise N/A. |
| COND-04 | P2 | Legacy fallback login/home/order-details pages. | Only supported ownership paths are exercised; demos/unsupported pages are N/A with reason. |
6.6 Cross-app E2E journeys (L7)
Only these critical chains use the real backend and real clients.
| ID | P | Journey | Expected |
|---|---|---|---|
| E2E-01 | P0 | Superadmin creates region A + bound + staff → staff creates store/product/slot/coupon → customer U1 sees catalog and places COD order → staff packages/delivers → customer sees delivered. | Full chain; IDs and money agree at every step. |
| E2E-02 | P0 | Superadmin creates global product G with A/B prices → customer sees G in A and B with different prices → regional admin edits A market price → A changes, B does not. | Global structure shared; market data isolated. |
| E2E-03 | P0 | Customer switches A→B and back on native and web with populated carts. | Region content/carts isolated; explicit switch clears/restores correctly. |
| E2E-04 | P0 | Coupon stack (10% + ₹100) across web/native checkout; verify persisted order/admin detail. | 200 discount on ₹1000; all surfaces agree; no negative totals. |
| E2E-05 | P0 | Flash order in A (enabled) and blocked flash attempt in B. | Flash price/flag in A; server rejection in B. |
| E2E-06 | P0 | Multi-slot order S1/S2 with one delivery fee; admin fulfills both. | One group, two sub-orders, one fee; statuses consistent. |
| E2E-07 | P0 | Cancel an order using a first-order coupon; verify usage restoration and re-order. | Coupon usable again only when no sibling remains. |
| E2E-08 | P0 | Web scheduled checkout with items in two slots. | No null-slot rejection; correct slots persisted (BR-06). |
| E2E-09 | P0 | Staff B searches U1's name/mobile; staff A searches same. | B cannot see A customer; A can (BR-01). |
| E2E-10 | P0 | Global product edit → both region caches refresh → customers in A/B see it. | All regions publish; regional edit does not narrow (BR-05). |
| E2E-11 | P1 | Admin-web reload → vendor snippet slot picker. | Slots load; staff/region restored (BR-15). |
| E2E-12 | P1 | Superadmin sends "Admin Notifs" to admins. | Queued, not UNAUTHORIZED (BR-16). |
| E2E-13 | P0 | Authorization probe: customer token against admin/superadmin mutations; staff against superadmin. | Denied at every step; no writes. |
| E2E-14 | P1 | Product soft-delete after an order; customer/admin order history. | Original name/amount render; catalog removes it. |
| E2E-15 | P0 | Address with coordinates in B while browsing A; place order. | Order appears in B admin queue and B pricing; A unaffected. |
| E2E-16 | P1 | Cancelled/delivered transitions and customer notification deep link. | Correct status/link; no duplicate order. |
7. Current-branch regression pack (release-blocking)
These cases must be automated first; they encode the defects found in the
MULTI_REGION_I2 review and the fixes applied during hardening.
| ID | P | Scenario | Expected | Automation |
|---|---|---|---|---|
| BR-01 | P0 | Staff A and B search customers by a name/mobile that exists in both regions. | A returns only customers with A orders; B only B; no cross-region mobile leakage. | apps/backend/tests/api/admin-region-isolation.test.ts |
| BR-02 | P0 | Web customer selects region/bound; inspect essentialConsts request. |
Request sends { boundId }, never { regionId }; catalog/slots enable. |
apps/web-ui/tests/flows/discovery.test.tsx + E2E |
| BR-03 | P0 | Superadmin edits a global product with two existing SKUs and saves twice. | SKU IDs preserved; SKU count unchanged; no suspended duplicate. | apps/backend/tests/api/superadmin.test.ts |
| BR-04 | P0 | Regional staff edits a global store with an image; mutation rejected. | Image/object remains; no partial update. | apps/backend/tests/api/admin-catalog.test.ts |
| BR-05 | P0 | Global product edit, then regional banner edit inside the debounce window; inspect caches. | allRegionsPending wins; every region regenerates. |
apps/backend/tests/api/cache-region.test.ts |
| BR-06 | P0 | Web scheduled checkout with items in S1/S2. | Each item sends its slotId; no slotId: null; order succeeds. |
apps/web-ui/tests/flows/checkout.test.tsx + E2E-08 |
| BR-07 | P0 | Superadmin creates a region with global products. | Cache files exist after the response; createRegionCacheFiles awaited. |
apps/backend/tests/api/regions.test.ts |
| BR-08 | P1 | Superadmin global products: open create, then edit, then create again. | Form resets/keyed; no draft bleed; submit targets the selected product. | apps/superadmin-ui/src/routes/global-products.test.tsx |
| BR-09 | P0 | Region A has old orders; region B creates > limit + 5 newer orders; page A. | A returns its rows and a valid next cursor; no global-ID window starvation. | apps/backend/tests/api/admin-orders.test.ts |
| BR-10 | P1 | Cold start adopts the first region with a populated persisted cart. | Cart preserved; only an explicit switch away clears it. | apps/user-ui/tests/flows/region.test.tsx + apps/web-ui/tests/flows/cart.test.tsx — known open |
| BR-11 | P0 | Suspend a global SKU in A; reopen; change only price/stock; save. | Suspension remains true in A; B unchanged. |
apps/backend/tests/api/admin-catalog.test.ts |
| BR-12 | P0 | Two ₹101 sub-orders + two ₹101 stackable coupons. | Discounts [101, 101]; totals [0, 0]; no negative; delivery handled separately. |
apps/backend/tests/api/coupon-math.test.ts + packages/shared via API |
| BR-13 | P2 | Historical order with a coupon-implied discount after migration. | discount_amount is 0 (accepted): invoices show no discount; derivation is not required. |
apps/backend/tests/api/order-lifecycle.test.ts — accepted limitation |
| BR-14 | P1 | Change a global coupon 20% → ₹50 and save. | Percent is cleared; pricing uses ₹50. | apps/backend/tests/api/coupons.test.ts — known open |
| BR-15 | P1 | Admin-web reload on the vendor snippet screen. | admin.staffUser.me restores staff/region; slots load. |
apps/admin-web/tests/flows/vendor-snippets.test.tsx |
| BR-16 | P0 | Superadmin sends an admin notification. | superadmin.staff.sendAdminNotification succeeds; staff endpoint still staff-guarded. |
apps/backend/tests/api/admin-ops.test.ts |
| BR-17 | P0 | Customer checkout and order detail. | COD only; no online-payment method/routes; disabled "coming soon" card if present. | apps/backend/tests/api/order-flow.test.ts + customer UI flows |
| BR-18 | P0 | Scheduled order with one null slot and one valid slot. | Rejected; no partial order; valid per-line slots succeed. | apps/backend/tests/api/place-order-edge-cases.test.ts |
| BR-19 | P0 | Address in B while client sends A; bound-specific fee. | Address region/bound wins; correct fee/region. | apps/backend/tests/api/order-rules.test.ts |
| BR-20 | P1 | A/B order pagination with interleaved IDs. | Stable keyset pages for each region; no skipped duplicate rows. | apps/backend/tests/api/admin-orders.test.ts |
8. Existing coverage and gaps
Reuse before writing new files
| Existing suite | Reuse/extend for |
|---|---|
apps/backend/tests/api/order-flow.test.ts, order-rules.test.ts, place-order-edge-cases.test.ts |
BE-ORDER-01–BE-ORDER-15, BR-18, BR-19 |
apps/backend/tests/api/coupon-math.test.ts, coupons.test.ts, coupon-ux.test.ts, order-lifecycle-gaps.test.ts |
BE-COUP-01–BE-COUP-18, BR-12, BR-14 |
apps/backend/tests/api/admin-orders.test.ts, admin-ops.test.ts, order-lifecycle.test.ts |
BE-ORDER-20–BE-ORDER-26, BR-09, BR-20 |
apps/backend/tests/api/authorization.test.ts, authorization-matrix.test.ts |
BE-AUTH-09, BE-ADMIN-02, BE-ADMIN-21, BR-16 |
apps/backend/tests/api/cache-*.test.ts |
BE-CACHE-01–BE-CACHE-12, BR-05 |
apps/user-ui/tests/screens/cart-*.test.tsx, checkout*.test.tsx, order-*.test.tsx |
CUST-26–CUST-55 baseline; replace component assertions with flow assertions where needed |
apps/admin-ui/tests/screens/* |
ADM-05–ADM-35 baseline; add multi-region/global cases |
apps/superadmin-ui/src/lib/bound-rules.test.ts |
Pure bound validation only; keep as-is, add route-level SA-* cases |
Current coverage
| App / suite | Existing | Gaps to fill |
|---|---|---|
apps/backend/tests/api |
35 Jest files (~192 describe/it entries), real HTTP, auth/order/coupon/cache/admin basics. | Multi-region/bounds, global products/stores, superadmin, region isolation, keyset pagination, store ownership/image, SKU ID preservation, cache all-regions flag, COD-only regression, web discovery contract, discount history. |
apps/user-ui/tests |
367 tests, mostly screen/component with mocked network. | Real screen-flow coverage for region adoption/switch, web parity, flash, checkout per-slot payload, account switching, startup cart preservation. |
apps/admin-ui/tests |
497 tests, screen/component with mocked network. | Multi-region/global market editing, region isolation, order keyset pagination, store image ownership, admin-web parity, cache-visible effects. |
apps/web-ui |
None. | Full L4 route-level harness + flows: discovery, auth, catalog, cart, checkout, orders, profile, flash. |
apps/admin-web |
None. | Full L5 route-level harness + flows; staff restore after reload; parity with admin-ui. |
apps/superadmin-ui |
One unit test (bound-rules.test.ts). |
L6 route tests for login, regions/bounds, staff, global stores/products/coupons, constants, notifications, cache. |
tests/e2e |
3 Maestro flows + subflows (add product, add slot, user order). | Region/global journeys, web checkout, coupon money, cancellation, authorization probes, cross-app chain. |
tests/e2e-web |
None. | Playwright critical web journeys. |
Recommended new files:
- Backend:
regions-bounds.test.ts,global-catalog.test.ts,superadmin.test.ts,admin-region-isolation.test.ts,cache-region.test.ts,payments-removed.test.ts,discount-history.test.ts. - Customer native:
tests/flows/region.test.tsx,cart-region.test.tsx,checkout-slots.test.tsx,flash.test.tsx,orders.test.tsx. - Admin native:
tests/flows/region-scope.test.tsx,global-products.test.tsx,order-pagination.test.tsx,store-safety.test.tsx. - Customer web:
tests/flows/discovery.test.tsx,cart.test.tsx,checkout.test.tsx,orders.test.tsx,auth.test.tsx. - Admin web:
tests/flows/auth-restore.test.tsx,orders.test.tsx,products-global.test.tsx,vendor-snippets.test.tsx. - Superadmin:
src/routes/regions.test.tsx,staff.test.tsx,global-products.test.tsx,global-coupons.test.tsx,send-notifications.test.tsx. - E2E:
tests/e2e/multi-region-order.yaml,tests/e2e-web/critical-journeys.spec.ts.
9. Recommended implementation order
- Harness first: backend fixture helpers for regions/bounds/global entities; web Jest/jsdom config; superadmin Vitest/jsdom config.
- P0 backend: authorization matrix, region isolation, order placement/money, coupon math, cache all-regions, store/global SKU safety.
- P0 web: discovery
boundId, scheduled checkout slots, admin-web reload, superadmin notifications. - P0 native: region startup/switch, checkout slot payload, coupon stacking, order/cancel flows.
- P1 backend/admin: CRUD coverage, fulfillment, pagination, notifications, uploads.
- P1 web/superadmin: parity flows and global authoring.
- E2E: only the critical journeys in §6.6, after the lower layers are stable.
- Full regression before release; run P0 twice (fresh session and already-open session).
CI split:
- PR: typecheck + backend P0 + affected UI flow suites.
- Nightly: all backend API + web/native flow suites.
- Pre-release: all P0/P1 + E2E + security matrix + cache deadline checks.
10. Known open / accepted items
| Item | Status | Handling |
|---|---|---|
Startup region adoption clears a persisted cart (region-switch.ts) |
Open | BR-10 is expected to fail until fixed; mark as known defect, not a test bug. |
Global coupon percent→flat keeps the old percent (global-coupons.ts) |
Open | BR-14/SA-15/BE-COUP-18 must fail until fixed. |
Historical discount_amount = 0 backfill |
Accepted | BR-13 asserts the accepted behavior; do not block release on it. |
| Server-side order idempotency | Deferred | Characterize concurrent submits; UI guard is required; do not assert deduplication. |
| OTP login/SMS | Approval-only | Excluded from default regression; use an isolated provider sandbox. |
| Reviews, vendor snippets, legacy fallback pages | Conditional | Run only if product/operations confirms support. |
| Online payments | Removed | Assert COD-only; no gateway routes/UI. |
Admin protectedProcedure endpoints (getStaff, createStaffUser, getRoles, savePushToken) |
Pending decision | BE-ADMIN-21 encodes the staff-only expectation; if customers are intentionally allowed, document it and downgrade the case. |
| No emulator/browser in the authoring environment | Process limitation | Cases are static proposals until a device/browser is available. |
11. Run report template
Run ID / date / code revision:
Environment / verified API host / client build:
Layer (L1–L7) / case ID / client / identity / region / bound:
Fixture IDs and relevant pre-state:
Actions and exact inputs:
Expected / actual:
Status: PASS | FAIL | BLOCKED | NOT RUN | N/A
API status/body, persisted values, versions, timestamps:
Screenshots/logs (redacted):
Cleanup / retained evidence / linked defect:
For every failure include the smallest reproduction, the authoritative data read,
and whether any data was mutated. A BLOCKED harness result is never a pass.