Vinculación de Usuarios y Proyectos
Descripción, Propósito y Objetivo
NOTE
La vista de Vinculación de Usuarios y Proyectos es la sección del ERP diseñada para gestionar la asignación del capital humano de la organización a los diferentes proyectos activos, estableciendo los parámetros operativos y financieros de cada relación.
Una Asignación es el registro formal que vincula a un Usuario (colaborador o especialista) con un Proyecto (desarrollo, consultoría o servicio contratado por un cliente) durante un período específico. A través de este módulo se definen las tarifas de costo por hora y la disponibilidad diaria pactada para cada recurso.
El objetivo de esta vista es centralizar y controlar las asignaciones operativas, facilitando el cálculo automático de nómina, la conciliación del registro de seguimiento de tiempo (time tracking) y la auditoría de costos del proyecto.
Contexto de Uso
Este módulo es utilizado por el equipo de administración y los Project Managers (PM) para:
- Planificar recursos: Asignar desarrolladores, consultores o líderes a proyectos específicos con fechas de vigencia claras.
- Controlar costos: Definir la tarifa horaria que el colaborador representa para el proyecto a fin de proyectar márgenes financieros.
- Establecer capacidades: Declarar la intensidad horaria diaria contratada o planificada para evitar sobrecargas de trabajo.
- Auditar relaciones: Consultar el histórico y estado vigente de las relaciones laborales asociadas a los proyectos de la organización.
Acciones Posibles
1. Consulta y Exportación de Vinculaciones
Permite visualizar el listado consolidado de todas las asignaciones usuario-proyecto en una tabla interactiva que muestra el nombre del colaborador, el proyecto asignado, las fechas de vigencia, el rol, la tarifa de costo, el horario pactado y el estado de la asignación.
- Filtrar y Ordenar: Ingrese el nombre de un usuario o proyecto en la barra de búsqueda (Buscar) para filtrar los resultados en tiempo real. También puede hacer clic en las cabeceras de columna (Usuario, Proyecto, Estado, Horas por día, Costo por hora) para reordenar la tabla alfabética o numéricamente.
- Exportar Datos: Haga clic en el botón azul con el icono de descarga ubicado al lado del botón de creación para descargar el consolidado general de vinculaciones en formato de hoja de cálculo .CSV.

2. Asignar un Usuario a un Proyecto
Para vincular a un nuevo colaborador a un proyecto registrado en el sistema:
- Haga clic en el botón Agregar usuario - proyecto ubicado en la esquina superior derecha de la vista.

- Se desplegará un panel lateral derecho. Diligencie los siguientes campos del formulario:
- Usuario*: Seleccione el nombre del colaborador desde el menú desplegable autocompletable.
- Proyecto*: Seleccione el proyecto al cual se le asignará el recurso.
- Rol*: Seleccione el rol operativo o administrativo que desempeñará dentro de ese proyecto (ej. Desarrollador, PM, Diseñador).
- Fecha de inicio*: Defina la fecha de arranque de la asignación usando el selector de calendario.
- Fecha de fin: Defina la fecha estimada de término del período de asignación (deje vacío si es indefinido).
- Horas por día*: Ingrese la intensidad horaria diaria acordada para el proyecto.
- Costo por hora*: Defina el costo monetario de cada hora de labor realizada por este usuario en el proyecto.

- Haga clic en Agregar para registrar la vinculación. Si desea declinar la operación, haga clic en Cancelar.

3. Editar una Asignación Existente
Si requiere modificar los términos financieros, la disponibilidad horaria o las fechas de vigencia del colaborador:
- Identifique la asignación en la tabla general y haga clic en el icono de lápiz (✏️) dentro de la columna de acciones.

- Se abrirá el panel lateral precargado con la información de la asignación. Modifique los datos necesarios (por ejemplo, actualice el costo por hora por un ajuste salarial o cambie la fecha de finalización del proyecto).
- Haga clic en Actualizar para guardar los cambios de forma inmediata.

4. Eliminar una Asignación (Desvinculación)
Para retirar formalmente la asignación de un usuario en un proyecto:
- Haga clic en el icono de papelera (🗑️) de la fila correspondiente.

- El sistema mostrará un modal de alerta con una solicitud de confirmación: ¿Está seguro que deseas eliminar la relación usuario proyecto del usuario [Nombre Usuario] con el proyecto [Nombre Proyecto]?

CAUTION
Eliminar una vinculación usuario-proyecto podría repercutir en la pérdida de registros históricos en el cálculo automático de nómina y reportes financieros consolidados de ese proyecto si existen horas cargadas a la relación.
Permisos Técnicos Requeridos
La visualización y administración de las vinculaciones de usuarios y proyectos están regidas por los siguientes privilegios:
user_projects_read/user_projects_list: Permite el acceso a la vista, visualizar las asignaciones registradas y realizar búsquedas de relaciones.user_projects_create: Habilita el botón y panel lateral para registrar una nueva asignación.user_projects_update: Permite la edición de tarifas, fechas de vigencia y horas en las vinculaciones existentes.user_projects_delete: Habilita la acción de borrado físico del registro en base de datos.user_projects_export: Permite realizar la descarga del reporte consolidado de asignaciones en formato.CSV.