Acceptance Test Cases

These are user-facing acceptance test cases — the manual scenarios you (or QA) walk through against a running TuffOps install before promoting to production. Each test case maps to a guide and a real user outcome. They're not a replacement for automated tests (the test suite covers far more), but they catch the regressions that only show up when a human clicks through the actual UI.

How to use these

Pick the area you're verifying. For each test case in that area:

1. Set up the Preconditions.
2. Walk through the Steps exactly.
3. Compare against Expected. If anything diverges, that's a bug — file it with the test case ID in the report.

Test case IDs follow the pattern TC-<AREA>-<NNN>:

• TC-CUST-* — Customers
• TC-UNIT-* — Units (includes QR codes and ties)
• TC-CR-* — Customer Requests
• TC-INV-* — Invoices
• TC-CHK-* — Checklists
• TC-WO-* — Work Orders
• TC-QUO-* — Quotations
• TC-COMP-* — Compliance (EPA Part 84)
• TC-TECH-* — Technician / Field Workflows
• TC-USER-* — Users (roles and direct permissions)
• TC-CAT-* — Catalog (device types, manufacturers, models, items)

IDs are stable — once a test case has an ID, it keeps it across edits. Don't renumber. New test cases get the next free ID in the area.

Coverage

Area	Test cases	Guide reference
Customers	TC-CUST-001 to 006	Guides -> Customers
Units	TC-UNIT-001 to 010	Guides -> Units
Customer Requests	TC-CR-001 to 005	Guides -> Customer Requests
Invoices	TC-INV-001 to 005	Guides -> Invoices
Checklists	TC-CHK-001 to 008	Guides -> Checklists
Work Orders	TC-WO-001 to 010	Guides -> Work Orders
Quotations	TC-QUO-001 to 006	Guides -> Quotations
Compliance	TC-COMP-001 to 082	Guides -> Compliance
Technician	TC-TECH-001 to 027	Guides -> Technician
Users & Catalog	TC-USER-001 to 002, TC-CAT-001 to 003	Guides -> Administration

Conventions

• "Logged in as Office" means a user with the typical office role bundle from Permissions Model.
• "Logged in as Tech" means a user with the typical technician bundle (*.view, work_orders.edit only).
• "Test customer" means a fresh customer with Test in the name, deletable after the test.
• Phone numbers in steps assume the tenant phone country/area defaults — substitute your own.

Smoke pass

If you only have time for the smallest possible verification before a release, run these four test cases:

• TC-CUST-001 — create a residential customer.
• TC-UNIT-001 — add a unit and assign it to that customer.
• TC-WO-001 — create a work order for that unit, assign and start.
• TC-WO-007 — submit the work order, approve from the office.

If those pass, the core dispatch loop is alive. Anything beyond is a deeper regression sweep.