KingstonRxSandbox user guide

Sandbox help

How to explore KingstonRx

Task-based walkthroughs for pharmacy volunteers and evaluators. Screenshots are captured from the same Playwright flows used in smoke testing so they stay aligned with the product.

Sandbox only. Use synthetic patients, prescribers, and inventory. Do not enter real patient names, IDs, prescription details, or medical histories. Keep sandbox materials confidential per the NDA.

Getting started

Request sandbox access, sign in, and choose a workspace for your session.

  1. Open the sandbox landing page and submit a request if you do not yet have credentials.
  2. After approval, use the activation email to set your password, then sign in at /login with the email address or username you registered.
  3. On the home screen, pick Pharmacy, Inventory, Point of sale, or Administration.
  4. Use Switch workspace in the sidebar footer to return home and change modules.
KingstonRx home screen with workspace cards

Prescription queue

Review seeded prescriptions and their clinical status before intake or dispensing.

  1. Open Pharmacy → Prescriptions to see the branch queue.
  2. Use search and filters to find a prescription by patient, prescriber, or status.
  3. Open a row to review screening results, notes, and workflow history.
  4. Statuses move from intake through screening, pharmacist review, counselling, and POS.
Pharmacy prescriptions list

Prescription intake

Capture patient details and walk through allergy and safety review steps.

  1. Open Pharmacy → New prescription to start intake.
  2. Enter synthetic patient demographics only — never real patient identifiers.
  3. Confirm parish/state and consent before continuing.
  4. Complete allergy acknowledgement, prescriber selection, medications, and save as draft or submit.
Prescription intake patient step with sample data

Inventory receiving

Receive purchase orders and put stock away before dispensing dependent workflows.

  1. Complete Track I receiving in the sandbox before clinical dispensing tests that need on-hand stock.
  2. Open Inventory → Receiving to view expected deliveries and open receipts.
  3. Finish quantity, batch, and cost capture, then put items away to bins.
  4. Use Item master to confirm sellable status and regulatory class.
Goods receiving list

POS dispense

Release pharmacist-approved prescriptions and complete compliance checks at the counter.

  1. Open Point of sale → Dispense to view prescriptions ready for release.
  2. Blocked cards indicate pending pharmacist review or missing compliance checks.
  3. Scan batch barcodes when prompted and confirm counselling or DDA steps as required.
  4. Hand off to the register when payment is required for the scenario.
POS dispense queue with compliance badges

Administration

Internal operators manage users, branches, workstations, and audit review.

  1. Sign in with an administrator account for admin-only tasks.
  2. Open Administration → Users to review staff accounts and roles.
  3. Use Workstations to approve desktop shell devices for a branch.
  4. Audit log and notifications support operational review during UAT.
Administration users list

Detailed UAT cases live in the repository under docs/UAT-PLAYBOOK.md. Engineering can refresh screenshots with npm run docs:capture.