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 Activos o Todos. Requiere permiso projects: delete. Doble confirmación.
Activar — Visible cuando el filtro es Inactivos. Requiere permiso projects: edit.
Cerrar selección — Botón X.

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)¶

La página #/projects-bulk permite crear múltiples proyectos a la vez.

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
4	Fecha inicio	No	Formato AAAA-MM-DD
5	Fecha fin	No	Formato AAAA-MM-DD

Importar desde archivo (con IA)¶

El botón Importar acepta .csv, .xlsx o .xls. La IA mapea columnas automáticamente.

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.