CPANEL DEPLOYMENT GUIDE - NL ASSET MANAGER
Domain: assetmanagement.app
Database: shthnl_asset
Database user: shthnl_asset

1) CREATE / ADD THE DOMAIN IN CPANEL
- Go to cPanel > Domains > Create a New Domain.
- Type: assetmanagement.app
- Leave "Share document root" unchecked.
- Document Root should be: /public_html/assetmanagement.app
- Click Submit.

2) CREATE / CONFIRM THE DATABASE
- Go to cPanel > MySQL Databases.
- Confirm this database exists: shthnl_asset
- Confirm this user exists: shthnl_asset
- Password: assetmanagement
- Add user shthnl_asset to database shthnl_asset.
- Give ALL PRIVILEGES.

3) IMPORT THE DATABASE
- Go to cPanel > phpMyAdmin.
- Click/select database shthnl_asset on the left side first.
- For a clean fresh system, import: install.sql
- If you want the exact data from the uploaded local SQL dump, import: cpanel_import_current_data.sql
- Wait until phpMyAdmin says import completed successfully.

4) UPLOAD THE SYSTEM FILES
- Go to cPanel > File Manager.
- Open: /public_html/assetmanagement.app
- Upload the ZIP package.
- Extract it.
- IMPORTANT: Make sure index.php, login.php, dashboard.php, assets.php, config/, includes/, assets/, and uploads/ are directly inside /public_html/assetmanagement.app
- Do not leave them one level deeper like /public_html/assetmanagement.app/asset_management/index.php unless you intentionally want the app URL to include /asset_management/.

5) CHECK CONFIGURATION
- The database connection is already set in: config/database.php
- DB_HOST = localhost
- DB_NAME = shthnl_asset
- DB_USER = shthnl_asset
- DB_PASS = assetmanagement
- Timezone = Europe/Amsterdam
- Currency = Euro

6) SET FOLDER PERMISSIONS
- uploads/ should be 755 or 775.
- uploads/photos/ should be 755 or 775.
- Do not set folders to 777 unless your host specifically requires it.

7) OPEN THE WEBSITE
- Visit: https://assetmanagement.app
- If the domain is not yet pointed/propagated, use the temporary subdomain shown by cPanel, for example: assetmanagement.app.shth.nl

8) LOGIN
- Email: admin@example.com
- Password: Admin@123
- After logging in, immediately create your real admin user or change the default admin password.

9) FIRST TESTS AFTER LAUNCH
- Login page opens.
- Dashboard loads without database error.
- Companies page shows Omega Vastgoed B.V., Caerus Tech B.V., and Vivet Associates.
- Add one location under the correct company.
- Add one test asset.
- Upload one asset photo.
- Open Labels and test QR scan.
- Open Reports and export CSV.

COMMON ERRORS
- Database connection failed: database was not imported, wrong credentials, or user has no privileges.
- 404 Not Found: files are in the wrong folder level. Move contents directly into /public_html/assetmanagement.app.
- Photos not uploading: check uploads/photos permission.
- Domain not opening: DNS is not pointed yet or SSL is not issued yet.
