=======================================================================
                  PHPHR — Open Source HR Software
                  INSTALLATION & SETUP GUIDE
=======================================================================

System Requirements:
--------------------
• PHP 7.4 or higher (PHP 8+ recommended)
• MySQL / MariaDB database
• Apache or Nginx Web Server
• Enabled PHP Extensions:
  - mysqli
  - pdo_mysql (optional for future updates)
  - openssl
  - mbstring
  - json
  - curl
• mod_rewrite enabled (optional for clean URLs)

Folder Structure (important paths):
-----------------------------------
/public               → Public root where index and modules are accessed
/app                  → MVC application files
/app/controllers      → Controller files
/app/models           → Data models
/app/views            → Views/templates
/app/config           → Application configuration + database connection
/database             → Contains installation SQL file

Installation File Location:
---------------------------
The SQL file required for database setup is located at:
    /database/phphr_install.sql

Installation Steps:
-------------------
1. Download the PHPHR source code and extract it to your web directory.
2. Create a new MySQL database (UTF8MB4 recommended).
3. Import the SQL file located at:
       /database/phphr_install.sql
4. Open file:
       /app/config/database.php
   and update the database credentials:
       DB_HOST, DB_NAME, DB_USER, DB_PASS
5. Open file:
       /app/config/config.php
   and update company / HR system settings if required.

Accessing PHPHR (URL):
----------------------
After successful installation, open your browser and enter:

    http://localhost/your-hr-folder/public/

Example:
    http://localhost/phphr/public/

If uploading to online server:
    https://yourdomain.com/public/

Admin Login Credentials:
------------------------
Default credentials after installation:
• Email: admin@phphr.com
• Password: 123456

(If login fails, verify that the `password_hash` field in table `phphr_users`
is VARCHAR(255) and the value is not truncated.)

File & Folder Permissions:
--------------------------
• /public/uploads   → Writable for uploads (if enabled)
• /app/logs         → Writable for system logs (if enabled)

Security Notes:
---------------
• Delete /database/phphr_install.sql after installation.
• Change admin password immediately after first login.
• Keep database configuration private and secure.
• Do not expose /app/config folder via the web.

Recommended PHP Settings:
-------------------------
• max_execution_time = 300
• memory_limit = 512M
• upload_max_filesize = 32M
• post_max_size = 32M

Support & Community:
--------------------
Website: https://www.phphr.com
Live Demo: https://www.phphr.com/hr-software-demo/
Download: https://www.phphr.com/download-hr-software/

License:
--------
PHPHR is licensed under the MIT Open Source License.
You may use, modify, rebrand, and deploy commercially
while preserving this copyright notice.

=======================================================================
               Thank you for choosing PHPHR Open Source!
=======================================================================