# backend — API test case catalogue (100% procedure coverage) > **Implemented.** These cases now live as a runnable live HTTP/tRPC suite in > [`tests/`](./tests/) (61 files, 1196 `it()` blocks; 1181 catalogue rows plus a > few harness/flash smoke cases). See [`tests/README.md`](./tests/README.md) for > the harness, fixtures, credentials and authoring rules. Run with: > > ```bash > cd apps/backend > bun run dev # wrangler dev on :8787 (keep running) > bun run tests/seed-local.ts # once: seeds e2e_super / e2e_staff / e2e_user > bun run test:api # jest --runInBand > ``` > > Rows that pin current (not intended) behaviour are prefixed `(current)` with a > comment in the corresponding test. See `tests/README.md` § "Local-dev > environment limitations" for the seeded-DB quirks (per-store detail files, > KV/D1 version lag, all-region rebuild OOM). This is the replacement checklist for the deleted `apps/backend/tests` suite. It is written for **live HTTP/API tests**, not unit tests: the test process talks to a running backend, authenticates with real tokens, creates data through the API, and reads the generated public cache files. - **Runner:** jest + ts-jest, node environment, `--runInBand` - **Target:** a running dev backend (`wrangler dev`, default `http://localhost:8787`) - **No mocks:** real D1, real R2/S3, real Durable Object cache creator, real queue bindings - **One row = one `it()`** unless the row explicitly says “table test” - **Suggested layout:** `apps/backend/tests/api//.test.ts` - **DB state:** API-created fixtures are preferred. Immutable state (roles, regions, bounds, superadmin, staff login) may be seeded once in local D1. Unique suffixes keep reruns valid. > The old `apps/backend/test-case-info.md` describes the deleted 107-test suite and still uses > old contracts (for example `cacheVersion` and `placeOrder` without `regionId`). Treat this file > as the current source of truth. --- ## 1. Harness and execution rules ### 1.1 Environment | Variable | Purpose | | --- | --- | | `API_BASE_URL` | backend origin, default `http://localhost:8787` | | `TEST_STAFF_NAME` / `TEST_STAFF_PASSWORD` | real staff login | | `TEST_USER_IDENTIFIER` / `TEST_USER_PASSWORD` | real user login | | `TEST_SUPERADMIN_USERNAME` / `TEST_SUPERADMIN_PASSWORD` | real superadmin login | | `TEST_REGION_ID` | a serviceable region used by most suites | | `TEST_BOUND_ID` | a bound in `TEST_REGION_ID` | | `TEST_OTHER_REGION_ID` / `TEST_OTHER_BOUND_ID` | cross-region isolation | | `CACHE_POLL_TIMEOUT_MS` | default `180000`; the product/cache flow should wait at least 60s | | `CACHE_POLL_INTERVAL_MS` | default `3000` | Tests must fail fast with a clear message if the backend is not up: ```ts beforeAll(async () => { const res = await fetch(`${API_BASE_URL}/api/health`) if (!res.ok) throw new Error(`Backend not reachable at ${API_BASE_URL}`) }) ``` ### 1.2 Tokens and HTTP details | ID | Type | Case | Assert | | --- | --- | --- | --- | | HARNESS-01 | setup | staff login | token present; staff id/regionId present | | HARNESS-02 | setup | user login | token present; user id present | | HARNESS-03 | setup | superadmin login | token present; superadmin id present | | HARNESS-04 | setup | bearer header | `Authorization: Bearer ` authenticates | | HARNESS-05 | edge | user token from cookie | cookie `auth_token` authenticates when no bearer | | HARNESS-06 | edge | `Caller-Interface: web` on user login | `Set-Cookie` contains HttpOnly/Secure/SameSite=Lax/Path=/ | | HARNESS-07 | edge | mobile login | no `Set-Cookie` | | HARNESS-08 | edge | expired/garbage token | treated as anonymous; protected endpoint returns 401 | | HARNESS-09 | edge | staff token on user-only endpoint | rejected (`ctx.user` absent) | | HARNESS-10 | edge | user token on staff-only write | rejected (`ctx.staffUser` absent) | | HARNESS-11 | edge | superadmin token on staff-only endpoint | rejected | | HARNESS-12 | edge | staff token on superadmin endpoint | rejected | | HARNESS-13 | edge | suspended user token | every tRPC request is rejected (current context behavior) | | HARNESS-14 | edge | unknown `boundId` | 404 from `common.essentialConsts` | | HARNESS-15 | edge | invalid JSON/batch body | tRPC error, no process crash | | HARNESS-16 | edge | OPTIONS CORS preflight | allowed origin/headers/methods | | HARNESS-17 | edge | unknown route | 404 JSON, no stack trace | | HARNESS-18 | edge | ApiError status mapping | 400/401/403/404/409/422 map to matching tRPC/HTTP codes | | HARNESS-19 | edge | unhandled error | 500 with generic message, not raw SQL | | HARNESS-20 | edge | concurrent suites | tests run serially; shared region counters are not raced | ### 1.3 Reusable fixtures | Fixture | Creation | Notes | | --- | --- | --- | | `staff` | `admin.staffUser.login` | region-scoped | | `superadmin` | `superadmin.auth.login` | global | | `user` | `user.auth.register` | unique email/mobile | | `store` | `admin.store.createStore` | unique name | | `product` | `admin.product.createProduct` | one or more SKUs; features include `quantity` | | `slot` | `admin.slots.createSlot` | future delivery/freeze | | `address` | `user.address.createAddress` | valid coords inside `TEST_BOUND_ID` | | `coupon` | `admin.coupon.create` | unique code | | `review` | `user.product.createReview` | attached to product | | `complaint` | `user.complaint.raise` | own order or none | | `region` | `superadmin.regions.create` | bounds required; unique priorities | Rules: 1. Every name/code gets `uniqueSuffix()`. 2. Future slot times are at least 2 hours ahead and freeze at least 1 hour ahead. 3. Order tests use a fresh user unless testing history/usage limits. 4. Cache tests use a dedicated product/store so unrelated writes do not confuse version polling. 5. Cleanup is best-effort; never make a test depend on a previous cleanup. 6. Do not import backend runtime modules; import only shared types and a tRPC client. ### 1.4 Optional local D1 seed The user explicitly allows creating SQLite/D1 state if needed. Keep it minimal and idempotent: | Seed | Why | | --- | --- | | one role (`owner`/`admin`) | `createStaffUser` needs a valid role | | one staff login | authenticates every admin suite | | one superadmin | authenticates superadmin suites | | two regions with at least one bound each | region isolation and effective-bound tests | | region/bound/global consts | deterministic thresholds and delivery charges | | one user login | order/address suites that need stable history | Seed script requirements: - `INSERT OR IGNORE` / upsert by unique name. - Never reset the whole DB inside a test run. - Never point at production. - Keep test-created data distinguishable by suffix. - If a test needs an empty region, create it through the superadmin API instead of deleting seeds. --- ## 2. Golden end-to-end API flows These are the first tests to write; they prove the whole API/cache pipeline is wired. ### 2.1 The requested product → list → cache flow | ID | Type | Case | Assert | | --- | --- | --- | --- | | E2E-01 | happy | staff login and resolve region/bound | `admin.region.current` and `admin.region.effective` return `TEST_REGION_ID`/bound | | E2E-02 | happy | capture baseline `common.essentialConsts({boundId})` | `products_version_num`, `slots_version_num`, `availability_version_num` numeric | | E2E-03 | happy | create a unique store `XYZ Store ` | `store.id > 0`; `getStoreById` returns it | | E2E-04 | happy | create product `XYZ Product ` with one SKU | `product.id` and `skus[0].id` exist; price/feature `quantity` round-trip | | E2E-05 | happy | `admin.product.getProducts` | created product/SKU present in the admin list | | E2E-06 | happy | `common.product.getAllProductsSummary` | created SKU present; scoped to staff region | | E2E-07 | happy | create a future slot containing the SKU | `slot.products`/SKU ids include it | | E2E-08 | happy | `user.slots.getSlots({regionId})` | new slot present, future only | | E2E-09 | happy | create address and place one COD order | one order returned; total > 0 | | E2E-10 | happy | `user.order.getOrders` | order present; `deliveryStatus: 'pending'`; pagination count > 0 | | E2E-11 | happy | `user.order.getOrderById({orderId:''})` | same order, item and amount | | E2E-12 | cache | poll `common.essentialConsts` after product creation | `products_version_num` advances past E2E-02 baseline | | E2E-13 | cache | fetch `products.json` at the new version | product by SKU id present; storeId, price, images, tags correct | | E2E-14 | cache | fetch `stores.json` | new store present; `productCount` matches | | E2E-15 | cache | fetch `stores/.json` | `store.id` matches; product present | | E2E-16 | cache | fetch `availability.json` | entry keyed by SKU id present; price/flags match | | E2E-17 | cache | fetch `slots.json` | new slot present; product id present | | E2E-18 | cache | fetch `essential-consts.json` | `boundId`/`regionId` match; version fields numeric | | E2E-19 | cache | fetch `banners.json` | file exists and is valid JSON | | E2E-20 | cache | all cache files are readable by public URL | no auth header required | | E2E-21 | cache | wait timing | poll at least 60s; first 404/old version is tolerated | | E2E-22 | edge | product appears in admin list before cache version moves | allowed: admin D1 read is immediate, cache is eventual | | E2E-23 | edge | cache version moves but one file 404s | poll that file individually until ready | | E2E-24 | edge | product created in region A | region B cache never contains it | | E2E-25 | edge | suspended SKU | absent from products/cache but still in admin DB | ### 2.2 Order lifecycle golden flow | ID | Type | Case | Assert | | --- | --- | --- | --- | | E2E-26 | happy | place two orders in different slots | one order per slot; delivery charged once per order | | E2E-27 | happy | admin `getSlotOrders` / `getAll` | both orders visible; first-order flag correct | | E2E-28 | happy | admin packaged then delivered | user sees `deliveryStatus: packaged` then `success` | | E2E-29 | happy | admin removes delivery charge | user `deliveryCharge` becomes 0 | | E2E-30 | happy | admin cancels fresh order | user sees cancelled + reason | | E2E-31 | happy | user cancels fresh order | list/detail reflect cancellation | | E2E-32 | edge | coupon first-order-only | second order rejects/does not apply | | E2E-33 | edge | coupon usage released on cancel | first-order status restored if it was first | ### 2.3 Coupon golden flow | ID | Type | Case | Assert | | --- | --- | --- | --- | | E2E-34 | happy | admin creates flat coupon | `getById` round-trips | | E2E-35 | happy | user `getEligible` | coupon present | | E2E-36 | happy | user places order with coupon | `discountAmount` equals expected; `couponCode` set | | E2E-37 | happy | admin invalidates coupon | `getEligible` excludes; order with it rejects | | E2E-38 | edge | coupon with both discount types | rejected | | E2E-39 | edge | coupon code duplicate | rejected | | E2E-40 | edge | user-based coupon for another user | never visible | ### 2.4 Catalog mutation golden flow | ID | Type | Case | Assert | | --- | --- | --- | --- | | E2E-41 | cache | update product name/price | admin list immediate; cache eventually reflects | | E2E-42 | cache | update SKU price | `availability.json` bumped synchronously; value updated | | E2E-43 | cache | toggle out of stock | availability entry updated synchronously; products file eventually | | E2E-44 | cache | update slot | `slots.json` bumped synchronously; new time present | | E2E-45 | cache | set slot capacity full | slot removed from public `slots.json` | | E2E-46 | cache | create/update/delete banner | `banners.json` eventually reflects | | E2E-47 | cache | create/update/delete tag | products.json tag list/order eventually reflects | | E2E-48 | cache | update `tagsOrder` region constant | product tag order eventually reflects | | E2E-49 | cache | update bound delivery constants | `common.essentialConsts` reflects after KV refresh | | E2E-50 | cache | delete store/product | removed from cache after rebuild; historical orders retain data | ### 2.5 Upload golden flow | ID | Type | Case | Assert | | --- | --- | --- | --- | | E2E-51 | happy | generate upload URL | URL returned; key has correct folder/extension | | E2E-52 | happy | PUT bytes to presigned URL | 200; object readable at public assets URL | | E2E-53 | edge | same mime type twice in one call | current implementation may share a millisecond key; assert returned URLs/keys if so | | E2E-54 | edge | unknown/already claimed key in product create | rejected before DB write | | E2E-55 | edge | unknown key in review | logged but review still creates (lenient contract) | --- ## 3. HTTP routes and authorization matrix ### 3.1 REST routes outside tRPC | ID | Type | Request | Assert | | --- | --- | --- | --- | | HTTP-01 | happy | `GET /api/health` | 200 `{status:'OK', timestamp, uptime, message}` | | HTTP-02 | happy | `GET /api/seed` | 200, no auth | | HTTP-03 | happy | `GET /api/test/` | 200 `{status:'ok'}` after auth middleware | | HTTP-04 | edge | `GET /api/test/` without token | 401 `Authorization token required` | | HTTP-05 | edge | `GET /api/health` with invalid token | still 200 (public) | | HTTP-06 | happy | `GET /api/v1/cm/products/summary?tagId=` with token | products for tag | | HTTP-07 | edge | summary without token | 401 | | HTTP-08 | edge | summary `tagId` missing | all products | | HTTP-09 | edge | summary `tagId` non-numeric | all products or no filter (current `parseInt` semantics) | | HTTP-10 | edge | summary unknown tag | `{products:[],count:0}` | | HTTP-11 | happy | summary product fields | id/name/price/marketPrice/unit/quantity/stock/nextDeliveryDate/images | | HTTP-12 | edge | summary image keys | signed/public asset URLs | | HTTP-13 | edge | unknown `/api/*` | 404 | | HTTP-14 | edge | malformed JSON | 400, no crash | | HTTP-15 | edge | CORS allowed origin | `Access-Control-Allow-Origin` | | HTTP-16 | edge | CORS disallowed origin | not echoed | | HTTP-17 | edge | preflight headers | Authorization and Caller-Interface allowed | | HTTP-18 | edge | `Caller-Interface: web` cookie login | cookie set | | HTTP-19 | edge | cookie-only authenticated request | accepted | | HTTP-20 | edge | `Set-Cookie` flags | HttpOnly/Secure/SameSite=Lax/Path=/ | ### 3.2 Principal matrix Apply these to every procedure in the groups below. The row is the expected result with no token. | ID | Group | Procedures | Expected | | --- | --- | --- | --- | | AUTH-01 | public | `common.healthCheck`, `common.listRegions`, `common.checkLocationInPolygon`, `common.resolveRegionByLocation`, `common.resolveBound`, `common.regionSettings`, `common.activeBound`, `common.essentialConsts`, `user.auth.*` public, `admin.staffUser.login`, `superadmin.auth.login`, `vendorSnippets` public reads | succeeds without token | | AUTH-02 | user protected | every `user.*` protected procedure except public ones | 401 UNAUTHORIZED | | AUTH-03 | admin/staff reads | every `admin.*` `protectedProcedure` read | user token may pass (current gap); no token 401; staff passes | | AUTH-04 | admin/staff writes | every `admin.*` `protectedProcedure` mutation | user token may pass today (current gap); no token 401; staff passes | | AUTH-05 | staff-only | `admin.banner.createBanner`, `admin.product.createProduct`, `admin.product.createGroup`, `admin.product.createProductTag`, `admin.store.createStore`, `admin.staffUser.me`, `admin.staffUser.sendAdminNotification`, `admin.vendorSnippets.create`, every `admin.region.*` | no token/user token/superadmin 401; staff passes | | AUTH-06 | authenticated-any | `common.generateUploadUrls` | user, staff and superadmin pass; anonymous 401 | | AUTH-07 | superadmin-only | every `superadmin.*` procedure | user/staff 401; superadmin passes | | AUTH-08 | cross-principal | staff token on `user.order.getOrders` | rejected | | AUTH-09 | cross-principal | user token on `admin.slots.createSlot` | rejected | | AUTH-10 | cross-principal | superadmin token on `admin.product.getProducts` | 401/500; no data leak | | AUTH-11 | suspended | suspended user on any user endpoint | rejected before resolver | | AUTH-12 | expired | expired user/staff/superadmin tokens | 401 | | AUTH-13 | forged | token signed with wrong secret | 401 | | AUTH-14 | wrong role | user token on `common.getStoresSummary` | 500/error because `ctx.staffUser` absent; assert no data | > The current branch has known `protectedProcedure` gaps on admin reads and several admin writes. > Keep those as explicit “current” cases until the guards are changed to `staffProcedure`. ### 3.3 Common request-shape edge cases | ID | Type | Case | Assert | | --- | --- | --- | --- | | REQ-01 | edge | unknown procedure path | 404/NOT_FOUND | | REQ-02 | edge | wrong HTTP verb for mutation | method not supported | | REQ-03 | edge | missing required input | BAD_REQUEST with field name | | REQ-04 | edge | wrong type (string where number) | BAD_REQUEST | | REQ-05 | edge | extra unknown fields | stripped, not written | | REQ-06 | edge | `null` for optional field | accepted/rejected per schema | | REQ-07 | edge | batch request with one failure | other results still returned; failure isolated | | REQ-08 | edge | very large array | bounded by schema (where max exists) | | REQ-09 | edge | negative id | zod positive rejection where declared | | REQ-10 | edge | float where int expected | BAD_REQUEST | | REQ-11 | edge | empty string required field | BAD_REQUEST | | REQ-12 | edge | SQL-like search strings | treated as text, no SQL error | | REQ-13 | edge | Unicode/emoji names | stored/returned unchanged | | REQ-14 | edge | leading/trailing whitespace | trimmed where code trims; assert per procedure | | REQ-15 | edge | concurrent identical mutation | both return or one conflict; no duplicate unique key crash | --- ## 4. Cache contract suite `common.essentialConsts({boundId})` is the source of truth for the version numbers. Cache files are public and versioned: ``` products ${assetsDomain}${apiCacheKey}/regions/${regionId}/v-${products_version_num}/products.json essential consts ${assetsDomain}${apiCacheKey}/regions/${regionId}/v-${products_version_num}/essential-consts.json stores ${assetsDomain}${apiCacheKey}/regions/${regionId}/v-${products_version_num}/stores.json store detail ${assetsDomain}${apiCacheKey}/regions/${regionId}/v-${products_version_num}/stores/.json banners ${assetsDomain}${apiCacheKey}/regions/${regionId}/v-${products_version_num}/banners.json slots ${assetsDomain}regions/${regionId}/slots/v-${slots_version_num}/slots.json availability ${assetsDomain}regions/${regionId}/av-${availability_version_num}/availability.json ``` ### 4.1 Essential constants | ID | Type | Case | Assert | | --- | --- | --- | --- | | CACHE-01 | happy | `common.essentialConsts({boundId})` | `regionId`, `boundId`, `assetsDomain`, `apiCacheKey` present | | CACHE-02 | happy | global fields | `versionNum`, `playStoreUrl`, `appStoreUrl`, `internalAppVersion` | | CACHE-03 | happy | region fields | `products_version_num`, `availability_version_num`, `slots_version_num`, `popularItems`, `allItemsOrder`, `supportMobile`, `supportEmail`, `welcomeMessage` | | CACHE-04 | happy | bound fields | `freeDeliveryThreshold`, `deliveryCharge`, `flashFreeDeliveryThreshold`, `flashDeliveryCharge` | | CACHE-05 | happy | flash flag | `isFlashDeliveryEnabled` boolean | | CACHE-06 | edge | missing numeric const | fallback 200/0/500/69 per scaffold | | CACHE-07 | edge | empty string const | fallback used | | CACHE-08 | edge | non-numeric const | fallback used | | CACHE-09 | edge | boolean `true` / `1` | true | | CACHE-10 | edge | boolean `false` / `0` / other | false | | CACHE-11 | edge | missing string const | empty string | | CACHE-12 | edge | unknown bound id | 404 `Bound not found` | | CACHE-13 | edge | bound from another region | payload uses that bound's region | | CACHE-14 | edge | global < region < bound precedence | bound value wins | | CACHE-15 | edge | KV miss | payload built from D1 and backfilled | | CACHE-16 | edge | KV hit | served without rebuild (observable via changed DB value not yet refreshed) | | CACHE-17 | edge | host contains `raw` | `webviewHtml` update notice; `isWebviewClosable:false` | | CACHE-18 | edge | host contains `mf` | same update notice | | CACHE-19 | edge | normal host | `webviewHtml:null`, closable true | | CACHE-20 | edge | region constants update | refreshed KV reflects new support values | | CACHE-21 | edge | bound settings update | refreshed KV reflects new threshold/charge | | CACHE-22 | edge | global constants update | refreshed KV reflects new version/store URLs | | CACHE-23 | edge | missing assets domain/cache key env | payload null/empty; cache tests should fail with actionable message | | CACHE-24 | edge | bound deleted and recreated | old KV key removed; new bound does not serve stale payload | | CACHE-115 | happy | `essentialUrls` in API + KV | products/stores/banners/essential-consts under the cache key; availability/slots outside it; store template substitutes | ### 4.2 products.json | ID | Type | Case | Assert | | --- | --- | --- | --- | | CACHE-25 | happy | file exists at current version | valid JSON, `products` array + `count` | | CACHE-26 | happy | count | `count === products.length` | | CACHE-27 | happy | product fields | id/name/shortDescription/unit/unitNotation/incrementStep/productQuantity/storeId/isOutOfStock/nextDeliveryDate/images/productType/isComboOnly/price/marketPrice/flashPrice/isFlashAvailable | | CACHE-28 | edge | image keys | converted to public asset URLs | | CACHE-29 | edge | suspended SKU | absent | | CACHE-30 | edge | combo-only SKU | present with `isComboOnly:true` (client hides it) | | CACHE-31 | edge | out-of-stock SKU | present with flag | | CACHE-32 | edge | nextDeliveryDate | latest in-region future/available slot or null | | CACHE-33 | edge | price numeric | number, not string/null | | CACHE-34 | edge | storeId | number or null | | CACHE-35 | edge | tag order | follows `tagsOrder` region constant; unknown tags after | | CACHE-36 | edge | tag product order | follows tag `sortOrder`; unknown ids after | | CACHE-37 | edge | tag image | signed/public URL | | CACHE-38 | edge | tag with no products | `productIds:[]` | | CACHE-39 | edge | product not in any tag | still in products array | | CACHE-40 | edge | duplicate tag mapping | product id once per tag | | CACHE-41 | cache | product create | version increments; new product appears after 30–60s | | CACHE-42 | cache | product update | version increments; updated name/price/images appear | | CACHE-43 | cache | product delete | version increments; product disappears | | CACHE-44 | cache | tag create/update/delete | version increments; tag appears/renames/disappears | | CACHE-45 | cache | `tagsOrder` update | version increments; order changes | | CACHE-46 | cache | store name update | products file's store-facing data eventually reflects | | CACHE-47 | edge | two writes in one debounce window | one rebuild includes both; versions still monotonic | | CACHE-48 | edge | global product edit | every region's cache rebuilds (`allRegionsPending`) | | CACHE-49 | edge | regional edit while global pending | regional request does not narrow the global rebuild | | CACHE-50 | edge | first file 404 after version bump | poll same URL until ready; do not assume atomic | ### 4.3 stores.json and store detail | ID | Type | Case | Assert | | --- | --- | --- | --- | | CACHE-51 | happy | stores file | every store: id/name/description/signedImageUrl/productCount/sampleProducts | | CACHE-52 | happy | detail file | `store.id`, products, tags | | CACHE-53 | edge | productCount | equals detail products length after rebuild | | CACHE-54 | edge | sample products | only in-region products; image URLs | | CACHE-55 | edge | store with no products | productCount 0 | | CACHE-56 | edge | global store | visible without region ownership? assert current | | CACHE-57 | edge | store image missing | null | | CACHE-58 | cache | create store | `stores.json` + `stores/.json` appear | | CACHE-59 | cache | update store | name/description/image update | | CACHE-60 | cache | delete store | removed after rebuild | | CACHE-61 | edge | detail file can be a later version than captured | resolve current version each poll | | CACHE-62 | edge | cross-region store | absent from other region's stores/detail | | CACHE-113 | edge | global store with a global product | productCount/samples include global products; count matches detail | | CACHE-114 | edge | global store tagged in the region | detail keeps the region-scoped tag | ### 4.4 slots.json | ID | Type | Case | Assert | | --- | --- | --- | --- | | CACHE-63 | happy | slots file | valid JSON; count | | CACHE-64 | happy | slot fields | id/deliveryTime/freezeTime/products | | CACHE-65 | edge | slot delivery past | excluded | | CACHE-66 | edge | slot freeze past | excluded | | CACHE-67 | edge | capacity full | excluded | | CACHE-68 | edge | product images | public URLs | | CACHE-69 | edge | productAvailability | present in slots payload | | CACHE-70 | cache | create slot | `slots_version_num` increments synchronously; new slot present | | CACHE-71 | cache | update slot | version increments; times updated | | CACHE-72 | cache | capacity full | version increments; slot removed | | CACHE-73 | cache | capacity restored | version increments; slot returns | | CACHE-74 | edge | cross-region slot | absent | | CACHE-75 | edge | slot with no products | present with empty products | | CACHE-76 | edge | unknown vendor snippet/group ids | slot still created or 400 per DB validation; assert current | ### 4.5 availability.json | ID | Type | Case | Assert | | --- | --- | --- | --- | | CACHE-77 | happy | availability file | array + count | | CACHE-78 | happy | entry key | `id` is SKU id, not product id | | CACHE-79 | happy | flags | price/marketPrice/flashPrice/isFlashAvailable/isOutOfStock/isOffer/isSuspended | | CACHE-80 | cache | toggle product out of stock | version increments synchronously; all SKU entries true | | CACHE-81 | cache | toggle one SKU | only that SKU changes; product aggregate matches | | CACHE-82 | cache | update price | version increments synchronously; price updates | | CACHE-83 | cache | update flash price/flag | version increments; fields update | | CACHE-84 | cache | invalid SKU in batch | 400 with invalid ids; assert whether valid rows were written (current path is not guaranteed atomic) | | CACHE-85 | edge | suspended SKU | flag true/absent per current implementation | | CACHE-86 | edge | missing availability row for product | products merge defaults 0/false; cache consistency may fail | | CACHE-87 | edge | cross-region SKU | absent | ### 4.6 banners.json and essential-consts.json | ID | Type | Case | Assert | | --- | --- | --- | --- | | CACHE-88 | happy | banners file | `banners` array; active only | | CACHE-89 | edge | banner fields | id/name/imageUrl/description/skuIds/redirectUrl/serialNum/isActive | | CACHE-90 | edge | skuIds migration | always array | | CACHE-91 | cache | create banner | appears after rebuild; initially inactive if create defaults inactive | | CACHE-92 | cache | activate/update banner | updated fields appear | | CACHE-93 | cache | delete banner | disappears | | CACHE-94 | happy | essential-consts file | flat payload; version fields numeric | | CACHE-95 | edge | file version matches path | `products_version_num` equals path version | | CACHE-96 | edge | essential-consts lag | slots/availability versions may lag live; test only numeric/stable fields | | CACHE-97 | edge | bound/region identity | match effective bound used to build | | CACHE-98 | edge | webview fields in file | null/closable (file build uses default host) | | CACHE-116 | happy | `essentialUrls` in the file | matches the file's own version fields; availability/slots outside the cache key | ### 4.7 Cross-file invariants | ID | Type | Case | Assert | | --- | --- | --- | --- | | CACHE-99 | invariant | every availability SKU maps to a product | 0 orphans after convergence | | CACHE-100 | invariant | every slot product maps to a product | 0 orphans after convergence | | CACHE-101 | invariant | every store detail productCount matches | all stores | | CACHE-102 | invariant | no cross-region product/store/slot ids | 0 leaks | | CACHE-103 | invariant | every file is valid JSON | parse all | | CACHE-104 | invariant | version counters monotonic | no decrease across writes | | CACHE-105 | invariant | cache rebuild non-atomic | tolerate temporary mismatches; poll to convergence | | CACHE-106 | invariant | public access | files readable with no Authorization header | | CACHE-107 | invariant | cache purge | changed file served after purge/rebuild, not stale CDN copy | | CACHE-108 | edge | cache creator global pending | all regions eventually advance | | CACHE-109 | edge | cache creator regional pending | only requested region advances | | CACHE-110 | edge | no CACHE_CREATOR binding | schedule logs warning; API mutation still succeeds | | CACHE-111 | edge | cache upload fails | mutation succeeds; error logged; no partial DB rollback | | CACHE-112 | edge | repeated rebuilds | versions strictly increase; no duplicate counters | --- ## 5. Common router ### 5.1 `common.product.getAllProductsSummary` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-01 | happy | staff call | products from staff region only | | COMMON-02 | edge | no products | `{products:[],count:0}` | | COMMON-03 | edge | suspended SKU | filtered | | COMMON-04 | edge | tags ordering | follows region tagsOrder | | COMMON-05 | edge | tag product order | follows sortOrder | | COMMON-06 | edge | image keys | public URLs | | COMMON-07 | edge | user token | current `protectedProcedure` allows call but `ctx.staffUser` may be null → assert current | | COMMON-08 | edge | no token | 401 | | COMMON-09 | edge | other-region staff | sees only its region | | COMMON-10 | edge | product with multiple SKUs | each SKU represented as its own entry | ### 5.2 `common.product.getAllSkusSummary` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-11 | happy | staff call | SKU ids/names/price/unit/features | | COMMON-12 | edge | empty region | empty array | | COMMON-13 | edge | suspended/out-of-stock | present with flags (picker) | | COMMON-14 | edge | multi-SKU product | all SKUs | | COMMON-15 | edge | region isolation | no foreign SKU | | COMMON-16 | edge | no token | 401 | | COMMON-17 | edge | global SKU price | uses the caller region’s market row (not 0) | | COMMON-18 | edge | global SKU regional suspension | hidden only in the suspending region | ### 5.3 `common.getStoresSummary` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-17 | happy | staff call | stores with id/name/product counts | | COMMON-18 | edge | empty region | empty | | COMMON-19 | edge | user token | current 500/no data; assert no leak | | COMMON-20 | edge | no token | 401 | | COMMON-21 | edge | cross-region | only own region | ### 5.4 `common.checkLocationInPolygon` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-22 | happy | point inside Mahabubnagar polygon | `{isInside:true}` | | COMMON-23 | happy | point outside | false | | COMMON-24 | edge | boundary point | deterministic true/false | | COMMON-25 | edge | lat/lng at limits | accepted where within range | | COMMON-26 | edge | lat > 90 / lng > 180 | BAD_REQUEST | | COMMON-27 | edge | non-number | BAD_REQUEST | | COMMON-28 | edge | (0,0) | false, no crash | | COMMON-29 | edge | no token | succeeds (public) | ### 5.5 `common.generateUploadUrls` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-30 | happy | review context, png | URL contains `review-images/` and `.png` | | COMMON-31 | happy | product_info jpeg | `product-images/`, `.jpg` | | COMMON-32 | happy | store png | `store-images/` | | COMMON-33 | happy | review_response | `review-response-images/` | | COMMON-34 | happy | complaint gif | `complaint-images/`, `.gif` | | COMMON-35 | happy | profile | `profile-images/` | | COMMON-36 | happy | tags | `tags/` | | COMMON-37 | happy | notification | `notification-images/` (common router) | | COMMON-38 | edge | empty mimeTypes | `{uploadUrls:[]}` | | COMMON-39 | edge | unknown mime | `.jpg` fallback | | COMMON-40 | edge | unknown context | BAD_REQUEST | | COMMON-41 | edge | user/staff/superadmin token | all allowed by `authenticatedProcedure` | | COMMON-42 | edge | no token | 401 | | COMMON-43 | error | S3 presign fails | 500 `Failed to generate upload URL` | | COMMON-44 | edge | two same mime in one call | assert key collision behavior; do not rely on it | | COMMON-45 | edge | pending upload row | one per URL created; claim test in upload suite | ### 5.6 `common.healthCheck` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-46 | happy | call | truthy status | | COMMON-47 | edge | public | no token | | COMMON-48 | error | DB down | error/500 not hang | ### 5.7 `common.listRegions` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-49 | happy | call | regions with id/name/description/center/effectiveBoundId | | COMMON-50 | edge | no regions | empty array | | COMMON-51 | edge | bounds not included/aggregate | assert current shape | | COMMON-52 | edge | public | no token | ### 5.8 `common.resolveRegionByLocation` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-53 | happy | point inside region/bound | resolves region + lowest-priority containing bound | | COMMON-54 | edge | outside every bound | null | | COMMON-55 | edge | point inside overlapping bounds | lowest priority number wins | | COMMON-56 | edge | invalid lat/lng | BAD_REQUEST | | COMMON-57 | edge | boundary | deterministic | | COMMON-58 | edge | public | no token | ### 5.9 `common.resolveBound` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-59 | happy | point in region bound | `{regionId,boundId}` | | COMMON-60 | error | point outside region | 422 | | COMMON-61 | error | unknown region | 422/404 | | COMMON-62 | edge | overlapping bounds | lowest priority | | COMMON-63 | edge | invalid inputs | BAD_REQUEST | | COMMON-64 | edge | public | no token | ### 5.10 `common.regionSettings` / `common.activeBound` | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-65 | happy | regionSettings | effective lowest-priority bound settings | | COMMON-66 | error | region with no bound | 422 | | COMMON-67 | error | unknown region | 422 | | COMMON-68 | edge | activeBound signed out | effective bound | | COMMON-69 | edge | activeBound user with address in region | least-priority bound among addresses | | COMMON-70 | edge | user with two addresses in same region | lowest priority wins | | COMMON-71 | edge | user address in another region only | effective bound, no leak | | COMMON-72 | edge | no bound | `boundId:null` | | COMMON-73 | edge | invalid region | BAD_REQUEST | ### 5.11 `common.essentialConsts` Covered comprehensively by section 4 (CACHE-01..24); add procedure-level cases: | ID | Type | Case | Assert | | --- | --- | --- | --- | | COMMON-74 | edge | missing `boundId` input (legacy no-arg call) | falls back to bound 1 / region 1 | | COMMON-75 | edge | boundId 0/negative/float | BAD_REQUEST | | COMMON-76 | edge | no token | succeeds | | COMMON-77 | edge | response shape flat (no nesting) | all keys at root | | COMMON-78 | edge | `webviewHtml` only for raw/mf host | assert with `Host` header override | --- ## 6. User router ### 6.1 `user.auth.login` | ID | Type | Case | Assert | | --- | --- | --- | --- | | UAUTH-01 | happy | email + password | token + user payload | | UAUTH-02 | happy | mobile + password | token + user | | UAUTH-03 | edge | email uppercase | case-insensitive lookup | | UAUTH-04 | edge | email with surrounding spaces | current behavior: identifier not trimmed before lookup; assert | | UAUTH-05 | edge | mobile with country code | lookup by raw identifier; current behavior | | UAUTH-06 | error | unknown identifier | 401 `Invalid credentials` | | UAUTH-07 | error | wrong password | 401 | | UAUTH-08 | error | missing identifier/password | BAD_REQUEST | | UAUTH-09 | error | account without credentials | 401 `Account setup incomplete` | | UAUTH-10 | happy | profile image set | signed URL in response | | UAUTH-11 | edge | caller-interface web | auth cookie | | UAUTH-12 | edge | mobile caller | no cookie | | UAUTH-13 | edge | suspended user login | login succeeds; subsequent requests blocked (assert current) | | UAUTH-14 | edge | token lifetime/shape | JWT userId claim | | UAUTH-15 | edge | no token returned in body? | token present | ### 6.2 `user.auth.register` | ID | Type | Case | Assert | | --- | --- | --- | --- | | UREG-01 | happy | valid registration | user + token + persisted profile | | UREG-02 | edge | name/email trimmed, email lowercased, mobile digits cleaned | stored normalized | | UREG-03 | error | name empty | BAD_REQUEST | | UREG-04 | error | invalid email | BAD_REQUEST | | UREG-05 | error | duplicate email (case-insensitive) | 409 | | UREG-06 | error | mobile not 10 digits / not 6–9 | 400 | | UREG-07 | error | duplicate mobile | 409 | | UREG-08 | edge | mobile with spaces/dashes | cleaned; duplicate check uses cleaned | | UREG-09 | edge | profileImageUrl | signed URL in response | | UREG-10 | edge | caller web | cookie | | UREG-11 | edge | concurrent same email/mobile | one succeeds, one 409 | | UREG-12 | edge | password hash | never returned; login works | | UREG-13 | edge | first user has no addresses | default address null | ### 6.3 `user.auth.sendOtp` / `verifyOtp` | ID | Type | Case | Assert | | --- | --- | --- | --- | | UOTP-01 | happy | send OTP valid mobile | success/message; OTP stored | | UOTP-02 | edge | invalid mobile | current OTP util behavior; assert | | UOTP-03 | edge | throttle/rapid resend | assert current (no throttle or provider response) | | UOTP-04 | edge | verify without send | 400 `OTP not sent or expired` | | UOTP-05 | edge | wrong OTP | 400 `Invalid OTP` | | UOTP-06 | edge | expired OTP | 400 | | UOTP-07 | happy | verify existing user | token + user | | UOTP-08 | happy | verify new mobile | creates user + token | | UOTP-09 | edge | verify consumes OTP | second verify fails/current | | UOTP-10 | edge | web caller | cookie | | UOTP-11 | edge | response token duplicated? | assert current shape has token | | UOTP-12 | edge | malformed mobile/otp | BAD_REQUEST/provider error | ### 6.4 `user.auth.updatePassword` | ID | Type | Case | Assert | | --- | --- | --- | --- | | UPASS-01 | happy | new password ≥6 | success; old password fails; new works | | UPASS-02 | error | <6 | BAD_REQUEST | | UPASS-03 | edge | no token | 401 | | UPASS-04 | edge | account with no password | row inserted; login works | | UPASS-05 | edge | repeated update | latest wins | | UPASS-06 | edge | staff token | rejected/500 no user | ### 6.5 `user.auth.updateProfile` | ID | Type | Case | Assert | | --- | --- | --- | --- | | UPROF-01 | happy | name/email/mobile | updated; response reflects | | UPROF-02 | edge | empty email | leaves email unchanged | | UPROF-03 | edge | invalid email | 400 | | UPROF-04 | edge | duplicate email | 409 | | UPROF-05 | edge | invalid/duplicate mobile | 400/409 | | UPROF-06 | edge | password | hashed; login with new password | | UPROF-07 | edge | bio/dateOfBirth/gender/occupation | round-trip | | UPROF-08 | edge | profileImageUrl | signed URL | | UPROF-09 | edge | partial update | omitted fields unchanged | | UPROF-10 | edge | no token | 401 | | UPROF-11 | edge | other user's email/mobile | 409, no takeover | | UPROF-12 | edge | invalid dateOfBirth | current behavior; assert | | UPROF-13 | edge | response token | same bearer token returned | ### 6.6 `user.auth.deleteAccount` | ID | Type | Case | Assert | | --- | --- | --- | --- | | UDEL-01 | happy | matching mobile | success; user cannot login; data removed | | UDEL-02 | error | wrong mobile | 400 | | UDEL-03 | edge | formatting differences | cleaned digits match | | UDEL-04 | error | mobile <10 | BAD_REQUEST | | UDEL-05 | error | no token | 401 | | UDEL-06 | error | nonexistent user token | 404 | | UDEL-07 | edge | other user's mobile | 400 | | UDEL-08 | edge | address/order/complaint/review cleanup | assert no orphan/cascade per schema | | UDEL-09 | edge | token after deletion | any request fails/expired identity | ### 6.7 Address API | ID | Type | Case | Assert | | --- | --- | --- | --- | | UADDR-01 | happy | create first address | success; `isDefault:true` | | UADDR-02 | happy | second address non-default | stays false | | UADDR-03 | edge | explicit default | unsets previous | | UADDR-04 | edge | phone regex valid 6–9 | accepted | | UADDR-05 | error | phone invalid | BAD_REQUEST | | UADDR-06 | edge | coords inside bound | boundId derived | | UADDR-07 | edge | no coords | effective bound fallback | | UADDR-08 | error | coords outside region | 422 | | UADDR-09 | edge | googleMapsUrl fallback | coords extracted | | UADDR-10 | edge | malformed googleMapsUrl | no coords → effective bound or 422; assert | | UADDR-11 | edge | region required | BAD_REQUEST | | UADDR-12 | edge | optional line2 | round-trip | | UADDR-13 | edge | user isolation | other user cannot read/update/delete | | UADDR-14 | happy | getDefaultAddress | default or null | | UADDR-15 | happy | getUserAddresses | own only, ordered as DB | | UADDR-16 | happy | update all fields | round-trip | | UADDR-17 | edge | update without isDefault | preserves | | UADDR-18 | edge | update to default | unsets old | | UADDR-19 | edge | update coords | backfilled flag cleared | | UADDR-20 | edge | update moves region | region/bound updated; user-region reconciled | | UADDR-21 | error | update other user's address | not found | | UADDR-22 | error | update missing | not found | | UADDR-23 | error | delete only address | 409 | | UADDR-24 | error | delete default | 409 | | UADDR-25 | error | delete address with ongoing order | 409 | | UADDR-26 | happy | delete non-default with another address | success | | UADDR-27 | error | delete other user's | 404 | | UADDR-28 | edge | delete triggers region/token reconcile | token region follows remaining address | | UADDR-29 | edge | no token | 401 | | UADDR-30 | edge | invalid id/region | BAD_REQUEST | ### 6.8 Cart slots | ID | Type | Case | Assert | | --- | --- | --- | --- | | UCART-01 | happy | one product with slots | map productId → slots | | UCART-02 | edge | empty productIds | `{}` | | UCART-03 | edge | unknown SKU | `[]` | | UCART-04 | edge | SKU from another region | `[]` | | UCART-05 | edge | region required | BAD_REQUEST | | UCART-06 | edge | past/full slots | filtered by slot store | | UCART-07 | edge | global SKU | served in requested region | | UCART-08 | edge | no token | public | ### 6.9 Complaints | ID | Type | Case | Assert | | --- | --- | --- | --- | | UCOMP-01 | happy | raise without order | success; own list contains | | UCOMP-02 | happy | raise with numeric order id | linked | | UCOMP-03 | edge | `ORD123` / `ORD-123` | linked | | UCOMP-04 | edge | invalid order string | saved with null orderId | | UCOMP-05 | error | empty body | BAD_REQUEST | | UCOMP-06 | edge | body trimmed | stored trimmed | | UCOMP-07 | happy | images | URLs stored/returned signed | | UCOMP-08 | happy | getAll | own only | | UCOMP-09 | edge | another user cannot see | isolation | | UCOMP-10 | edge | cross-user order id | current behavior: no ownership check; assert gap | | UCOMP-11 | edge | no token | 401 | ### 6.10 User coupons | ID | Type | Case | Assert | | --- | --- | --- | --- | | UCOUP-01 | happy | getEligible | visible coupons + `isFirstOrder` | | UCOUP-02 | edge | expired | excluded | | UCOUP-03 | edge | invalidated | excluded | | UCOUP-04 | edge | usage limit reached | excluded | | UCOUP-05 | edge | other user's personal coupon | excluded | | UCOUP-06 | edge | min-order/region ineligible | still returned for client disabled state | | UCOUP-07 | edge | first-order-only non-first | current `getEligible` still returns? assert current | | UCOUP-08 | happy | getMyCoupons | personal/general split | | UCOUP-09 | edge | first-order-only non-first | filtered | | UCOUP-10 | edge | expired/invalidated | filtered | | UCOUP-11 | edge | used-up | included with `isUsedUp:true`? assert current | | UCOUP-12 | edge | region input | filter applies? assert current | | UCOUP-13 | happy | redeem valid secret | success; coupon appears | | UCOUP-14 | error | unknown code | 400 | | UCOUP-15 | error | expired secret | 400 | | UCOUP-16 | error | already redeemed by same user | 400 | | UCOUP-17 | error | first-order-only and user has order | 400 | | UCOUP-18 | edge | race two users redeem same secret | one success, one 400 | | UCOUP-19 | edge | no token | 401 | | UCOUP-20 | edge | secret case | lookup as supplied? assert current | | UCOUP-21 | error | coupon-code collision on redeem | redemption fails; reserved coupon stays unredeemed | ### 6.11 `user.order.placeOrder` All calls require `regionId`. A test helper should always pass it; the old suite’s omission is a known stale-test bug. #### Guards and input validation | ID | Type | Case | Assert | | --- | --- | --- | --- | | UORD-01 | happy | one SKU/one slot/COD | one order; total >0; items persisted | | UORD-02 | error | no token | 401 | | UORD-03 | error | suspended user | rejected before order; current context may surface 401 instead of the handler’s 403 `Unable to place order` — assert the actual contract | | UORD-04 | error | empty `selectedItems` | current raw DB/validation error; assert not success | | UORD-05 | error | quantity 0 | BAD_REQUEST | | UORD-06 | error | negative quantity | BAD_REQUEST | | UORD-07 | edge | huge quantity (1e9) | current cap absent; assert current or add cap | | UORD-08 | error | unknown SKU | `not found` rejection | | UORD-09 | error | SKU from another region | rejection / not found | | UORD-10 | error | suspended SKU | rejection | | UORD-11 | error | out-of-stock SKU | rejection | | UORD-12 | error | address id missing | `Invalid address` | | UORD-13 | error | address belongs to another user | `Invalid address` | | UORD-14 | edge | address coords outside region | region resolution rejects or falls back; assert current | | UORD-15 | edge | client `regionId` differs from address coords region | address coords win | | UORD-16 | edge | address has no coords but stored region | stored region used | | UORD-17 | edge | boundId supplied vs derived | address bound wins or validates; assert | | UORD-18 | error | regionId missing | BAD_REQUEST | | UORD-19 | error | invalid regionId | BAD_REQUEST | | UORD-20 | error | regular item with null slotId | rejection | | UORD-21 | error | regular item slot from another region | rejection | | UORD-22 | error | regular item slot not offered for SKU | rejection | | UORD-23 | error | regular item slot freeze passed | rejection | | UORD-24 | error | regular item slot capacity full | 403 capacity | | UORD-25 | edge | two items same slot | one order | | UORD-26 | edge | two items different slots | one order per slot, delivery charged once each | | UORD-27 | edge | flash order with slot ids | slot ids ignored/null | | UORD-28 | edge | flash disabled | 403 | | UORD-29 | edge | flash enabled + eligible SKU | order with `isFlashDelivery:true`, null slot | | UORD-30 | edge | flash enabled + ineligible SKU | rejection | | UORD-31 | edge | flash out-of-stock | rejection | | UORD-32 | edge | combo product | combo line/price accepted | | UORD-33 | edge | combo-only SKU direct order | assert accepted/rejected per stock rules | | UORD-34 | edge | duplicate same SKU lines | merged or separate per current; amount correct | | UORD-35 | edge | two slots with same SKU | separate orders, quantities correct | | UORD-36 | edge | userNotes | persisted | | UORD-37 | edge | long notes | accepted (no max declared) | | UORD-38 | edge | special chars/emoji notes | round-trip | | UORD-39 | edge | no coupons | no coupon usage rows | | UORD-40 | edge | one coupon | applied | | UORD-41 | edge | multiple coupons | sequential stack | | UORD-42 | edge | coupon from another region | rejected/not applied | | UORD-43 | edge | coupon owned by another user | rejected | | UORD-44 | edge | invalidated/expired coupon | rejected | | UORD-45 | edge | usage-limit coupon | rejected | | UORD-45B | edge | coupon with 2 permitted usages | two orders store the coupon; usageCount is 2; third order rejects with usage limit exceeded | | UORD-46 | edge | min-order not met | rejected/not applied | | UORD-47 | edge | targeted SKU coupon | discount only target | | UORD-47B | edge | targeted SKU coupon, target below minOrder but whole cart above it | accepted; discount only on target | | UORD-48 | edge | first-order-only | first works, second rejects | | UORD-49 | edge | exclusive coupon + another | reject or exclusive wins per contract | | UORD-50 | edge | 100%+ percentage coupon | total never negative; delivery still correct | | UORD-51 | edge | flat discount > goods | capped at goods | | UORD-52 | edge | fractional percentage | whole-rupee rounding | | UORD-53 | edge | delivery threshold after discount | delivery re-added | | UORD-54 | edge | flash threshold/charge | flash values used | | UORD-55 | edge | user coupon usage row | created with order/order group | | UORD-56 | edge | first-order flag | cleared/updated | | UORD-57 | edge | double-submit same payload | current no idempotency; assert two orders or add key | | UORD-58 | edge | two concurrent placeOrder | both persisted; no shared state corruption | | UORD-59 | edge | order publish/queue | queue failure does not roll back order; logged | | UORD-60 | edge | order grouping id | same `orderGroupId` across split orders | | UORD-61 | edge | order visibility | immediately in getOrders/getOrderById | | UORD-62 | edge | order region/cache | appears in region's order queries only | | UORD-63 | edge | address region/permission | cannot use address outside user | | UORD-64 | edge | no address at all | 400 | | UORD-65 | edge | stock changes between validation and write | transaction/stock check rejects | | UORD-66 | edge | slot capacity changes between validation and write | rejects or one succeeds | | UORD-67 | edge | price changes between quote and write | server price wins | | UORD-68 | edge | `isCod`/payment fields removed | payload only COD contract; no online path | | UORD-69 | edge | malformed selectedItems | BAD_REQUEST | | UORD-70 | edge | address with only one coordinate | current behavior; assert | #### Reads and lifecycle | ID | Type | Case | Assert | | --- | --- | --- | --- | | UORD-71 | happy | getOrders defaults | page 1/pageSize 10 | | UORD-72 | edge | pagination page 2 | different orders; no overlap | | UORD-73 | error | pageSize 51 | BAD_REQUEST | | UORD-74 | error | page 0 | BAD_REQUEST | | UORD-75 | edge | no orders | data [], totalCount 0, totalPages 0 | | UORD-76 | edge | pending status | deliveryStatus pending; orderStatus success | | UORD-77 | edge | all items packaged | deliveryStatus packaged | | UORD-78 | edge | delivered | deliveryStatus success | | UORD-79 | edge | cancelled | both cancelled; cancelReason | | UORD-80 | edge | mixed item packaging | pending until all packaged | | UORD-81 | edge | order item fields | name/skuName/quantity/unit/price/discountedPrice/amount/image | | UORD-82 | edge | order list user isolation | only own orders | | UORD-83 | edge | region fields | regionId/regionName from order region | | UORD-84 | edge | flash flag/date | isFlashDelivery | | UORD-85 | happy | getOrderById numeric string | detail matches | | UORD-86 | error | `ORD123`/`ORD-123` | parseInt behavior; assert current (likely 500 not found) | | UORD-87 | error | unknown id | not found | | UORD-88 | error | another user's order | not found | | UORD-89 | edge | detail coupon | couponCode/list, discountAmount from stored order | | UORD-90 | edge | detail totals | orderAmount/totalAmount/deliveryCharge | | UORD-91 | edge | detail cancellation | cancelReason | | UORD-92 | edge | detail flash | isFlashDelivery | | UORD-93 | happy | update notes pending | persisted | | UORD-94 | error | update notes delivered | 400 | | UORD-95 | error | update notes cancelled | 400 | | UORD-96 | error | update notes other user's order | not found | | UORD-97 | edge | empty notes | accepted (string no min) | | UORD-98 | happy | cancel pending own order | success; status cancelled; reason | | UORD-99 | error | cancel without/blank reason | BAD_REQUEST | | UORD-100 | error | cancel missing order | 404/generic | | UORD-101 | error | cancel another user's order | generic 500 `failed to cancel order` current | | UORD-102 | error | cancel already cancelled | 400/generic current | | UORD-103 | error | cancel delivered | 400/generic current | | UORD-104 | edge | cancel releases coupon usage | coupon usable again if applicable | | UORD-105 | edge | cancel clears first-order | first-order-only available again | | UORD-106 | edge | cancel publishes cancellation | queue/publish called; failure logged | | UORD-107 | edge | double cancel race | one success/one failure, no corrupt status | | UORD-108 | edge | order with orderGroup | cancellation updates group/status consistently | | UORD-108B | edge | grouped order with a usage-capped coupon; cancel siblings one by one | coupon stays exhausted until the last sibling is cancelled, then becomes reusable | ### 6.12 User product API | ID | Type | Case | Assert | | --- | --- | --- | --- | | UPROD-01 | happy | getProductDetails numeric id + region | product detail | | UPROD-02 | error | non-numeric id | BAD_REQUEST regex | | UPROD-03 | error | region missing | BAD_REQUEST | | UPROD-04 | error | unknown product | not found | | UPROD-05 | error | product owned by another region | not found | | UPROD-06 | edge | global SKU | served in requested region | | UPROD-07 | edge | cache hit | slots filtered to future/non-full | | UPROD-08 | edge | cache miss | DB fallback with signed images | | UPROD-09 | edge | no slots | empty deliverySlots | | UPROD-10 | edge | combo items/special deals/store | present per fixture | | UPROD-11 | happy | reviews pagination | limit/offset/hasMore | | UPROD-12 | error | limit 0/51 | BAD_REQUEST | | UPROD-13 | error | offset negative | BAD_REQUEST | | UPROD-14 | edge | no reviews | [] hasMore false | | UPROD-15 | happy | create review | success; visible in list | | UPROD-16 | error | rating 0/6 | BAD_REQUEST | | UPROD-17 | error | empty body | BAD_REQUEST | | UPROD-18 | error | unknown product | 404 | | UPROD-19 | edge | upload URLs/images | stored; signed URLs returned | | UPROD-20 | edge | unknown upload URL | logged, review still created (lenient) | | UPROD-21 | edge | no token create review | 401 | | UPROD-22 | edge | one review per user? | assert current (multiple allowed or rejected) | | UPROD-23 | edge | review images | signed | | UPROD-24 | edge | XSS string | stored/escaped, not executed | ### 6.13 User slots | ID | Type | Case | Assert | | --- | --- | --- | --- | | USLOT-01 | happy | getSlots region | future, non-full only | | USLOT-02 | edge | past delivery | excluded | | USLOT-03 | edge | past freeze | excluded | | USLOT-04 | edge | capacity full | excluded | | USLOT-05 | edge | unknown region | empty | | USLOT-06 | error | region missing | BAD_REQUEST | | USLOT-07 | edge | cross-region | no leak | | USLOT-08 | edge | no slots | count 0 | | USLOT-09 | edge | public | no token | | USLOT-10 | edge | products | id + images only | ### 6.14 User profile / push token | ID | Type | Case | Assert | | --- | --- | --- | --- | | UUSER-01 | happy | getSelfData | id/name/email/mobile/profile fields | | UUSER-02 | edge | profile image | signed URL | | UUSER-03 | edge | missing detail row | nulls, no crash | | UUSER-04 | error | deleted user token | 404 | | UUSER-05 | error | no token | 401 | | UUSER-06 | happy | savePushToken authenticated | token stored; region from address | | UUSER-07 | edge | authenticated, no address, region supplied | supplied region used | | UUSER-08 | edge | authenticated, no address/no region, prior unlogged token | prior region carried | | UUSER-09 | edge | notif_creds region column failure | token still stored without region | | UUSER-10 | happy | savePushToken unauthenticated | unlogged token stored | | UUSER-11 | edge | unlogged token with region | region stored | | UUSER-12 | edge | re-save token | upsert, no duplicate | | UUSER-13 | edge | address region wins over browser region | token follows address | | UUSER-14 | happy | recordTrackedRegion | success; association inserted/updated | | UUSER-15 | error | region invalid/missing | BAD_REQUEST | | UUSER-16 | edge | no token record | 401 | | UUSER-17 | edge | location association does not move token | current rule | ### 6.15 User file upload | ID | Type | Case | Assert | | --- | --- | --- | --- | | UUP-01 | happy | review jpeg | URL/key | | UUP-02 | happy | product_info png | folder/extension | | UUP-03 | happy | notification/tags/profile/complaint | folders | | UUP-04 | edge | empty mimeTypes | [] | | UUP-05 | edge | unknown mime | `.jpg` | | UUP-06 | error | invalid context | BAD_REQUEST | | UUP-07 | error | no token | 401 | | UUP-08 | error | S3 failure | 500 | | UUP-09 | edge | `review_response` context | current enum excludes it here; assert BAD_REQUEST if used | | UUP-10 | edge | one pending row per URL | pending status exists | ### 6.16 User complaint API Covered by UCOMP-01..11. Add admin-side cases in section 7. --- ## 7. Admin router ### 7.1 `admin.staffUser` — login/identity | ID | Type | Case | Assert | | --- | --- | --- | --- | | ASTAFF-01 | happy | staff login | token + staff id/name/regionId | | ASTAFF-02 | error | unknown name | 401 invalid credentials | | ASTAFF-03 | error | wrong password | 401 | | ASTAFF-04 | error | missing fields | 400 | | ASTAFF-05 | happy | `me` | id/name/regionId/regionName | | ASTAFF-06 | error | `me` no token | 401 | | ASTAFF-07 | edge | `me` user token | rejected/500 no staff | | ASTAFF-08 | happy | getStaff | staff list; role/permissions | | ASTAFF-09 | edge | user token getStaff | current protected read allows; assert gap | | ASTAFF-10 | happy | getRoles | roles list | | ASTAFF-11 | happy | createStaffUser | staff created; login works | | ASTAFF-12 | error | duplicate name | 409 | | ASTAFF-13 | error | password <6 | BAD_REQUEST | | ASTAFF-14 | error | invalid role | 400 | | ASTAFF-15 | edge | createStaffUser region id? | current derives staff region; assert | | ASTAFF-16 | happy | savePushToken | stored | | ASTAFF-17 | error | no staff | 401 | | ASTAFF-18 | happy | sendAdminNotification | queued count/message | | ASTAFF-19 | error | empty title/text | BAD_REQUEST | | ASTAFF-20 | edge | no admins with tokens | queued 0, success | | ASTAFF-21 | edge | queue push fails | logged; success? assert current | | ASTAFF-22 | edge | user token on sendAdminNotification | rejected | ### 7.2 `admin.banner` | ID | Type | Case | Assert | | --- | --- | --- | --- | | ABAN-01 | happy | getBanners empty | [] | | ABAN-02 | happy | getBanners populated | only staff region; skuIds array; image URL | | ABAN-03 | edge | no image | imageUrl null | | ABAN-04 | happy | getBanner | by id | | ABAN-05 | error | unknown banner | null? assert current returns null | | ABAN-06 | error | other-region banner | null | | ABAN-07 | happy | createBanner | banner created inactive, serial 999, skuIds default [] | | ABAN-08 | error | name empty | BAD_REQUEST | | ABAN-09 | error | invalid image URL | BAD_REQUEST | | ABAN-10 | edge | no image | imageUrl required in schema; assert | | ABAN-11 | edge | redirectUrl invalid | BAD_REQUEST | | ABAN-12 | edge | URL key extraction | stored object key | | ABAN-13 | edge | send notification? | create does not notify; assert | | ABAN-14 | happy | update name/active/serial/skuIds | round-trip | | ABAN-15 | edge | update image replaces key | old key deletion? assert current | | ABAN-16 | edge | update serial null | null accepted | | ABAN-17 | error | update unknown | 404 | | ABAN-18 | happy | delete | success; getBanner null | | ABAN-19 | error | delete unknown | 404 | | ABAN-20 | edge | user token write | current protected gap; assert | | ABAN-21 | cache | create/update/delete | schedule cache; banners.json eventually | ### 7.3 `admin.complaint` | ID | Type | Case | Assert | | --- | --- | --- | --- | | ACOMP-01 | happy | getAll | complaints for staff region | | ACOMP-02 | edge | pagination cursor/limit | nextCursor | | ACOMP-03 | edge | empty | [] | | ACOMP-04 | edge | status mapping | resolved/pending | | ACOMP-05 | edge | images signed | | | ACOMP-06 | happy | resolve | response stored; status resolved | | ACOMP-07 | error | unknown id | not found | | ACOMP-08 | error | empty response | BAD_REQUEST | | ACOMP-09 | edge | response trimmed | stored trimmed | | ACOMP-10 | edge | user notified | queue called; no tokens tolerated | | ACOMP-11 | edge | other-region complaint | not found | | ACOMP-12 | edge | user token | current protected gap; assert | ### 7.4 `admin.product` #### Reads | ID | Type | Case | Assert | | --- | --- | --- | --- | | APROD-01 | happy | getProducts | all products/SKUs in region | | APROD-02 | edge | empty | [] | | APROD-03 | edge | image signing | SKU images public URLs | | APROD-04 | edge | suspended/deleted | current inclusion | | APROD-05 | happy | getProductById | product + skus | | APROD-06 | error | unknown | 404 | | APROD-07 | error | other region | 404 | | APROD-08 | edge | user token read | current gap | | APROD-09 | happy | getProductReviews | limit/offset/hasMore | | APROD-10 | error | limit 0/51 | BAD_REQUEST | | APROD-11 | edge | no reviews | [] | | APROD-12 | edge | signed image arrays | | | APROD-13 | happy | getGroups | groups with SKUs | | APROD-14 | happy | getProductTags | tags + message | | APROD-15 | happy | getProductTagById | tag/products/productIds | | APROD-16 | error | unknown tag | 404 | #### Create/update/delete | ID | Type | Case | Assert | | --- | --- | --- | --- | | APROD-17 | happy | create product | product/SKU IDs; feature quantity; images | | APROD-18 | error | duplicate name | 400 | | APROD-19 | error | name empty | BAD_REQUEST | | APROD-20 | error | storeId 0/missing | BAD_REQUEST | | APROD-21 | error | no SKUs | BAD_REQUEST | | APROD-22 | error | price 0/negative | BAD_REQUEST | | APROD-23 | error | no feature | BAD_REQUEST | | APROD-24 | error | feature value empty | BAD_REQUEST | | APROD-25 | edge | multiple SKUs | all created | | APROD-26 | edge | combo type + combo items | stored | | APROD-27 | edge | flash fields | stored | | APROD-28 | edge | marketPrice null | stored null | | APROD-29 | edge | image upload URLs | keys stored/claim | | APROD-30 | error | fabricated/reused image key | rejected before write | | APROD-31 | edge | no images | [] | | APROD-32 | edge | duplicate SKU names? | assert current | | APROD-33 | cache | create schedule | products version eventually | | APROD-34 | happy | update product | fields/SKUs update | | APROD-35 | error | update unknown | 404 | | APROD-36 | error | update name empty/price invalid | BAD_REQUEST | | APROD-37 | edge | update SKU id omitted | create new/current semantics | | APROD-38 | edge | deleting images | deletedImageKeys removed after update | | APROD-39 | edge | new image URL validation | claim before delete | | APROD-40 | edge | current image re-sent | not treated as new | | APROD-41 | edge | regional suspension | stored in product_market_stats.is_suspended_in_region | | APROD-42 | cache | update schedule | eventually | | APROD-43 | error | delete product with SKUs | current FK/raw failure; assert rejection | | APROD-44 | error | delete unknown | 404 | | APROD-45 | edge | delete image cleanup | best-effort | | APROD-46 | happy | toggle whole product out of stock | all SKUs flip; availability sync | | APROD-47 | happy | toggle specific SKUs | only those flip; ignored IDs 400 | | APROD-48 | edge | skuIds without isOutOfStock | 400 | | APROD-49 | edge | partial variants | product aggregate/partial message | | APROD-50 | error | unknown product/SKU | 404/400 | | APROD-51 | happy | update prices | updatedCount/message | | APROD-52 | error | empty updates | 400 | | APROD-53 | error | invalid SKU id | 400 with ids | | APROD-54 | error | no price fields | 400 | | APROD-55 | cache | price update | availability version sync | | APROD-56 | happy | create group | group returned | | APROD-57 | happy | update group | name/description/products | | APROD-58 | error | update unknown group | 404 | | APROD-59 | happy | delete group | success | | APROD-60 | error | delete unknown group | 404 | | APROD-61 | happy | create tag | tag + product mapping | | APROD-62 | error | duplicate tag name | 400 | | APROD-63 | error | empty tag name | BAD_REQUEST | | APROD-64 | edge | tag image URL | normalized/signed | | APROD-65 | edge | relatedStores/productIds | stored/mapped | | APROD-66 | edge | upload URL validation | before tag write | | APROD-67 | happy | update tag | rename/image/products | | APROD-68 | error | update unknown | 404 | | APROD-69 | edge | image replacement cleanup | old image deleted best-effort | | APROD-70 | happy | delete tag | success; image cleanup best-effort | | APROD-71 | error | delete unknown | 404 | | APROD-72 | cache | tag writes | products version eventually | | APROD-73 | happy | respond to review | response/images stored | | APROD-74 | error | unknown review | 404 | | APROD-75 | edge | empty response/images | accepted? assert | | APROD-76 | edge | upload URLs claim | validated/claimed | | APROD-77 | edge | user token write | current gap | | APROD-78 | happy | regional admin edits a global product | market data only | | APROD-79 | error | regional admin changes global structure | 403, rejected fields named | | APROD-80 | error | regional admin deletes a global image | 403; image key kept | | APROD-81 | error | regional update sets the structural isSuspended | global flag untouched | | APROD-82 | edge | regional create with isSuspended | region flag set; global false | ### 7.5 `admin.order` | ID | Type | Case | Assert | | --- | --- | --- | --- | | AORD-01 | happy | getAll default | 20 orders; nextCursor | | AORD-02 | edge | pagination | no overlap | | AORD-03 | edge | filters packaged/delivered/cancelled/flash | each applied | | AORD-04 | edge | slotId filter | only slot | | AORD-05 | error | limit invalid? schema default only, no max | assert current | | AORD-06 | edge | empty | []/undefined on error | | AORD-07 | happy | getOrderDetails | full detail | | AORD-08 | error | unknown | `Order not found` | | AORD-09 | error | other region | not found | | AORD-10 | happy | updateNotes | stored | | AORD-11 | error | unknown | error | | AORD-12 | edge | empty notes | stored null | | AORD-13 | happy | updatePackaged true/false | status; user notification | | AORD-14 | error | unknown order | 404 | | AORD-15 | edge | string orderId | schema requires string | | AORD-16 | happy | updateDelivered true/false | user status success/pending | | AORD-17 | error | unknown | 404 | | AORD-18 | happy | updateOrderItemPackaging | flags | | AORD-19 | error | unknown item | 404 | | AORD-20 | edge | only one flag supplied | other preserved | | AORD-21 | happy | removeDeliveryCharge | 0; user sees | | AORD-22 | error | unknown | error | | AORD-23 | happy | getSlotOrders | orders + isFirstOrder | | AORD-24 | edge | no orders | [] | | AORD-25 | error | invalid slot string | current behavior | | AORD-26 | happy | updateAddressCoords | success | | AORD-27 | error | unknown address | 404 | | AORD-28 | edge | coords visible to user? | current gap: not exposed | | AORD-29 | happy | rebalanceSlots | result; sequence updated | | AORD-30 | error | empty/over-50 slot ids | BAD_REQUEST | | AORD-31 | happy | cancel fresh order | success; user sees cancelled | | AORD-32 | error | blank reason | BAD_REQUEST | | AORD-33 | error | unknown order | 404 | | AORD-34 | error | already cancelled | 400 | | AORD-35 | error | delivered | 400 | | AORD-36 | edge | cancellation clears first order | tracker updated | | AORD-37 | edge | publish cancellation | queue called | | AORD-38 | edge | user token write | current gap | ### 7.6 `admin.coupon` | ID | Type | Case | Assert | | --- | --- | --- | --- | | ACOUP-01 | happy | create flat | returns array; code uppercase/trim | | ACOUP-02 | happy | create percent | percent stored | | ACOUP-03 | happy | multiple codes | one coupon per code | | ACOUP-04 | edge | no code | generated MF code | | ACOUP-05 | error | both discount types | error | | ACOUP-06 | error | neither | error | | ACOUP-07 | error | user-based without users | error | | ACOUP-08 | error | user-based + apply-all | error | | ACOUP-09 | error | invalid applicable user | error | | ACOUP-10 | error | duplicate code | error | | ACOUP-11 | edge | skuIds null/empty | whole cart | | ACOUP-12 | edge | max/min/maxLimit/exclusive/first-order | stored | | ACOUP-13 | edge | validTill | parsed | | ACOUP-14 | happy | getAll + pagination + search | | | ACOUP-15 | happy | getById | coupon + applicableUsers ids | | ACOUP-15B | happy | getById for a global coupon | region admin reads a superadmin-created global coupon | | ACOUP-16 | error | unknown | error | | ACOUP-17 | happy | update partial | fields present win | | ACOUP-18 | edge | update code top-level/array | uppercase | | ACOUP-19 | edge | update applicableUsers | relationships replaced | | ACOUP-20 | error | update both discount types | error | | ACOUP-21 | error | update unknown | error | | ACOUP-22 | happy | delete | soft invalidate; message | | ACOUP-23 | edge | getById after delete | still returns row invalidated | | ACOUP-24 | edge | user getEligible after delete | excluded | | ACOUP-25 | happy | getReservedCoupons | pagination/search | | ACOUP-26 | happy | createReservedCoupon | secret code; one/multiple | | ACOUP-27 | error | duplicate secret | error | | ACOUP-28 | error | both/neither discount | error | | ACOUP-29 | happy | getUsersMiniInfo | limit/offset/search | | ACOUP-30 | edge | search matching | | | ACOUP-31 | happy | createCoupon by mobile | 20%/min1000/max500/limit1 | | ACOUP-32 | error | mobile not 10 digits | error | | ACOUP-33 | error | unknown mobile | error | | ACOUP-34 | edge | generated code uniqueness | | | ACOUP-35 | edge | user token write | current gap | | ACOUP-36 | cache | none for coupons | no cache version bump required | ### 7.7 `admin.region` | ID | Type | Case | Assert | | --- | --- | --- | --- | | AREG-01 | happy | current | staff region | | AREG-02 | happy | bounds | priority ascending | | AREG-03 | happy | effective | lowest-priority settings | | AREG-04 | error | effective no bound | 422 | | AREG-05 | happy | getRegionConstants | key/value rows | | AREG-06 | edge | update constants | updated/deleted counts | | AREG-07 | edge | null deletes | key removed | | AREG-08 | error | wrong-scope key | BAD_REQUEST | | AREG-09 | edge | tagsOrder update | cache schedule | | AREG-10 | edge | non-cache key | no cache schedule | | AREG-11 | happy | getBoundSettings | bound in staff region | | AREG-12 | error | bound from another region | 404 | | AREG-13 | happy | updateBoundSettings | counts | | AREG-14 | error | wrong-scope bound key | BAD_REQUEST | | AREG-15 | edge | null deletes | removed | | AREG-16 | edge | user token | 401 staff-only | | AREG-17 | edge | superadmin token | 401 staff-only | | AREG-18 | cache | constants/bound settings | essentialConsts reflects after refresh | ### 7.8 `admin.slots` | ID | Type | Case | Assert | | --- | --- | --- | --- | | ASLOT-01 | happy | getAll | ≤20 slots, region only | | ASLOT-02 | edge | >20 slots | cap 20 | | ASLOT-03 | happy | create slot | slot + products/snippets/groups | | ASLOT-04 | error | missing times | 400 | | ASLOT-05 | edge | invalid date strings | current DB/parse behavior | | ASLOT-06 | edge | no skus | empty slot | | ASLOT-07 | error | invalid sku | DB/validation error | | ASLOT-08 | edge | vendor snippets | created/access URL | | ASLOT-09 | edge | duplicate vendor snippet name? | assert current | | ASLOT-10 | cache | create | slots version sync | | ASLOT-11 | happy | getSlotById | slot/snippets/accessUrl | | ASLOT-12 | error | unknown | 404 | | ASLOT-13 | happy | update slot | times/products/snippets | | ASLOT-14 | error | unknown | current catch masks to 500 `Unable to Update Slot` | | ASLOT-15 | cache | update | slots version sync | | ASLOT-16 | happy | getDeliverySequence | sequence map | | ASLOT-17 | error | unknown | 404 | | ASLOT-18 | happy | updateDeliverySequence | stored | | ASLOT-19 | error | unknown | 404 | | ASLOT-20 | happy | updateSlotCapacity | flag | | ASLOT-21 | error | unknown | 404 | | ASLOT-22 | cache | capacity | slots version sync; public file removes/returns | | ASLOT-23 | edge | user token | current gap for protected procedures | | ASLOT-24 | edge | other-region slot | not found | ### 7.9 `admin.store` | ID | Type | Case | Assert | | --- | --- | --- | --- | | ASTORE-01 | happy | getStores | own region, signed images | | ASTORE-02 | edge | empty | [] | | ASTORE-03 | happy | getStoreById | | | ASTORE-04 | error | unknown | 404 | | ASTORE-05 | error | other region | 404 | | ASTORE-06 | happy | create store | store id | | ASTORE-07 | error | name empty | BAD_REQUEST | | ASTORE-08 | edge | no image | null | | ASTORE-09 | edge | products array | associations | | ASTORE-10 | edge | image URL key extraction | | | ASTORE-11 | happy | update store | name/description/products | | ASTORE-12 | error | unknown/other region/global | 404 | | ASTORE-13 | edge | image replacement | old deleted after update | | ASTORE-14 | error | update rejected | old image not deleted | | ASTORE-15 | happy | delete store | success | | ASTORE-16 | error | unknown | 404 | | ASTORE-17 | edge | store with products | delete behavior/FK; assert | | ASTORE-18 | edge | user token write | current gap | | ASTORE-19 | cache | create/update/delete | stores/stores detail eventually | ### 7.10 `admin.user` | ID | Type | Case | Assert | | --- | --- | --- | --- | | AUSER-01 | happy | getEssentials | unresolved complaints count | | AUSER-02 | happy | getAllUsers | pagination, stats, last order, suspension | | AUSER-03 | edge | search | name/mobile filter | | AUSER-04 | edge | cursor | no overlap | | AUSER-05 | edge | limit max 100 | BAD_REQUEST above | | AUSER-06 | happy | getUserDetails | user + order list/status/item counts | | AUSER-07 | error | unknown | 404 | | AUSER-08 | error | other region | 404 | | AUSER-09 | edge | long order history | current unchunked IN bug; assert failure/limit | | AUSER-10 | happy | update suspension | reflected | | AUSER-11 | happy | unsuspend | reflected | | AUSER-12 | error | unknown user | current upsert behavior; assert | | AUSER-13 | happy | getUsersForNotification | eligibility flag | | AUSER-14 | edge | search | | | AUSER-15 | happy | sendNotification all | token batches, queued count | | AUSER-16 | happy | sendNotification specific | only those tokens | | AUSER-17 | edge | no tokens | success 0 | | AUSER-18 | error | empty title/text | BAD_REQUEST | | AUSER-19 | edge | queue failure | logged; success/count behavior | | AUSER-20 | happy | getUserIncidents | list with order status | | AUSER-21 | error | unknown user | empty | | AUSER-22 | happy | addUserIncident | created; negativity recompute | | AUSER-23 | edge | optional order/comment/score | nulls accepted | | AUSER-24 | error | no staff auth | 401 | | AUSER-25 | edge | user token | current gap | | AUSER-26 | edge | cross-region user | not found/empty | ### 7.11 `admin.vendorSnippets` | ID | Type | Case | Assert | | --- | --- | --- | --- | | AVEND-01 | happy | create with slot/skus | snippet | | AVEND-02 | error | missing code | BAD_REQUEST | | AVEND-03 | error | no skus | BAD_REQUEST | | AVEND-04 | error | invalid slot | error | | AVEND-05 | error | invalid/foreign sku | error | | AVEND-06 | error | duplicate code | error | | AVEND-07 | edge | no slot | allowed; orders endpoint later errors | | AVEND-08 | edge | validTill/isPermanent | stored | | AVEND-09 | happy | getAll | snippets + products/accessUrl | | AVEND-10 | edge | empty | [] | | AVEND-11 | happy | update | fields/slot/skus/code | | AVEND-12 | error | unknown | not found | | AVEND-13 | error | invalid slot/sku | error | | AVEND-14 | error | duplicate code | error | | AVEND-15 | happy | delete | success | | AVEND-16 | error | unknown | error | | AVEND-17 | happy | getOrdersBySnippet | orders filtered to snippet SKUs | | AVEND-18 | error | unknown code | error | | AVEND-19 | error | expired | error | | AVEND-20 | error | no slot | `not associated with a slot` | | AVEND-21 | edge | cancelled orders | excluded | | AVEND-22 | edge | orders without snippet SKUs | excluded | | AVEND-23 | edge | no customer name | empty string | | AVEND-24 | edge | public | no auth needed | | AVEND-25 | happy | getUpcomingSlots | slots after now-3h | | AVEND-26 | edge | no slots | [] | | AVEND-27 | happy | getOrdersBySnippetAndSlot | filtered by slot | | AVEND-28 | error | unknown snippet/slot | error | | AVEND-29 | happy | updateOrderItemPackaging | is_packaged changes | | AVEND-30 | error | unknown item | error | | AVEND-31 | edge | public packaging mutation | current no auth — security gap | | AVEND-32 | edge | cross-region snippet | public lookup global; assert | --- ## 8. Superadmin router ### 8.1 `superadmin.auth` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SAUTH-01 | happy | valid username/password | token + superadmin id/username | | SAUTH-02 | error | unknown username | 401 | | SAUTH-03 | error | wrong password | 401 | | SAUTH-04 | error | empty fields | 400 | | SAUTH-05 | happy | `me` | superadmin identity | | SAUTH-06 | error | `me` no token | 401 | | SAUTH-07 | error | staff/user token | 401 | | SAUTH-08 | edge | token identity | superadminId/identityType claims | | SAUTH-09 | edge | suspended/removed superadmin | token no longer resolves | ### 8.2 `superadmin.const` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SCONST-01 | happy | getGlobalConstants | key/value list | | SCONST-02 | edge | update global constants | counts/keys; KV refresh | | SCONST-03 | edge | null value deletes | removed | | SCONST-04 | edge | unknown key | inserted/current | | SCONST-05 | happy | getLegacyConstants | key/value list | | SCONST-06 | happy | update legacy constants | counts/keys | | SCONST-07 | edge | empty array | success 0 | | SCONST-08 | error | no token/staff | 401 | | SCONST-09 | cache | global update | every bound's essentialConsts refreshes | | SCONST-10 | edge | invalid value object | BAD_REQUEST | ### 8.3 `superadmin.regions` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SREG-01 | happy | list | all regions | | SREG-02 | happy | get | region + bounds | | SREG-03 | error | unknown | 404 | | SREG-04 | happy | create region with one bound | region + bound; cache files generated | | SREG-05 | error | no bounds | BAD_REQUEST | | SREG-06 | error | duplicate priority | 409 | | SREG-07 | edge | explicit center | stored | | SREG-08 | edge | no center | computed from bound | | SREG-09 | edge | invalid geojson shape | BAD_REQUEST | | SREG-10 | edge | priority numeric string | stored | | SREG-11 | error | non-numeric priority | BAD_REQUEST | | SREG-12 | happy | update name/description | round-trip | | SREG-13 | error | update unknown | 404 | | SREG-14 | happy | bounds list | priority ascending | | SREG-15 | happy | createBound | bound + refresh | | SREG-16 | error | duplicate priority | 409 | | SREG-17 | error | unknown region | 409/404 | | SREG-18 | happy | updateBound | description/geojson/priority | | SREG-18b | happy | updateBound geojson | region addresses rebalanced from coords; outside → null; backfill flag unchanged | | SREG-19 | error | duplicate priority | 409 | | SREG-20 | error | unknown | 404 | | SREG-21 | happy | deleteBound | success/remaining bounds | | SREG-22 | error | only bound | 409 | | SREG-23 | error | bound used by addresses | 409 | | SREG-24 | error | unknown | 404 | | SREG-25 | edge | deleted bound KV key removed | essentialConsts old bound 404 | | SREG-26 | happy | boundSettings | list | | SREG-27 | happy | updateBoundSettings | counts; KV refresh | | SREG-28 | error | wrong-scope key | BAD_REQUEST | | SREG-29 | edge | null deletes | removed | | SREG-30 | happy | getRegionConstants | list | | SREG-31 | happy | updateRegionConstants | counts; KV refresh | | SREG-32 | error | wrong-scope key | BAD_REQUEST | | SREG-33 | edge | tagsOrder | cache rebuild | | SREG-34 | happy | effectiveSettings | lowest-priority bound | | SREG-35 | error | no bound | 422 | | SREG-36 | edge | cross-region cache | new region files isolated | | SREG-37 | error | no token/staff/user | 401 | ### 8.4 `superadmin.staff` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SSTAFF-01 | happy | list | staff + region/role | | SSTAFF-02 | happy | roles | roles | | SSTAFF-03 | happy | create | staff created with region | | SSTAFF-04 | error | duplicate name | 409 | | SSTAFF-05 | error | password <6 | BAD_REQUEST | | SSTAFF-06 | error | invalid role | 400 | | SSTAFF-07 | error | invalid region | 400 | | SSTAFF-08 | happy | update region | moved | | SSTAFF-09 | error | unknown staff | 404 | | SSTAFF-10 | error | invalid region | 400 | | SSTAFF-11 | happy | remove | success | | SSTAFF-12 | error | unknown | 404 | | SSTAFF-13 | error | owns store | 409 | | SSTAFF-14 | error | created coupons | 409 | | SSTAFF-15 | error | created reserved coupons | 409 | | SSTAFF-16 | happy | sendAdminNotification | queued count | | SSTAFF-17 | error | empty title/text | BAD_REQUEST | | SSTAFF-18 | edge | no admin tokens | 0 success | | SSTAFF-19 | edge | queue failure | logged | | SSTAFF-20 | error | staff/user token | 401 | ### 8.5 `superadmin.globalProducts` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SGPROD-01 | happy | list | global products | | SGPROD-02 | happy | get | product/SKUs | | SGPROD-03 | error | unknown | 404 | | SGPROD-04 | happy | create | product/SKUs; schedule all-region cache | | SGPROD-05 | error | invalid name/price/feature | BAD_REQUEST | | SGPROD-06 | error | no SKUs | BAD_REQUEST | | SGPROD-07 | edge | multiple SKUs/combo | stored | | SGPROD-08 | happy | update | fields/SKUs; IDs preserved for existing | | SGPROD-09 | error | unknown | 404 | | SGPROD-10 | edge | update adds/removes SKUs | current semantics | | SGPROD-11 | happy | delete | deleted; schedule all-region | | SGPROD-12 | error | unknown | 404 | | SGPROD-13 | edge | product assigned to region | visible in region caches after sync | | SGPROD-14 | error | no token/staff/user | 401 | | SGPROD-16 | edge | create with >=12 regions | market rows seeded via chunked insert | | SGPROD-17 | edge | update adds a SKU with >=12 regions | new SKU's market rows seeded | | SGPROD-15 | cache | global create/update/delete | all regions rebuild (no narrowing) | ### 8.6 `superadmin.globalStores` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SGSTORE-01 | happy | list | global stores with image URLs | | SGSTORE-02 | happy | get | store | | SGSTORE-03 | error | unknown | 404 | | SGSTORE-04 | happy | create | store; schedule cache | | SGSTORE-05 | error | name empty | BAD_REQUEST | | SGSTORE-06 | edge | image key extraction | stored key | | SGSTORE-07 | happy | update | name/description/image | | SGSTORE-08 | error | unknown | current behavior (null/500); assert | | SGSTORE-09 | happy | delete | result; schedule cache | | SGSTORE-10 | edge | delete store with products | current FK behavior | | SGSTORE-11 | cache | writes | all-region rebuild | | SGSTORE-12 | error | no token | 401 | ### 8.7 `superadmin.globalCoupons` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SGCOUP-01 | happy | list | global coupons | | SGCOUP-02 | happy | get | coupon | | SGCOUP-03 | error | unknown | 404 | | SGCOUP-04 | happy | create flat/percent | coupons array | | SGCOUP-05 | error | both/neither | 400 | | SGCOUP-06 | error | user-based no users | 400 | | SGCOUP-07 | error | user-based + apply-all | 400 | | SGCOUP-08 | error | invalid users | 400 | | SGCOUP-09 | error | duplicate code | 400 | | SGCOUP-10 | edge | no code | generated | | SGCOUP-11 | happy | update partial | fields preserved/updated | | SGCOUP-12 | error | both discount types | 400 | | SGCOUP-13 | error | unknown | 404 | | SGCOUP-14 | happy | delete | invalidated | | SGCOUP-15 | error | unknown | 404 | | SGCOUP-16 | edge | user getEligible sees global coupon | after refresh | | SGCOUP-17 | error | no token | 401 | ### 8.8 `superadmin.products` / `superadmin.stores` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SPROD-01 | happy | products.list default | 20 rows | | SPROD-02 | edge | regionId filter | only region | | SPROD-03 | edge | search by name | matching | | SPROD-04 | edge | limit 1–100 | works; 0/101 BAD_REQUEST | | SPROD-05 | edge | offset | pagination | | SPROD-06 | happy | elevate product | global product attached to global store | | SPROD-07 | error | unknown product | 404 | | SPROD-08 | error | invalid/global store | 400 | | SPROD-09 | cache | elevate | all-region rebuild | | SPROD-10 | happy | stores.list region | regional stores | | SPROD-11 | happy | elevate store | global store | | SPROD-12 | error | unknown store | 400/404 | | SPROD-13 | cache | elevate | all-region rebuild | | SPROD-14 | error | no token | 401 | | SPROD-15 | edge | elevationDependents | regional combo components listed | | SPROD-16 | happy | elevate combo | components elevated; market rows seeded | ### 8.9 `superadmin.complaint` | ID | Type | Case | Assert | | --- | --- | --- | --- | | SCOMP-01 | happy | getAll | all-region complaints | | SCOMP-02 | edge | pagination | nextCursor | | SCOMP-03 | edge | empty | [] | | SCOMP-04 | edge | status/images/region | mapped/signed | | SCOMP-05 | edge | no token | 401 | | SCOMP-06 | edge | staff/user token | 401 | --- ## 9. Upload/S3 suite | ID | Type | Case | Assert | | --- | --- | --- | --- | | UPL-01 | happy | presign product image | PUT bytes; public GET returns exact bytes/sha256 | | UPL-02 | happy | two folders in separate calls | distinct keys/objects | | UPL-03 | edge | png and jpeg in one call | extension per mime | | UPL-04 | edge | unknown mime | `.jpg` | | UPL-05 | edge | empty mime list | no URLs | | UPL-06 | edge | presigned URL query signature | PUT without R2 credentials | | UPL-07 | edge | Content-Type unsigned | any content type accepted (current) | | UPL-08 | edge | URL expiry | after 180s PUT fails | | UPL-09 | edge | object never uploaded | public GET 404 | | UPL-10 | edge | re-upload same key | overwrite/current | | UPL-11 | edge | pending status row | created per presign | | UPL-12 | edge | claim once | success | | UPL-13 | edge | claim unknown | `Failed to claim upload URL` | | UPL-14 | edge | claim already claimed | error | | UPL-15 | happy | create product with claimed images | images stored | | UPL-16 | error | create product with unclaimed/fake image | rejected before DB write | | UPL-17 | happy | update product with new claimed image | stored | | UPL-18 | error | update with another product's image | rejected as not newly referenced | | UPL-19 | edge | deleteImageUtil removes object | GET 404 | | UPL-20 | edge | tag image replacement | old deleted best-effort, new claimed | | UPL-21 | edge | review response images | claim/validate | | UPL-22 | edge | review image lenient | invalid URL logged, review still created | | UPL-23 | edge | store image replacement | old deleted after update | | UPL-24 | edge | same-millisecond same-mime collision | assert current; do not depend | | UPL-25 | error | S3 presign failure | 500, no partial row? assert | | UPL-26 | edge | upload bytes mismatch | object holds supplied bytes, not original | | UPL-27 | edge | path traversal key | normalized/safe | | UPL-28 | edge | public asset URL from key | `scaffoldAssetUrl` correct | --- ## 10. Notifications, queues and jobs Visible through API responses; queue side effects are asserted through the backend’s queue binding or by observing notification state where exposed. | ID | Type | Case | Assert | | --- | --- | --- | --- | | NOTIF-01 | happy | admin send to all | batches of 5; queued count | | NOTIF-02 | happy | admin send to selected | only selected tokens | | NOTIF-03 | edge | duplicate tokens | no duplicate job? assert current | | NOTIF-04 | edge | >5 tokens | multiple queue messages | | NOTIF-05 | edge | no tokens | 0 success | | NOTIF-06 | error | queue push failure for one batch | other batches continue; count excludes failure | | NOTIF-07 | happy | complaint resolve | response notification queued | | NOTIF-08 | happy | order packaged | packaged notification | | NOTIF-09 | happy | order delivered | delivered notification | | NOTIF-10 | happy | cancellation | cancellation queue | | NOTIF-11 | edge | user with no token | no notification, mutation succeeds | | NOTIF-12 | edge | unlogged token included for broadcast | yes | | NOTIF-13 | edge | push token region follows address | assert token payload/DB | | NOTIF-14 | edge | tracked location does not move token | current rule | | NOTIF-15 | edge | notification permission denied | no token registration | | NOTIF-16 | edge | queue consumer order-by-name | correct handler | | NOTIF-17 | edge | flash cron | toggles flash at scheduled time (if testable) | | NOTIF-18 | edge | order publish failure | order still created; logged | --- ## 11. Cross-cutting invariants ### 11.1 Tenant / region isolation For every region-scoped read and write, assert a second region cannot see or mutate the first’s data. Minimum matrix: | ID | Type | Case | Assert | | --- | --- | --- | --- | | ISO-01 | invariant | admin store/product/slot/user/order/banner/tag/coupon/vendor reads | only staff region | | ISO-02 | invariant | user product/slot/store/cache reads | only requested region | | ISO-03 | invariant | address/store/product/slot/order writes with foreign region id | reject or not visible | | ISO-04 | invariant | cache files | no foreign ids | | ISO-05 | invariant | notifications | token follows address region, not browsing region | | ISO-06 | invariant | global product/store | visible in every region’s cache | | ISO-07 | invariant | superadmin complaint/products | explicitly global | | ISO-08 | invariant | vendor public links | global lookup by code, expected | ### 11.2 Transactions and partial failure | ID | Type | Case | Assert | | --- | --- | --- | --- | | TX-01 | edge | product create fails on image claim | no product/SKU rows | | TX-02 | edge | product update fails on claim | no delete, no update | | TX-03 | edge | tag create fails on upload claim | no tag/mapping | | TX-04 | edge | coupon create with one duplicate code | no partial coupons? assert current | | TX-05 | edge | order place fails on item insert | no order/order items/coupon usage | | TX-06 | edge | cancel fails mid-transaction | status/reason unchanged | | TX-07 | edge | address create fails after default clear | previous default restored? assert | | TX-08 | edge | address update fails after default clear | previous default restored? assert | | TX-09 | edge | staff delete blocked by relation | no partial delete | | TX-10 | edge | region create with duplicate priority | no region/bounds | | TX-11 | edge | slot create with invalid product | no slot relations | | TX-12 | edge | order publish/queue failure | DB order remains committed | ### 11.3 Concurrency | ID | Type | Case | Assert | | --- | --- | --- | --- | | CONC-01 | edge | two orders same slot near capacity | capacity respected; no overbook | | CONC-02 | edge | two orders same SKU stock 1 | one succeeds/one rejects | | CONC-03 | edge | two coupon redemptions same code | one success | | CONC-04 | edge | two staff updates same product | last write wins; no corrupt SKU list | | CONC-05 | edge | cache creator regional + global schedules | global not narrowed | | CONC-06 | edge | duplicate staff name concurrent | one 409 | | CONC-07 | edge | duplicate product name concurrent | one 400/409 | | CONC-08 | edge | duplicate tag name concurrent | one 400 | | CONC-09 | edge | same push token concurrent | upsert, no duplicate rows | | CONC-10 | edge | same address default updates concurrent | exactly one default | ### 11.4 Pagination, search and sorting | ID | Type | Case | Assert | | --- | --- | --- | --- | | PAGE-01 | edge | limit default per procedure | matches schema | | PAGE-02 | edge | limit max | 400 above | | PAGE-03 | edge | cursor first/last | no duplicates/missing | | PAGE-04 | edge | empty result nextCursor | undefined | | PAGE-05 | edge | search case-insensitive | expected | | PAGE-06 | edge | search partial mobile/code/name | expected | | PAGE-07 | edge | search `%`/`_` | literal, no wildcard injection | | PAGE-08 | edge | stable ordering | deterministic tie-break | | PAGE-09 | edge | soft-deleted/invalidated rows | excluded/included per procedure | | PAGE-10 | edge | region filter combined with search | both applied | ### 11.5 Status/error contract | ID | Type | Case | Assert | | --- | --- | --- | --- | | ERR-01 | edge | ApiError 400 | HTTP 400/BAD_REQUEST | | ERR-02 | edge | ApiError 401 | UNAUTHORIZED | | ERR-03 | edge | ApiError 403 | FORBIDDEN | | ERR-04 | edge | ApiError 404 | NOT_FOUND | | ERR-05 | edge | ApiError 409 | CONFLICT | | ERR-06 | edge | ApiError 422 | UNPROCESSABLE_CONTENT | | ERR-07 | edge | unknown error | INTERNAL_SERVER_ERROR, no SQL details | | ERR-08 | edge | raw `Error('Order not found')` | current 500; assert until converted to ApiError | | ERR-09 | edge | zod error | BAD_REQUEST with path | | ERR-10 | edge | error logger | logs path/type/user but not secrets | --- ## 12. Procedure coverage checklist Every procedure must have at least one happy test and one auth test; mutations also need validation and side-effect tests. Use this table as the completion gate. | Router | Procedure | Case IDs | | --- | --- | --- | | common.product | getAllProductsSummary | COMMON-01..10 | | common.product | getAllSkusSummary | COMMON-11..18 | | common | getStoresSummary | COMMON-17..21 | | common | checkLocationInPolygon | COMMON-22..29 | | common | generateUploadUrls | COMMON-30..45, UPL-01..28 | | common | healthCheck | COMMON-46..48, HTTP-01 | | common | listRegions | COMMON-49..52 | | common | resolveRegionByLocation | COMMON-53..58 | | common | resolveBound | COMMON-59..64 | | common | regionSettings | COMMON-65..67 | | common | activeBound | COMMON-68..73 | | common | essentialConsts | CACHE-01..24, COMMON-74..78 | | user.auth | login | UAUTH-01..15 | | user.auth | register | UREG-01..13 | | user.auth | sendOtp | UOTP-01..03 | | user.auth | verifyOtp | UOTP-04..12 | | user.auth | updatePassword | UPASS-01..06 | | user.auth | updateProfile | UPROF-01..13 | | user.auth | deleteAccount | UDEL-01..09 | | user.address | getDefaultAddress | UADDR-14 | | user.address | getUserAddresses | UADDR-15 | | user.address | createAddress | UADDR-01..13 | | user.address | updateAddress | UADDR-16..22 | | user.address | deleteAddress | UADDR-23..30 | | user.cart | getCartSlots | UCART-01..08 | | user.complaint | getAll | UCOMP-08..09 | | user.complaint | raise | UCOMP-01..07, 10..11 | | user.coupon | getEligible | UCOUP-01..07 | | user.coupon | getMyCoupons | UCOUP-08..12 | | user.coupon | redeemReservedCoupon | UCOUP-13..20 | | user.fileUpload | generateUploadUrls | UUP-01..10 | | user.order | placeOrder | UORD-01..70 | | user.order | getOrders | UORD-71..84 | | user.order | getOrderById | UORD-85..92 | | user.order | cancelOrder | UORD-98..108 | | user.order | updateUserNotes | UORD-93..97 | | user.product | getProductDetails | UPROD-01..10 | | user.product | getProductReviews | UPROD-11..14 | | user.product | createReview | UPROD-15..24 | | user.slots | getSlots | USLOT-01..10 | | user.user | getSelfData | UUSER-01..05 | | user.user | savePushToken | UUSER-06..13 | | user.user | recordTrackedRegion | UUSER-14..17 | | admin.staffUser | login | ASTAFF-01..04 | | admin.staffUser | me | ASTAFF-05..07 | | admin.staffUser | getStaff | ASTAFF-08..09 | | admin.staffUser | createStaffUser | ASTAFF-11..15 | | admin.staffUser | getRoles | ASTAFF-10 | | admin.staffUser | savePushToken | ASTAFF-16..17 | | admin.staffUser | sendAdminNotification | ASTAFF-18..22, NOTIF-01..06 | | admin.banner | getBanners | ABAN-01..03 | | admin.banner | getBanner | ABAN-04..06 | | admin.banner | createBanner | ABAN-07..13 | | admin.banner | updateBanner | ABAN-14..17 | | admin.banner | deleteBanner | ABAN-18..21 | | admin.complaint | getAll | ACOMP-01..05 | | admin.complaint | resolve | ACOMP-06..12 | | admin.product | getProducts | APROD-01..04 | | admin.product | getProductById | APROD-05..08 | | admin.product | deleteProduct | APROD-43..45 | | admin.product | toggleOutOfStock | APROD-46..50 | | admin.product | createProduct | APROD-17..33, 82 | | admin.product | updateProduct | APROD-34..42, 78..81 | | admin.product | getProductReviews | APROD-09..12 | | admin.product | respondToReview | APROD-73..77 | | admin.product | getGroups | APROD-13 | | admin.product | createGroup | APROD-56 | | admin.product | updateGroup | APROD-57..58 | | admin.product | deleteGroup | APROD-59..60 | | admin.product | updateProductPrices | APROD-51..55 | | admin.product | getProductTags | APROD-14 | | admin.product | getProductTagById | APROD-15..16 | | admin.product | createProductTag | APROD-61..66 | | admin.product | updateProductTag | APROD-67..69 | | admin.product | deleteProductTag | APROD-70..72 | | admin.order | updateNotes | AORD-10..12 | | admin.order | getOrderDetails | AORD-07..09 | | admin.order | updatePackaged | AORD-13..15 | | admin.order | updateDelivered | AORD-16..17 | | admin.order | updateOrderItemPackaging | AORD-18..20 | | admin.order | removeDeliveryCharge | AORD-21..22 | | admin.order | getSlotOrders | AORD-23..25 | | admin.order | updateAddressCoords | AORD-26..28 | | admin.order | getAll | AORD-01..06 | | admin.order | rebalanceSlots | AORD-29..30 | | admin.order | cancelOrder | AORD-31..38 | | admin.coupon | create | ACOUP-01..13 | | admin.coupon | getAll | ACOUP-14 | | admin.coupon | getById | ACOUP-15, 15B, 16 | | admin.coupon | update | ACOUP-17..21 | | admin.coupon | delete | ACOUP-22..24 | | admin.coupon | getReservedCoupons | ACOUP-25 | | admin.coupon | createReservedCoupon | ACOUP-26..28 | | admin.coupon | getUsersMiniInfo | ACOUP-29..30 | | admin.coupon | createCoupon | ACOUP-31..35 | | admin.region | current | AREG-01 | | admin.region | bounds | AREG-02 | | admin.region | effective | AREG-03..04 | | admin.region | getRegionConstants | AREG-05 | | admin.region | updateRegionConstants | AREG-06..10, 18 | | admin.region | getBoundSettings | AREG-11..12 | | admin.region | updateBoundSettings | AREG-13..18 | | admin.slots | getAll | ASLOT-01..02 | | admin.slots | createSlot | ASLOT-03..10 | | admin.slots | getSlotById | ASLOT-11..12 | | admin.slots | updateSlot | ASLOT-13..15 | | admin.slots | getDeliverySequence | ASLOT-16..17 | | admin.slots | updateDeliverySequence | ASLOT-18..19 | | admin.slots | updateSlotCapacity | ASLOT-20..24 | | admin.store | getStores | ASTORE-01..02 | | admin.store | getStoreById | ASTORE-03..05 | | admin.store | createStore | ASTORE-06..10, 19 | | admin.store | updateStore | ASTORE-11..14, 19 | | admin.store | deleteStore | ASTORE-15..19 | | admin.user | getEssentials | AUSER-01 | | admin.user | getAllUsers | AUSER-02..05 | | admin.user | getUserDetails | AUSER-06..09 | | admin.user | updateUserSuspension | AUSER-10..12 | | admin.user | getUsersForNotification | AUSER-13..14 | | admin.user | sendNotification | AUSER-15..19, NOTIF-01..06 | | admin.user | getUserIncidents | AUSER-20..21 | | admin.user | addUserIncident | AUSER-22..26 | | admin.vendorSnippets | create | AVEND-01..08 | | admin.vendorSnippets | getAll | AVEND-09..10 | | admin.vendorSnippets | update | AVEND-11..14 | | admin.vendorSnippets | delete | AVEND-15..16 | | admin.vendorSnippets | getOrdersBySnippet | AVEND-17..24 | | admin.vendorSnippets | getUpcomingSlots | AVEND-25..26 | | admin.vendorSnippets | getOrdersBySnippetAndSlot | AVEND-27..28 | | admin.vendorSnippets | updateOrderItemPackaging | AVEND-29..32 | | superadmin.auth | login | SAUTH-01..04 | | superadmin.auth | me | SAUTH-05..09 | | superadmin.const | getGlobalConstants | SCONST-01 | | superadmin.const | updateGlobalConstants | SCONST-02..04, 09 | | superadmin.const | getLegacyConstants | SCONST-05 | | superadmin.const | updateLegacyConstants | SCONST-06..10 | | superadmin.regions | list | SREG-01 | | superadmin.regions | get | SREG-02..03 | | superadmin.regions | create | SREG-04..11 | | superadmin.regions | update | SREG-12..13 | | superadmin.regions | bounds | SREG-14 | | superadmin.regions | createBound | SREG-15..17 | | superadmin.regions | updateBound | SREG-18..20 | | superadmin.regions | deleteBound | SREG-21..25 | | superadmin.regions | boundSettings | SREG-26 | | superadmin.regions | updateBoundSettings | SREG-27..29 | | superadmin.regions | getRegionConstants | SREG-30 | | superadmin.regions | updateRegionConstants | SREG-31..33 | | superadmin.regions | effectiveSettings | SREG-34..37 | | superadmin.staff | sendAdminNotification | SSTAFF-16..20 | | superadmin.staff | list | SSTAFF-01 | | superadmin.staff | roles | SSTAFF-02 | | superadmin.staff | create | SSTAFF-03..07 | | superadmin.staff | update | SSTAFF-08..10 | | superadmin.staff | remove | SSTAFF-11..15 | | superadmin.globalProducts | list | SGPROD-01 | | superadmin.globalProducts | get | SGPROD-02..03 | | superadmin.globalProducts | create | SGPROD-04..07, 16 | | superadmin.globalProducts | update | SGPROD-08..10, 17 | | superadmin.globalProducts | delete | SGPROD-11..15 | | superadmin.globalStores | list | SGSTORE-01 | | superadmin.globalStores | get | SGSTORE-02..03 | | superadmin.globalStores | create | SGSTORE-04..06 | | superadmin.globalStores | update | SGSTORE-07..08 | | superadmin.globalStores | delete | SGSTORE-09..12 | | superadmin.globalCoupons | list | SGCOUP-01 | | superadmin.globalCoupons | get | SGCOUP-02..03 | | superadmin.globalCoupons | create | SGCOUP-04..10 | | superadmin.globalCoupons | update | SGCOUP-11..13 | | superadmin.globalCoupons | delete | SGCOUP-14..17 | | superadmin.products | list | SPROD-01..05 | | superadmin.products | elevate | SPROD-06..09, 16 | | superadmin.products | elevationDependents | SPROD-15 | | superadmin.stores | list | SPROD-10 | | superadmin.stores | elevate | SPROD-11..14 | | superadmin.complaint | getAll | SCOMP-01..06 | --- ## 13. Known current gaps to pin explicitly These are intentionally written as “current” cases until the underlying defect is fixed: 1. Admin `protectedProcedure` reads/writes are callable with a user token. 2. `admin.order.getAll` swallows errors and returns `undefined`. 3. `admin.order.getOrderDetails`/`updateNotes`/`removeDeliveryCharge` throw raw `Error`, producing a 500 instead of 404. 4. `admin.slots.updateSlot` masks all failures as `Unable to Update Slot`. 5. `admin.user.getUserDetails`/`getAllUsers` build an unchunked `IN (...)` and fail on long histories. 6. `admin.product.deleteProduct` fails on products with SKUs (FK/raw error). 7. `placeOrder` has no idempotency key and no quantity upper bound. 8. Empty `selectedItems` falls through to a raw DB error. 9. A user can raise a complaint against another user’s order id. 10. Vendor snippet packaging endpoints and order lookup are public by design; treat as a security review item. 11. Suspended-user handling in `createContext` swallows the `TRPCError`, so requests look anonymous rather than 403. 12. `getOrderById`/`cancelOrder`/`updateUserNotes` accept only numeric-string ids; `ORD` display ids fail. 13. Cart/checkout area identity uses address coordinates; a stale client `regionId` must not win. 14. Cache rebuilds are non-atomic and eventual; every cache test must poll, never sleep once. 15. `cacheVersion`/`slotsVersionNum`/`availabilityVersionNum` are old names; use `products_version_num`/`slots_version_num`/`availability_version_num`. 16. `common.essentialConsts` accepts an optional `boundId`; a missing input is a temporary backwards-compatibility path that falls back to bound 1 (region 1). --- ## 14. Suggested execution order 1. Harness + auth + HTTP routes. 2. Golden E2E-01..25 (catalog + cache). 3. Common router. 4. User auth/address/cart. 5. User order + product + coupon. 6. Admin product/store/slot/banner/tag. 7. Admin order/coupon/user/vendor. 8. Superadmin. 9. Uploads/S3. 10. Cache invariants + concurrency + cross-region isolation. Run serially (`--runInBand`). Cache tests may take several minutes; keep them in their own Jest project or a `describe` with `jest.setTimeout(240000)`.