Files
GSB-Construction/docs/PLAN.md
Christopher Boyles 64d4b331a8
Some checks failed
Tests / PHP 8.3 (push) Has been cancelled
Tests / PHP 8.4 (push) Has been cancelled
Tests / PHP 8.5 (push) Has been cancelled
Additional Changes
2026-06-02 22:04:03 +08:00

1.9 KiB

Plan: Group Labors and Equipment & Tools under Master Data Module

This plan details the reorganization of the sidebar navigation to group the Labors and Equipment & Tools modules under a unified Master Data module.

User Review Required

We need your feedback on the preferred UI/UX pattern for grouping:

Important

Option 1: New Top-Level Group (Recommended)

  • A new section header Master Data will be added to the sidebar, positioned below Management or Overview.
  • Labors and Equipment & Tools will be moved directly under this new group as distinct top-level items.

Option 2: Collapsible Menu Item

  • A new sidebar menu item named Master Data will be added under the Management section.
  • Clicking it will expand a submenu showing Labors and Equipment & Tools.

Proposed Changes

Component: Navigation Configuration (resources/js/lib)


[MODIFY] nav-config.ts

  • Remove Labors and Equipment & Tools items from the Management group.
  • Create a new NavGroup or nested menu item structure for Master Data containing both items.
  • Ensure the respective icons (Hammer and Truck), permissions, routes, and layout match existing patterns.

Verification Plan

Automated Tests

  • Since client-side routing and sidebar visibility are driven by nav-config.ts and React components, we will verify compiling the frontend assets using:
    npm run build
    

Manual Verification

  1. Access the web interface.
  2. Confirm the new Master Data section/item is rendered correctly in the sidebar.
  3. Verify that clicking Labors redirects to the Labors module.
  4. Verify that clicking Equipment & Tools redirects to the Equipments module.
  5. Verify that permissions (e.g., hiding modules if the user lacks access) still work as expected.