# GUÍA DE INSTALACIÓN · Sistema de Declaraciones con Telegram
# 100% GRATIS · cPanel + Bot de Telegram

=============================================================
PASO 1 · CREAR EL BOT DE TELEGRAM (5 minutos)
=============================================================

1. Abre Telegram y busca: @BotFather
2. Escribe: /newbot
3. Ponle un nombre, ej: Declaraciones Tributarias
4. Ponle un usuario, ej: mis_declaraciones_bot
5. BotFather te da un TOKEN como este:
   1234567890:AAHdqTcvCHHvsuBT6U8ZMSeJAHKPsdjhkuy
   → GUÁRDALO, lo necesitas en el siguiente paso

6. Para obtener tu CHAT ID:
   a. Busca en Telegram: @userinfobot
   b. Escríbele /start
   c. Te responde con tu ID numérico, ej: 987654321
   → GUÁRDALO también


=============================================================
PASO 2 · CREAR LA BASE DE DATOS EN CPANEL (3 minutos)
=============================================================

1. Entra a cPanel → "MySQL Databases"
2. Crea una base de datos: declaraciones_db
3. Crea un usuario: tu_usuario_db con una contraseña segura
4. Añade el usuario a la base de datos con TODOS LOS PRIVILEGIOS

5. Ve a cPanel → phpMyAdmin
6. Selecciona la base de datos que creaste
7. Haz clic en la pestaña "SQL"
8. Pega TODO el contenido del archivo 01_base_de_datos.sql
9. Haz clic en "Continuar" o "Go"

10. Luego actualiza el token y chat_id en la tabla configuracion:
    UPDATE configuracion SET valor='TU_BOT_TOKEN'  WHERE clave='telegram_bot_token';
    UPDATE configuracion SET valor='TU_CHAT_ID'    WHERE clave='telegram_chat_id';


=============================================================
PASO 3 · SUBIR LOS ARCHIVOS PHP A TU HOSTING (2 minutos)
=============================================================

1. En cPanel → File Manager → public_html
2. Crea una carpeta llamada: declaraciones
3. Sube dentro de esa carpeta los 3 archivos:
   - 02_notificador.php  → renómbralo a notificador.php
   - 03_webhook.php      → renómbralo a webhook.php
   - 04_panel.php        → renómbralo a panel.php

4. Edita los 3 archivos y reemplaza estas líneas con tus datos reales:
   define('DB_NAME', 'declaraciones_db');  ← puede tener prefijo, ej: usuariocpanel_declaraciones_db
   define('DB_USER', 'TUUSUARIO_db');      ← el usuario MySQL que creaste
   define('DB_PASS', 'TU_PASSWORD_DB');    ← la contraseña que pusiste

   NOTA: En cPanel el nombre real de la BD suele ser:
   nombredeusuario_declaraciones_db  (con prefijo del usuario cPanel)
   Verifica el nombre exacto en MySQL Databases.

5. En notificador.php, también cambia:
   $url_panel = "https://TUDOMINIO.com/declaraciones/panel.php";
   → pon tu dominio real


=============================================================
PASO 4 · REGISTRAR EL WEBHOOK DE TELEGRAM (1 minuto)
=============================================================

Abre tu navegador y visita esta URL (una sola vez):

https://api.telegram.org/botTU_BOT_TOKEN/setWebhook?url=https://TUDOMINIO.com/declaraciones/webhook.php

Reemplaza:
- TU_BOT_TOKEN → el token que te dio BotFather
- TUDOMINIO.com → tu dominio real

Si ves {"ok":true} → ¡está funcionando!


=============================================================
PASO 5 · CONFIGURAR EL CRON JOB EN CPANEL (3 minutos)
=============================================================

1. cPanel → "Cron Jobs"
2. Selecciona "Once per hour" o configura manualmente:

   Minuto:  0
   Hora:    8-20        ← ejecuta cada hora de 8am a 8pm
   Día:     *
   Mes:     *
   Día sem: *

3. Comando (cambia TUUSUARIO por tu usuario de cPanel):
   php /home/TUUSUARIO/public_html/declaraciones/notificador.php

   Si no sabes el path exacto, en File Manager ve a notificador.php,
   haz clic derecho → "Change Permissions" y verás la ruta completa.


=============================================================
PASO 6 · PROBAR EL SISTEMA
=============================================================

1. Abre tu bot en Telegram y escribe: /pendientes
   → Debe responderte con la lista del mes actual

2. Escribe: ok hernandez
   → Debe confirmar que marcó a Hernandez Jorge

3. Visita en tu celular:
   https://TUDOMINIO.com/declaraciones/panel.php
   → Verás el panel visual con todos los clientes


=============================================================
CÓMO FUNCIONA DÍA A DÍA
=============================================================

• Cada hora de 8am a 8pm el sistema revisa si hay declaraciones
  que vencen ESE DÍA y están pendientes
• Si hay, te manda un mensaje en Telegram con la lista
• A las 7pm y 8pm el mensaje es más urgente (🚨)
• Si ya no hay pendientes, no manda nada (sin spam)

Para marcar completado tienes 3 opciones:
  1. Responder "ok nombre" en Telegram
  2. Tocar el botón ✓ OK en el panel web
  3. El sistema deja de notificar ese cliente automáticamente


=============================================================
COSTO TOTAL: $0.00
=============================================================
- Telegram Bot API: GRATIS ilimitado
- cPanel/Hosting: ya lo tienes
- MySQL: ya incluido en cPanel
- PHP/Cron Jobs: ya incluido en cPanel


=============================================================
SOPORTE · COMANDOS DEL BOT
=============================================================

/pendientes  → lista todos los pendientes del mes
/estado      → solo los de hoy
ok nombre    → marca una declaración como completada
              (ej: "ok torres", "ok camara", "ok bueno")
