Proyectos¶
¿Qué es?¶
El módulo de Proyectos organiza las operaciones por contrato o sitio de trabajo. Un proyecto agrupa los puestos de trabajo, los empleados autorizados y las zonas donde opera un cliente. La jerarquía es: Cliente → Proyecto → Puestos. Las programaciones de turnos, novedades y minutas se vinculan siempre a un proyecto.
Vista principal¶
Columnas de la tabla¶
- Nombre — Nombre del proyecto. Ancho máximo 280 px, truncado.
- Cliente — Nombre del cliente al que pertenece (
partner_name). Ancho máximo 220 px, truncado. - Encargado — Nombre del empleado responsable del proyecto (
manager_name). Ancho 200 px, truncado. - Inicio — Fecha de inicio en formato AAAA-MM-DD (monoespaciado). Ancho 110 px.
- Fin — Fecha de fin del proyecto en formato AAAA-MM-DD. Ancho 110 px.
- Zonas — Badge azul con el número de zonas asociadas al proyecto.
- Autorizados — Badge morado con el número de empleados autorizados en el proyecto. Ancho 110 px.
- Estado — Badge: Activo (verde) o Inactivo (gris).
Filtros¶
- Buscar por nombre o cliente... — Campo de texto libre.
- Estado — Selector:
Activos(por defecto),Inactivos,Todos.
Ordenación por defecto¶
Ordenada por nombre ascendente (A → Z).
Acciones disponibles¶
Botón "Nuevo proyecto"¶
Visible con permiso projects: create. Abre el modal de creación.
Botón "Importar"¶
Visible con permiso projects: import. Navega a la importación masiva (#/projects-bulk).
Exportar¶
Botón de exportación. Descarga un archivo proyectos. Requiere permiso projects: export.
Acciones masivas¶
Al seleccionar uno o más proyectos:
- Inactivar — Visible cuando el filtro es
ActivosoTodos. Requiere permisoprojects: delete. Doble confirmación. - Activar — Visible cuando el filtro es
Inactivos. Requiere permisoprojects: edit. - Cerrar selección — Botón X.
Modal de creación / edición¶
Campos del formulario¶
- Nombre — Nombre del proyecto (obligatorio).
- Cliente (
partner_id) — Autocompletado de clientes. Al enfocar el campo sin texto, carga los primeros resultados automáticamente. - Encargado (
user_id) — Autocompletado de empleados. Permite asignar un responsable del proyecto. - Fecha de inicio (
date_start) — Selector de fecha. - Fecha de fin (
date) — Selector de fecha. - Descripción — Campo de texto libre para información adicional del proyecto.
- Activo — Toggle para activar/inactivar el proyecto.
Sección de Zonas (solo en edición)¶
En modo edición, el modal carga automáticamente las zonas asociadas al proyecto. Se puede:
- Agregar zonas mediante autocompletado (zoneQ).
- Eliminar zonas de la lista haciendo clic en la X de cada una.
Sección de Empleados autorizados (solo en edición)¶
En modo edición, se cargan los empleados autorizados en el proyecto:
- Autocompletado para agregar empleados (empQ).
- X en cada empleado para quitarlo de la lista.
Nota: Mientras carga las relaciones (zonas y empleados), el modal muestra un indicador loadingRels.
Validaciones¶
- Nombre es obligatorio. Sin él, aparece "El nombre es requerido".
Importación masiva de proyectos (projects-bulk)¶
En Proyectos, la importación masiva (Portal › Operaciones → Proyectos → Importar) permite crear muchos proyectos a la vez desde una hoja tipo Excel o desde un archivo analizado con IA.
Columnas de la hoja¶
| # | Columna | Obligatorio | Notas |
|---|---|---|---|
| 1 | Nombre | Sí | Nombre del proyecto |
| 2 | Cliente | No | Nombre del cliente (debe existir) |
| 3 | Encargado | No | Nombre del empleado encargado (debe existir) |
| 4 | Zona | No | Nombre de la zona. Si no existe, se puede crear en el mismo paso |
| 5 | Fecha inicio | No | AAAA-MM-DD o DD/MM/AAAA (también DD-MM-AAAA) |
| 6 | Fecha fin | No | AAAA-MM-DD o DD/MM/AAAA (también DD-MM-AAAA) |
| 7 | Descripción | No | Texto libre |
Los clientes y encargados deben existir antes de importar: si un nombre no se encuentra, la celda queda en rojo («Encargado no encontrado — créalo primero o corrige el nombre») y la fila no se guarda.
Importar desde archivo (con IA)¶
El botón Importar acepta .csv, .xlsx o .xls. La IA mapea columnas automáticamente y llena la hoja.
Al leer las fechas del Excel, el orden día/mes/año se decide mirando toda la columna, no una sola celda: si algún valor tiene un primer número mayor que 12 (por ejemplo 13/01/2026), la columna se lee como día/mes. Si ningún valor lo aclara, se asume el orden colombiano (día/mes/año).
Crear zonas nuevas al importar proyectos¶
En la importación de Proyectos, si la columna Zona trae zonas que todavía no existen, después del análisis aparece el panel Nuevas zonas detectadas con la lista (todas marcadas). Elige cuáles crear (Todos / Ninguno, o busca con «Buscar zona...») y toca Crear seleccionadas: las zonas se crean en Zonas y las filas quedan listas para guardar.
Mientras una zona no exista, su celda queda marcada en rojo («Zona no existe — se creará al importar») y Guardar no deja continuar: crea la zona desde el panel, corrige el nombre o deja la celda vacía para importar el proyecto sin zona.
Permisos¶
| Acción | Permiso requerido |
|---|---|
| Ver proyectos | projects: view |
| Crear proyecto | projects: create |
| Editar proyecto | projects: edit |
| Inactivar | projects: delete |
| Exportar | projects: export |
| Importar | projects: import |
Páginas relacionadas¶
- Clientes — El cliente al que pertenece cada proyecto.
- Puestos — Los puestos de trabajo se crean bajo un proyecto.
- Zonas — Las zonas se asocian a proyectos para controlar el acceso al monitor.
- Turnos y horarios — Las programaciones de turno se crean por proyecto.
- Novedades — Las novedades están vinculadas a un proyecto específico.
Preguntas frecuentes¶
¿Un proyecto puede pertenecer a más de un cliente? No. Cada proyecto está vinculado a un solo cliente. Si un cliente tiene múltiples contratos o sitios, crea un proyecto por cada uno.
¿Qué son los "Autorizados" en un proyecto? Son los empleados que tienen permiso explícito para acceder al proyecto. Esta lista se usa en algunos flujos de autorización y en las asignaciones de formularios por proyecto.
¿Inactivar un proyecto afecta los puestos? No directamente. Los puestos asociados permanecen, pero el proyecto no aparecerá en las búsquedas de autocompletado cuando está inactivo.
¿Cómo creo las zonas que no existen al importar proyectos? Después de analizar el archivo aparece el panel «Nuevas zonas detectadas»: deja marcadas las que quieras y toca Crear seleccionadas. Las zonas aparecen de inmediato en Zonas. Ver Crear zonas nuevas al importar proyectos.
¿Por qué no me deja guardar la importación de proyectos? Hay celdas en rojo: un cliente o encargado que no existe, una fecha no válida o una zona que aún no se ha creado. Pasa el mouse sobre la celda para ver el motivo.
¿La importación entiende fechas como 05/03/2026? Sí. Acepta AAAA-MM-DD, DD/MM/AAAA y DD-MM-AAAA. Al importar un Excel, el orden día/mes se decide mirando toda la columna; si nada lo aclara, se toma como día/mes/año.