# Manual de Usuario - GanttScrum Pro

GanttScrum Pro es una plataforma corporativa para la gestión ágil e inteligente de proyectos, que combina un tablero Kanban interactivo, diagramas de Gantt dinámicos, control de hitos, y un asistente de Inteligencia Artificial (Gemini) para la confección automática de informes ejecutivos y desglose de subtareas.

---

## 1. Módulos Principales de la Aplicación

### A. Tablero Kanban (Vista Principal)
El tablero Kanban organiza las tareas del proyecto en columnas verticales correspondientes a sus estados (ej: *Pendiente*, *En Progreso*, *Bloqueado*, *Finalizado*).
*   **Crear Tarea:** Haz clic en el botón `+` en la parte superior de cualquier columna.
*   **Mover Tareas:** Arrastra y suelta (Drag and Drop) las tarjetas entre las columnas para actualizar su estado.
*   **Edición Detallada:** Haz clic sobre cualquier tarjeta de tarea para abrir el formulario modal, donde podrás configurar:
    *   **Título y Descripción:** Información del entregable.
    *   **Asignación:** Responsable de la tarea (usuario o equipo de trabajo).
    *   **Etiquetas:** Clasificadores de colores.
    *   **Fechas:** Fecha de inicio y término para el cronograma.
    *   **¿Es Hito?:** Checkbox para declarar que la tarea es un hito crítico del proyecto (asigna automáticamente la prioridad Alta).
    *   **Subtareas (Checklist):** División del trabajo con barra de progreso propia. Puedes usar el botón **"Sugerir con IA"** para que Gemini desglose los pasos técnicos automáticamente.
    *   **Precedencias:** Vincula tareas previas necesarias para poder iniciar la tarea actual.
    *   **Adjuntos:** Sube archivos de soporte técnico.
    *   **Observaciones:** Historial de comentarios del equipo de desarrollo.

### B. Diagrama de Gantt
Muestra la línea de tiempo interactiva del proyecto utilizando el motor DHTMLX Gantt.
*   **Hitos Visuales:** Se identifican como **diamantes púrpuras** en su fecha de término con un icono de bandera `🚩` en el nombre de la grid izquierda.
*   **Tareas e Hijos:** Muestra tareas padre y sus subtareas anidadas de forma jerárquica.
*   **Vínculos de Dependencia:** Arrastra círculos en los extremos de las barras para crear dependencias de fin a inicio de forma visual.
*   **Auto-Programación:** Si una tarea predecesora se retrasa, las tareas dependientes se reprogramarán de forma automática para evitar colisiones de fechas.
*   **Línea Base (Baseline):** Permite congelar el cronograma inicial mediante el botón **"Capturar"** en la barra de herramientas. Al activar el switch **"Línea Base"**, se proyecta una barra gris debajo de las tareas activas para comparar visualmente las desviaciones de tiempo respecto a la planificación original.
*   **Ruta Crítica (Critical Path):** Al activar el switch **"Ruta Crítica"**, un solucionador algorítmico matemático (CPM) resalta en color rojo las tareas y enlaces consecutivos que definen la fecha mínima de finalización del proyecto y que no tienen margen de holgura.
*   **Exportación:** Botones para descargar la carta Gantt directamente a PDF o a una hoja de Excel.

### C. Hoja de Ruta Multitemática (Roadmap)
Es una herramienta estratégica para planificar el proyecto en base a 6 tópicos clave:
1.  **Objetivos Estratégicos:** Metas principales.
2.  **Entregables Clave:** Qué se va a entregar.
3.  **Estrategia de Ejecución:** Metodología y pasos.
4.  **Recursos e Infraestructura:** Presupuesto, hardware, licencias.
5.  **Plazos e Hitos:** Fechas objetivo principales.
6.  **Stakeholders:** Interesados y canales de comunicación.

Al abrir la Hoja de Ruta (botón en la barra lateral), puedes:
*   Redactar manualmente cada sección.
*   Presionar **"Sugerir con IA (Gemini)"** para que la inteligencia artificial analice tu Kanban y redacte propuestas estratégicas.
*   **Guardar Versión:** Genera un snapshot histórico para no perder el borrador activo.
*   **Exportar a Word:** Descarga la versión activa a un archivo `.doc` imprimible.

### D. Generación de Informes Premium
Genera resúmenes ejecutivos corporativos combinando las métricas en tiempo real de tu Kanban con la Hoja de Ruta:
*   **Avance Físico vs. Avance de Esfuerzo:** Mide el progreso general según tareas completadas vs. Story Points (puntos de esfuerzo) completados.
*   **Alertas de Planificación:** Identifica de forma automática tareas atrasadas, bloqueadas, o prontas a vencer.
*   **Carga de Trabajo:** Distribución de tareas y Story Points planificados vs. completados por cada desarrollador.
*   **Gestión de Recursos y Costos:** Si el switch **"Incluir Resumen de Recursos y Costos"** está activo, se anexa un bloque verde que resume el presupuesto total planificado vs. el costo devengado (tareas completadas) y las horas-hombre (H-H) estimadas de desarrollo.
*   **Semaforización de Hitos:** Cuadro de mando visual (Verde: finalizado, Amarillo: en progreso, Rojo: no iniciado o atrasado).
*   **Gemini AI Synthesis:** Genera un reporte detallado con análisis de riesgos y plan de mitigación en segundos.
*   **Respaldar Informe:** Guarda el informe consolidado (incluyendo el texto de la IA) en un historial persistente.
*   **Exportación:** Permite imprimir a PDF o descargar a Word desde la pantalla de previsualización o desde el historial de respaldos.

---

## 2. Roles y Permisos de Usuarios
La aplicación cuenta con tres niveles de roles asignables por el administrador:
*   **Administrador / Project Manager:** Acceso total, puede crear y editar proyectos, tareas, respaldos, hitos y configuraciones del sistema.
*   **Desarrollador:** Puede crear y modificar tareas del tablero Kanban y diagramas Gantt del proyecto asignado.
*   **Visualizador:** Acceso de sólo lectura. Puede ver el tablero, Gantt, reportes y exportarlos, pero no realizar modificaciones, arrastres ni guardados.