This is an old revision of the document!
Table of Contents
Tutorial Update (Resolved)
Reported by: Khaled Tarabay on 2026-07-29T13:47:24+01:00
Assigned to: Claude
Resolved by: Claude on 2026-07-30T07:15:26+01:00
Priority: normal
Severity: minor
Reproducibility: have not tried
Category: General
Description: as new tabs and features are added both the global product wide tour needs an update and specific page tutorial, make sure to update all the pages as right now the tutorial is outdated, make sure the tutorial is also role adaptive
Resolution: FIXED. The in-app tutorial (product tour + per-page guides) is refreshed for the features added since it was last updated, and stays role-adaptive.
WHERE: app/classes/Core/Tutorial.php.
WHAT CHANGED: - Deleted Transactions (the finance recycle bin at /finance/deleted, added recently) had NO tour step and NO page guide — added both. Its tour step is gated on a new 'adminormanager' sentinel in allowed() (mirrors the existing 'superadmin' one) so it appears only for a manager or admin — the SAME gate its sidebar item uses; a new 'finance' page guide explains restore vs. owner-only permanent delete. - Contact invoices (#141/#142, done this session): the Contacts + Invoices tour steps and the contacts/billing page guides now explain that a client sale and a supplier/provider purchase each raise a real invoice that shows in the Invoices tab (a purchase = a payable “bill”) and feeds finance. - Maintenance/Installations (#138): the tour + guide no longer say “create the job here” — maintenance/installation jobs are created from a task now (via the task's job type), and the invoice is captured at task close-out. - Tasks: the tour + guide now mention the List/Board (kanban) view toggle and drag-to-move (with the phone “Move to…” fallback), plus the task job-type field.
ROLE-ADAPTIVE (unchanged design, verified intact): every tour step and guide line is still filtered through the same Auth::can()/role check the sidebar uses, so a role never receives a card for a feature it can't reach — the new Deleted Transactions step is dropped for anyone below manager, exactly like its sidebar entry.
VERIFIED: php -l clean; a 20-check reflection/content harness green (all new guide steps present & well-formed; the 'adminormanager' gate correctly fails-safe to “dropped” when the viewer isn't admin/manager, DB-free; every tour wording edit present and correctly gated). NOTE: the positive role-adaptive HTTP run (manager sees the step, field officer doesn't) could not be executed this pass because the local MySQL service stopped mid-session and can't be restarted without elevation (its data dir is permission-locked) — but the gate reuses the exact Auth::isAdmin()/isManager() the sidebar's own adminOrManager entry uses, which is already proven, and the tour is pure content (no schema/route/permission change, so PHPUnit — 29/29 green earlier this session — is unaffected).
Activity / Notes
- 2026-07-30T07:15:23+01:00 - Claude: FIXED. The in-app tutorial (product tour + per-page guides) is refreshed for the features added since it was last updated, and stays role-adaptive.
WHERE: app/classes/Core/Tutorial.php.
WHAT CHANGED: - Deleted Transactions (the finance recycle bin at /finance/deleted, added recently) had NO tour step and NO page guide — added both. Its tour step is gated on a new 'adminormanager' sentinel in allowed() (mirrors the existing 'superadmin' one) so it appears only for a manager or admin — the SAME gate its sidebar item uses; a new 'finance' page guide explains restore vs. owner-only permanent delete. - Contact invoices (#141/#142, done this session): the Contacts + Invoices tour steps and the contacts/billing page guides now explain that a client sale and a supplier/provider purchase each raise a real invoice that shows in the Invoices tab (a purchase = a payable “bill”) and feeds finance. - Maintenance/Installations (#138): the tour + guide no longer say “create the job here” — maintenance/installation jobs are created from a task now (via the task's job type), and the invoice is captured at task close-out. - Tasks: the tour + guide now mention the List/Board (kanban) view toggle and drag-to-move (with the phone “Move to…” fallback), plus the task job-type field.
ROLE-ADAPTIVE (unchanged design, verified intact): every tour step and guide line is still filtered through the same Auth::can()/role check the sidebar uses, so a role never receives a card for a feature it can't reach — the new Deleted Transactions step is dropped for anyone below manager, exactly like its sidebar entry.
VERIFIED: php -l clean; a 20-check reflection/content harness green (all new guide steps present & well-formed; the 'adminormanager' gate correctly fails-safe to “dropped” when the viewer isn't admin/manager, DB-free; every tour wording edit present and correctly gated). NOTE: the positive role-adaptive HTTP run (manager sees the step, field officer doesn't) could not be executed this pass because the local MySQL service stopped mid-session and can't be restarted without elevation (its data dir is permission-locked) — but the gate reuses the exact Auth::isAdmin()/isManager() the sidebar's own adminOrManager entry uses, which is already proven, and the tour is pure content (no schema/route/permission change, so PHPUnit — 29/29 green earlier this session — is unaffected).
Full History
| Date Modified | Username | Field | Change |
|---|---|---|---|
| 2026-07-29T13:47:25+01:00 | Khaled Tarabay | issue-new | New Issue |
| 2026-07-30T07:15:19+01:00 | Claude | Assigned To | ⇒ Claudine |
| 2026-07-30T07:15:21+01:00 | Claude | tag-added | Tag Attached: done-by-claude |
| 2026-07-30T07:15:23+01:00 | Claude | note-added | Note Added: 0000102 |
| 2026-07-30T07:15:26+01:00 | Claude | Status | new ⇒ resolved |
Synced automatically from MantisBT issue #143.
