========================================================================
Bolo (বলো) — cPanel PHP + MySQL Backend Setup Guide
Subdomain: https://chatapp.reevox.site/api/
========================================================================

IMPORTANT:
- This backend uses a SEPARATE MySQL database dedicated to Bolo on the
  chatapp.reevox.site subdomain. Do NOT reuse or touch the main
  reevox.site database or any of its tables.
- Plain PHP + MySQL only (no Firebase, no WebSocket, no Node.js).

------------------------------------------------------------------------
1. CREATE A FRESH MYSQL DATABASE IN CPANEL
------------------------------------------------------------------------
1. Open cPanel -> MySQL® Databases.
2. Create a new database (e.g., `reevox_bolo_chat`).
3. Create a new database user and grant ALL PRIVILEGES on that new DB.
4. Open cPanel -> phpMyAdmin, select the new database, and import:
     `schema.sql`
   (Note: edit/remove the `CREATE DATABASE` / `USE` lines at the top of
   `schema.sql` if your cPanel phpMyAdmin requires importing directly into
   your pre-selected cPanel-prefixed database.)

------------------------------------------------------------------------
2. UPLOAD FILES TO SUBDOMAIN DOCUMENT ROOT
------------------------------------------------------------------------
Upload the contents of this zip into the document root of
`chatapp.reevox.site` (for example: `/home/USERNAME/chatapp.reevox.site/`):
  - `api/`        -> `/home/USERNAME/chatapp.reevox.site/api/`
  - `uploads/`    -> `/home/USERNAME/chatapp.reevox.site/uploads/`

Ensure `uploads/` and its subdirectories (`avatars/`, `images/`, `voice/`)
have writable permissions (0755) for PHP.

------------------------------------------------------------------------
3. CONFIGURE CREDENTIALS IN `api/config.php`
------------------------------------------------------------------------
Open `api/config.php` and fill in these placeholders:
  - `DB_HOST`    : usually `'localhost'`
  - `DB_NAME`    : your new Bolo MySQL database name
  - `DB_USER`    : your new Bolo MySQL database username
  - `DB_PASS`    : your new Bolo MySQL database password
  - `APP_SECRET` : replace with a unique random 64-character secret string

------------------------------------------------------------------------
4. ANDROID APP CONFIG VALUE (IF DOMAIN EVER CHANGES)
------------------------------------------------------------------------
In the Android project, the API base URL is configured in ONE place:
  File: `app/build.gradle.kts`
  Line: `buildConfigField("String", "API_BASE_URL", "\"https://chatapp.reevox.site/api/\"")`

It is already set to `https://chatapp.reevox.site/api/` by default.

------------------------------------------------------------------------
5. PHP REQUIREMENTS
------------------------------------------------------------------------
- PHP 8.0+ (with `pdo_mysql`, `fileinfo`, `mbstring`, `json`)
- Apache `mod_rewrite` / `.htaccess` enabled (included in `api/.htaccess`
  so `Authorization: Bearer ...` headers reach PHP under CGI/FastCGI).
- HTTPS active on `chatapp.reevox.site` (required by Android).
