05-sep: [infra] configurar Raspberry Pi y documentar flota

documentacion/bitacora-dashboard-telegram-2026-09-05.md

@@ -0,0 +1,35 @@
+# 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`).