# SmartTech OMP — Grouped Sidebar & Account UI Update

Release date: 2026-06-25

## Scope

This update redesigns the navigation and shared account interface for:

- Super Admin
- Staff accounts
- Vendor accounts
- Customer accounts
- Affiliate / Marketing Member accounts
- POS Admin, Manager and Cashier screens

No database schema change is required.

## Navigation improvements

- Converted flat sidebar lists into grouped dropdown/accordion menus.
- Automatically opens the group containing the current page.
- Highlights the active page with a clear visual state.
- Added menu item counts for each group.
- Added a sidebar search box for large admin menus.
- Added persistent group state using browser local storage.
- Added contextual icons for groups and menu items.
- Added an empty-search result message.
- Added a website shortcut and workspace identity area.

## Mobile improvements

- Sidebars now work as off-canvas drawers on tablets and phones.
- Added a dark overlay and close button.
- Added Escape-key closing support.
- Added responsive top bars and compact account menus.
- POS navigation uses a mobile drawer and a bottom quick-navigation bar.

## Account interface improvements

- Redesigned sticky top bar.
- Added breadcrumb context and cleaner page titles.
- Added user avatar and account dropdown.
- Added notification and website shortcuts where appropriate.
- Improved cards, tables, forms, tabs, buttons, alerts and pagination.
- Improved input focus states and spacing.
- Added accessible labels and keyboard-focus behavior for scrollable tables.
- Retained existing authorization and module visibility rules.

## POS improvements

- Grouped navigation into Overview, Sales, Operations, Reports & Settings and Management.
- Improved register and shift status visibility.
- Added vendor switcher for authorized admin users.
- Added responsive POS user menu.
- Improved active states and mobile navigation.

## Files changed

1. `app/Layouts/account_sidebar.php` — new shared grouped sidebar
2. `app/Layouts/admin_header.php`
3. `app/Layouts/admin_footer.php`
4. `app/Layouts/panel_header.php`
5. `app/Layouts/panel_footer.php`
6. `public/assets/css/purchase-haat.css`
7. `public/assets/js/account-ui.js` — new account UI behavior
8. `pos/partials/header.php`
9. `pos/partials/footer.php`
10. `public/assets/css/pos.css`
11. `public/assets/js/pos-core.js`

## Validation

- 316 PHP files passed `php -l` syntax validation.
- 102 JavaScript files passed `node --check` validation.
- Mock-rendered Admin, Vendor and POS layouts produced valid navigation structures.
- Active menu highlighting was detected in all three layout tests.
- No duplicate HTML IDs were detected in the rendered layout tests.
- Patch and complete ZIP archives passed integrity testing.

## Installation

### Existing latest release

1. Back up the current project files.
2. Extract `SmartTechOMP_Sidebar_UI_Patch_2026-06-25.zip` into the project root.
3. Allow the included files to overwrite existing files.
4. Clear PHP OPcache, hosting cache and browser cache.
5. No SQL import is required.

### Test first

- `/admin/index.php`
- `/admin/products.php`
- `/vendor/index.php`
- `/vendor/products.php`
- `/customer/dashboard.php`
- `/member/index.php`
- `/pos/register.php`

