primer commit

docs/MODULES.md

@@ -0,0 +1,30 @@
+# Módulos
+
+| Archivo | Función |
+|---|---|
+| `main.py` | Daemon orquestador. Bucle infinito con horarios configurables, obtiene token, consulta HANA, procesa pendientes (nuevos + reintentos). |
+| `get_token_headless.py` | Login headless via Chrome real (`channel="chrome"`). Sin ventana visible. |
+| `get_token.py` | Login SOL via Playwright (headless=False). Navega menú → extrae JWT de `sessionStorage['SUNAT.token']`. |
+| `consulta_cpe.py` | Consulta API REST `api-cpe.sunat.gob.pe`. Retorna `(data, status_code)`. Lanza `TokenExpiredError` en 401. |
+| `hana_manager.py` | Conexión HANA vía `hdbcli`. Consulta pendientes en `OPCH`, actualiza flags de descarga. |
+| `gestor_fallas.py` | SQLite `fallas_descarga.db`. Registro de fallas con conteo de intentos y backoff progresivo (0min → 5min → 15min → ... → 12h, máx 20). |
+| `smb_manager.py` | Monta recurso SMB (`mount_smbfs`/`mount.cifs`/`net use`) y sincroniza PDF/XML al NAS. Limpia JSON/ZIP temporales. |
+| `login_api.py` | Intento de `password_grant()` / `authorization_code` directo a SUNAT (sin navegador, generalmente ya no funciona). Se mantiene como referencia. |
+| `logger_utilities.py` | Redirige stdout/stderr a `logs/YYYY-MM-DD.log` + terminal. Rotación diaria. |
+| `reporte_fallas.py` | Genera resumen textual + 3 gráficos PNG desde `fallas_descarga.db`. |
+| `token.json` | Token JWT auto-generado con expiración. |
+| `.env` | Credenciales HANA y SUNAT. |
+
+## Flujo
+
+1. `main.py` verifica día/horario → renueva token si expiró (get_token_headless → get_token.py headless=False)
+2. `obtener_pendientes()` trae todos los documentos de OPCH donde `tienePDF='N'` o `tieneXML='N'`
+3. Separa en **nuevos** (no están en fallas DB) y **reintentos** (fallas pendientes con backoff cumplido)
+4. Por cada doc:
+   - `consultar_cpe()` → si 401, renueva token y reintenta
+   - Si falla (500/404/etc) → `registrar_falla()` con backoff progresivo
+   - Si OK → `descargar_archivo()` (XML + PDF + CDR)
+   - `marcar_pdf_descargado()` / `marcar_xml_descargado()` actualizan HANA
+   - Si era reintento exitoso → `eliminar_falla()`
+5. `sincronizar_a_smb()` monta NAS (si no está montado), copia PDF/XML via rsync (Mac/Linux) o shutil.move (Windows), y elimina JSON/ZIP temporales de `descargas/`
+6. Espera intervalo configurado (5 min modo rápido, 1 h modo full) y repite