# Pop Rush — Servidor (ranking mundial + donaciones)

## Archivos
| Archivo | Para qué |
|---|---|
| `config.php` | **Edita esto primero**: clave secreta, contraseña admin, paquetes, enlaces de pago |
| `api.php` | La API que usa el juego (no se abre en el navegador) |
| `admin.php` | Tu panel: acreditar puntos, crear códigos, moderar el ranking |
| `donar.php` | Página pública que ve el jugador al tocar "DONAR" |
| `lib.php` | Funciones internas |
| `data/` | Aquí se crea la base SQLite (protegida para IIS y Apache) |

## Instalación
1. Sube la carpeta `poprush-api` a tu hosting con **HTTPS** (por ejemplo `https://tudominio.com/poprush/`).
   Requiere PHP 7.4+ con `pdo_sqlite` (o `pdo_mysql` si usas MySQL).
2. Edita `config.php`:
   - `secret`: una clave larga y aleatoria.
   - `admin_password`: tu contraseña del panel.
   - `donate_url`: la dirección real de `donar.php`.
   - `packages`, `payment_links` y `contact`.
3. Dale permiso de escritura a la carpeta `data/` para el usuario de PHP
   (en IIS: usuario `IUSR` / grupo `IIS_IUSRS`).
4. Abre `https://tudominio.com/poprush/admin.php` y entra con tu contraseña. Así se crean las tablas.
5. En el juego (`index.html`), busca `const SERVER` y pon:
   ```js
   url: 'https://tudominio.com/poprush/api.php',
   secret: 'la-misma-clave-de-config.php',
   ```
6. Genera el APK de nuevo.

## Flujo de una donación
1. El jugador va a Tienda > Puntos y toca **DONAR** en un paquete. Se abre `donar.php` con su **ID de jugador**.
2. Paga con MercadoPago o PayPal y te manda el comprobante junto con su ID.
3. En `admin.php` > *Acreditar puntos*, pegas su ID y los puntos.
4. Al abrir el juego o la tienda, los puntos le llegan solos con un aviso.

También puedes crear **códigos de canje** para sorteos o para vender por otro medio. Cada código sirve una sola vez.

## Seguridad
- La clave `secret` va dentro del APK. Alguien con conocimientos podría extraerla y enviar récords falsos.
  Por eso el servidor limita la frecuencia de envíos, valida rangos y solo deja subir récords, nunca bajarlos.
  Desde el panel puedes **ocultar** o **borrar** jugadores tramposos.
- Los puntos de donación los das tú manualmente, así que no se pueden falsificar desde el juego.