Clientes¶

¿Qué es?¶

El módulo de Clientes es el directorio de empresas y personas naturales que contratan los servicios de seguridad o recursos humanos. Los clientes (también llamados "partners" o "terceros" internamente) se asocian a Proyectos, que a su vez se asocian a Puestos de trabajo y Novedades. Es el primer eslabón de la cadena: Cliente → Proyecto → Puesto.

Vista principal¶

La tabla muestra todos los clientes con las siguientes columnas:

Nombre — Nombre del cliente con avatar de iniciales de colores y badge de tipo:
Badge Empresa (azul pequeño) — Si es persona jurídica.
Badge Persona (gris pequeño) — Si es persona natural. Ancho máximo 280 px, truncado.
NIT / ID — Número de NIT o documento de identidad del cliente, formateado. Fuente monoespaciada. Ancho 150 px.
Teléfono — Número de teléfono formateado. Ancho 140 px.
Correo — Correo electrónico de contacto. Ancho máximo 220 px, truncado.
Ciudad — Ciudad donde se ubica el cliente. Ancho 160 px, truncado.

Filtros¶

Buscar por nombre o NIT... — Campo de texto libre.
Tipo — Selector: Todos, Empresa, Persona.
Estado — Selector: Activos (por defecto), Inactivos, Todos.

Ordenación por defecto¶

Ordenada por nombre ascendente (A → Z).

Acciones disponibles¶

Botón "Nuevo cliente"¶

Visible con permiso clients: create. Abre el modal de creación.

Botón "Importar"¶

Visible con permiso clients: import. Navega a la importación masiva (#/clients-bulk).

Exportar¶

Botón de exportación en la barra de la tabla. Descarga un archivo clientes. Requiere permiso clients: export.

Acciones masivas¶

Al seleccionar uno o más clientes:

Inactivar — Visible cuando el filtro de Estado es Activos o Todos. Requiere permiso clients: delete. Requiere doble confirmación (segundo clic en "¿Confirmar?").
Activar — Visible cuando el filtro de Estado es Inactivos. Requiere permiso clients: edit.
Cerrar selección — Botón X para deseleccionar todo.

Al hacer clic en una fila o en el botón "Nuevo cliente" se abre el modal.

Campos del formulario¶

Nombre — Nombre del cliente o empresa (obligatorio).
NIT / ID (vat) — Número de identificación tributaria o documento. Texto libre.
Teléfono (phone) — Teléfono fijo de la empresa. Texto libre.
Celular (mobile) — Número de celular. Texto libre.
Correo (email) — Dirección de correo electrónico.
Dirección (street) — Dirección física. Campo con autocompletado de Google Places: al escribir más de 3 caracteres, sugiere direcciones. Al seleccionar una sugerencia, se completa automáticamente el campo Ciudad.
Ciudad (city) — Ciudad del cliente. Se rellena automáticamente al seleccionar una dirección; también editable manualmente.
Sitio web (website) — URL del sitio web del cliente.
Comentario (comment) — Campo de texto libre para notas internas.
Tipo (is_company) — Toggle que indica si es Empresa (activado) o Persona natural (desactivado).
Activo — Toggle para activar/inactivar el cliente.

Validaciones¶

El campo Nombre es obligatorio. Sin él, el botón Guardar muestra el error "El nombre es obligatorio".

Importación masiva de clientes (clients-bulk)¶

La página #/clients-bulk permite crear múltiples clientes usando una hoja de cálculo o importación con IA.

Columnas de la hoja¶

#	Columna	Obligatorio	Notas
1	Nombre	Sí	Nombre del cliente o empresa
2	NIT/ID	No	Número de identificación
3	Teléfono	No	Teléfono fijo
4	Correo	No	Email de contacto
5	Ciudad	No	Ciudad del cliente
6	Tipo	No	`empresa` / `e` o `persona` / `p`

Importar desde archivo (con IA)¶

Clic en Importar en la barra superior.
Seleccionar archivo .csv, .xlsx o .xls.
La IA analiza el archivo, mapea columnas automáticamente y llena la hoja.
Aparece un resumen de detecciones y advertencias.

Guardar importación¶

Botón Guardar envía los datos en bloques. Progreso en porcentaje. Redirige a la lista al terminar.

Permisos¶

Acción	Permiso requerido
Ver clientes	`clients: view`
Crear cliente	`clients: create`
Editar cliente	`clients: edit`
Inactivar	`clients: delete`
Exportar	`clients: export`
Importar	`clients: import`

Páginas relacionadas¶

Proyectos — Cada proyecto pertenece a un cliente. Al crear un proyecto, se selecciona el cliente.
Novedades — Las novedades se vinculan al cliente a través del proyecto.
Puestos — Los puestos están bajo proyectos que pertenecen a clientes.

Preguntas frecuentes¶

¿Puedo tener clientes sin NIT? Sí. El campo NIT/ID es opcional. Se puede registrar un cliente con solo el nombre.

¿Inactivar un cliente afecta sus proyectos? No directamente. Los proyectos y puestos asociados permanecen activos. La inactivación del cliente solo lo oculta del listado por defecto (filtro Activos).

¿Cuál es la diferencia entre Teléfono y Celular? Teléfono (phone) es para el número fijo de la empresa; Celular (mobile) para el número móvil del contacto. Ambos son opcionales.