Entregable 1 - lhiguitab/Vision_Gerencial_360 GitHub Wiki
Sección 1: Generalidades del Proyecto
Descripción del Problema:
Visión Gerencial, empresa especializada en recuperación de cartera, enfrenta dificultades en la evaluación del desempeño de sus negociadores. Actualmente, este proceso se realiza a través de formularios manuales y subjetivos en Microsoft Forms, lo que genera varios problemas:
-
No hay trazabilidad de las evaluaciones anteriores.
-
Los resultados son subjetivos y no integran indicadores reales del negocio.
-
No se generan retroalimentaciones automáticas ni documentos de compromiso o reconocimiento.
Esto limita la capacidad de los líderes para tomar decisiones basadas en datos, dificulta el seguimiento del desempeño de los negociadores y afecta el control de la operación por parte de la parte administrativa.
Solución Planteada:
Se propone desarrollar una aplicación web 360 de evaluación de desempeño, que automatice el proceso, integre datos operacionales reales desde Databricks, permita evaluar indicadores objetivos y subjetivos, y genere retroalimentación automática basada en IA.
Esta aplicación contará con:
-
Autenticación con OAuth2.
-
Dashboards de indicadores por tipo de usuario.
-
Evaluaciones con trazabilidad histórica.
-
Integración de datos en tiempo real desde Databricks.
-
Generación automática de recomendaciones mediante OpenAI.
Personas y Roles del Proyecto:
| Nombre Completo | Correo Institucional | Rol |
|---|---|---|
| Luis Cano | [email protected] | Product Owner |
| Daniel Arcila | [email protected] | Scrum Master |
| Lucas Higuita | [email protected] | Dev Team |
| Andrés Gárnica | [email protected] | Dev Team |
| Jose Alejandro Jimenéz | [email protected] | Dev Team |
Público Objetivo y Contexto:
Tipos de usuarios:
Líderes de negociadores
Encargados de supervisar entre 15 y 30 negociadores. Deben acceder al sistema para consultar indicadores individuales, realizar evaluaciones y generar retroalimentaciones automáticas a los miembros de su equipo.
Área administrativa
Accede a dashboards globales que muestran indicadores agregados de desempeño por líder, negociador, y por semestre. Usan esta información para tomar decisiones estratégicas y de mejora continua.
Tecnología requerida:
- Navegador web moderno (Chrome, Edge, Firefox).
- Acceso a Internet.
- Dispositivo con pantalla suficiente para visualizar dashboards (PC o portátil).
Diagrama de Flujo:
Glosario de Términos:
| Término | Definición |
|---|---|
| Evaluación del ser | Evaluación subjetiva basada en preguntas de percepción del desempeño humano. |
| Evaluación 360 | Evaluación integral que combina indicadores cuantitativos y cualitativos. |
| KPI | Key Performance Indicator. Indicador clave de rendimiento. |
| Recaudo | Monto total recuperado por un negociador en un periodo. |
| Conversión | Porcentaje de gestiones exitosas frente al total de contactos. |
| Databricks | Plataforma de análisis de datos utilizada para orquestar los KPIs. |
| OpenAI | Herramienta de inteligencia artificial utilizada para generar sugerencias. |
| OAuth2 | Protocolo de autenticación segura para gestionar el acceso a la aplicación. |
Sección 2: Determinación de Necesidades
Requisitos Funcionales:
Técnicas de Elicitación de Requerimientos
Para la identificación de los requisitos funcionales del sistema, se aplicaron las siguientes técnicas:
| Técnica | Descripción | Fecha | Participantes | Evidencia |
|---|---|---|---|---|
| Reuniones Informativas | Se realizó una reunión con el cliente para asentar las bases del proyecto, conversación y lluvia de ideas realizada en conjunto con Wilson y Luis para entender el proceso actual de evaluación. | 04/08/2025 | Luis Cano y Wilson Arcila. | Foto de la reunión y notas adjuntas. |
| Estudio de Cuestionario | Se estructuró bien el problema a solucionar y los objetivos para identificar puntos críticos en el sistema actual. | 05/08/2025 | Luis Cano y Daniel Arcila. | Resultados en presentación estructurada. |
| Retroalimentación de Propuesta | Sesión de solución de dudas y finalizar el planteamiento de la solución entre el equipo técnico, Luis Cano y el acompañamiento de la empresa. | 05/08/2025 | Jose Jiménez, Daniel Arcila, Lucas Higuita, Andrés Garnica y Luis Cano. | Mural colaborativo y acta de reunión. |
Requisitos Funcionales Identificados
| ID | Requisito | Descripción |
|---|---|---|
| RF01 | Autenticación OAuth2 | Acceso seguro mediante autenticación federada. |
| RF02 | Dashboard por tipo de usuario | Dashboards diferenciados para líderes y administrativos. |
| RF03 | Registro y trazabilidad de evaluaciones | Cada evaluación debe almacenarse con historial y versiones. |
| RF04 | Integración con Databricks | Obtener datos en tiempo real para análisis objetivos. |
| RF05 | Evaluaciones automáticas con IA | Generar retroalimentaciones, compromisos o felicitaciones usando inteligencia artificial. |
| RF06 | Visualización de indicadores | Ver promedios, KPIs individuales y grupales. |
| RF07 | Acceso a histórico por negociador | Consultar todas las evaluaciones anteriores de cada negociador. |
| RF08 | Gestión de pendientes | Mostrar alertas o notificaciones para evaluaciones no realizadas. |
| RF09 | Exportación de resultados | Permitir descarga de informes individuales o grupales en PDF/Excel. |
| RF10 | Notificaciones automáticas | Enviar alertas a líderes cuando haya nuevas evaluaciones que diligenciar. |
| RF11 | Evaluación del ser | Formulario estructurado con preguntas de 1 a 5 con evaluación objetiva. |
| RF12 | Promedio automático | Calcular automáticamente porcentaje final de desempeño. |
| RF13 | Sugerencias automáticas IA | IA genera documento con compromisos o felicitaciones según resultados. |
| RF14 | Acceso limitado por rol | Los líderes solo pueden ver datos de sus negociadores asignados. |
Antecedentes:
1. Lattice
- URL: https://lattice.com/
- Captura de Pantalla:
- Descripción: Lattice es una plataforma avanzada de gestión de desempeño que permite realizar evaluaciones 360, establecer objetivos (OKRs) y generar retroalimentación continua.
- Diferenciador: Lattice está más orientada a grandes corporativos con estructuras de OKRs. A diferencia del proyecto propuesto, no está especializada en empresas de cobranza ni tiene integración con Databricks ni personalización para líderes operativos de campo.
2. CultureAmp
- URL: https://www.cultureamp.com/
- Captura de Pantalla:
- Descripción: CultureAmp permite medir desempeño, cultura organizacional y compromiso. Tiene encuestas de 360 grados con dashboards avanzados.
- Diferenciador: Muy centrado en temas de clima organizacional y cultura empresarial. La solución para Visión Gerencial es más operativa, centrada en KPIs de recuperación de cartera y control individual por líder.
3. 15Five
- URL: https://www.15five.com/
- Captura de Pantalla:
- Descripción: Plataforma para retroalimentación continua, seguimiento de desempeño y desarrollo del talento. Enfatiza las "conversaciones de mejora continua".
- Diferenciador: Centrada en desarrollo humano. La herramienta propuesta para Visión Gerencial tiene un enfoque más cuantitativo y automatizado basado en integración con KPIs financieros.
Sección 3: User Story Mapping y Backlog del Producto
Story Mapping:
Enlace para Mejor Visualización: https://miro.com/welcomeonboard/dTNReG9QajBweUVLQlNZWCtVM2QxNVZ1UDNDTktVKzd0MWY5a01GQnZxWmtySDVEV2FTejNMY0xuVGFvODRxbzNmMEtnOXQ3UG94NDZBUGtvMSszSHpYWEQzdzd5Y2dBbktndzBsOW1pZTE0K04vOGNLV1V1cnZmNzczMEs2WDB3VHhHVHd5UWtSM1BidUtUYmxycDRnPT0hdjE=?share_link_id=861997135247
Backlog:
Enlace del Backlog Estructurado: https://github.com/users/lhiguitab/projects/6
Planeación Sprint 1:
Enlace del Backlog del Sprint 1: https://github.com/users/lhiguitab/projects/6/views/3?filterQuery=-status%3ATodo%2C"SPRINT+2"%2C"SPRINT+3"&groupedBy%5BcolumnId%5D=&visibleFields=%5B"Title"%2C"Assignees"%2C"Status"%2C"Labels"%5D
Descripción de las Historias de Usuario:
| ID | Historia de Usuario | Criterios de Aceptación |
|---|---|---|
| HU01 | Inicio de sesión seguro para líderes | - El sistema debe validar usuario y contraseña contra la base de datos. - Debe permitir iniciar sesión solo con credenciales correctas. - Si las credenciales son inválidas, debe mostrar un mensaje de error claro. |
| HU02 | Visualización de negociadores asignados | - Al iniciar sesión, se listan únicamente los negociadores asignados al líder. - La lista debe mostrar nombre, ID y estado de evaluaciones pendientes. - Si no tiene negociadores asignados, debe mostrar un mensaje informativo. |
| HU03 | Listado de evaluaciones pendientes por negociador | - Cada negociador debe mostrar el número de evaluaciones pendientes. - La lista de pendientes debe actualizarse automáticamente si se completa una evaluación. - Si no hay evaluaciones pendientes, debe indicarlo de manera visible. |
| HU04 | Inicio de evaluación de desempeño para negociador | - Al hacer clic en un negociador, debe aparecer la opción "Iniciar evaluación". - El formulario de evaluación debe cargarse correctamente con sus indicadores. - No debe permitir iniciar la evaluación si ya existe una en progreso no completada. |
| HU05 | Visualización de indicadores históricos y actuales del negociador | - Se deben mostrar indicadores clave: conversión, recaudación, ausentismo, etc. - Debe existir un gráfico de tendencias de desempeño histórico. - La información debe provenir de Databricks en tiempo real. |
| HU06 | Consulta de última evaluación del negociador | - El sistema debe mostrar la última evaluación con fecha y puntaje. - Debe permitir visualizar comentarios o retroalimentación previa. - Si no hay evaluaciones previas, mostrar un mensaje indicando que será la primera. |
| HU07 | Diligenciamiento de evaluación del ser con escala 1-5 | - Cada pregunta debe permitir seleccionar un valor del 1 al 5. - El sistema debe validar que todas las preguntas estén respondidas antes de enviar. - Al guardar, debe confirmarse que la evaluación fue registrada correctamente. |
Sección 4: Diseño de la Arquitectura
Alcance:
El MVP (Producto Mínimo Viable) representa la versión más básica y funcional del sistema de evaluación 360, que permita a los líderes de Visión Gerencial realizar evaluaciones de desempeño con base en datos objetivos, almacenarlas con trazabilidad y consultar indicadores clave de sus negociadores.
El objetivo del MVP es poner en marcha la solución de forma funcional, aunque limitada, enfocándose en cubrir los procesos más críticos para los usuarios principales (líderes de equipo), dejando funcionalidades complementarias o avanzadas para versiones posteriores.
Resumen del Alcance del MVP
El MVP de la aplicación web 360 permitirá:
- Autenticación de usuarios (líderes y administrativos) mediante OAuth2.
- Visualización de dashboards personalizados según el rol del usuario.
- Registro de evaluaciones con trazabilidad histórica por negociador.
- Visualización de indicadores operativos en tiempo real desde Databricks.
- Generación automática de retroalimentación mediante IA (OpenAI).
- Exportación de resultados en PDF y Excel para reportes internos.
Fuera del alcance inicial:
- Aplicación móvil nativa (solo será web responsiva).
- Integración con sistemas externos diferentes a Databricks y OpenAI.
El MVP será suficiente para validar el proceso de evaluación digital, recolectar retroalimentación de los usuarios clave y establecer la base para iteraciones futuras del producto.
Requisitos No Funcionales:
| ID | Requisito | Descripción |
|---|---|---|
| RNF01 | Rendimiento del sistema | El sistema debe responder en menos de 3 segundos en operaciones estándar y menos de 5 segundos en procesos de IA como generación de feedback. |
| RNF02 | Seguridad y protección de datos | Autenticación mediante OAuth2, cifrado de datos en tránsito y en reposo, roles definidos, y registro de actividad (logs de auditoría). |
| RNF03 | Usabilidad | Interfaz intuitiva, con validaciones en tiempo real, navegación clara y diseño responsivo compatible con tabletas y computadores. |
| RNF04 | Accesibilidad | Cumplimiento con los estándares WCAG 2.1 AA: navegación por teclado, contraste adecuado y soporte básico para lectores de pantalla. |
| RNF05 | Disponibilidad | El sistema debe garantizar una disponibilidad mínima del 99.5% mensual, especialmente durante los períodos de evaluación. |
| RNF06 | Escalabilidad | Arquitectura capaz de escalar horizontalmente para soportar un crecimiento de usuarios y evaluaciones sin degradación del rendimiento. |
| RNF07 | Mantenibilidad | Código modular y documentado. API REST documentada con Swagger. Cobertura de pruebas superior al 80%. |
| RNF08 | Integración robusta con Databricks | Debe garantizar consistencia de datos incluso si hay latencia o intermitencia temporal entre fuentes de datos. |
| RNF09 | Exportación y backup | Soporte para exportar datos e informes. Backups automáticos diarios de evaluaciones, logs y configuraciones clave. |
| RNF10 | Soporte de carga y concurrencia | El sistema debe soportar al menos 20 usuarios concurrentes y hasta 15 peticiones por segundo en horas pico sin fallos ni degradaciones. |
Dimensiones del sistema:
- Usuarios concurrentes esperados: 20 (11 líderes + área administrativa).
- Peticiones promedio: ~100 consultas de dashboards y 20 evaluaciones diarias.
- Tiempo de respuesta esperado: < 3 segundos por carga de dashboard.
- Disponibilidad esperada: 99%.
- Seguridad:
- Autenticación OAuth2 con control por roles.
- Encriptación de datos sensibles (AES-256 para histórico de evaluaciones).
- Accesibilidad: Compatible con navegadores modernos y pantallas de escritorio.
- Usabilidad: Interfaz intuitiva, con dashboards claros y botones destacados para evaluaciones.
- Escalabilidad: Posibilidad de soportar 50 usuarios concurrentes si la empresa crece, y mayor flujo de datos. (A corto Plazo)
Diagrama de Clases:
Descripción de los Componentes:
Enumerar y describir los componentes y subsistemas de la arquitectura del proyecto. Especificar las tecnologías que se van a utilizar para implementar dicho componente. Un componente es una parte modular, que desempeña una función específica dentro de un sistema y puede interactuar con otros componentes a través de interfaces.
Diagrama de Componentes:
Tecnologías a Emplear:
| Herramienta / Plataforma | Nombre | Descripción y Justificación |
|---|---|---|
| Framework web | Django | Framework web en Python que permite un desarrollo rápido y estructurado. Incluye ORM, panel administrativo, sistema de autenticación y plantillas HTML. Ideal para construir el MVP sin necesidad de frameworks frontend complejos. |
| Lenguaje de programación | Python 3.x | Lenguaje principal del desarrollo. Utilizado tanto para la lógica del backend como para el manejo de integraciones y posibles procesos con IA en el futuro. |
| Base de datos | SQlite | Sistema de base de datos relacional robusto, escalable y con soporte completo en Django. Ideal para manejar relaciones complejas como usuarios, evaluaciones, roles, etc. |
| ORM | Django ORM | Sistema de mapeo objeto-relacional incorporado en Django, que permite trabajar con la base de datos sin escribir SQL directamente. Facilita la mantenibilidad. |
| Sistema de autenticación | Django Allauth (con OAuth2) | Biblioteca de Django para autenticación que soporta OAuth2. Permite implementar el login seguro requerido con roles diferenciados para líderes y administrativos. |
| Frontend | Django Templates (HTML + Bootstrap básico) | El frontend se desarrollará utilizando el motor de plantillas de Django junto con HTML, CSS y Bootstrap básico. Esto permite mantener la interfaz funcional y responsiva sin necesidad de JavaScript avanzado. |
| Plataforma de integración de datos | Databricks (conexión vía PyODBC o API REST) | Utilizada para consultar en tiempo real los indicadores operativos necesarios para alimentar las evaluaciones. Se establecerá una conexión directa desde Python utilizando PyODBC, pandas o peticiones HTTP según disponibilidad. |
| Entorno de desarrollo | Visual Studio Code / PyCharm | Editores recomendados para el desarrollo en Python. Ofrecen herramientas de depuración, gestión de entornos virtuales y control de versiones. |
| Control de versiones | Git + GitHub / GitLab | Herramientas para gestionar el código fuente, trabajar en equipo y mantener trazabilidad de los cambios. GitHub es ideal para colaboración y seguimiento. |
| Entorno de ejecución local | Docker (opcional) | Aunque no es obligatorio, se puede usar Docker para garantizar entornos reproducibles y facilitar despliegue en pruebas. Si no se usa, se trabajará con entornos virtuales (venv). |
| IA para retroalimentación (no en MVP) | OpenAI API | Se prevé usar la API de OpenAI (por ejemplo, GPT) para generar sugerencias automáticas de retroalimentación en versiones posteriores. |
Sección 5: Diseño de Interfaces
Prototipo:
Prueba de Prototipo:
Al enseñarle el prototipo al gerente de estrategias y al gerente financiero y administrativo nos dan su aprovación con respecto al diseño y el desarrolo del prototipo. Les gustó mucho el prototipo interactivo en el cual se puede evidenciar gran parte de lo que será la funcionalidad de la aplicación. Las sugerencias que nos dieron fue poner el logo real de Vision Gerencial y agregar unos detalles a la vista del administrador.