Actualizar README.md
This commit is contained in:
@@ -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**.
|
||||
|
||||
Reference in New Issue
Block a user