mifibra-sync · Portal de Operaciones Mi Fibra

Robot que descarga el reporte "Cronograma de Trabajo (Órdenes de Servicio)" de ScordSoft, lo limpia, calcula los tableros y guarda en Supabase solo lo que cambió. El portal (Vercel) lee esos tableros ya listos.

GitHub Actions (8:00 a 0:00, cada 20 min)
  → robot entra a ScordSoft → 1 Excel (todas las filiales, por Registro, mes anterior + mes en curso)
  → limpieza y tableros en memoria
  → Supabase (solo órdenes nuevas o cambiadas + tableros que cambiaron)
                                   ↓
            Portal Mi Fibra (Vercel) ← /api/instalaciones, /api/averias, /api/indicadores, /api/ordenes

Todo funciona en planes gratuitos: GitHub Actions (repositorio público = minutos ilimitados), Supabase Free y Vercel.

Horario

Hora de Lima	Qué hace
8:00, 8:20, 8:40 … 23:40 y 0:00	Descarga el reporte del periodo y actualiza el portal (49 veces al día)

Turnos de hasta ~5 h 30 min encadenados: al terminar, cada turno lanza el siguiente, que arranca apenas el anterior termina. Fuera de horario el turno espera dormido, así el de las 8:00 ya está despierto. El cron de GitHub (que se atrasa o se salta corridas) queda solo de respaldo.

Tipo de actualización	Qué pide a ScordSoft	Cuándo
Completa	Mes anterior + mes en curso (~14 min)	La primera de cada turno y luego una por hora
Rápida	Solo el mes en curso (~la mitad)	Las demás marcas; se junta con la última completa

Qué descarga

Un solo reporte por corrida, igual que a mano: Filial SELECCIONE (todas) · Registro · del 1 del mes anterior al último día del mes en curso (p. ej. 01/09/2026 – 31/10/2026). Si ScordSoft devolviera una sola filial, el robot pide las demás en la misma sesión.

Las órdenes que ya no están en el reporte (por ejemplo, las del mes que sale del periodo al empezar un mes nuevo) se borran de la base: Supabase siempre contiene solo el periodo.

Por qué así (plan gratuito de Supabase)

El plan gratuito tiene muy poco disco por segundo. Si cada corrida reescribe o relee las ~400 mil órdenes del periodo, se agota el presupuesto de E/S y el portal deja de responder ("Supabase 504 / statement timeout"). Por eso:

• El robot guarda la huella de cada orden en la caché de GitHub Actions (.estado/) y solo escribe lo que cambió.
• Los tableros de Instalaciones, Averías e indicadores de la portada se calculan en memoria con el Excel recién descargado (no se relee la base) y se guardan solo si cambiaron.
• El portal lee filas ya calculadas de la tabla tableros; no hay cálculos pesados en cada visita.

Carpetas

Archivo	Qué hace
sync/descargar.py	Robot (Playwright): login, filtros del reporte, Procesar y descarga del Excel.
sync/procesar.py	Lee el Excel y conserva solo columnas operativas (sin nombres, documentos, direcciones ni teléfonos).
sync/main.py	Orquesta una corrida y calcula todos los tableros.
sync/resumen.py	Indicadores de la portada y del Dashboard.
sync/averias.py, sync/instalaciones.py	Tableros de Averías y TC, e Instalaciones.
sync/cajas.py	Cajas de planta cercanas a cada alta (mapas de Google My Maps).
sync/subir.py	Escribe en Supabase solo lo que cambió y borra lo que salió del periodo.
api/	Funciones de Vercel que leen Supabase.
public/	Páginas del portal.
db/	SQL de la base.
.github/workflows/sincronizar.yml	Horario del robot.

Configuración

GitHub → Settings → Secrets and variables → Actions

Tipo	Nombre	Valor
Secret	SCORDSOFT_USUARIO, SCORDSOFT_CLAVE	usuario de servicio de ScordSoft
Secret	SCORDSOFT_TOTP_SECRETO	solo si usa app autenticadora
Secret	SUPABASE_URL, SUPABASE_SERVICE_KEY	Project URL y service_role key de Supabase

Los IDs de los mapas de cajas no van en el código (el repo es público): están en Supabase, tabla ajustes, clave robot:cajas_mapas ({"mapas": ["id1", "id2", …]}). Opcionalmente, la variable CAJAS_MAPAS tiene prioridad.

Vercel → Settings → Environment Variables: SUPABASE_URL, SUPABASE_SERVICE_KEY, PORTAL_TOKEN (clave del portal) y MASTER_TOKEN (clave master para editar agendas).

Ejecutar a mano

Actions → Sincronizar ScordSoft → Run workflow:

• una: una actualización ahora.
• turno: actualiza cada 20 min durante ~5 h 30 min.
• reescribir: reescribe todas las órdenes (solo si se cambió la limpieza en procesar.py; mejor de noche).

Probar sin robot

pip install -r requirements.txt
python -m sync.main --excel reporte.xlsx --sin-subir   # solo procesa y calcula
python -m sync.main --excel reporte.xlsx               # procesa y guarda en Supabase

Si ScordSoft cambia

• Cambia la pantalla del reporte → ajusta los selectores al inicio de sync/descargar.py.
• Cambian las columnas del Excel → el robot falla con "El reporte ya no trae estas columnas"; ajusta COLUMNAS en sync/procesar.py.