# Ficha de Relato de Proyecto — Dashboard Talento Humano *Completada siguiendo el esquema de `ficha-relato-proyecto-innovacion.md`* --- ### 1. IDENTIDAD - **Nombre del proyecto:** Dashboard Talento Humano - **Nombre en lenguaje de negocio:** Tablero de control de personal y nómina del grupo - **Estado:** Producción - **Fecha de inicio / puesta en operación:** 25 de marzo de 2026. Fecha exacta de primera puesta en producción: `NO DOCUMENTADO` - **Propiedades o áreas cubiertas:** Todas las propiedades del grupo Faranda con nómina activa (27 razones sociales registradas en el sistema, incluyendo GHS, Casa Canabal, FC Bogotá, FC Cartagena, FC Cúcuta, FC Barranquilla, FC Medellín, FC Cali, Belvedere, Casa Don Luis, Hotel Caribe, Aloft Bogotá, Servihoteles, entre otras) — área funcional: Talento Humano - **Responsable técnico / Responsable funcional:** Responsable técnico — desarrollo y mantenimiento a cargo de una sola persona (BI). Responsable funcional del lado de Talento Humano: `NO DOCUMENTADO` --- ### 2. SITUACIÓN DE PARTIDA - **¿Qué necesidad existía?** No había una vista única de personal y nómina: cada propiedad opera bajo su propio NIT/razón social ante el proveedor externo de nómina, y el histórico previo vivía en archivos Excel separados por tema (empleados, nómina, ingresos y retiros). - **¿Cómo se resolvía antes?** Consulta directa a la API del proveedor de nómina hotel por hotel, y consolidación manual en Excel para análisis históricos o comparativos entre propiedades. - **¿Qué esfuerzo consumía ese proceso?** `NO DOCUMENTADO` — no existe una medición formal de horas u horas-persona del proceso anterior. --- ### 3. QUÉ SE CONSTRUYÓ - **Descripción funcional:** Tablero web único que consolida activos, ingresos y retiros, salarios, nómina detallada, ausencias/incapacidades y estadísticas por hotel, cruzando datos en vivo del proveedor externo con una base histórica propia en PostgreSQL. - **Componentes entregados:** - Tablero con 7 vistas: Análisis, Empleados, Salarios CECO, Ingresos y Retiros, Ausencias e Incapacidades, Payroll, Estadísticas Hoteles. - Panel de "hoja de vida" por empleado: historial por empresa, evolución salarial y desglose completo de nómina histórica mes a mes. - Script de cierre mensual automatizado que alimenta la base histórica sin intervención manual. - Backup automático diario de la base de datos (implementado 2026-08-27, no existía antes). - **Sistemas con los que se conecta:** API externa del proveedor de nómina, API externa de P&G (indicadores financieros por hotel), base de datos PostgreSQL propia. - **Naturaleza del acceso:** Solo lectura para el usuario final del tablero. El servidor sí expone un set separado de operaciones de escritura administrativa (sincronizar catálogos de hoteles/cargos/centros de costo desde Excel) — protegidas con una clave de acceso dedicada `[SENSIBLE]`, distinta de las credenciales de lectura. --- ### 4. APORTE A LA CALIDAD DE LA INFORMACIÓN - **¿Qué información antes no existía y hoy está disponible?** La antigüedad real de una persona dentro del grupo (sumando tiempo entre cambios de cargo o de contrato en la misma empresa, sin reiniciarse artificialmente), y el desglose completo de nómina histórica por concepto (sueldo, auxilios, deducciones) para cualquier mes desde enero de 2024 — antes solo se podía obtener consultando la API en vivo mes por mes, y solo para el período actual. - **¿Qué información antes estaba dispersa y hoy está unificada y gobernada?** Los catálogos de hoteles, cargos y centros de costo, antes con nombres inconsistentes entre el proveedor de nómina y los registros internos, hoy viven en tablas de unificación versionadas. - **¿Dónde vive esa información hoy?** Una base PostgreSQL propia es la fuente de verdad para todo período cerrado; el mes en curso se consulta en vivo contra el proveedor externo. - **¿Es auditable?** Parcialmente. Existe backup diario automático desde el 27 de agosto de 2026 (antes no existía ninguno). No existe todavía una tabla de auditoría formal de cambios manuales fila por fila. Durante una revisión reciente se detectó y corrigió un problema de integridad heredado de la fuente original (298 personas con identificador de empleado sin resolver en un rango de 21 meses); quedó documentado y corregido en un 65% de los casos, el resto es irrecuperable por falta de dato en origen. - **¿Qué decisión de negocio se puede tomar hoy que antes no era posible?** Revisar el recibo de nómina histórico completo de cualquier persona sin depender de una consulta puntual al proveedor externo, y comparar la evolución salarial completa de dos personas lado a lado. --- ### 5. LENTE DIRECCIÓN Y FINANZAS — TRANQUILIDAD INTERNA - **Exposición que este proyecto reduce o cierra:** Reduce la dependencia de consolidar manualmente datos de personal dispersos entre propiedades. - **Control o evidencia que hoy existe y antes no:** Backup automático diario con 30 días de retención. Registro en logs cuando falla una consulta puntual de nómina a un hotel (antes esos fallos quedaban en cero sin ningún rastro). - **Esfuerzo liberado o costo evitado:** `NO DOCUMENTADO` — sin base de cálculo instrumentada. - **Si este proyecto se detuviera mañana:** Dirección y Talento Humano perderían la única vista consolidada de personal y nómina de todas las propiedades, y volverían a depender de consultas manuales propiedad por propiedad. --- ### 6. LENTE MARCA — RESPALDO EXTERNO - **¿Qué mejora percibe el huésped, el cliente o el socio comercial?** Impacto indirecto — es una herramienta interna de gestión, sin interacción directa con el huésped. - **¿Este proyecto acerca a Faranda a un estándar internacional del sector?** Acerca a la cadena a tener información de personal centralizada y con historial trazable por propiedad, una práctica habitual en operadores hoteleros internacionales — sin que exista hoy una certificación o benchmark externo verificado que lo confirme. - **¿Es narrable públicamente sin exponer información sensible?** Parcial — el sistema en sí (no sus datos) puede mencionarse; los datos que administra (cédulas, salarios, fechas de nacimiento del personal) son sensibles y no deben describirse con detalle en ningún relato externo. - **Frase de vitrina:** "Faranda centraliza y hace trazable la información de personal de todas sus propiedades en un sistema propio." --- ### 7. MÉTRICAS `NO DOCUMENTADO` — no hay métricas de uso o desempeño instrumentadas todavía. **¿Qué métrica debería existir y qué haría falta para instrumentarla?** - Uso del tablero (usuarios activos, frecuencia de consulta) — requeriría agregar analítica básica de acceso. - Cobertura de datos por mes/hotel (% de meses con nómina completa cargada) — se podría calcular directo desde las tablas existentes. - % de conceptos de nómina clasificados vs. sin clasificar — el sistema ya detecta conceptos nuevos sin clasificar (implementado 2026-08-27); falta exponer esa cifra como métrica histórica. --- ### 8. DEPENDENCIAS Y PUNTOS DE ATENCIÓN - **Roles críticos de los que depende:** Un único responsable técnico concentra desarrollo y mantenimiento (sin respaldo documentado). - **Accesos o credenciales de los que depende:** Credenciales de la API externa de nómina, de la API externa de P&G, de la base de datos y del canal administrativo del sistema — todas `[SENSIBLE]`, viven en un archivo de configuración local no versionado. - **Punto único de falla técnico:** El equipo que sirve el tablero en producción no tiene redundancia (un solo servidor, reinicio automático si se cae, pero sin failover a otro equipo). El cierre mensual corre en un equipo dedicado distinto, también sin redundancia. - **Pendientes técnicos o funcionales que la dirección debería conocer:** 1. El histórico de personal antes de 2022 no está cargado (hueco de datos permanente salvo que aparezca una fuente adicional). 2. Un proveedor de nómina específico tiene una falla de acceso persistente de su lado, sin solución posible desde este sistema. --- ### 9. HORIZONTE Y ENCAJE - **Próximos 2 hitos concretos y su fecha objetivo:** 1. Certificar que el cierre de nómina de septiembre de 2026 corrió correctamente desde el equipo dedicado — objetivo: primeros días de septiembre de 2026. 2. `NO DOCUMENTADO` - **¿Con qué otros proyectos del área se conecta o debería conectarse?** Se entrelaza con el proyecto Inntime. También comparte el equipo dedicado de cierres mensuales con otras cargas de trabajo de Faranda no relacionadas funcionalmente con este proyecto. - **¿Es replicable a otras propiedades?** Ya cubre hoy todas las propiedades del grupo Faranda. Para un grupo hotelero externo: Con adaptación — dependería de que use el mismo proveedor de nómina o de construir un conector nuevo. - **¿Qué habilita este proyecto para que otros puedan existir?** Una base histórica de personal y nómina gobernada, consultable sin depender de la API en vivo — base sobre la que ya se construyó, en esta misma iteración, el desglose completo de nómina histórica por persona. --- ### 10. LA FRASE Un solo sistema centraliza, audita y hace trazable la información de personal y nómina de todos los hoteles del grupo.