Skip to main content

KB coverage roadmap

The support assistant's grounding quality is bounded by guide coverage, not tooling. This page tracks every app menu and submenu against the production standard, and the batch order for the rest.

The standard, per submenu screen (the ui-guide skill is the playbook):

  1. Verify against source — the screen component in retaildek-app/apps/vendor and its routes/rules in apps/server.
  2. A short page — a sentence or two, "What you can do here", good-to-know, troubleshooting.
  3. Required screenshots — via the module's tools/media/<module>.json manifest, 1280×800, highlighted.
  4. A narrated walkthrough video — say: subtitles on every step, chapter: per stage, self-cleaning when it mutates, no length cap.
  5. Gates green (lint:md, lint:prose, lint:js, typecheck, test, build) plus --check-videos, then commit, then npm run docgen:kb-export.

Page category values must match the KB component vocabulary exactly — the export tool validates and skips mismatches.

Done​

MenuPagesVideos
Quick onboard1Complete first-day walkthrough (signup → first paid invoice, 6 chapters)
Dashboard1Tour
Contacts2Tour · add/edit/delete pass
Inventory (all 5 submenus)9Items tour · add/delete · adjust stock · bulk edit · import/export · barcode labels · stock audit · display stock · transfer + reversal
POS Store (all 5)6Full shift arc · bills · sessions · day book · customer display
Sales (all 4)5Quote draft · order + advance · invoice + cancel · return + delete
Purchases (all 3)4PO + cancel · bill + delete-reverses · full return cycle
Service & Delivery (all 3)4Manual challan · commitment · installation
Day Books (all 3)4Day close + summary card · receipt + soft-cancel + ageing · expense
Reference Data (all 4)5One add-and-delete pass each
Imports & Exports2Tally export preview + import path
Staff & Performance (both)3Staff add/delete · scoreboard tour

Remaining​

Every menu and submenu is documented except one plan-blocked group:

BatchSubmenusStatus
Accounts & ReportsAll 7 submenusDone — 7 pages, 7 tour videos, 7 screenshots
Admin ConsoleAll 5 submenusDone — 5 pages, 5 tour videos, 5 screenshots
My AccountAll 7 tabsDone — 1 consolidated page, tab-tour video
Loyalty & OffersOffers · Coupons · Loyalty Program · Loyalty MembersBlocked on tenant plan — the demo tenant is Gold, which hides the group. Needs a Free/Diamond tenant (or a plan switch) to write and film.