RF-001 Requisitos antes de iniciar el proceso de prenómina.

3.1.1.1	RF-001-A Subida del archivo Match con Tacloud.
Campo	Valor
ID	RF-001-A
Nombre	Subida del archivo “Match con Tacloud”
Descripción	El sistema permitirá subir un archivo Excel que contiene los registros de asistencia para el proceso de prenómina.
Actor(es)	Usuario RH
Entradas	Archivo .xlsx, .xls o .csv
Proceso	-	El sistema solicitará seleccionar el archivo mediante drag and drop o examinar.
-	El sistema validará que el archivo cumple con el formato correcto.
-	El sistema mostrará un mensaje que el archivo se ha cargado correctamente.
-	Se habilita el botón de Iniciar Prenómina.
Salidas	Archivo con el formato validado, listo para usarse en el proceso de prenómina.
Reglas de Negocio	Deben existir las columnas: Nombre, Fecha, Entrada, Salida, Resultado, Incidencia, DepartamentoInterno, Región.
Precondiciones	-	No debe existir un proceso de prenómina activo.
Postcondiciones	Los Datos del archivo se guardan en una tabla temporal de match con Tacloud.
Excepciones / Errores	-	Si el archivo no tiene encabezados correctos → mostrar error y no permitir continuar.
-	Si existe un proceso actual de prenómina en curso, la opción de subir un archivo se deshabilita y el botón de iniciar prenómina, se reemplaza por continuar prenómina
Prioridad	Alta
Criterios de Aceptación	1) El sistema rechaza el archivo que no cumple con el formato. 

3.1.1.2	RF-001-B Configuración de políticas de Prenómina
Campo	Descripción
ID del Requisito	RF-001-B
Nombre / Título	Configuración de Políticas de Prenómina
Descripción	El sistema debe permitir gestionar un apartado de ajustes donde se configuren las políticas que se aplicarán en el proceso de prenómina.
Actor(es)	Usuario RH
Entradas	Parámetros ingresados o modificados por el usuario.
Proceso / Comportamiento	1) El usuario accede a la opción “Configurar Políticas” desde la vista donde se importa el Match con Tacloud. 
2) El sistema muestra los valores actuales de las políticas. 
3) El usuario puede editar los parámetros permitidos. 
4) Al presionar guardar, el sistema pregunta si estas seguro de guardar los datos, y entonces se aplican los cambios.
5) El sistema actualiza la información de la configuración en la tabla de políticas de prenómina.
Parámetros Configurables	Incidencias.
-	Cantidad de retardos que generan una falta (Por defecto 2 retardos ameritan una falta). 
General.
-	Cuando contabilizar Chargeback, Streaming, Descuentos y errores de captura. (Checklist que muestra Quincena 1 y Quincena 2).
-	Cuando asignar el número de quincena correspondiente al día de la realización de la prenómina (Por defecto Quincena 1 igual o antes del 15 y Quincena 2 igual o antes del 30).
Streaming.
-	Cuanto descuento se aplica por cada streaming no visto, dependiendo del puesto que posea el colaborador.
Salidas	Políticas actualizadas y asociadas a la prenómina correspondiente.
Reglas de Negocio	- Cambios solo aplican antes de procesar prenómina.
- Si el usuario edita las políticas, se marca que políticas ha editado antes de guardar.
Precondiciones	N/A
Postcondiciones	Las políticas se registran/actualizan en la tabla de las políticas de prenómina.
Excepciones / Errores	- Si un parámetro requerido está vacío → impedir guardado y mostrar mensaje.
- El sistema deshabilita la opción de editar políticas si existe un proceso de prenómina iniciado.
Prioridad	Media
Criterios de Aceptación	1) En el apartado de configuración, el sistema pregunta si está seguro de guardar los cambios.
2) La política aplicada se visualiza antes de procesar la prenómina.
3) Solo usuarios autorizados pueden modificar parámetros.

3.1.1.3	RF-001-C Inicio del proceso de Prenómina
Campo	Contenido
ID del Requisito	RF-001-C
Nombre / Título	Inicio del proceso de Prenómina
Descripción	Se define la acción del usuario para iniciar el proceso de prenómina, que consolida los datos del archivo Match con Tacloud (RF-001-A) y las políticas configuradas (RF-001-B). Al presionar el botón “Iniciar Prenómina”, el sistema genera las estructuras temporales necesarias para el cálculo y visualización de incidencias, deducciones y percepciones.
Actor(es)	Usuario RH.
Entradas	- Archivo Match con Tacloud validado.
- Políticas de prenómina configuradas.
Proceso / Comportamiento	1.	El usuario presiona el botón “Iniciar Prenómina”.
2.	El sistema guarda la información  del match con tacloud en una tabla temporal
3.	Se obtiene la información de la tabla de las políticas de prenómina para saber que deducciones se tomarán para el proceso.
4.	En la tabla temporal de procesos de prenómina se genera una row por cada proceso de prenómina: incidencias, bonos, comisiones, descuentos + las obtenidos de la tabla de políticas de prenómina (chargeback, streaming y/o errores de captura). En el status de las rows se pone en_proceso.

Parámetros Configurables	-	Los definidos en la configuración de políticas (RF-001-B)
Salidas	El sistema redirige a la vista de las incidencias.
Reglas de Negocio	- Solo puede existir un proceso de prenómina activo.
- Si existe un proceso activo, el sistema debe impedir iniciar un nuevo proceso de prenómina (control de concurrencia), ya que primero debe finalizarse (ya sea porque se canceló y se decidió reiniciar o concluyó exitosamente)
- Las estructuras temporales se eliminan cuando se autorice que el proceso de prenómina ha concluido exitosamente.
Precondiciones	- El archivo Match con Tacloud debe haberse subido y validado exitosamente (RF-001-A).
- Las políticas de prenómina deben estar configuradas y guardadas (RF-001-B).
- El usuario debe tener permisos de nivel RH.
Postcondiciones	- Tablas temporales generadas con los datos integrados.
- El proceso de prenómina se encuentra activo.
Excepciones / Errores	- Falta de archivo validado → mostrar mensaje “Debe cargar un archivo Match válido antes de iniciar la prenómina”.
- Políticas no configuradas → mensaje “Debe configurar las políticas de prenómina antes de continuar”.
- Error de conexión o escritura en DB → registrar error y mostrar alerta al usuario.
Prioridad	Alta
Criterios de Aceptación	- El sistema impide iniciar el proceso sin archivo o sin políticas configuradas.
- Se generan correctamente las estructuras temporales con los datos integrados.
- Solo puede existir un proceso de prenómina activo.

