Builds stakeholder-readable scripted manual test cases from a feature spec in four formats: a step-table (preconditions / steps / expected result / actual / pass-fail / notes) for spreadsheet review, a Gherkin Given/When/Then format for BDD-aware teams, a business-language UAT script with acceptance-criteria mapping and contractual sign-off (references/uat-format.md), and a one-line-per-item execution checklist for smoke / on-call / bug-bash / compliance sweeps (references/checklist-format.md). Each script is self-contained (no implicit team knowledge), single-scenario (one happy + N edge per script), and includes the data setup the tester needs without being a developer. Use when a feature can't be (or shouldn't be) fully automated and a human tester needs an executable script or checklist - UAT sign-off rounds, regression baselines, certification testing, deploy smoke checklists, exploratory follow-up scripts.
94
88%
Does it follow best practices?
Impact
95%
0.98xAverage score across 10 eval scenarios
High
Do not use without reviewing
Everything we have for goods receiving is the paragraph in
docs/receiving-notes.md. It was written by the engineer who built the handheld
flow and it makes sense to about four people in the building.
Two of them have left. The agency operators who cover night shift cannot use it: they do not know which scan comes first, and when they guess wrong the handheld shows a message they report as a bug every time. It is not a bug. The paragraph also rolls three different behaviours together - a clean delivery, a delivery with more on the pallet than the order says, and a short delivery - so when somebody reports "receiving is broken" we have no idea which of the three they were doing.
Our team runs its acceptance suite through Cucumber, so these need to come back as Given / When / Then, one behaviour at a time, in language an operator on the floor can follow while holding a scanner.
One more thing: receiving a purchase order closes it. We have a fixed pool of seeded orders and last quarter we ran out three weeks before the environment rebuild.
Produce one markdown document at exactly docs/receiving-scenarios.md
containing:
Out of scope: automating these as step definitions, putaway, cycle counting, and anything about the label printer.
Extract the following files before beginning.
=============== FILE: docs/receiving-notes.md ===============
Given the warehouse is set up, when the operator scans the pallet the usual way, then receiving works. If there is more on the pallet than the order says that should be handled too, and short deliveries need to work as well. Ask Dmitri if the scanner does not connect.
=============== FILE: docs/wms-test-data.md ===============
WMS web console: https://wms-staging.brightport.example Handheld: Zebra MC3300, WMS client 4.8, cradle 3 in the QA bay.
OP-1020
(M. Sowinska) is the seeded receiving operator.DD-03; the others are bound to outbound.Receiving expects the pallet licence plate first, then the destination bin.
Scanning the bin first returns Unexpected scan - expecting LPN on the
handheld. That message is correct behaviour, not a defect.
All are for SKU WID-2200 (Widget 20mm), 120 units ordered, arriving as 10
pallet licence plates of 12 units each, labelled LPN-<PO>-01 to
LPN-<PO>-10.
| PO | State |
|---|---|
| PO-88401 | received - closed |
| PO-88402 | received - closed |
| PO-88403 | received - closed |
| PO-88404 | open |
| PO-88405 | open |
| PO-88406 | open |
| PO-88407 | open |
| PO-88408 | open |
Receiving against a PO closes it. A closed PO cannot be received again. The pool is restored when staging is rebuilt, on the first Monday of the quarter.
| Situation | What happens |
|---|---|
| Quantity received = ordered | PO moves to Received; handheld shows Receipt complete 120/120. |
| Over ordered, within 5% | Accepted; PO moves to Received (over); handheld shows the received figure over the ordered figure. |
| Over ordered, above 5% | Handheld shows Over tolerance - supervisor override required; nothing is received until a supervisor badge is scanned. Supervisor badge S-4471 (T. Adeyemi). |
| Quantity received < ordered | PO moves to Partially received; a discrepancy note is raised in the console under Receiving > Discrepancies. |
Destination bin for all receiving tests: RCV-A-01.