Bakery POS - Phase 8.1 Outlet / Location Administration

DATABASE
========
No SQL migration is required for Phase 8.1.
The existing Phase 8 database already contains the required location and user-location tables.
Do NOT re-import Phase 8 SQL migrations.

RECOMMENDED DEPLOYMENT
======================
1. Back up /public_html/bakery/.
2. Back up the engrgolk_bakery database.
3. Open /public_html/bakery/ in cPanel File Manager.
4. Upload bakery_full_phase8_1_DIRECT_EXTRACT.zip there.
5. Extract it in that exact directory and overwrite existing files.
6. Confirm config/database.php still contains your correct hosting credentials.
7. Login as Super Admin or Admin.
8. Open Administration -> Locations & Outlets.
9. Create a test Outlet.
10. Open Administration -> User Access and assign a test user to the new outlet.
11. Login as the test user and confirm the outlet appears under Outlet -> My Outlets.

PHASE 8.1 FEATURES
==================
- Create Bakery, Outlet and Warehouse locations.
- Automatic location code generation when code is blank.
- Main Outlet selection.
- Safe activation/deactivation; locations are never deleted.
- Deactivation is blocked when stock, reserved stock, open transfers or active production exist.
- User Access page for assigning multiple roles and multiple locations.
- Only Super Admin can assign/change Super Admin access.
- Last active Super Admin is protected.
- Pending user approval now uses checkbox cards for roles and locations.
- Outlet Dashboard shows each accessible outlet separately.

CODE FORMAT
===========
All Phase 8.1 new/changed PHP, CSS and JavaScript files use vertically readable formatting,
normal indentation and line breaks. No Phase 8.1 source file is intentionally minified or written
as long paragraph-style code.
