# Bitacora: Dashboard de descargas en Telegram

**Fecha:** 2026-09-05 · **Equipo:** sobremesa · **Agentes:** OpenCode

---

## Registro en tiempo real

### [14:35] Diseño inicial
- **Que:** Crear una vista de descargas dentro de Telegram.
- **Como:** Reutilizar la consulta existente a Download Station y editar un unico mensaje con botones inline.
- **Resultado:** OK
- **Decisiones:** No se crea una web externa ni una Mini App en esta primera version.
- **Gotchas/Lecciones:** El bot usa directamente la Bot API mediante `requests` y actualmente solo procesa mensajes normales.

### [14:42] Implementacion
- **Que:** Añadir panel editable, botones inline, callbacks y refresco automatico.
- **Como:** `pi_bot.py` mantiene un mensaje por chat y lo actualiza cada 20 segundos; `nas_dl.py` genera la barra Unicode usando el porcentaje de piezas descargadas.
- **Resultado:** OK
- **Decisiones:** `descargas` y `descargar` sin argumento abren el panel; `descargar <enlace>` mantiene la funcion de añadir tareas.
- **Gotchas/Lecciones:** Telegram necesita recibir y responder `callback_query` para que los botones funcionen correctamente.

### [14:47] Verificacion local
- **Que:** Comprobar sintaxis, barra de progreso y callbacks sin llamar a Telegram.
- **Como:** `py_compile`, prueba de extremos de `progress_bar` y callbacks simulados.
- **Resultado:** OK
- **Decisiones:** No se enviaron mensajes reales ni se modificaron tareas del NAS durante la prueba.
- **Gotchas/Lecciones:** La Pi no acepta conexiones SSH desde este equipo en `192.168.50.187:22`; el despliegue queda pendiente.

### [15:43] Configuracion Raspberry Pi y flota
- **Que:** Recuperar el acceso por clave, configurar teclado/locale espanoles, zona horaria y NTP, y centralizar el mantenimiento de Raspberry Pi.
- **Como:** Se uso el salto PC -> VPS -> tunel inverso -> Pi; se aplico `raspi-config` para teclado, `localectl` para locale/X11 y `timedatectl` para hora.
- **Resultado:** OK
- **Decisiones:** Ethernet queda como ruta preferida, Wi-Fi como respaldo; se crea `raspberry_info.sh` como comando unico de diagnostico sin secretos.
- **Gotchas/Lecciones:** El servicio correcto es `autossh-tunel.service`; la Pi tiene Raspbian 13 y dos IPs activas (`192.168.50.187` y `192.168.50.251`).

### [16:20] Inicio de control directo Tapo
- **Que:** Preparar el primer dispositivo Telegram -> Raspberry -> Tapo sin Alexa.
- **Como:** Se instalo `python-kasa`, se descubrio el enchufe `termo` por MAC y se encontro en `192.168.50.6`.
- **Resultado:** Implementacion desplegada; pendiente de credenciales Tapo locales.
- **Decisiones:** Comandos permitidos: `/termo on`, `/termo off` y `/termo estado`.
- **Gotchas/Lecciones:** La cuenta Tapo y su contrasena no se guardan en el repositorio; deben introducirse directamente en el `.env` de la Pi.

### [18:25] Control Telegram del ASUS
- **Que:** Integrar consultas y acciones protegidas del router ASUS desde Telegram.
- **Como:** `router_control.py` usa la clave SSH de servicio de la Raspberry y una lista cerrada de comandos.
- **Resultado:** OK; estado, clientes y Wi-Fi verificados desde la Pi.
- **Decisiones:** El reinicio exige `/router reiniciar confirmar`; no se habilitan comandos arbitrarios.
- **Gotchas/Lecciones:** El ASUS esta detras del router Digi; el acceso se hace siempre por Raspberry/VPS y no se expone SSH a Internet.