AL GHANI HR ONLINE CRM
======================
Target URL: https://crm.alghanihr.site

Requirements
- cPanel hosting with PHP 8.1+ recommended
- MySQL/MariaDB
- HTTPS/SSL
- PDO MySQL extension

INSTALLATION
1. Create subdomain crm.alghanihr.site in cPanel and set its document root to the folder where you upload this package. Upload/extract the package contents into that document root.
2. Create a MySQL database and database user in cPanel; grant the user ALL PRIVILEGES to that database.
3. Import sql/database.sql using phpMyAdmin.
4. Copy app/config.example.php to app/config.php if your package includes it; otherwise edit app/config.php and enter DB_HOST, DB_NAME, DB_USER and DB_PASS.
5. Ensure storage/ is writable by PHP. It is deliberately protected from direct web access.
6. Open https://crm.alghanihr.site/install.php and create the first administrator (10+ character password).
7. Delete install.php from the server immediately after successful installation.
8. Log in and create staff accounts under Users & Roles.

IMPORTANT SECURITY
- Do not publish database credentials.
- Do not disable HTTPS.
- Candidate passport files are stored in protected storage and are not meant to be directly browsable.
- Passwords use PHP password_hash/password_verify.
- Back up the MySQL database and storage directory regularly.

CURRENT MVP MODULES
Dashboard, Candidates, Clients, Job Orders, Finance, Reports, Settings, Users/Roles, Audit Log, secure uploads, printable/PDF-ready candidate profiles.

NEXT EXPANSION POINTS
- Full manpower deployment/worker module
- Overseas agent module
- invoices/quotations/receipts
- interview/medical/visa/ticket workflow
- WhatsApp templates
- advanced passport MRZ/OCR verification
- candidate photo/logo cropper
- Excel import/export
- automated email/WhatsApp integrations
