Actualizar README.md
This commit is contained in:
@@ -9,19 +9,10 @@
|
|||||||
| Campo | Detalle |
|
| Campo | Detalle |
|
||||||
|---|---|
|
|---|---|
|
||||||
| **Proyecto** | Cruces de Seguridad Social |
|
| **Proyecto** | Cruces de Seguridad Social |
|
||||||
| **Área** | Administración / Recursos Humanos / IT |
|
| **Área** | Administración |
|
||||||
| **Estado** | En producción / mantenimiento evolutivo |
|
|
||||||
| **Developer Principal** | Isaac Aracena |
|
| **Developer Principal** | Isaac Aracena |
|
||||||
| **IT Manager** | Luis Matos |
|
| **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 |
|
| **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 |
|
| Archivos | Google Drive API | Almacenamiento y permisos |
|
||||||
| Notificaciones | Gmail OAuth | Envío de correos |
|
| Notificaciones | Gmail OAuth | Envío de correos |
|
||||||
| Auditoría | Supabase / REST API | Registro de ejecuciones, archivos y hallazgos |
|
| Auditoría | Supabase / REST API | Registro de ejecuciones, archivos y hallazgos |
|
||||||
| Infraestructura | Servidor GLM / DigitalCompass | Hosting de n8n y formularios |
|
|
||||||
|
|
||||||
### Integraciones externas
|
### 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**.
|
> Documento mantenido por el equipo **GLM IT**.
|
||||||
|
|||||||
Reference in New Issue
Block a user