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.
| Thing | Value |
|---|---|
| Application URL | https://assembleos.vercel.app |
| Health check | /api/health must show {"ok":true,"db":"connected","seeded":true} before you start. If not, stop and report. |
| Browsers | Latest Chrome or Edge (primary). One pass in Firefox or Safari is a bonus. |
| Password (all demo users) | demo1234 |
| Role | Used in suites | |
|---|---|---|
| Admin | ada@apexnaturals.com | Most suites |
| Operator | funke@apexnaturals.com | B (permissions) |
| Sales Manager | bisi@apexnaturals.com | B (permissions) |
| Finance Manager | kemi@apexnaturals.com | B (permissions) |
LOT-TEST-JD-01) so records are attributable.| ID | Steps | Expected 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. |
| ID | Steps | Expected 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. |
Log in as Admin for suites C through H.
| ID | Steps | Expected 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. |
| ID | Steps | Expected 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. |
| ID | Steps | Expected 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. |
| ID | Steps | Expected 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. |
| ID | Steps | Expected 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. |
| ID | Steps | Expected 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 ₦. |
Print this page (or copy this table) and mark one row per case.
| Case | Pass / Fail | Notes (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 |
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)