Proyectos
Videos tutoriales
Los videos se reproducen si la carpeta media/ está disponible en el servidor.
¿Para qué sirve este módulo?
El módulo Proyectos centraliza la gestión de proyectos por cliente: planificación (cronograma), equipo (participantes), seguimiento operativo (tareas, reuniones, gestiones telefónicas, PQR), cumplimiento (legal, vencimientos), facturación y bitácora de novedades.
Está pensado para equipos comerciales, consultores, implementadores o cualquier área que lleve entregables asociados a un cliente dentro de Ecobelleza.
- Crear y filtrar proyectos por estado operativo.
- Abrir la ficha del proyecto con once pestañas integradas (agenda, cronograma, CRM, legal, financiera, etc.).
- Generar el cronograma de trabajo desde una plantilla definida por tipo de proyecto.
- Sincronizar ítems del cronograma con tareas y reuniones del CRM.
- Vincular ventas, documentos legales, vencimientos y archivos del proyecto.
- Configurar catálogos maestros (tipos, fases, estados, acciones, tareas de plantilla).
Estructura del módulo
| Nivel | Qué es | Cómo llegar |
|---|---|---|
| 1. Listado | Proyectos filtrados por estado (Pendientes, En proceso, etc.). | Iconos de estado en la barra superior |
| 2. Ficha del proyecto | Hub con pestañas: agenda, cronograma, tareas, gestiones, reuniones, PQR, legal, vencimientos, financiera, documentos, novedades. | Botón amarillo Ver en el listado |
| 3. Catálogos | Tipos, estados, fases, tipos de novedad, tipos de acción y catálogo de tareas/reuniones. | Icono Configuración |
| 4. Plantilla por tipo | Ítems de cronograma, documentos legales y productos financieros asociados a un tipo de proyecto. | Desde Tipo proyectos → icono calendario |
| 5. Detalle CRM | Tarea o reunión abierta desde el cronograma o pestañas. | Enlace en columna CRM o pestañas Tareas/Reuniones |
Relación con otros módulos
| Módulo | Relación |
|---|---|
| Clientes | Cada proyecto requiere un cliente. Vencimientos y facturación usan el cliente del proyecto. |
| Empleados | Participantes del proyecto, encargados/seguimiento en cronograma, autor de novedades. |
| Tareas | Pestaña Tareas y sincronización desde cronograma (módulo Tareas). |
| Reuniones | Pestaña Reuniones e ítems de tipo reunión en cronograma (módulo Reuniones). |
| Telemercadeo / Gestiones | Pestaña Gestiones: llamadas y seguimiento comercial del proyecto. |
| PQR | Pestaña Pqrs: peticiones/quejas/reclamos vinculados al proyecto. |
| Legal | Documentos legales de la plantilla del tipo; se vinculan en pestaña Legal. |
| Vencimientos | Crear vencimientos desde el proyecto; quedan en módulo Vencimientos. |
| Productos / Ventas / Pedidos | Productos en plantilla del tipo → botón crear factura; ventas vinculadas en Financiera. |
| Agenda | Calendario del proyecto con eventos y fechas clave. |
Inicio rápido
- Configuración → crear al menos un Tipo de proyecto, estados, fases y tipos de novedad.
- Tipo acciones → definir agrupadores (ej. «Diagnóstico», «Implementación»).
- Tipo tareas → Ver → catálogo global de tareas y reuniones; enlazar en Plantilla del tipo de proyecto.
- En la plantilla, opcionalmente vincule documentos legales y productos para facturación.
- Nuevo proyecto → cliente, nombre, fecha límite, tipo, estado y fase.
- Abrir ficha () → agregar participantes.
- Pestaña Cronograma → botón + «Crear desde plantilla» → editar filas (encargado, fechas, estado).
- Use las demás pestañas según el avance (tareas, reuniones, financiera, novedades).
Conceptos clave
| Término | Significado |
|---|---|
| Proyecto | Registro de trabajo para un cliente con nombre, fechas, estado, fase y tipo. |
| Tipo de proyecto | Catálogo que define plantilla de cronograma, legales y productos financieros. |
| Estado del proyecto | Situación global (pendiente, en proceso, retrasado, completado, abortado). Filtra el listado. |
| Fase | Etapa metodológica configurable (ej. «Kick-off», «Entrega»). |
| Cronograma | Lista de actividades del proyecto, generada desde plantilla o gestionada fila a fila. |
| Tipo de acción | Agrupador visual en cronograma (encabezados rojos en la tabla). |
| Tipo tarea / reunión | Ítem del catálogo global; puede ser tarea CRM o reunión CRM. |
| Encargado / Seguimiento | Participantes asignados a cada fila del cronograma (responsable y supervisor). |
| Participantes | Empleados del equipo del proyecto; solo ellos aparecen en selectores del cronograma. |
| Novedades (bitácora) | Registro cronológico de comentarios tipificados sobre el proyecto. |
| % avance | Porcentaje calculado según ítems del cronograma; se muestra en la ficha. |
Estados del proyecto
Filtros del listado (menú superior)
| Código | Etiqueta menú | Uso típico |
|---|---|---|
| 1 | Pendientes | Proyectos recién creados o aún no iniciados en operación. |
| 2 | En proceso | Proyecto activo con trabajo en curso. |
| 3 | Retrasado | Proyecto fuera de plazo o con alerta de retraso. |
| 4 | Completado | Proyecto cerrado satisfactoriamente. |
| 5 | Abortado | Proyecto cancelado o interrumpido. |
Los nombres del desplegable al crear proyecto vienen del catálogo Estados proyectos. Mantenga coherencia entre las etiquetas del menú y las del formulario.
Estados del cronograma (por fila)
| Código | Estado | Color fila |
|---|---|---|
| 1 | Pendiente | Blanco |
| 2 | Asignado | Amarillo claro |
| 3 | En proceso | Verde claro |
| 4 | Finalizada | Verde intenso |
| 5 | Cancelada | Rojo claro |
Listado de proyectos
Tabla con columnas: Cliente, Proyecto, Inicio, Fecha límite, Estado, Fase, Observaciones, Detalle.
- Botón en encabezado: mismo modal que «Nuevo proyecto» del menú.
- Columna Detalle: botón amarillo abre Ficha del proyecto.
- Si falta el tipo al guardar, verá un mensaje indicando que debe seleccionar el tipo de proyecto.
Nuevo proyecto (modal)
| Campo | Obligatorio | Notas |
|---|---|---|
| Cliente (cédula — nombre) | Sí | Select2 con todos los clientes. |
| Proyecto (nombre) | Sí | Máximo 30 caracteres. |
| Fecha límite | Sí | Fecha de entrega o cierre esperado. |
| Estado | Sí | Desde catálogo Estados proyectos. |
| Fase | Sí | Desde catálogo Fases proyectos. |
| Tipo | Sí | Desde catálogo Tipos de proyecto. Sin tipo no guarda. |
| Observaciones | No | Texto libre (brief, alcance). |
Pulse Guardar. La fecha de inicio la asigna el sistema al crear. No hay botón visible para editar datos generales tras la creación; coordine cambios mayores con el administrador.
Ficha del proyecto
Parte superior: pestañas con contadores. Parte inferior: tarjetas Datos del proyecto, Participantes y Logística (esta última reservada; puede aparecer vacía).
| Pestaña | Función |
|---|---|
| Agenda | Calendario con eventos del proyecto. |
| Cronograma | Plan de trabajo; ver sección Cronograma. |
| Tareas | Listado de tareas; botón + agrega tarea vinculada. |
| Gestiones | Gestiones telefónicas del módulo Telemercadeo. |
| Reuniones | Reuniones del proyecto. |
| Pqrs | Casos PQR asociados. |
| Legal | Documentos legales de la plantilla del tipo. |
| Vencimientos | Crear y listar vencimientos del cliente/proyecto. |
| Financiera | Facturación y ventas vinculadas. |
| Documentos | Archivos subidos al proyecto. |
| Novedades | Bitácora en línea de tiempo. |
Datos del proyecto muestra: nombre, cliente, badges de estado/fase/tipo, estado de pago, % avance, fechas y observaciones.
Participantes: botón + abre modal para agregar empleado con observaciones. Debe haber participantes antes de asignar encargados en cronograma.
Cronograma de trabajo
1. Crear desde plantilla
Botón + en encabezado del cronograma. El sistema confirma con SweetAlert y copia los ítems definidos en la plantilla del tipo de proyecto. No duplica filas ya existentes.
2. Editar una fila
Botón abre modal con: actividad, fechas, encargado, seguimiento, estado, entregable y observaciones. Al guardar con encargado asignado, puede generarse automáticamente la tarea o reunión en CRM (columna CRM).
3. Vista de agrupación
Selector «Vista»: por grupos (tipo de acción), por tipo tarea/reunión, por responsable o por estado.
4. Eliminar vs anular
- Eliminar (): solo si la fila no tiene vínculo CRM.
- Anular (): si ya hay tarea o reunión CRM; la fila pasa a Cancelada sin borrar el registro CRM.
5. Columna CRM
Enlace a Detalle de tarea o Detalle de reunión cuando el ítem está sincronizado. Si muestra «—», asigne encargado y guarde la fila.
Pestañas CRM (tareas, gestiones, reuniones, PQR)
Cada pestaña reutiliza las vistas de su módulo correspondiente, filtradas por proyecto vinculado.
- Tareas: modal «Agregar Tarea»; estados/prioridad desde modales estándar del módulo Tareas.
- Gestiones: registro de contacto telefónico vinculado al proyecto y cliente.
- Reuniones: alta y listado; coherente con ítems «reunión» del cronograma.
- Pqrs: consulta de casos PQR del proyecto; detalle del caso PQR si aplica.
Los formularios de estas pestañas se abren en ventanas modales sobre la ficha del proyecto.
Legal, vencimientos, financiera y documentos
Legal
Solo documentos definidos en la plantilla del tipo de proyecto. Formulario «Vincular al proyecto» y tabla de vinculados con enlace al módulo Legal.
Vencimientos
Requiere cliente en el proyecto. Botón + crea vencimiento asociado; el registro vive en módulo Vencimientos con enlace externo.
Financiera
Muestra cliente y productos de la plantilla del tipo. Botón + crea pedido o factura desde el proyecto. Requisitos: cliente, tipo con productos y precios > 0 en catálogo. Lista ventas vinculadas con enlace a factura o antepedido.
Documentos
Subida de archivos al proyecto. Enlace para descargar; icono papelera para eliminar un documento.
Novedades
Timeline con tipo de novedad, empleado, fecha y observaciones. Tipos configurables en Tipo novedad.
Configuración y catálogos
| Catálogo | Para qué sirve |
|---|---|
| Tipo proyectos | Tipos de servicio/proyecto; acceso a plantilla por fila. |
| Estados proyectos | Etiquetas de estado en alta de proyecto. |
| Fases proyectos | Etapas metodológicas. |
| Tipo novedad | Clasificación de entradas de bitácora. |
| Tipo tareas | Tipos de acción (agrupadores) y catálogo global de tareas/reuniones. |
Orden recomendado de implementación: acciones → tareas en catálogo → tipos de proyecto → plantilla → estados/fases/novedades.
Plantilla por tipo de proyecto
Desde Tipos de proyecto → botón calendario .
Sección cronograma
- Elija tipo de acción y marque ítems del catálogo «Tipo tareas proyecto».
- Arrastre filas para reordenar (guardado automático).
- Quitar enlace no borra el catálogo global.
Documentos legales
Vincule documentos activos del módulo Legal disponibles para este tipo.
Productos (financiera)
Vincule productos del catálogo; se usarán al crear factura desde proyectos de este tipo.
Flujo recomendado de trabajo
- Configure catálogos y plantilla del tipo «Implementación estándar» (ejemplo).
- Cree proyecto para el cliente → estado Pendientes, fase inicial.
- Agregue participantes (consultor, líder, comercial).
- Genere cronograma desde plantilla → asigne fechas y encargados.
- Avance estados del cronograma; use pestañas Tareas/Reuniones para detalle.
- Registre novedades en bitácora en hitos importantes.
- Vincule legales y cree factura en Financiera al cierre.
- Cambie filtro del listado a Completado cuando cierre el proyecto.
Permisos y acceso
El acceso al módulo depende del permiso al ítem de menú lateral en Empleados → Permisos.
No hay permisos granulares adicionales documentados solo para Proyectos: quien accede puede operar listado, ficha, cronograma y configuración según las reglas generales de su rol.
Restrinja el módulo a roles de consultoría, PMO o administración si otros usuarios no deben ver datos de clientes en proyectos.
Preguntas frecuentes
Ejemplos prácticos
Ejemplo 1 — Implementación software
Tipo «Implementación ERP» con plantilla: Diagnóstico → Capacitación → Go-live. Cliente «Distribuidora XYZ», participantes consultor + cliente interno. Cronograma desde plantilla, reuniones de kick-off y cierre en pestaña Reuniones.
Ejemplo 2 — Proyecto legal + facturación
Tipo con contrato y anexo en plantilla legal; pestaña Legal vincula documentos. Al entregar, Financiera crea pedido con productos «Licencia anual» + «Soporte».
Ejemplo 3 — Seguimiento comercial
Proyecto «Renovación 2026» en En proceso; gestiones telefónicas en pestaña Gestiones; novedades en bitácora tras cada llamada; PQR del cliente visible en pestaña Pqrs.
Buenas prácticas
- Defina tipos de proyecto y plantillas antes de que el equipo cree proyectos reales.
- Use nombres de proyecto cortos y claros (máx. 30 caracteres).
- Mantenga participantes actualizados antes de planificar cronograma.
- Registre novedades en hitos clave para trazabilidad.
- Revise pestaña Financiera al cierre para no dejar ventas sin vincular.
- Coordinar IDs de estados del catálogo con filtros 1–5 del menú.
- No elimine filas de cronograma con CRM vinculado; use Anular.