# 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`).