# GORO Platform - Installation Instructions

## Requirements
- PHP 7.2 or higher
- MySQL 5.7 or higher
- Web server (Apache/Nginx)
- Composer (optional, for installing QR code library)

## Installation Steps

1. **Database Setup**
   - Create a new MySQL database named `goro_platform`
   - Import the `database.sql` file to create all tables and sample data

2. **Application Setup**
   - Copy all files to your web server directory
   - Configure your web server to point to the project's root directory
   - Make sure the following directories are writable by the web server:
     - uploads/
     - uploads/payments/
     - uploads/equipment/
     - uploads/rewards/
     - uploads/qrcodes/
     - application/cache/
     - application/logs/

3. **Configuration**
   - Edit `application/config/config.php` and set the `base_url` to your domain
   - Edit `application/config/database.php` and update the database credentials

4. **QR Code Library Installation**
   - Create a directory `application/third_party/phpqrcode/`
   - Download phpqrcode library from http://phpqrcode.sourceforge.net/
   - Extract the files to the directory created above

5. **Test the Application**
   - Open your browser and navigate to your domain
   - You should see the GORO Platform landing page
   - Use the following credentials to login:
     - Admin: username: admin, password: admin123
     - Citizen: username: warga1, password: admin123

## Troubleshooting

- If you encounter a "404 Not Found" error, make sure your .htaccess file is properly configured
- If you see database connection errors, verify your database credentials in `application/config/database.php`
- For QR code generation issues, ensure the phpqrcode library is correctly installed

## Security Notes

- Change the default admin password immediately after installation
- Set proper file permissions to prevent unauthorized access
- Consider enabling CSRF protection in `application/config/config.php`