Empleados¶

¿Qué es?¶

El módulo de Empleados es el directorio central del personal de la empresa. Permite registrar, editar, activar/inactivar y buscar a todos los empleados que usan la aplicación Clic2Track. Desde aquí también se gestionan los catálogos de Departamentos y Cargos.

Vista principal¶

La pantalla muestra una tabla con las siguientes columnas:

Código — Código interno del empleado asignado por la empresa (texto libre, opcional). Ancho fijo 110 px.
Nombre — Nombre completo del empleado con foto o avatar de iniciales. Truncado en 260 px.
Cédula — Número de documento de identidad, formateado con puntos (ej. 1.234.567.890). Ancho 140 px.
Teléfono — Número de celular o teléfono, formateado. Ancho 140 px.
Correo — Correo laboral del empleado. Truncado en 200 px.
Departamento — Departamento asignado (proviene del catálogo de departamentos). Ancho 180 px.
Cargo — Cargo o puesto de trabajo (proviene del catálogo de cargos). Ancho 180 px.
Estado — Badge verde Activo o gris Inactivo.

Avatares¶

El sistema carga automáticamente la foto de perfil de cada empleado después de renderizar la tabla. Si no hay foto registrada, se muestra un círculo de color con las iniciales del nombre (primeras letras de las dos primeras palabras).

Filtros y búsqueda¶

La barra de filtros encima de la tabla permite:

Buscar por nombre, cédula o código — Búsqueda de texto libre que coincide con cualquier campo del encabezado.
Departamento — Autocompletado que busca en el catálogo; escribir el nombre y seleccionar de la lista desplegable.
Cargo — Autocompletado igual que Departamento.
Estado — Selector fijo con tres opciones:
Activos (valor por defecto al cargar la página)
Inactivos
Todos

La tabla se ordena por defecto por Nombre en orden ascendente (A → Z). Se puede cambiar el orden haciendo clic en el encabezado de cualquier columna ordenable.

Acciones disponibles¶

Botón "Nuevo" (crear empleado)¶

Visible solo para usuarios con permiso employees: create. Abre el modal de creación.

Botón "Importar"¶

Visible solo para usuarios con permiso employees: import. Navega a la página de importación masiva (employees-bulk).

Botón "Catálogos"¶

Visible para usuarios con permiso employees: view. Abre el panel deslizante (slide-over) de catálogos desde la derecha.

Exportar¶

Botón de exportación en la barra de la tabla. Descarga un archivo con nombre empleados que contiene todos los empleados según los filtros activos.

Selección múltiple y acciones masivas¶

Al marcar uno o más empleados con la casilla de verificación, aparece una barra flotante en la parte inferior de la pantalla con:

Contador — "N empleado(s) seleccionados".
Inactivar — Solo visible cuando el filtro de Estado es Activos o Todos. Requiere permiso employees: delete. Al hacer clic por primera vez muestra "¿Confirmar?" con fondo rojo; hacer clic de nuevo ejecuta la acción. La inactivación es reversible.
Activar — Solo visible cuando el filtro de Estado es Inactivos. Requiere permiso employees: edit. Reactiva los empleados seleccionados inmediatamente.
Cerrar selección — X para deseleccionar todo y cerrar la barra.

Cómo crear un empleado¶

