192 lines
9.7 KiB
Markdown
192 lines
9.7 KiB
Markdown
# Requerimientos y Historias de Usuario
|
|
|
|
**Sistema de Remuneración Variable, Compensación y Comisiones - Hoteles Estelar**
|
|
|
|
---
|
|
|
|
## Objetivo General
|
|
Implementar una plataforma centralizada para la administración, cálculo, validación y seguimiento de remuneración variable, compensaciones e incentivos comerciales, reemplazando el manejo manual actual realizado en archivos Excel y permitiendo automatizar el proceso de liquidación, aprobación y trazabilidad.
|
|
|
|
---
|
|
|
|
## Alcance Funcional
|
|
El sistema se compone de 7 características principales (Features) divididas en 14 Historias de Usuario (HU).
|
|
|
|
### FEATURE 1 — Administración de Planes de Compensación
|
|
|
|
#### HU-COM-001 — Crear plan de compensación
|
|
* **Como:** Administrador del sistema
|
|
* **Quiero:** Crear planes de compensación y comisiones
|
|
* **Para:** Definir las reglas de remuneración variable.
|
|
* **Descripción:**
|
|
El sistema deberá permitir configurar planes asociados a:
|
|
* Hoteles
|
|
* Regiones
|
|
* Equipos comerciales
|
|
* Cargos
|
|
* Campañas
|
|
* Temporadas
|
|
* Unidades de negocio
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Creación exitosa):** Dado que el administrador ingresa al módulo de compensación, cuando selecciona "Crear plan" y diligencia los campos requeridos, entonces el sistema debe almacenar el plan correctamente.
|
|
* **Escenario 2 (Validación de obligatoriedad):** Dado que existen campos obligatorios, cuando el usuario intenta guardar sin completarlos, entonces el sistema debe mostrar mensajes de validación.
|
|
* **Campos sugeridos:**
|
|
* Nombre del plan, Código, Vigencia, Tipo de compensación, Área, Cargo, Hotel, Región, Tipo de cálculo, Fórmula, Meta, Porcentaje, Topes máximos, Estado.
|
|
* **Operaciones (Sub-features):**
|
|
* Crear plan, Editar plan, Duplicar plan, Versionamiento, Inactivar plan.
|
|
|
|
#### HU-COM-002 — Configurar reglas de cálculo
|
|
* **Como:** Administrador
|
|
* **Quiero:** Parametrizar reglas de negocio
|
|
* **Para:** Automatizar liquidaciones de comisiones e incentivos.
|
|
* **Descripción:**
|
|
El sistema deberá soportar:
|
|
* Cálculos porcentuales
|
|
* Escalas y Rangos
|
|
* Cumplimiento de metas
|
|
* Comisiones fijas y variables
|
|
* Bonos especiales
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Configuración de fórmula):** Dado que existe un plan de compensación, cuando el usuario define las reglas, entonces el sistema debe almacenar la configuración.
|
|
* **Escenario 2 (Validación de topes):** Dado que existe un tope máximo definido, cuando el cálculo supera el límite, entonces el sistema debe aplicar el tope configurado.
|
|
* **Operaciones (Sub-features):**
|
|
* Fórmulas dinámicas, Escalas de comisión, Topes máximos, Reglas condicionales, Bonificaciones especiales.
|
|
|
|
#### HU-COM-003 — Configurar metas comerciales
|
|
* **Como:** Administrador
|
|
* **Quiero:** Configurar metas comerciales
|
|
* **Para:** Medir cumplimiento para cálculo de variables.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Configurar meta):** Dado que existe un colaborador o equipo, cuando el usuario asigna metas, entonces el sistema debe almacenarlas por periodo.
|
|
* **Operaciones (Sub-features):**
|
|
* Metas mensuales, trimestrales, por hotel, por equipo, individuales.
|
|
|
|
---
|
|
|
|
### FEATURE 2 — Carga e Integración de Información
|
|
|
|
#### HU-COM-004 — Importar resultados comerciales desde Excel
|
|
* **Como:** Usuario
|
|
* **Quiero:** Importar resultados comerciales desde Excel
|
|
* **Para:** Evitar procesos manuales.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Importación válida):** Dado que el usuario carga un archivo válido, cuando el sistema procesa la información, entonces debe actualizar resultados automáticamente.
|
|
* **Escenario 2 (Archivo inválido):** Dado que el archivo contiene errores, cuando el sistema procesa el archivo, entonces debe mostrar inconsistencias.
|
|
* **Operaciones (Sub-features):**
|
|
* Importación XLSX/CSV, Validación de columnas, Plantillas de carga.
|
|
|
|
#### HU-COM-005 — Integración automática con sistemas externos
|
|
* **Como:** Administrador
|
|
* **Quiero:** Integrar automáticamente información de ventas
|
|
* **Para:** Automatizar el cálculo de comisiones.
|
|
* **Descripción:**
|
|
El sistema deberá integrarse con:
|
|
* ERP, PMS hotelero, CRM, Sistemas financieros, Plataformas de reservas, Revenue Management.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Integración exitosa):** Dado que existe una integración configurada, cuando el proceso automático se ejecuta, entonces el sistema debe actualizar la información automáticamente.
|
|
* **Escenario 2 (Error de integración):** Dado que existe una falla, cuando el proceso no finaliza correctamente, entonces el sistema debe registrar logs y notificar al administrador.
|
|
* **Operaciones (Sub-features):**
|
|
* Integraciones API, Jobs automáticos, Logs, Reintentos automáticos.
|
|
|
|
---
|
|
|
|
### FEATURE 3 — Liquidación Automática
|
|
|
|
#### HU-COM-006 — Calcular comisiones automáticamente
|
|
* **Como:** Sistema
|
|
* **Quiero:** Calcular automáticamente las comisiones
|
|
* **Para:** Reducir errores manuales.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Cálculo individual):** Dado que existen ventas registradas, cuando el sistema ejecuta la liquidación, entonces debe calcular automáticamente: Comisión individual, Cumplimiento, Bono e Incentivo.
|
|
* **Escenario 2 (Cálculo grupal):** Dado que existen reglas grupales, cuando el sistema procesa el cálculo, entonces debe generar comisión grupal automáticamente.
|
|
* **Operaciones (Sub-features):**
|
|
* Motor de cálculo, Liquidación automática, Cálculos masivos, Simulación de pagos.
|
|
|
|
#### HU-COM-007 — Simular liquidación antes de aprobar
|
|
* **Como:** Líder Comercial
|
|
* **Quiero:** Simular liquidaciones
|
|
* **Para:** Validar resultados antes de aprobar pagos.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Simulación):** Dado que existe un periodo de liquidación, cuando el usuario ejecuta simulación, entonces el sistema debe mostrar resultados preliminares.
|
|
* **Operaciones (Sub-features):**
|
|
* Simulación, Validación previa, Comparativos, Ajustes antes de cierre.
|
|
|
|
---
|
|
|
|
### FEATURE 4 — Aprobaciones y Flujo de Validación
|
|
|
|
#### HU-COM-008 — Aprobar liquidaciones
|
|
* **Como:** Líder Comercial
|
|
* **Quiero:** Aprobar o rechazar liquidaciones
|
|
* **Para:** Validar pagos variables.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Aprobar):** Dado que existe una liquidación generada, cuando el líder revisa la información, entonces puede aprobarla.
|
|
* **Escenario 2 (Rechazar):** Dado que existen inconsistencias, cuando el líder rechaza la liquidación, entonces debe registrar observaciones obligatorias.
|
|
* **Operaciones (Sub-features):**
|
|
* Flujo de aprobación, Observaciones, Rechazos, Reenvío de liquidación.
|
|
|
|
#### HU-COM-009 — Notificar aprobación o rechazo
|
|
* **Como:** Sistema
|
|
* **Quiero:** Notificar resultados de aprobación
|
|
* **Para:** Informar a los responsables.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Notificación de aprobación):** Dado que la liquidación fue aprobada, cuando finaliza el proceso, entonces el sistema debe enviar notificación automática.
|
|
* **Operaciones (Sub-features):**
|
|
* Correos automáticos, Notificaciones push, Historial de notificaciones.
|
|
|
|
---
|
|
|
|
### FEATURE 5 — Consulta y Trazabilidad
|
|
|
|
#### HU-COM-010 — Consultar histórico de comisiones
|
|
* **Como:** Colaborador
|
|
* **Quiero:** Consultar mi histórico de pagos variables
|
|
* **Para:** Validar liquidaciones realizadas.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Consulta histórica):** Dado que existen periodos liquidados, cuando el usuario consulta la información, entonces el sistema debe mostrar: Periodo, Meta, Resultado, Comisión, Estado.
|
|
* **Operaciones (Sub-features):**
|
|
* Histórico de pagos, Filtros, Descarga PDF, Consulta por periodos.
|
|
|
|
#### HU-COM-011 — Registrar trazabilidad y auditoría
|
|
* **Como:** Sistema
|
|
* **Quiero:** Registrar cambios y aprobaciones
|
|
* **Para:** Mantener trazabilidad histórica.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Registro automático):** Dado que un usuario modifica reglas o liquidaciones, cuando guarda cambios, entonces el sistema debe registrar: Usuario, Fecha, Hora, Acción, Valor anterior, Valor nuevo.
|
|
* **Operaciones (Sub-features):**
|
|
* Auditoría, Logs, Histórico, Bitácora.
|
|
|
|
---
|
|
|
|
### FEATURE 6 — Reportes y Analítica
|
|
|
|
#### HU-COM-012 — Visualizar dashboard de compensación
|
|
* **Como:** Director Comercial
|
|
* **Quiero:** Visualizar dashboards de compensación
|
|
* **Para:** Analizar desempeño y costos variables.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Dashboard ejecutivo):** Dado que existen liquidaciones generadas, cuando el usuario consulta el dashboard, entonces el sistema debe mostrar: Comisiones pagadas, Cumplimiento, Ranking comercial, Costos variables, Tendencias.
|
|
* **Operaciones (Sub-features):**
|
|
* Dashboards, KPIs financieros, Tendencias, Comparativos.
|
|
|
|
#### HU-COM-013 — Exportar reportes financieros
|
|
* **Como:** Usuario Financiero
|
|
* **Quiero:** Exportar reportes
|
|
* **Para:** Realizar análisis presupuestal y operativo.
|
|
* **Criterios de Aceptación:**
|
|
* **Escenario 1 (Exportación):** Dado que existen resultados liquidados, cuando el usuario selecciona exportar, entonces el sistema debe generar: PDF, Excel, Consolidados por hotel, Consolidados por región.
|
|
* **Operaciones (Sub-features):**
|
|
* Exportación PDF, Exportación Excel, Reportes consolidados, Programación automática de reportes.
|
|
|
|
---
|
|
|
|
### FEATURE 7 — Seguridad y Permisos
|
|
|
|
#### HU-COM-014 — Gestionar roles y permisos
|
|
* **Como:** Administrador
|
|
* **Quiero:** Gestionar roles y accesos
|
|
* **Para:** Proteger información sensible.
|
|
* **Roles sugeridos:**
|
|
* Administrador, Director Comercial, Gerente Hotel, Líder Comercial, Analista Financiero, Consulta.
|
|
* **Operaciones (Sub-features):**
|
|
* Roles, Permisos, Restricción por hotel, Restricción por región, Restricción por área.
|