AssembleOS · Tester Package v1.0

Structured test pack: 30 cases across 8 suites

Everything a tester needs: environment, accounts, ordered test cases with expected results, a result sheet, and a bug report template. No technical background needed. Budget roughly 60 to 90 minutes for a full pass.

1Environment & accounts

ThingValue
Application URLhttps://assembleos.vercel.app
Health check/api/health must show {"ok":true,"db":"connected","seeded":true} before you start. If not, stop and report.
BrowsersLatest Chrome or Edge (primary). One pass in Firefox or Safari is a bonus.
Password (all demo users)demo1234

RoleEmailUsed in suites
Adminada@apexnaturals.comMost suites
Operatorfunke@apexnaturals.comB (permissions)
Sales Managerbisi@apexnaturals.comB (permissions)
Finance Managerkemi@apexnaturals.comB (permissions)
Shared demo data: all testers share one demo company. Numbers (stock, orders) may differ from the examples if someone tested before you; judge the behaviour, not the exact figures. Use your initials in anything you create (e.g. lot LOT-TEST-JD-01) so records are attributable.

2How to run this pack

Follow the stepsexactly as written Compare to Expectedword for word Record Pass / Failon the result sheet If Fail:file a bug report
The loop for every test case. Anything not matching Expected is a Fail, even if it looks harmless.

3Test suites

SUITE A Signing in & account safety

IDStepsExpected result
A1 Open /dashboard directly while logged out. You are redirected to the login page, never shown the dashboard.
A2 Log in as ada@apexnaturals.com with password wrongpass. Red message "Invalid email or password." You stay on the login page.
A3 Repeat A2 six times in a row. By the sixth attempt the message becomes "Too many attempts. Try again in 15 minutes."
A4 Log in as ada@apexnaturals.com / demo1234. (If A3 locked Ada, use another admin-capable account or wait.) Dashboard loads, greeting "Welcome back, Ada", menu visible on the left.
A5 Login page → "Forgot password?" → enter ada@apexnaturals.com → Send. Confirmation message appears, plus a demo reset link. The link opens a "Set a new password" page. Do not actually change the password; just confirm the page loads.
A6 Click the logout icon (top right). Back to the login page; pressing the browser Back button does not reopen the dashboard.

SUITE B Permissions (who can do what)

IDStepsExpected result
B1 Log in as Operator (funke@...). Look at the left menu, then try opening /admin/users by typing the address. Menu shows only Dashboard + Manufacturing entries. The /admin attempt bounces you back to the dashboard.
B2 Still as Operator, open a production order and use its buttons (allowed work). Production pages work normally for the Operator.
B3 Log in as Finance (kemi@...). Open any production order and click Issue materials. A polite refusal appears: "You do not have permission to perform this action." Nothing changes in the data.

SUITE C Buying (PO → approve → receive)

Log in as Admin for suites C through H.

IDStepsExpected result
C1 Procurement → Purchase Orders → New order. Pick any supplier, add 1 line (e.g. Shea Butter, qty 50, price 3500). Create. New PO appears in the list as Pending Approval with a fresh number and correct line total.
C2 Open your PO and click Approve. Status changes to Approved; a Receive option appears.
C3 Before receiving: note the item's "on hand" in Inventory → Stock Balances. Then receive the PO: choose warehouse Raw Materials, full quantity, lot LOT-TEST-[initials]. Success; PO becomes Received; the GRN appears under Goods Received.
C4 Re-check Stock Balances and Movements for that item. On hand increased by exactly your received quantity; Movements shows a receipt row with your lot number.

SUITE D Making (production)

IDStepsExpected result
D1 Manufacturing → Production Orders → New order. Pick the finished product, target qty 100. Create, then open it. Order page shows target 100, produced 0, an active BOM version, and a Material availability panel.
D2 Click Issue materials. Confirmation like "Materials issued (MI-XXXX)". Raw-material stock decreases; Manufacturing → Material Issues lists the new issue with lots.
D3 Click Post output. Message with a new batch (e.g. LOT-FG-000X); order flips to Completed with produced = 100.
D4 Open Manufacturing → Finished Goods. The new batch is listed as Quarantined with quantity 100.

SUITE E Quality release

IDStepsExpected result
E1 Quality → Quality Checks. Find your batch under "Awaiting batch release" and click Release. The batch leaves the waiting list; on Finished Goods it now reads Available.
E2 Admin → Audit Logs. A "Released batch ..." entry exists with your user name and the right time.

SUITE F Selling & shipping

IDStepsExpected result
F1 Sales → Sales Orders → New order. Pick a customer, product qty 20, any price. Create, then open it. Order is Open; totals are price x qty plus 7.5% tax; Stock availability panel is green for 20.
F2 Click Dispatch. Order becomes Completed, dispatched qty 20. Distribution → Dispatch shows a new dispatch with a delivery note number and the exact batch shipped.
F3 Check Finished Goods / Stock Balances for the product. Available stock dropped by exactly 20.

SUITE G Stock corrections

IDStepsExpected result
G1 Inventory → Adjustments. Pick an item + warehouse, quantity -2, reason "Tester damage check". Record. Adjustment appears in the right-hand list; the item's on hand drops by 2; a movement is logged.
G2 Inventory → Transfers. Move qty 1 of an item between two different warehouses. Transfer listed as Completed; source warehouse -1, destination +1 on Stock Balances.
G3 On Transfers, try source = destination (same warehouse). Friendly validation stops you ("Source and destination must differ"). Nothing is saved.

SUITE H The Know layer & a new company

IDStepsExpected result
H1 Open Traceability and search the finished-goods lot you dispatched in F2. A timeline appears connecting your batch back to material issues and forward to the dispatch.
H2 Open Finance → Costing & Valuation. Inventory valuation table with a grand total; product cost & margin row; variance table. All money shows the company currency symbol consistently.
H3 Open Insight → AI Insights. A summary sentence plus a prioritised list (severity colours). Each insight has a working action link.
H4 Log out → Create one (sign up): company "Test Co [initials]", your name, a fresh email, password 8+ chars. You land on the Onboarding wizard as Company Admin of an EMPTY company (no Apex data anywhere).
H5 Complete onboarding: pick any template, set base currency USD, apply. Then open Finance → Costing and Sales → Orders. Wizard confirms applied; all money across the app now shows $, not ₦.

4Known behaviours (not bugs)

5Result sheet

Print this page (or copy this table) and mark one row per case.

CasePass / FailNotes (what actually happened, if different)
A1
A2
A3
A4
A5
A6
B1
B2
B3
C1
C2
C3
C4
D1
D2
D3
D4
E1
E2
F1
F2
F3
G1
G2
G3
H1
H2
H3
H4
H5

6Bug report template

Copy this block for each Fail. Precise reports get fixed fastest.

Title:        [Case ID] Short description, e.g. "C3: stock did not increase after receiving"
Account used: e.g. ada@apexnaturals.com
Date/time:    e.g. 2026-06-11 14:32 (your timezone)
Steps:        1. ...  2. ...  3. ...
Expected:     (copy from the test case)
Actual:       what you actually saw, including any exact error text
Screenshot:   attached / link
How often:    always / sometimes (tried N times)