Haz clic en el botón Nuevo (esquina superior derecha).
Se abre el modal "Nuevo empleado".
Haz clic en el círculo de avatar (arriba del formulario) para subir una fotografía. Acepta cualquier imagen (image/*). En modo creación, la foto se envía junto con el empleado al guardar.
Completa los campos:
Nombre (obligatorio) — Nombre completo del empleado.
Cédula (obligatorio) — Solo dígitos numéricos, sin puntos ni guiones.
Código (opcional) — Código interno de la empresa para este empleado.
Teléfono (opcional) — Celular o teléfono, se formatea automáticamente.
Correo laboral (opcional) — Email laboral del empleado.
Departamento (opcional) — Campo de autocompletado; escribir para buscar en el catálogo.
Cargo (opcional) — Campo de autocompletado; escribir para buscar en el catálogo.
Tipo (opcional) — Selector con opciones: Interno / Externo / sin tipo.
Género (opcional) — Selector: Masculino, Femenino, Otro / sin especificar.
Fecha de nacimiento (opcional) — Selector de fecha, formato DD/MM/AAAA.
Haz clic en Crear empleado.
Si hay foto pendiente, se sube automáticamente después de crear el registro.
La tabla se recarga mostrando el nuevo empleado.

Validaciones al guardar: - El campo Nombre es obligatorio. Sin él, el botón queda deshabilitado. - La cédula es obligatoria. Sin ella, el botón queda deshabilitado.

Cómo editar un empleado¶

Haz clic sobre cualquier fila de la tabla.
Se abre el modal "Editar empleado" con todos los datos precargados.
La foto de perfil se carga en segundo plano desde el servidor.
Para cambiar la foto, haz clic sobre el círculo de avatar → selecciona la nueva imagen → se sube inmediatamente (no requiere guardar el formulario).
Modifica los campos necesarios.
Haz clic en Guardar cambios.
La tabla se recarga con los datos actualizados.

Cómo inactivar un empleado¶

Opción 1 — Individual: 1. Selecciona la casilla del empleado. 2. En la barra flotante, haz clic en Inactivar. 3. El botón cambia a rojo con texto "¿Confirmar?". 4. Haz clic de nuevo para confirmar.

Opción 2 — Masivo: Selecciona múltiples empleados y sigue el mismo flujo.

La inactivación no elimina el empleado del sistema. El empleado queda en estado Inactivo y deja de aparecer con el filtro por defecto (Activos). Puede reactivarse en cualquier momento.

Cómo reactivar un empleado¶

Cambia el filtro Estado a Inactivos.
Selecciona el o los empleados a reactivar.
En la barra flotante, haz clic en Activar.
El empleado vuelve al estado Activo inmediatamente.

Catálogos (Departamentos y Cargos)¶

El panel de Catálogos se abre desde el botón Catálogos y muestra dos pestañas:

Pestaña Departamentos¶

Lista todos los departamentos de la empresa. Para cada uno muestra: - Nombre del departamento. - Cantidad de empleados asignados (ej. "5 emp.").

Acciones disponibles al pasar el cursor sobre una fila: - Renombrar (lápiz) — Activa un campo de texto en línea. Presionar Enter o hacer clic en el check guarda. Presionar Escape cancela. - Eliminar (papelera) — Abre confirmación antes de eliminar. No se puede deshacer.

Para agregar un nuevo departamento: escribir el nombre en el campo del pie del panel y presionar Enter o hacer clic en el botón "+".

Pestaña Cargos¶

Funciona igual que Departamentos pero para los cargos o títulos de trabajo.

Reglas de negocio de catálogos: - Un departamento o cargo con empleados asignados puede eliminarse (el sistema lo permite), pero los empleados quedarán sin departamento/cargo hasta que se reasigne. - Los nombres son únicos por tipo (no puede haber dos departamentos con el mismo nombre, validado en servidor).

Importación masiva¶

La página de importación masiva (#/employees-bulk) permite cargar múltiples empleados a la vez usando una hoja de cálculo tipo spreadsheet.

Columnas de la hoja¶

#	Columna	Obligatorio	Notas
1	Nombre	Sí	Nombre completo
2	Cédula	Sí	Solo dígitos; el sistema valida que sean números
3	Código	No	Código interno
4	Teléfono	No	Se formatea automáticamente
5	Correo	No	Se valida formato email
6	Departamento	No	Debe coincidir con catálogo o se creará automáticamente
7	Cargo	No	Debe coincidir con catálogo o se creará automáticamente
8	Tipo	No	Valores: `interno` o `externo` (o `i` / `e`)
9	Nacimiento	No	Formato DD/MM/AAAA o AAAA-MM-DD
10	Género	No	Valores: `male`/`m`/`masculino`, `female`/`f`/`femenino`, `other`/`o`/`otro`

Importar desde archivo (con IA)¶

Haz clic en el botón Importar (esquina superior derecha).
Aparece un diálogo de confirmación describiendo el proceso.
Selecciona un archivo .csv, .xlsx o .xls.
La IA analiza el archivo, mapea automáticamente las columnas y rellena la hoja.
Aparece un resumen de lo que se detectó y advertencias si hubo columnas no reconocidas.

Panel de Nuevos elementos detectados¶

Si el archivo contiene departamentos o cargos que no existen en el catálogo, aparece un panel antes de importar: - Lista de Departamentos nuevos y Cargos nuevos detectados. - Cada ítem tiene una casilla para incluirlo o no. - Botones "Todos" / "Ninguno" para selección rápida. - Campo de búsqueda para filtrar la lista. - Botón Crear seleccionados — crea los ítems en el catálogo antes de importar. - Botón Omitir — cierra el panel sin crear; los ítems quedarán sin departamento/cargo.

Indicador de estado de la hoja¶

Encima de la tabla muestra: - Badge verde Listo para importar — No hay errores. - Badge amarillo N celda(s) con error — Hay celdas inválidas. - Botón Ver — Salta a la primera celda con error. - Botón Ordenar errores arriba — Reorganiza las filas para ver los errores primero.

Guardar la importación¶

El botón Guardar envía los datos al servidor en bloques. Muestra el progreso en porcentaje (ej. "Guardando 45%"). Si hay errores en alguna fila, se muestran detallados después de completar la importación. Al terminar correctamente, redirige a la lista de empleados.

Reglas de validación para importar: - Filas completamente vacías se ignoran. - Si una fila tiene nombre pero no cédula (o viceversa), la importación se detiene con error. - El sistema no puede importar si hay celdas marcadas como inválidas (la tabla las muestra en rojo).

Estados posibles¶

Estado	Descripción
Activo	El empleado puede iniciar sesión en la app y registra asistencia normalmente
Inactivo	El empleado no puede acceder a la app; sus datos históricos se conservan

Páginas relacionadas¶

Asistencia — Historial de entradas/salidas por empleado.
Monitoreo — Estado en tiempo real de dispositivos de empleados.
Usuarios — Credenciales de acceso al portal para supervisores/admins; vinculados a empleados.
Contratos — Información salarial y contractual por empleado.
Nómina — Comprobantes de pago ligados a empleados activos.
Turnos — Programaciones de horario asignadas a empleados.
Puestos — Puestos de trabajo donde los empleados registran asistencia.

Preguntas frecuentes¶

¿Cómo busco un empleado por su número de cédula? Escribe la cédula (o parte de ella) en el campo de búsqueda principal. El sistema busca coincidencias en nombre, cédula y código.

¿Puedo eliminar un empleado permanentemente? No. El portal solo permite inactivar empleados, no eliminarlos. Los datos históricos se conservan.

¿Qué pasa si inactivo un empleado que tiene turnos asignados? El empleado queda inactivo pero sus turnos históricos se conservan. Los turnos futuros deberán ajustarse manualmente.

¿Cómo cambio la foto de un empleado? Abre el modal de edición haciendo clic en la fila del empleado, luego haz clic sobre el círculo de foto. Selecciona la nueva imagen y se subirá automáticamente.

¿El código de empleado es único? No hay validación de unicidad en el código. Es un campo libre que la empresa puede usar a su conveniencia (ej. código del ERP externo).

¿Qué significa "Tipo" en el formulario? Indica si el empleado es de personal Interno (empleado directo de la empresa) o Externo (contratista, proveedor, etc.). Solo tiene efecto informativo dentro del portal.

¿Puedo importar empleados que ya existen? Sí. Si la cédula ya existe, el sistema actualiza el registro en lugar de crear uno nuevo (upsert). No genera duplicados.

¿Cómo filtro por departamento en la lista? Haz clic en el campo "Departamento" debajo de la barra de búsqueda, escribe el nombre y selecciona de la lista desplegable.