Employee Service

Orchestrator Services

EmpleadosOrchestratorServicio

Propósito

EmployeeService administra el maestro central de trabajadores. Expone operaciones para crear, consultar, actualizar y eliminar empleados, aplicando validaciones de datos personales, estados laborales y normalización de campos antes de persistir.

El servicio no calcula remuneraciones ni define condiciones contractuales. Su responsabilidad es mantener una entidad empleado consistente para que contratos, asistencia, vacaciones, liquidaciones y finiquitos puedan operar sobre una base común.

Ubicación

• Directoryorchestrator/src/domain/employees/

  • EmployeeService.ts
  • EmployeeRepository.ts

Métodos

Método	Uso
getEmployeeById(tenantDb, id)	Obtiene un empleado por identificador.
getEmployees(tenantDb, filter)	Lista empleados con filtros operativos.
createEmployee(tenantDb, userId, data)	Crea un empleado nuevo.
updateEmployee(tenantDb, userId, id, data)	Actualiza datos del empleado.
deleteEmployee(tenantDb, id)	Elimina o desactiva un empleado según regla vigente.

Flujo de Escritura

1. Recibir el tenantDb, el usuario ejecutor y el payload del empleado.

2. Validar campos obligatorios y enumeraciones.

3. Sanitizar strings, estados y valores booleanos.

4. Persistir mediante EmployeeRepository.

5. Devolver el empleado normalizado para que la vista recargue el estado.

Validaciones

Campo	Regla
rut	Formato y unicidad operativa.
sexo	Valores esperados M o F.
estado_civil	Valores controlados por catálogo laboral.
estado	Estados laborales válidos para el flujo.
tipo_cuenta	Cuenta corriente, vista o ahorro cuando se informa pago bancario.

Sanitización

El servicio normaliza datos antes de persistir:

• aplica trim a textos;
• convierte enumeraciones a mayúsculas;
• parsea booleanos como asignacion_familiar;
• completa valores por defecto cuando corresponde, como nacionalidad;
• evita que la UI persista variantes inconsistentes de estados o catálogos.

Integraciones

Servicio	Relación
ContractService	Usa el empleado como titular de contratos laborales y anexos.
AttendanceService	Asocia asistencia, licencias y horas extra a trabajador/contrato.
PayrollService	Hidrata contexto de liquidación con empleado, contrato y previsión.
FiniquitoService	Usa estado laboral, contrato y antigüedad para término de relación.

Ver También

Servicio de Empleados Lectura contable y operativa del maestro de trabajadores.

Empleados en Sevastopol Vista frontend para mantener el maestro de trabajadores.

ContractService Contratos laborales, jornada, sueldo base y vigencia.

PayrollService Motor de cálculo, hidratación de contexto y persistencia de liquidaciones.