AL HASHMI CONSULTING ENGINEERS & ARCHITECTS
ERP V6 REALTIME — FINAL TEST BUILD

IMPORTANT
=========
This ZIP is intended for a TEST subdomain/folder and a NEW TEST DATABASE first.
Do NOT extract it over the current live ERP until you have tested it.

RECOMMENDED TEST LOCATION
=========================
Example folder:
  public_html/erp-v6-test/
Example URL:
  https://erp-v6-test.yourdomain.com

INSTALLATION
============
1. In cPanel create a NEW MySQL database and DB user. Grant the user ALL PRIVILEGES on that test database.
2. Upload the ZIP to the TEST ERP root and extract it.
3. Make sure these folders/files are present in that root:
   install/
   includes/
   assets/
   clients/
   projects/
   drawings/
   sketches/
   site/
   portal/
   dashboard.php
   login.php
4. Open:
   https://YOUR-TEST-ERP-URL/install/
5. Enter DB Host, DB Name, DB User, DB Password, Base URL and create the Super Admin account.
6. After installation, login.php opens normally. The installer automatically locks itself once config.php exists.
7. Test modules before moving any production data.

CORE V6 FEATURES INCLUDED
=========================
- Modern responsive dashboard with Lucide icons
- Mobile off-canvas menu
- Back / Home / Close toolbar on internal modules
- AJAX/History-API navigation for internal pages
- AJAX save/update/delete forms with toast messages
- Global search across client/project/drawing/sketch/employee/vehicle/court records
- English/Arabic transliteration helpers
- Clients: auto Client No., WhatsApp country code, direct WhatsApp, alternative number, view popup
- Projects: locked auto Job No., editable auto Project No., Arabic auto-fill, view popup, default stages
- Drawings: project-wise editable auto Drawing No.
- Sketches: project-wise editable auto Sketch No.
- Documents / Client Uploads / Contractor Submissions
- Site stages: custom add/edit/delete, stage progress, photos, edit/delete/replace, GPS Google Maps link
- Full Site and Stage reports using AL HASHMI letterhead
- RFI / Inspections / NCR
- Employees / Inventory / Vehicles / expiry alerts
- Court Cases / Email Records
- Internal Chat
- Calendar / Tasks / Notifications / Reports
- Audit History / Trash restore + permanent delete
- Admin user management: role, email/password, portal type, multiple project assignments, safe delete
- Client Portal
- Contractor Portal with assigned-project security

HOSTING COMPATIBILITY
=====================
- PHP 8.1+ recommended (PHP 8.3 tested by syntax validation).
- MySQL/MariaDB.
- File uploads include a MIME detection fallback when PHP finfo/Fileinfo is unavailable.
- uploads/.htaccess blocks PHP execution in upload storage.

REALTIME/AJAX NOTE
==================
This is a PHP server application. “Realtime” here means internal navigation and normal CRUD actions use fetch/AJAX so the browser does not reload the complete shell each time. Download, PDF/report/print and logout links intentionally use normal navigation. Internal Chat refreshes periodically.

TEST CHECKLIST
==============
- Login / logout
- Mobile menu open/close
- Back / Home / Close on modules
- Add/Edit/Delete/View Client
- Add/Edit/Delete/View Project
- Drawing and Sketch auto numbering
- Upload PDF/JPG/PNG with Fileinfo enabled and disabled
- Site custom stage + photos + report
- Admin create user + assign multiple projects
- Client portal access
- Contractor assigned-project access
- Global search
- Trash restore/purge
- Audit history

Do not use the production database until this test checklist is completed.
