diff --git a/README.md b/README.md index 02030b2..d9b06da 100644 --- a/README.md +++ b/README.md @@ -9,19 +9,10 @@ | Campo | Detalle | |---|---| | **Proyecto** | Cruces de Seguridad Social | -| **Área** | Administración / Recursos Humanos / IT | -| **Estado** | En producción / mantenimiento evolutivo | +| **Área** | Administración | | **Developer Principal** | Isaac Aracena | | **IT Manager** | Luis Matos | -| **Organización** | GomezLee Marketing | -| **Tecnología principal** | n8n | -| **Repositorio** | `cruces-seguridad-social` | | **Países implementados** | Guatemala, Honduras, República Dominicana, Costa Rica y El Salvador | -| **Fecha de inicio** | 2026 | -| **Fecha de cierre estimada** | Proyecto evolutivo | -| **Ciclo Shape Up** | No documentado | -| **Board de ejecución** | No documentado | -| **PRD del proyecto** | No documentado | --- @@ -121,7 +112,6 @@ Los workflows automatizan, según el país: | Archivos | Google Drive API | Almacenamiento y permisos | | Notificaciones | Gmail OAuth | Envío de correos | | Auditoría | Supabase / REST API | Registro de ejecuciones, archivos y hallazgos | -| Infraestructura | Servidor GLM / DigitalCompass | Hosting de n8n y formularios | ### Integraciones externas @@ -455,159 +445,4 @@ Proceso recomendado: --- -## CHANGELOG - -### 2026-08 — Consolidación del repositorio - -- Centralización de los workflows de Seguridad Social. -- Guatemala incorporado. -- Honduras incorporado. -- República Dominicana incorporado. -- Costa Rica incorporado. -- El Salvador incorporado. -- Integración BambooHR. -- Formularios mensuales. -- Reportes automatizados. -- Correos HTML GLM. -- Compartición automática. -- Auditoría Supabase en los workflows aplicables. - -### Costa Rica - -- Lectura robusta de los PDF oficiales de CCSS. -- Validación de período. -- Cruce de identidad y montos. -- Conciliación de totales. -- Matching robusto BambooHR. -- Nómina sin BambooHR. -- Formato optimizado del reporte. - -### El Salvador - -- Soporte para nóminas históricas con nombres de hoja variables. -- Preservación del binario entre intentos de lectura. -- Cruce DUI y montos. -- Matching BambooHR. -- Google Drive, permisos y correo final. -- Manejo de errores. -- Botón para realizar otro cruce. - -### Honduras - -- Lectura de múltiples planillas IHSS PDF. -- Procesamiento dinámico de hojas de nómina. -- Lectura de IHSS-RAP. -- Manejo de personal especial. -- Cruce de identidad y montos IHSS. -- BambooHR. -- Nómina sin BambooHR. -- Auditoría. - -### República Dominicana - -- Lectura del formato real de TSS. -- Cruce Nómina vs. TSS. -- Información BambooHR en diferencias. -- Nómina sin BambooHR. -- Formulario reutilizable mensualmente. - ---- - -## DECISIONS LOG - -### DEC-001 — Repositorio centralizado por dominio - -- **Fecha:** 2026 -- **Contexto:** los cruces de Seguridad Social utilizan una misma finalidad de negocio, pero existen múltiples implementaciones por país. -- **Opciones consideradas:** un repositorio por país vs. un repositorio centralizado. -- **Decisión:** mantener todos los workflows dentro del repositorio `cruces-seguridad-social`. -- **Razón:** facilita versionado, mantenimiento, documentación y expansión a nuevos países. - -### DEC-002 — Workflow independiente por país - -- **Fecha:** 2026 -- **Contexto:** cada institución utiliza documentos y estructuras distintas. -- **Opciones consideradas:** un único workflow universal vs. un workflow especializado por país. -- **Decisión:** mantener un JSON independiente por país. -- **Razón:** reduce el riesgo de que cambios realizados para una institución afecten las demás. - -### DEC-003 — Procesar documentos originales - -- **Fecha:** 2026 -- **Contexto:** algunos documentos anteriormente necesitaban preparación manual antes de ser procesados. -- **Opciones consideradas:** seguir modificando documentos manualmente vs. adaptar los workflows. -- **Decisión:** los workflows deben leer directamente los archivos en el formato real en que serán utilizados cada mes. -- **Razón:** Administración debe poder ejecutar el formulario sin depender de IT para modificar previamente los documentos. - -### DEC-004 — BambooHR como fuente complementaria - -- **Fecha:** 2026 -- **Contexto:** algunos hallazgos necesitan información adicional del empleado. -- **Opciones consideradas:** revisión manual en BambooHR vs. consulta automática. -- **Decisión:** utilizar BambooHR para complementar los cruces. -- **Razón:** permite conocer si un empleado existe, su estado, fecha de ingreso y nombre oficial. - -### DEC-005 — Matching conservador de identidad - -- **Fecha:** 2026 -- **Contexto:** los nombres pueden presentar errores ortográficos o variaciones entre fuentes. -- **Opciones consideradas:** matching estricto vs. matching aproximado sin control vs. matching aproximado conservador. -- **Decisión:** permitir variaciones razonables, pero no aceptar coincidencias ambiguas automáticamente. -- **Razón:** es preferible enviar un caso a revisión que asociar incorrectamente dos empleados distintos. - ---- - -## CONTACTOS DEL PROYECTO - -| Rol | Nombre | Contacto | -|---|---|---| -| IT Manager | Luis Matos | Interno GLM | -| Developer Principal | Isaac Aracena | `iaracena@gomezleemarketing.com` | -| Área usuaria | Administración / Recursos Humanos | Interno GLM | - ---- - -## DEFINITION OF DONE - -Un workflow de Seguridad Social se considera listo cuando: - -- [x] El formulario funciona. -- [x] Los documentos originales pueden cargarse sin preparación manual. -- [x] El cruce de identidad funciona. -- [x] El cruce de montos funciona. -- [x] Se analizan ambas direcciones del cruce. -- [x] BambooHR está integrado cuando corresponde. -- [x] Nómina sin BambooHR está disponible cuando aplica. -- [x] El reporte tiene formato legible. -- [x] Los usuarios autorizados reciben acceso. -- [x] El correo de resultado funciona. -- [x] Existe manejo de errores. -- [x] Se puede regresar al formulario. -- [x] El workflow fue probado con archivos reales. -- [x] El JSON estable está almacenado en Gitea. -- [x] El README está actualizado. - ---- - -## SEGURIDAD - -Este repositorio no debe contener secretos. - -Nunca incluir: - -```text -Passwords -API Keys -OAuth Client Secrets -Service Account Keys -Access Tokens -Refresh Tokens -Credenciales BambooHR -Credenciales Supabase -``` - -Todas las credenciales deben permanecer dentro del Credential Manager de n8n o de la infraestructura segura definida por GLM IT. - ---- - > Documento mantenido por el equipo **GLM IT**.