THE LABS GADGET CRM — UI REFRESH PATCH (after Phase 16)
=======================================================
PURPOSE: Compact text/cards/spacing, consistent grouped navigation on Dashboard and module pages. Front Counter groups Register Device + POS + Payments + Cash Register. No SQL or migration. Business code, roles, financial/stock logic unchanged.

REQUIREMENTS: Activated CRM Phase 16 and its dependencies; PHP 8.1+.

FILES:
  REPLACE EXISTING: dashboard.php, crm3.php
  ADD NEW: crm-ui-nav.php, assets/ui-refresh.css, assets/ui-refresh.js

BEFORE INSTALLATION:
  1. Back up ENTIRE CRM website folder outside public_html and export FULL database SQL using phpMyAdmin.
  2. Back up dashboard.php and crm3.php separately.
  3. Compare the two replacement files against your current ones. If changed since Phase 16, DO NOT overwrite blindly. Merge the UI changes or provide current versions to adapt.
  4. Confirm crm3.php is in the same folder as app.php and dashboard.php.

INSTALLATION:
  Upload ZIP to the CRM folder containing app.php; Extract, allowing only dashboard.php and crm3.php to overwrite. Three other files are new. NO upgrade script or database activation needed.
  Refresh browser with Ctrl+Shift+R / Cmd+Shift+R to clear cached CSS and JS.

NEW MENU GROUPS:
  Overview: Dashboard; Daily Operations
  Front Counter: Register Device; Point of Sale; Payments & Invoices; Cash Register & Closing
  Repairs & Customers: Repair Records; Customers; Device Inspection & QC; Repair Tracking QR; Warranty & Claims; Customer Notifications; 3-Day Follow-Ups
  Inventory & Suppliers: Inventory & Barcode; Suppliers & Purchase Orders
  Team & Reports: Attendance & HR; Sales & Performance
  Administration (Owner/HR): Staff Management; CRM Settings
  Change Password remains outside the collapsible groups. The active group expands automatically.
  Use ⇤ to minimize desktop sidebar to icon rail, ⇥ to expand. Clicking any category icon when minimized expands it. Mobile navigation remains an overlay.

ACCESS:
  Menus preserve Phase 16 visibility rules and Fasa 10 module permissions, including restricted POS/Finance/Inventory and admin/HR pages. Hidden links do NOT create or change authorization; original pages still enforce permissions.

TESTS (read-only UI smoke tests):
  - Owner: Dashboard, Repair Records, Register Device, POS and Cash Register menu links appear under intended category.
  - Manager / HR / Frontdesk / Technician: only links permitted by their original role and permission remain visible.
  - Open/close groups and minimize sidebar on desktop; open hamburger on mobile and inspect layout.
  - Existing business actions should be unaffected; no transaction testing is required solely for UI patch.

ROLLBACK: restore backed-up dashboard.php and crm3.php. Extra three files may remain unused or be deleted. No SQL rollback needed.

IMPORTANT: This patch does NOT validate untested POS/QC/PO/HR/Cash Register functions and does NOT change data. Browser UI changes only. If your dashboard.php or crm3.php was replaced/modified after Phase 16, send those files to merge before installing.
