se agrega integración con SAP HANA, manejo de errores en el demonio y actualización de documentación

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-09-02 07:40:26 -05:00
1 parent fcc80d3c6e
commit e6cde62e72
@@ -0,0 +1,95 @@
+# Inventario del código
+
+## Archivos
+
+| Archivo | Líneas | Rol |
+|---------|--------|-----|
+| `main.py` | 134 | Demonio orquestador (loop de horarios) |
+| `pipeline.py` | 957 | Pipeline core (procesar un correo completo) |
+| `sunat_schema.py` | 521 | Parseo de XML SUNAT (Invoice, DespatchAdvice) |
+| `pdf_utilities.py` | 450 | Parseo de PDFs (factura, guías) |
+| `sapb1_manager.py` | 322 | Comunicación con SAP B1 Service Layer |
+| `outlook_utilities.py` | 228 | Comunicación con Microsoft Graph |
+| `hana_manager.py` | 126 | Comunicación con SAP HANA directa |
+| `database_utilities.py` | 114 | SQLite local (cache de correos) |
+| `consulta_rapida.py` | 115 | Script auxiliar para reprocesar correos por ID |
+| `email_utilities.py` | 93 | Utilitarios de adjuntos (ZIP, filtrado) |
+| `logger_utilities.py` | 72 | Logging a archivo + consola |
+
+---
+
+## Dependencias entre archivos
+
+```
+main.py
+  └── pipeline.py
+        ├── sunat_schema.py
+        ├── pdf_utilities.py
+        ├── sapb1_manager.py
+        │     └── hana_manager.py
+        ├── outlook_utilities.py
+        ├── email_utilities.py
+        │     └── database_utilities.py
+        └── database_utilities.py
+```
+
+---
+
+## Flujo de datos
+
+```
+main()
+  └── run_pipeline()
+        ├── step_authenticate() → token MS Graph
+        ├── step_fetch_emails() → emails[]
+        └── _procesar_un_correo() (por cada email)
+              ├── BD: verificar duplicado
+              ├── _descargar_adjuntos() → archivos
+              ├── _descomprimir() ZIPs
+              ├── _filtrar_y_limpiar() → solo PDF/XML
+              ├── _procesar_pdfs() → pdf_cache
+              │     └── pdf_utilities.extraer_datos_pdf()
+              ├── _procesar_xmls(pdf_cache) → documentos[]
+              │     └── sunat_schema.extraer_datos_xml()
+              ├── _guardar_resultado(documentos)
+              ├── _validate_prices(factura) → (ok, resultados)
+              │     └── sapb1_manager.get_delivery_notes()
+              │           ├── SL (Service Layer) GET /DeliveryNotes
+              │           └── HANA fallback (get_delivery)
+              ├── _build_sap_draft(factura, resultados) → draft
+              ├── _guardar_draft_json(draft)
+              ├── sapb1_manager.create_draft(draft)
+              └── outlook_utilities.send_email(notificación)
+```
+
+---
+
+## Problemas conocidos hasta ahora
+
+| # | Problema | Archivo | Estado |
+|---|----------|---------|--------|
+| 1 | `_extraer_serie_numero_desde_texto` no limpiaba leading zeros | `sunat_schema.py` | ✅ Corregido |
+| 2 | Al asignar guías por línea, si hay +refs que líneas, las sobrantes se perdían | `pipeline.py` | ✅ Corregido |
+| 3 | SL sin fallback a HANA | `sapb1_manager.py` | ✅ Corregido |
+| 4 | Ctrl+C mostraba traceback | `main.py` | ✅ Corregido |
+| 5 | `.env.dev` vs `.env` inconsistente | `sapb1_manager.py` | ✅ Corregido |
+| 6 | `HANA_HOST` vs `HANA_SERVER` en `.env` | `hana_manager.py` | ✅ Corregido |
+| 7 | Columna `Cancelled` vs `CANCELED` en HANA | `hana_manager.py` | ✅ Corregido |
+
+---
+
+## Funciones internas en `_procesar_un_correo` (pipeline.py)
+
+| Función | Líneas | Propósito |
+|---------|--------|-----------|
+| `_descargar_adjuntos` | 107-134 | Descarga adjuntos vía Graph API |
+| `_descomprimir` | 136-149 | Descomprime ZIPs |
+| `_filtrar_y_limpiar` | 151-191 | Filtra PDF/XML, elimina el resto |
+| `_procesar_pdfs` | 193-246 | Extrae datos de PDFs, renombra, genera cache |
+| `_procesar_xmls` | 248-377 | Procesa XMLs, cruza con PDF, asigna guías |
+| `_guardar_resultado` | 379-408 | Guarda JSON con datos extraídos |
+| `_build_sap_draft` | 410-569 | Construye payload del draft SAP B1 |
+| `_validate_prices` | 571-745 | Valida precios contra DeliveryNotes SAP |
+| `_build_validation_html` | 747-775 | Genera tabla HTML para notificación |
+| `_build_notification_body` | 777-814 | Arma cuerpo del email de notificación |
+| `_guardar_draft_json` | 816-842 | Guarda draft JSON para depuración |