# Especificación funcional inicial

## Nombre sugerido

**Mandatos GE - Plataforma de Gestión Laboral y Novedades de Personal**

## Objetivo

Centralizar la información laboral y administrativa de las empresas cliente de Mandatos, permitiendo registrar colaboradores, fondos y entidades de seguridad social, novedades mensuales, ingresos, retiros, vacaciones, incapacidades, permisos, licencias, ausencias, horas extras, préstamos, procesos de selección y demás hechos con impacto legal o administrativo.

## Enfoque multiempresa

El sistema no queda limitado a Vergel Plántulas y Vivero. La estructura permite crear varias empresas, por ejemplo:

- Vergel Plántulas y Vivero S.A.S.
- Cootranszipa.
- Ajos Colombianos.
- Transcolvolcos.
- Kidar S.A.S.
- Otros clientes de Mandatos.

Cada colaborador y novedad pertenece a una empresa específica.

## Módulos incluidos

### 1. Inicio de sesión

Acceso por correo y contraseña.

### 2. Empresas

Permite crear empresas cliente, editar datos básicos y mantenerlas activas o inactivas.

### 3. Colaboradores

Permite registrar:

- Empresa.
- Tipo y número de documento.
- Nombres y apellidos.
- Cargo.
- Área.
- Tipo de vinculación.
- Fecha de ingreso.
- Fecha de retiro.
- Estado.
- EPS.
- AFP.
- ARL.
- Caja de compensación.
- Fondo de cesantías.
- Salario base.
- Observaciones.

### 4. Novedades

Permite registrar:

- Empresa.
- Colaborador relacionado.
- Fecha de registro.
- Fecha de inicio y fin.
- Quincena automática.
- Categoría.
- Tipo de novedad.
- Días.
- Horas.
- Valor.
- Estado.
- Impacto legal.
- Descripción.
- Soporte documental.

### 5. Informes

Permite filtrar novedades por:

- Empresa.
- Colaborador.
- Categoría.
- Tipo de novedad.
- Fecha inicial.
- Fecha final.
- Quincena.

El informe se puede exportar a CSV para Excel o imprimirse como PDF desde el navegador.

### 6. Importación CSV

Permite migrar datos existentes desde Excel, usando plantillas estandarizadas.

### 7. Usuarios

Permite crear usuarios con roles:

- Superadministrador.
- Administrador de empresa.
- Consulta.

### 8. Auditoría

Registra acciones relevantes, usuario, empresa, fecha, IP y detalle.

## Recomendación de uso

La plataforma debe instalarse preferiblemente en un subdominio privado, por ejemplo:

`talentohumano.mandatosabogados.com`

## Evolución recomendada

La versión inicial debe usarse como MVP. Después de probarla con Vergel, se recomienda ampliar:

1. Contratos y prórrogas.
2. Control automático de vacaciones.
3. Alertas de vencimientos.
4. Control de documentos pendientes.
5. Informes PDF con formato Mandatos.
6. Firma o constancia digital de comunicaciones.
7. Tablero gerencial por cliente.
8. Parametrización de listas por empresa.
