Plataforma técnica · Sevastopol
Empleados en Sevastopol
Islands Remuneraciones Empleados
Propósito
Section titled “Propósito”EmployeesViewIsland mantiene el maestro de trabajadores del tenant. Es la entrada al dominio remuneraciones — sin empleado no hay contrato, ni APV, ni asistencia, ni liquidación. La island consolida en un sólo formulario los datos personales, organizacionales (cargo + departamento), previsionales (AFP + Isapre), bancarios y documentales.
El estado laboral (activos por defecto) determina qué empleados participan del cálculo mensual.
Decisiones de UX
Section titled “Decisiones de UX”| Decisión | Motivo |
|---|---|
| Paginación servidor + filtros locales | EmployeesViewIsland envía scope=activos, q, estado, limit, offset al backend. El servidor pagina; los filtros se reflejan en query. |
| 5 catálogos cargados al cambiar tenant | AFP, Isapre, cargos, departamentos y contratos se hidratan en paralelo en loadCatalogs(tenant) para que el modal abra sin esperas. |
| AFP/Isapre como catálogos globales | /api/afp y /api/isapre se cargan sin tenant (fetchStatic) — son institucionales, no del tenant. |
| Form con muchos campos opcionales | RUT, nombres, apellidos, fecha nacimiento, fecha ingreso y sexo son obligatorios; el resto se persiste como null si vacío. Evita registros inflados con strings vacíos. |
Eliminar con confirm nativo | El empleado eliminado no es soft-delete del Orchestrator — la UI obliga ratificación. |
estado heredado del filtro | Cambiar el filtro de estado recarga con setOffset(0) para que el paginado no quede en página huérfana. |
Datos visibles
Section titled “Datos visibles”| Grupo | Campos esperados |
|---|---|
| Identificación | RUT, nombres, apellidos, fecha de nacimiento, sexo. |
| Organización | Cargo (FK), departamento (FK), estado laboral. |
| Domicilio | Dirección, comuna, región, código postal. |
| Previsión | AFP, Isapre, cargas familiares, hijos, asignación familiar. |
| Pago | Banco, tipo de cuenta, número de cuenta. |
| Contacto | Email, teléfono, celular. |
| Documento | Foto, observaciones. |
Endpoints
Section titled “Endpoints”| Método + ruta | Uso |
|---|---|
GET /api/employees?tenant_id=&scope=activos&q=&estado=&limit=&offset= | Listado paginado. |
GET /api/employees?id=&tenant_id= | Carga puntual para editar. |
POST /api/employees?tenant_id= | Alta. |
PUT /api/employees?id=&tenant_id= | Edición. |
DELETE /api/employees?id=&tenant_id= | Eliminación. |
GET /api/afp · GET /api/isapre | Catálogos globales (sin tenant). |
GET /api/cargos?tenant_id= · GET /api/departments?tenant_id= · GET /api/contracts?tenant_id= | Catálogos del tenant. |
Backend de referencia
Section titled “Backend de referencia”EmployeeService — CRUD del maestro con normalización de RUT y validación de duplicados.