art4hotel-hub/INSTALACION.md

Instalación y Despliegue — Art4Hotel Hub

Sin Docker, sin pip, sin CI/CD. Solo Python 3 y systemd.

---

Requisitos

• Python 3.8+ (stdlib únicamente — http.server, sqlite3, hashlib, hmac)
• Linux con systemd (para correr como servicio). En Windows/Mac corre igual con python3 server.py.

---

1. Desarrollo local

git clone https://git.consultoria-as.com/consultoria-as/art4hotel-hub.git
cd art4hotel-hub
python3 server.py
# → http://localhost:4401

Primera vez: la app pide crear la cuenta admin (pantalla de setup). Genera art4hotel.db y secret.key automáticamente.

---

2. Despliegue en servidor

a) Copiar archivos

scp server.py index.html backup.py usuario@servidor:/ruta/art4hotel-hub/

No copiar secret.key ni art4hotel.db desde tu máquina local — el servidor genera los suyos en el primer arranque (o migra los existentes en producción). Los datos del negocio viven solo en el servidor.

b) Servicio systemd

/etc/systemd/system/art4hotel-hub.service:

[Unit]
Description=Art4Hotel Hub
After=network.target

[Service]
Type=simple
User=claude
WorkingDirectory=/ruta/art4hotel-hub
ExecStart=/usr/bin/python3 server.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now art4hotel-hub
sudo systemctl status art4hotel-hub

c) Redespliegue (actualizar código)

scp server.py index.html usuario@servidor:/ruta/art4hotel-hub/
ssh usuario@servidor 'sudo systemctl restart art4hotel-hub'

Las migraciones de esquema corren solas al reiniciar (idempotentes).

---

3. Acceso remoto (Tailscale)

El Hub vive en una red privada Tailscale (MagicDNS iclaude):

• Privado (equipos en la tailnet): http://iclaude:4401/
• Público (si se requiere exponer): Tailscale Funnel en un puerto dedicado (443/8443/10000).

tailscale funnel --bg 4401     # expone el Hub públicamente
tailscale funnel status        # ver qué está expuesto

Nota de seguridad: el Hub ya tiene login propio, pero exponerlo públicamente amplía la superficie de ataque. Mantener el login activo y contraseñas fuertes.

---

4. Respaldos

backup.py por cron diario:

0 3 * * *  cd /ruta/art4hotel-hub && /usr/bin/python3 backup.py

Hace: online backup de la DB (seguro con WAL) + uploads.tar.gz. Retiene 30 días en backups/. También disponible bajo demanda desde la UI (POST /api/backup-now).

---

5. Reloj del servidor (importante)

El servidor de producción tiene CMOS muerto y NTP bloqueado; un reloj desfasado rompe los logins basados en token (Filebrowser/Immich) y firma de sesiones. Mitigación: cron sync_clock.sh que toma el header Date de 1.1.1.1 y ajusta la hora. Verificar date tras reinicios.

---

6. Solución de problemas

Síntoma	Causa probable	Solución
"Sesión inválida" constante	reloj del servidor desfasado	corregir hora; revisar sync_clock.sh
secret.key regenerado → todos deslogueados	se borró/cambió la clave	restaurar secret.key; es la clave de firma
Imágenes equivocadas como ejemplo	prefijos de archivo	ver lógica first_image en /api/file-counts
No resuelve nombres públicos	DNS de Tailscale sin upstream	tailscale set --accept-dns=false

---

Stack deliberadamente mínimo: todo el sistema cabe en una USB y corre con un solo python3 server.py.