Bienvenido al módulo de Programación de Proyecto de QOSTUM, la herramienta especializada para planificar y controlar el cronograma de proyectos de construcción.
Este manual le guiará a través de todas las funcionalidades del sistema: desde la importación de presupuestos hasta la generación del diagrama de Gantt, ruta crítica y programación financiera del proyecto.
Importante: Este manual corresponde a la versión 1.0 del módulo de Programación. El módulo se integra con el módulo de Presupuestos de QOSTUM para importar estructura, costos y tareas.
Esta guía rápida le permite crear su primera programación de proyecto en cinco pasos.
Paso 1: Importe su presupuesto
Vaya a Archivo → Abrir Presupuesto y seleccione el archivo .json exportado desde QOSTUM Presupuestos. Se abrirá un panel de configuración.
Paso 2: Configure fecha y jornada
En el panel de importación, establezca la fecha de inicio del proyecto y la jornada laboral (5, 6 o 7 días por semana). Seleccione la profundidad de importación (normalmente 2 niveles: capítulos y partidas) y una duración por defecto para las tareas (por ejemplo, 10 días). Haga clic en Importar.
Paso 3: Ajuste las duraciones
Haga clic en la celda de Duración de cada tarea hoja y escriba la duración real estimada en días hábiles. Presione Enter para confirmar. Las fechas se recalcularán automáticamente.
Paso 4: Defina las dependencias
Haga clic en la celda Pred. de una tarea y escriba el código WBS de la tarea que debe finalizar antes. Puede ingresar varias separadas por coma (ej: 1.1, 1.2). El diagrama mostrará las flechas de dependencia automáticamente.
Paso 5: Analice y exporte
Active la Ruta Crítica para identificar las tareas que controlan el plazo
Abra Herramientas → Programación del Proyecto para ver la distribución de costos en el tiempo
Exporte el diagrama a PDF desde Archivo → Exportar PDF
Guarde su trabajo con el botón Guardar (esquina superior derecha)
¡Listo! Ya tiene su primera programación de proyecto. Continúe leyendo las secciones siguientes para dominar todas las funcionalidades del sistema.
SECCIÓN 2
Introducción y Conceptos Básicos
¿Qué es la Programación de Proyecto?
El módulo de Programación de QOSTUM permite crear diagramas de Gantt profesionales a partir de un presupuesto de construcción. Transforma la estructura de costos en un cronograma visual que muestra cuándo se ejecutará cada actividad, sus dependencias y la distribución de costos en el tiempo.
Características Principales
Importación desde Presupuesto: Cargue un archivo de presupuesto QOSTUM (.json) y conviértalo automáticamente en un diagrama de Gantt
Diagrama de Gantt Interactivo: Visualice tareas, duraciones y dependencias en una línea de tiempo
Estructura WBS: Numeración jerárquica automática (EDT - Estructura de Desglose de Trabajo)
Ruta Crítica (CPM): Identifique las tareas que determinan la duración total del proyecto
Programación Financiera: Distribución del costo del proyecto por período (día, semana o mes)
Hitos: Marque eventos clave del proyecto con duración cero
Vista General: Panorámica completa del proyecto con navegación rápida
Exportación: Genere PDFs del diagrama y exporte la programación financiera a Excel
Conceptos Clave
Estructura WBS (EDT)
La WBS (Work Breakdown Structure), conocida en español como EDT (Estructura de Desglose de Trabajo), organiza las tareas del proyecto en una jerarquía numérica. Cada tarea recibe un código único que refleja su posición dentro de la estructura:
Nivel
Ejemplo WBS
Descripción
Capítulo
1
Agrupación principal (ej: Proyectos Preliminares)
Partida
1.1
Actividad dentro de un capítulo (ej: Limpieza del terreno)
Sub-partida
1.1.1
Detalle de una partida (ej: Chapeo y destronque)
Ejemplo: En un proyecto con WBS 2.3, el 2 indica el segundo capítulo (ej: Cimentación) y el 3 indica la tercera partida dentro de ese capítulo (ej: Cimiento corrido). Esta numeración se genera automáticamente al importar el presupuesto.
Tipos de Tareas
Tipo
Descripción
Representación en el diagrama
Duración
Tarea resumen
Agrupa tareas hijas (capítulos)
Barra fina con extremos triangulares
Automática (abarca todas sus hijas)
Tarea hoja
Actividad ejecutable (partidas)
Barra de color sólido
Editable en días hábiles
Hito
Evento puntual sin duración
Rombo (◊)
Cero (marca una fecha)
Días Hábiles vs Días Calendario
La programación trabaja exclusivamente con días hábiles. Usted configura qué días de la semana son laborables (lunes a viernes, lunes a sábado, etc.) y el sistema calcula automáticamente las fechas de inicio y fin excluyendo los días no laborables. Además de la jornada semanal, el proyecto puede registrar feriados (manuales o por país), que tampoco cuentan como días hábiles (ver "Feriados por País" en la sección de importación).
Ejemplo práctico: Una tarea de 10 días hábiles que inicia un lunes con jornada Lun-Vie terminará el viernes de la segunda semana (10 días hábiles = 14 días calendario). Si la jornada fuera Lun-Sáb, terminaría el miércoles de la segunda semana (10 días hábiles = 12 días calendario).
Relación con el Presupuesto
El módulo de Programación se alimenta del módulo de Presupuestos. Al importar un presupuesto, el sistema:
Convierte capítulos en tareas resumen
Convierte partidas en tareas hoja con el costo del presupuesto
Preserva la moneda, el nombre del proyecto y la estructura jerárquica
Importante: Al importar un presupuesto, configure correctamente la jornada laboral desde el inicio. Cambiarla después recalculará todas las fechas del proyecto, lo cual puede ser intencional pero también podría afectar dependencias que ya estaban ajustadas.
SECCIÓN 3
Interfaz de Usuario
Diseño General
La interfaz se divide en áreas funcionales diseñadas para ofrecer máxima eficiencia al programar proyectos de construcción. De arriba hacia abajo: barra de menú, barra de herramientas, panel de tareas (izquierda) + diagrama de Gantt (derecha), y barra de estado inferior.
1. Barra de Menú Superior
Contiene los menús principales del sistema:
Archivo: Importar presupuesto, abrir/guardar programaciones y exportar PDF del diagrama
Herramientas: Expandir/contraer tareas, agregar tareas manuales e hitos, eliminar tareas, ir a la fecha de hoy y acceder a la Programación del Proyecto
Manual: Acceso a esta guía de uso
Dashboard: Volver al panel principal de QOSTUM
Botón Guardar: Botón verde en la esquina derecha. Guarda la programación actual en un archivo JSON
2. Barra de Herramientas
Barra interactiva debajo del menú con los controles de uso más frecuente:
Control
Función
Fecha de inicio
Selector de calendario para la fecha de inicio del proyecto. Al cambiarla, todas las tareas se recalculan
Jornada laboral
Configurar días hábiles: Lun-Vie, Lun-Sáb, Diario, o una combinación personalizada con casillas individuales por día. Sábado permite elegir día completo o medio día
Zoom (Día / Sem / Mes)
Cambiar la escala temporal del diagrama. Sem (semana) es la vista recomendada
Hoy
Desplazar la línea de tiempo para centrar la fecha actual en la pantalla
+ Todo / − Todo
Expandir o contraer todas las tareas resumen de un solo clic
Ruta Crítica
Botón toggle: activa/desactiva el cálculo y resaltado en rojo de las tareas críticas
Vista General
Abre un canvas panorámico con todo el proyecto miniaturizado
Presupuesto total
Insignia que muestra el costo total del proyecto y la moneda (ej: GTQ 2,450,000)
3. Panel Lateral de Tareas (Tabla)
Tabla a la izquierda que muestra la lista completa de tareas. Las columnas disponibles son:
Columna
Descripción
Editable
WBS
Código jerárquico de la Estructura de Desglose de Trabajo
No
Nombre
Descripción de la tarea
Sí (clic derecho → Editar nombre)
Duración
Duración en días hábiles
Sí (solo tareas hoja)
Inicio
Fecha de inicio calculada
No (se calcula automáticamente)
Fin
Fecha de finalización calculada
No (se calcula automáticamente)
Pred.
Códigos WBS de tareas predecesoras, separados por coma
Sí (clic en la celda)
Costo
Costo de la tarea en la moneda del proyecto
No (proviene del presupuesto)
Personalizar columnas visibles: Haga clic derecho sobre el encabezado de la tabla. Aparecerá un menú con casillas para mostrar u ocultar cada columna (WBS, Duración, Inicio, Fin, Pred., Costo). Esta configuración se guarda junto con la programación.
4. Área del Diagrama de Gantt
Zona principal a la derecha que muestra la representación gráfica de la programación:
Encabezados de tiempo: Muestran las fechas según el nivel de zoom seleccionado
Barras de tareas: Representan la duración de cada actividad; su ancho es proporcional al tiempo
Flechas de dependencia: Conectan el fin de la predecesora con el inicio de la sucesora
Línea de hoy: Indicador vertical de la fecha actual (si está dentro del rango visible)
Hitos: Representados como rombos (◊) en la fecha correspondiente
5. Separador Redimensionable
Arrastre el borde derecho del encabezado "Nombre" para ajustar el ancho de la columna de nombres y, con ello, la proporción entre la tabla de tareas y el diagrama de Gantt.
6. Información Emergente (Tooltip)
Al posicionar el cursor sobre una barra de tarea en el diagrama, se muestra un tooltip con información detallada:
Nombre y código WBS de la tarea
Fechas de inicio y fin
Duración en días hábiles
Costo asignado
Indicador de si pertenece a la ruta crítica
7. Barra de Estado Inferior
Muestra información resumida del proyecto en todo momento:
Tareas: Número total (tareas hoja + tareas resumen)
Duración total: Días hábiles del proyecto completo
Inicio: Fecha de inicio del proyecto
Fin: Fecha de finalización calculada
Ruta Crítica: Cantidad de tareas críticas (solo visible cuando la ruta crítica está activa)
SECCIÓN 4
Importar un Presupuesto
La forma principal de crear una programación es importando un presupuesto de QOSTUM. Esto convierte automáticamente la estructura de costos en tareas del diagrama de Gantt, preservando la jerarquía, moneda y costos.
Pasos para Importar
Vaya al menú Archivo → Abrir Presupuesto
Seleccione el archivo .json exportado desde el módulo de Presupuestos de QOSTUM
Se abrirá el panel de configuración de importación con opciones para personalizar cómo se crearán las tareas
Configuración de Importación
Nombre del Proyecto
Se toma automáticamente del presupuesto. Puede modificarlo antes de importar. Este nombre aparecerá en las exportaciones a PDF y en la barra de estado.
Fecha de Inicio
Seleccione la fecha en que iniciará el proyecto. Todas las tareas sin predecesoras se programarán a partir de esta fecha. Asegúrese de seleccionar un día hábil según la jornada configurada.
Jornada Laboral
Seleccione los días de trabajo de la semana:
Opción
Días
Uso típico
5 días
Lunes a viernes
Oficinas, proyectos urbanos con restricción de ruido
6 días
Lunes a sábado
Construcción estándar en Latinoamérica
7 días
Todos los días
Proyectos urgentes, turnos continuos
Consejo: En Centroamérica es común trabajar 6 días (Lun-Sáb). Si su proyecto trabaja sábado medio día, puede configurarlo en la barra de herramientas después de la importación usando la opción de jornada personalizada.
Feriados por País
La configuración de días laborales incluye la lista de feriados del proyecto: alta manual (fecha + descripción) y carga de 1 clic de los feriados nacionales 2026–2027 de 16 países (Guatemala, México, Honduras, Nicaragua, Costa Rica, Panamá, República Dominicana, Colombia, Perú, Bolivia, Chile, Argentina, Paraguay, Uruguay, Ecuador y El Salvador), con la posibilidad de quitar los que no apliquen. Los feriados no cuentan como días hábiles, se sombrean en el cronograma como los fines de semana, se guardan con el proyecto y recalculan las fechas al cambiar.
Profundidad de Importación
Controla hasta qué nivel de la jerarquía se importarán los elementos (1 a 5 niveles):
Nivel 1: Solo capítulos (pocas tareas, visión macro)
Nivel 2: Capítulos y partidas (recomendado para programación general)
Nivel 3+: Incluye sub-partidas e insumos (muy detallado, solo para proyectos pequeños)
Recomendación: Use profundidad 2 para la mayoría de los proyectos. Un exceso de detalle hace que el diagrama sea difícil de leer y gestionar. Puede agregar tareas adicionales manualmente después de la importación.
Duración por Defecto
Asigna una duración inicial (en días hábiles) a todas las tareas hoja. Este valor es un punto de partida; ajuste cada tarea después según la estimación real.
Resultado de la Importación
Después de importar, el sistema automáticamente:
Crea la estructura WBS basada en la jerarquía del presupuesto
Asigna las duraciones por defecto configuradas
Calcula fechas de inicio y fin para cada tarea
Genera el diagrama de Gantt
Muestra el costo total del proyecto en la barra de herramientas
Actualizar desde el Presupuesto sin Perder la Programación
Si llega un presupuesto (botón "Enviar a Programación" de Presupuestos o importación del archivo) y ya hay un proyecto cargado, el sistema ofrece dos opciones:
Reemplazar todo: descarta la programación actual y crea el proyecto de cero, como una importación normal.
Actualizar conservando programación: las partidas emparejadas conservan fechas, duración, dependencias y avance (se actualizan costos y descripciones); las nuevas entran al final de su capítulo con la insignia ámbar "Nueva" (desaparece al programarlas); las que ya no están en el presupuesto NO se borran: quedan con la insignia "Ya no está en el presupuesto" para decidir su destino.
Al final se muestra un resumen del cambio (X actualizadas / Y nuevas / Z retiradas). Las líneas base se conservan; si no existía ninguna, se congela una línea base 0 automática con el estado previo al cambio.
Ejemplo: Importar un Edificio Residencial
Suponga que tiene un presupuesto con esta estructura:
Código
Descripción
Costo
CAP-01
Proyectos Preliminares
—
PAR-01
Limpieza y chapeo
GTQ 22,200
PAR-02
Trazo y nivelación
GTQ 31,250
CAP-02
Cimentación
—
PAR-03
Excavación estructural
GTQ 45,300
PAR-04
Zapatas aisladas
GTQ 78,500
Al importar con profundidad 2, fecha 03/Mar/2026 y 10 días por defecto, se obtiene:
WBS
Tarea
Tipo
Dur.
Inicio
Fin
Costo
1
Proyectos Preliminares
Resumen
20
03-Mar
28-Mar
—
1.1
Limpieza y chapeo
Hoja
10
03-Mar
14-Mar
GTQ 22,200
1.2
Trazo y nivelación
Hoja
10
03-Mar
14-Mar
GTQ 31,250
2
Cimentación
Resumen
20
03-Mar
28-Mar
—
2.1
Excavación estructural
Hoja
10
03-Mar
14-Mar
GTQ 45,300
2.2
Zapatas aisladas
Hoja
10
03-Mar
14-Mar
GTQ 78,500
Note que todas las tareas inician el mismo día porque aún no se han definido dependencias. El siguiente paso es establecer la secuencia constructiva correcta.
Error común: Olvidar definir las dependencias después de importar. Sin dependencias, todas las tareas aparecen en paralelo desde el día 1, lo cual no refleja la realidad del proyecto. Dedique tiempo a establecer la lógica de secuencia constructiva.
SECCIÓN 5
Gestión de Tareas
Seleccionar una Tarea
Haga clic en cualquier fila de la tabla de tareas para seleccionarla. La tarea seleccionada se resaltará visualmente tanto en la tabla como en el diagrama de Gantt, facilitando su identificación.
Editar el Nombre de una Tarea
Haga clic derecho sobre la tarea en la tabla
Seleccione “Editar nombre” en el menú contextual
Modifique el texto directamente en la celda
Presione Enter para confirmar o Escape para cancelar y restaurar el nombre original
Editar la Duración
Haga clic en la celda de Duración de una tarea hoja
Ingrese el nuevo valor en días hábiles
Presione Enter para confirmar
El sistema recalculará automáticamente la fecha de fin de la tarea, la duración de sus tareas resumen (padres), y las fechas de todas las tareas que dependan de ella directa o indirectamente.
Nota: Las tareas resumen calculan su duración automáticamente, abarcando desde el inicio más temprano hasta el fin más tardío de sus tareas hijas. No es posible editar su duración directamente.
Calculadora de Duración por Rendimiento
QOSTUM permite calcular la duración de una tarea con base en una fórmula simple:
duración = cantidad ÷ rendimiento
Así queda registrado por qué la tarea dura lo que dura, y puede ajustarse en cualquier momento sin perder la trazabilidad. Los recursos asignados se anotan al lado como referencia, pero no entran en la fórmula.
Abrir la calculadora
Haga doble clic sobre la celda de Duración de cualquier tarea hoja. Se abrirá el modal Calcular duración por rendimiento con el WBS y el nombre de la tarea visibles en un banner. Las tareas con cálculo activo se distinguen porque su duración aparece resaltada en color naranja.
Cantidad de proyecto
Es la magnitud a ejecutar (200 m², 80 m³, 60 puntos, etc.).
Si la tarea viene de un presupuesto QOSTUM: la cantidad y unidad se llenan automáticamente y aparecen como solo lectura, con la nota “Cantidad tomada del presupuesto”.
Si la tarea es manual o no tiene partida vinculada: el usuario debe ingresar la cantidad y la unidad para que la calculadora pueda derivar el rendimiento.
Rendimiento ↔ Duración
Son dos campos enlazados. Cambia uno y el otro se ajusta automáticamente para mantener la fórmula:
Si edita el rendimiento (por ejemplo de 16 a 32 m²/día), la duración se acorta a la mitad.
Si edita la duración (por ejemplo de 25 a 10 días), el rendimiento sube proporcionalmente.
Cuando se abre la calculadora por primera vez, QOSTUM sugiere el rendimiento esperado derivado de la duración actual del Gantt. Por ejemplo, si la tarea es de 50 m² y dura 25 días, el rendimiento sugerido es 2 m²/día. El usuario puede ajustar cualquiera de los dos.
Recursos considerados (referencia)
Lista editable de los recursos que el usuario consideró al hacer el presupuesto. Cada fila lleva tipo (MDO, MAT, EQU, etc.), nombre, cantidad y unidad.
Importante: los recursos son solo nota. No afectan el cálculo de duración ni el rendimiento. Sirven para que más adelante usted recuerde cuáles tenía en mente al programar la tarea.
Traer del presupuesto
Si la tarea proviene de una partida del presupuesto importado, aparece el botón Traer del presupuesto. Al pulsarlo, QOSTUM rellena automáticamente:
La cantidad y unidad de la partida.
Los insumos del APU (mano de obra, maquinaria, equipo, subcontratos, herramienta, renta) como recursos de referencia.
Cambiar la duración con cálculo activo
Si edita la duración directamente en la tabla mientras la tarea tiene un cálculo activo, QOSTUM le pregunta:
Reajustar rendimiento — conserva la cantidad, adapta el rendimiento para que cuadre con la nueva duración.
Desconectar cálculo — deja la duración manual y desactiva el cálculo (los datos quedan guardados pero ya no afectan la duración).
Cancelar — descarta el cambio y restaura el valor anterior.
Uso práctico: ¿Cuánto se acortaría la tarea si la cuadrilla rinde más? Abra el modal, suba el rendimiento y vea la nueva duración al instante. Aplique al Gantt y todas las tareas dependientes se reacomodarán.
Editar Predecesoras
Haga clic en la celda de la columna Pred.
Ingrese los códigos WBS de las tareas predecesoras, separados por coma
Presione Enter para confirmar
Ejemplo: 1.1, 1.2 indica que la tarea no puede iniciar hasta que las tareas 1.1 y 1.2 hayan finalizado.
Precaución: Si ingresa un código WBS que no existe, el sistema lo descartará silenciosamente. Verifique que los códigos sean correctos. Tampoco cree dependencias circulares (A depende de B, y B depende de A).
Agregar Tareas Manuales
Además de las tareas importadas del presupuesto, puede crear tareas adicionales:
Vaya al menú Herramientas → Agregar tarea
Ingrese el nombre de la tarea
Seleccione la referencia WBS (la tarea se ubicará como hermana de esa referencia)
Elija si desea agregarla antes o después de la referencia
Ingrese la duración en días hábiles
Haga clic en Agregar
Uso práctico: Las tareas manuales son útiles para agregar actividades que no están en el presupuesto pero sí afectan el cronograma: trámites de permisos, tiempos de curado, entregas de materiales, inspecciones, etc.
Agregar Hitos
Los hitos representan eventos importantes del proyecto con duración cero:
Vaya al menú Herramientas → Agregar hito
Ingrese el nombre del hito (ej: “Entrega de cimentación”, “Aprobación de planos”)
Seleccione la referencia WBS y posición
Haga clic en Agregar
Los hitos se representan como un rombo (◊) en el diagrama de Gantt. Puede asignarles predecesoras para que su fecha se calcule automáticamente.
Eliminar Tareas
Seleccione la tarea haciendo clic sobre ella
Vaya al menú Herramientas → Eliminar tarea
Si la tarea es resumen y tiene hijas, el sistema le advertirá cuántas tareas se eliminarán en cascada
Confirme la eliminación
Advertencia: Al eliminar una tarea, todas las referencias a ella como predecesora en otras tareas se limpian automáticamente. Esto puede provocar que tareas sucesoras se reubiquen al inicio del proyecto. Revise las dependencias después de eliminar.
Expandir y Contraer Tareas
Las tareas resumen pueden expandirse o contraerse para mostrar u ocultar sus tareas hijas:
Individualmente: Haga clic en el triángulo (▸ / ▾) junto al nombre de la tarea resumen
Todas a la vez: Use los botones + Todo (expandir) o − Todo (contraer) en la barra de herramientas, o desde Herramientas → Expandir todo / Contraer todo
Consejo: Contraiga las tareas resumen para obtener una visión macro del proyecto y expanda solo los capítulos que necesite revisar en detalle.
SECCIÓN 6
El Diagrama de Gantt
Niveles de Zoom
El diagrama ofrece tres niveles de zoom para visualizar el cronograma a diferentes escalas:
Vista general, proyectos medianos (2-18 meses). Recomendado
Mes
Un mes por columna (Ene, Feb...)
Panorámica, proyectos largos (> 1 año)
Representación Visual de las Tareas
Tareas hoja: Barras de color sólido cuyo ancho es proporcional a la duración. El nombre de la tarea puede aparecer dentro o junto a la barra
Tareas resumen: Barras más finas con extremos triangulares que abarcan desde la primera hasta la última tarea hija
Hitos: Rombos (◊) que marcan un evento puntual
Tareas críticas: Se resaltan en rojo cuando la ruta crítica está activada
Flechas de Dependencia
Las flechas van desde el final de la tarea predecesora hasta el inicio de la tarea sucesora. La relación es Fin-Comienzo (FC): la sucesora no puede iniciar hasta que la predecesora haya finalizado.
Navegación en el Diagrama
Scroll horizontal: Desplácese a lo largo de la línea de tiempo
Scroll vertical: Desplácese a lo largo de la lista de tareas (sincronizado entre tabla y diagrama)
Botón “Hoy”: Centra el diagrama en la fecha actual
Consejo: Si el proyecto es muy largo y la navegación es lenta, cambie al zoom de Mes para desplazarse rápidamente, luego vuelva a Semana para el detalle.
SECCIÓN 7
Dependencias y Predecesoras
¿Qué son las Dependencias?
Las dependencias definen el orden en que deben ejecutarse las tareas. Una tarea con predecesoras no puede iniciar hasta que todas sus predecesoras hayan finalizado. Esto es fundamental para modelar correctamente la secuencia constructiva de un proyecto.
Tipo de Relación: Fin-Comienzo (FC)
QOSTUM utiliza la relación Fin-Comienzo (FC), la más utilizada en la programación de proyecto:
Fecha Inicio (sucesora) = Máximo( Fecha Fin (predecesora₁), Fecha Fin (predecesora₂), ... ) + 1 día hábil
Si una tarea tiene múltiples predecesoras, su inicio se determina por la que termine más tarde.
Cómo Definir Predecesoras
Localice la tarea sucesora en la tabla
Haga clic en la celda de la columna Pred.
Ingrese los códigos WBS de las predecesoras, separados por coma
Presione Enter para confirmar
Efecto en el Cálculo
Al establecer o modificar dependencias:
La fecha de inicio de la tarea se ajusta automáticamente
Se dibujan flechas de dependencia en el diagrama
Las tareas resumen se recalculan para abarcar a todas sus hijas
La ruta crítica se actualiza (si está activa)
La barra de estado muestra la nueva duración total del proyecto
Ejemplo Práctico: Secuencia Constructiva
Considere las primeras actividades de un edificio residencial:
WBS
Tarea
Dur.
Pred.
Lógica constructiva
1.1
Limpieza del terreno
5
—
Primera actividad, inicia con el proyecto
1.2
Trazo y nivelación
3
1.1
Requiere terreno limpio
1.3
Bodega provisional
4
1.1
Requiere terreno limpio (en paralelo con trazo)
2.1
Excavación estructural
12
1.2
Requiere trazo completo
2.2
Zapatas aisladas
15
2.1
Requiere excavación lista
2.3
Cimiento corrido
10
2.1
En paralelo con zapatas (diferentes zonas)
Observe que las tareas 1.2 y 1.3 pueden ejecutarse en paralelo porque ambas dependen únicamente de 1.1. De igual forma, 2.2 y 2.3 son paralelas. En cambio, 2.1 depende de 1.2 y forma una cadena secuencial. Modelar correctamente estas relaciones es lo que permite obtener una ruta crítica realista.
Regla general: Solo establezca dependencias donde exista una restricción real. “¿La tarea B realmente no puede iniciar hasta que A termine?” Si la respuesta es no (porque trabajan en zonas distintas o con recursos diferentes), no las vincule. Dependencias innecesarias alargan artificialmente el proyecto.
Cuidado con las dependencias circulares: Si la tarea A depende de B, y B depende de A, se crea un bucle imposible de resolver. El sistema validará las predecesoras, pero es responsabilidad del usuario asegurar una lógica coherente.
SECCIÓN 8
Ruta Crítica (CPM)
¿Qué es la Ruta Crítica?
La Ruta Crítica (Critical Path Method - CPM) identifica la secuencia más larga de tareas dependientes que determina la duración mínima del proyecto. Las tareas en la ruta crítica no pueden retrasarse sin afectar la fecha de finalización del proyecto.
Activar la Ruta Crítica
Haga clic en el botón “Ruta Crítica” en la barra de herramientas
Las tareas críticas se resaltarán en rojo en el diagrama
La barra de estado mostrará el número de tareas críticas
Para desactivar, haga clic nuevamente en el botón
Cómo Funciona el Cálculo
El algoritmo CPM realiza dos pasadas sobre la red de tareas:
Pasada hacia adelante (Forward Pass)
Recorre las tareas desde el inicio del proyecto calculando:
ES (Early Start): La fecha más temprana en que puede iniciar la tarea
EF (Early Finish): ES + Duración
Pasada hacia atrás (Backward Pass)
Recorre las tareas desde el fin del proyecto calculando:
LF (Late Finish): La fecha más tardía en que puede terminar sin retrasar el proyecto
LS (Late Start): LF − Duración
Holgura (Slack / Float)
Holgura = LS - ES = LF - EF
Si Holgura = 0 → La tarea es CRÍTICA (no admite retraso)
Si Holgura > 0 → La tarea tiene margen de días para retrasarse
Ejemplo Numérico Completo
Usando el ejemplo de la sección anterior (con fecha de inicio día 0):
WBS
Tarea
Dur.
Pred.
ES
EF
LS
LF
Holgura
¿Crítica?
1.1
Limpieza
5
—
0
5
0
5
0
Sí
1.2
Trazo
3
1.1
5
8
5
8
0
Sí
1.3
Bodega
4
1.1
5
9
16
20
11
No
2.1
Excavación
12
1.2
8
20
8
20
0
Sí
2.2
Zapatas
15
2.1
20
35
20
35
0
Sí
2.3
Cimiento
10
2.1
20
30
25
35
5
No
Ruta crítica: 1.1 → 1.2 → 2.1 → 2.2 (35 días). La tarea “Bodega” tiene 11 días de holgura y “Cimiento corrido” tiene 5 días. Si la excavación se retrasa 1 día, todo el proyecto se retrasa 1 día. En cambio, la bodega puede retrasarse hasta 11 días sin afectar el plazo total.
Interpretación Práctica
Tareas críticas (rojo): Asigne los mejores recursos, supervise de cerca, tenga planes de contingencia
Tareas con holgura: Puede reasignar recursos temporalmente a tareas críticas sin afectar el plazo final
Muchas tareas críticas: Revise si hay dependencias excesivas. Un proyecto donde todo es crítico es frágil
Consejo: Concentre sus esfuerzos de supervisión y control en las tareas de la ruta crítica. Si necesita acelerar el proyecto, reduzca la duración de una tarea crítica (agregando recursos, horas extra, etc.).
Aplicación real: Si en una reunión de proyecto le dicen “la excavación se va a retrasar 3 días”, revise si esa tarea está en la ruta crítica. Si lo está, el proyecto se retrasará 3 días a menos que compense en otra tarea crítica. Si no lo está, verifique que el retraso no exceda su holgura.
SECCIÓN 9
Programación del Proyecto
¿Qué es?
La Programación del Proyecto es una herramienta de control financiero que distribuye el costo del presupuesto a lo largo del tiempo. Muestra cuánto dinero se consumirá en cada período según la duración programada de cada tarea. Es esencial para elaborar flujos de caja, solicitar anticipos y controlar el avance presupuestal.
Acceso
Vaya al menú Herramientas → Programación del Proyecto. Se abrirá un panel modal con la tabla de distribución de costos.
Vistas Disponibles
Vista
Columnas
Ejemplo de encabezado
Recomendado para
Día
Un día hábil por columna
Lun 02 Mar
Proyectos cortos (< 1 mes)
Semana
Una semana por columna
Sem 1 (02-07 Mar)
Proyectos medianos (1-12 meses)
Mes
Un mes por columna
Mar 2026
Proyectos largos (> 1 año)
Contenido de la Tabla
Filas de tareas: Solo se muestran tareas hoja con costo > 0. Cada celda muestra el monto prorrateado para ese período
TOTAL PERÍODO: Suma de los costos de todas las tareas en cada período
ACUMULADO: Costo acumulado desde el inicio hasta cada período, con indicadores:
% tiempo: Días hábiles consumidos / Días hábiles totales del proyecto
% costo: Costo acumulado / Presupuesto total del proyecto
Cálculo de Prorrateo
Tasa diaria = Costo de la tarea / Días hábiles de duración
Costo en período = Tasa diaria × Días hábiles de la tarea en ese período
Ejemplo Numérico
Suponga dos tareas con jornada Lun-Vie e inicio 02 Mar 2026:
Tarea
Costo
Dur.
Tasa diaria
Sem 1
Sem 2
Sem 3
1.1 Limpieza
GTQ 22,200
10
GTQ 2,220
GTQ 11,100
GTQ 11,100
—
1.2 Trazo
GTQ 31,250
5
GTQ 6,250
—
GTQ 18,750
GTQ 12,500
Sem 1
Sem 2
Sem 3
TOTAL PERÍODO
GTQ 11,100
GTQ 29,850
GTQ 12,500
ACUMULADO
GTQ 11,100
GTQ 40,950
GTQ 53,450
% costo
20.8%
76.6%
100%
La tarea 1.2 inicia en Sem 2 porque depende de 1.1 (que dura 10 días = 2 semanas). Se puede ver que la Sem 2 tiene la mayor concentración de costos (GTQ 29,850) porque ambas tareas están activas simultáneamente.
Interpretación de los Porcentajes
Comparación % tiempo vs % costo: Si al 50% del tiempo transcurrido el costo acumulado es del 60%, el proyecto está consumiendo presupuesto más rápido de lo programado. Esto puede ser normal (muchas actividades costosas al inicio) o una señal de alerta si no era lo esperado.
Exportar la Programación
Desde el panel puede exportar en dos formatos:
PDF: Documento con encabezado del proyecto, tabla completa, totales, acumulados y porcentajes
Excel: Hoja de cálculo con formato numérico, ideal para análisis adicionales y gráficas de curva S
Uso práctico: Exporte a Excel para crear la curva S del proyecto (gráfica del costo acumulado vs tiempo). Es una herramienta estándar en la industria para reportar avance financiero a clientes y supervisores.
SECCIÓN 9.5
Recursos del Proyecto
El botón Recursos en la barra de herramientas abre un índice consolidado de todos los recursos que usted anotó como referencia en las tareas con cálculo de duración activo (ver Sección 5). Sirve para revisar de un vistazo qué recursos consideró a lo largo del proyecto, sin tener que abrir cada tarea por separado.
Índice de referencia, no demanda exacta. QOSTUM no calcula la cantidad simultánea ni los totales acumulados de cada recurso a lo largo del proyecto. Las cantidades que ve son las que usted escribió en cada tarea: pueden representar trabajadores en paralelo, cantidad por unidad de proyecto (al estilo APU), o cualquier otra magnitud. Por eso, sumar a través de tareas no tendría un significado preciso.
Acceso
Haga clic en el botón Recursos de la barra de herramientas. Se abre el modal Recursos del proyecto con la lista consolidada.
Requisito: el modal solo muestra datos cuando hay al menos una tarea con cálculo de duración activo y al menos un recurso anotado. Si no, aparece un mensaje invitándole a hacerlo desde la celda de Duración de cada tarea.
Estructura del modal
Tres indicadores arriba
Recursos distintos: cuántos nombres únicos de recursos has anotado en todo el proyecto.
Tareas con cálculo: cuántas tareas tienen el cálculo de rendimiento activo, sobre el total de tareas hoja del proyecto.
Total menciones: la suma de pares (recurso × tarea). Si "Albañil" aparece en 5 tareas y "Cemento" en 3, total menciones = 8.
Tabla principal
Una fila por recurso, con dos columnas:
Recurso: nombre tal como lo escribió, con su tipo (MDO, MAT, EQU, SUB, HER, REN) cuando viene del presupuesto.
# tareas que lo mencionan: cuántas tareas anotaron este recurso, con una mini-barra de densidad relativa al recurso más mencionado.
Las filas están ordenadas de mayor a menor número de menciones.
Detalle por recurso (expandible)
Haga clic en el nombre de cualquier recurso para desplegar la lista de tareas donde aparece. Cada fila muestra:
Tarea: código WBS y nombre.
Cantidad: la cantidad y unidad que usted escribió en esa tarea (sin sumar, tal cual quedó).
Fechas: el rango de la tarea (inicio → fin).
Días: la duración calculada para esa tarea.
Haga clic en cualquier tarea de la lista para cerrar el modal y saltar directamente a esa tarea en el Gantt.
Exportar el índice
El botón Exportar índice (CSV) en el pie del modal genera un CSV plano con una fila por par (recurso × tarea). Las columnas son: Recurso, Tipo, # tareas, WBS, Tarea, Cantidad, Unidad, Inicio, Fin, Días. Útil para revisar en Excel o Google Sheets, o pasarlo al equipo de compras como referencia.
Casos de uso típicos:
Revisar que no olvidó anotar recursos clave entre 50+ tareas.
Detectar inconsistencias en cómo escribió cantidades (a veces "2 albañiles", a veces "0.30 saco/m²").
Hacer un índice maestro de recursos del proyecto para entregar a residencia o compras.
Saltar rápidamente desde la lista al Gantt para revisar una tarea específica.
SECCIÓN 10
Vista General (Overview)
¿Qué es?
La Vista General ofrece una panorámica completa del proyecto en un canvas miniaturizado. Permite ver todas las tareas y su distribución temporal de un vistazo, sin necesidad de hacer scroll. Es especialmente útil para proyectos grandes con muchas tareas.
Acceso
Haga clic en el botón “Vista General” en la barra de herramientas.
Controles de Navegación
Acción
Control
Zoom in / Zoom out
Rueda del ratón o botones + / −
Mover la vista
Arrastrar con el ratón (clic sostenido + mover)
Navegar al punto
Hacer clic en el área deseada del canvas
Ajustar a ventana
Botón “Ajustar” (escala para ver todo el proyecto)
Copiar imagen
Botón “Copiar” (copia la imagen al portapapeles para pegar en informes)
Consejo: Use la función “Copiar” para obtener una imagen del diagrama completo y pegarla directamente en presentaciones de PowerPoint, informes de Word o correos electrónicos.
SECCIÓN 11
Guardar y Abrir Programaciones
Guardar la Programación
Para guardar su trabajo actual:
Haga clic en el botón verde “Guardar” (esquina superior derecha)
También disponible en Archivo → Guardar Programación
Se descargará un archivo .json con toda la información del proyecto
¿Qué se guarda?
El archivo incluye absolutamente todo lo necesario para restaurar el estado completo:
Nombre del proyecto, fecha de inicio, moneda
Configuración de jornada laboral (qué días son hábiles)
Todas las tareas con sus propiedades: WBS, nombre, duración, predecesoras, costo, tipo
Datos del presupuesto vinculado (si se importó)
Estado de la interfaz: tareas expandidas/contraídas, columnas visibles/ocultas, nivel de zoom, estado de ruta crítica
Consejo: Guarde su programación frecuentemente, especialmente después de ajustar duraciones y dependencias. El archivo es pequeño y puede mantener múltiples versiones (ej: proyecto_v1.json, proyecto_v2.json).
Abrir una Programación Guardada
Vaya al menú Archivo → Abrir Programación Guardada
Seleccione el archivo .json guardado previamente
El sistema validará el archivo y restaurará todo el estado del proyecto
Validaciones al Abrir
El sistema verifica la integridad de los datos al cargar un archivo:
Formato de archivo válido (verificación de marca _qostumGantt)
Campos obligatorios en cada tarea (id, wbs, nombre, nivel, tipo)
Formato de fechas correcto (ISO 8601)
WBS duplicados (se reportan como advertencia)
Referencias de predecesoras válidas (se eliminan las inválidas)
Integridad de relaciones padre-hijo (se reparan las rotas)
Nota: Si el archivo contiene inconsistencias, el sistema las corregirá automáticamente y le notificará con mensajes de advertencia. El proyecto se cargará con las correcciones aplicadas.
Precaución: No edite manualmente los archivos JSON. Si necesita hacer cambios, ábralos en QOSTUM, modifique y vuelva a guardar. La edición manual puede corromper el archivo.
De 1 a 8 páginas para distribuir la línea de tiempo horizontalmente
Ajustar en una página
Escala automáticamente todo el diagrama para caber en una sola página
Contenido
Panel de tareas solamente, barras de Gantt solamente, o ambos
Consejo para impresión: Para proyectos grandes, use tamaño A3 o Tabloide con 2-3 páginas de ancho. Para presentaciones ejecutivas, use “Ajustar en una página” con tamaño Carta o A4.
Exportar Programación Financiera a PDF
Desde el panel de Programación del Proyecto (Herramientas → Programación del Proyecto), haga clic en el botón “PDF”. Se generará un documento con la tabla de distribución de costos, totales, acumulados y porcentajes de avance.
Exportar Programación Financiera a Excel
Desde el mismo panel, haga clic en el botón “Excel”. La hoja de cálculo incluye:
Encabezado con nombre del proyecto y vista seleccionada
Tabla completa de tareas con costos por período
Fila de TOTAL PERÍODO
Fila de ACUMULADO
Filas de % AVANCE TIEMPO y % AVANCE PRESUPUESTO
Formato numérico y de porcentaje aplicado
Uso práctico del Excel: Abra el archivo en Excel o Google Sheets, seleccione la fila de ACUMULADO y cree un gráfico de línea. Obtendrá la curva S del proyecto, herramienta estándar para reportar avance financiero a clientes, bancos y supervisores.
SECCIÓN 13
Referencia Rápida
Atajos de Teclado
Tecla
Acción
Contexto
Enter
Confirmar edición
Al editar nombre, duración o predecesoras
Escape
Cancelar edición / Cerrar panel
Revierte cambios en la celda o cierra paneles modales (PDF, Programación, agregar tarea)
Clic derecho
Menú contextual
Sobre una tarea: opciones de edición. Sobre encabezado de tabla: ocultar/mostrar columnas
Clic en fila
Seleccionar tarea
Resalta la tarea en tabla y diagrama
Clic en ▸
Expandir/contraer
Sobre el triángulo de una tarea resumen
Menús Principales
Menú
Opción
Descripción
Archivo
Abrir Presupuesto
Importar archivo JSON de presupuesto
Abrir Programación Guardada
Cargar una programación previamente guardada
Guardar Programación
Exportar la programación actual a archivo JSON
Exportar PDF
Generar PDF del diagrama de Gantt
Herramientas
Expandir todo / Contraer todo
Mostrar u ocultar todas las tareas hijas
Ir a hoy
Centrar la línea de tiempo en la fecha actual
Agregar tarea
Crear una tarea manual con duración y posición
Agregar hito
Crear un evento puntual (duración cero)
Eliminar tarea
Borrar la tarea seleccionada (con confirmación)
Programación del Proyecto
Abrir el panel de distribución financiera
Columnas de la Tabla de Tareas
Columna
Editable
Ocultar
Notas
WBS
No
Sí
Código jerárquico automático
Nombre
Sí
No
Clic derecho → Editar nombre
Duración
Solo hojas
Sí
Días hábiles. Resumen = automática
Inicio
No
Sí
Calculada desde predecesoras
Fin
No
Sí
Inicio + Duración (días hábiles)
Pred.
Sí
Sí
Códigos WBS separados por coma
Costo
No
Sí
Proviene del presupuesto importado
SECCIÓN 14
Consejos y Mejores Prácticas
Flujo de Trabajo Recomendado
Prepare el presupuesto en QOSTUM Presupuestos con la estructura completa
Exporte el presupuesto como archivo JSON
Importe en Programación configurando fecha de inicio, jornada laboral y profundidad
Ajuste las duraciones de cada tarea según la estimación real del equipo de proyecto
Defina las dependencias siguiendo la lógica constructiva: ¿qué debe terminar antes de que otra pueda empezar?
Active la Ruta Crítica para identificar las tareas que controlan el plazo total
Revise la Programación Financiera para validar el flujo de costos y detectar picos de inversión
Exporte el diagrama a PDF y la programación financiera a Excel
Guarde la programación para futuras actualizaciones durante el proyecto
Sobre las Duraciones
Estime duraciones en días hábiles, no calendario. Si una cuadrilla tarda 2 semanas de Lun-Vie, la duración es 10, no 14
Considere la disponibilidad real de mano de obra y maquinaria en su región
Incluya tiempo para curado del concreto (7-14 días según elemento), tiempos de entrega de materiales, trámites de permisos
Sea conservador: es mejor prometer menos y entregar antes. Aplique un margen de 10-15% sobre su estimación ideal
Rendimientos típicos en Centroamérica: Excavación manual: 3-5 m³/día por peón. Pegado de block: 8-12 m²/día por albañil. Armado de acero: 100-150 kg/día por armador. Use estos rendimientos como guía para estimar duraciones.
Sobre las Dependencias
No todas las tareas necesitan predecesoras. Las que no tienen, inician en la fecha de inicio del proyecto
Evite dependencias innecesarias: solo vincule tareas con restricción real. “¿Realmente B no puede iniciar hasta que A termine?”
Identifique actividades que pueden ser paralelas (diferentes zonas, diferentes cuadrillas). Esto reduce la duración total del proyecto
Use la ruta crítica para verificar que la red de dependencias tiene sentido lógico
Error frecuente: Encadenar todas las tareas en secuencia estricta (1.1 → 1.2 → 1.3 → 2.1 → 2.2...). Esto produce un diagrama donde todo es ruta crítica y una duración irreal. En la práctica, muchas actividades ocurren en paralelo.
Sobre la Ruta Crítica
Si más del 70% de las tareas son críticas, probablemente hay dependencias excesivas
La ruta crítica cambia dinámicamente al modificar duraciones o dependencias
Las tareas con holgura son oportunidades para optimizar recursos (mover cuadrillas a tareas críticas)
Revise la ruta crítica semanalmente durante la ejecución del proyecto
Sobre la Programación Financiera
Use la vista semanal para proyectos de 3 a 12 meses
Use la vista mensual para proyectos de más de un año
Compare % costo vs % tiempo para detectar desfases: si el costo va adelante, investigue por qué
Utilice los datos de la programación para justificar solicitudes de anticipo o pagos parciales ante el cliente
Recuerde: La programación es una herramienta viva. Actualícela periódicamente con las duraciones reales y las dependencias ajustadas para mantener un control efectivo del proyecto. Un Gantt desactualizado es peor que no tener Gantt.
SECCIÓN 15
Resolución de Problemas
Problemas Frecuentes
El archivo de presupuesto no se importa
Verifique que el archivo sea un JSON exportado desde QOSTUM Presupuestos
El archivo debe contener un arreglo elementos con la estructura del presupuesto
Intente abrir el archivo en un editor de texto para verificar que no esté corrupto (debe empezar con {)
Verifique que el archivo no esté vacío o truncado
Las fechas no coinciden con lo esperado
Verifique la configuración de jornada laboral: ¿está usando 5 o 6 días por semana?
Recuerde que las duraciones son en días hábiles, no calendario. 10 días Lun-Vie = 14 días calendario
Revise las predecesoras: una tarea puede retrasarse porque espera a otra
Verifique que la fecha de inicio del proyecto sea un día hábil
Una tarea no se mueve aunque cambié la duración de otra
Verifique que exista una dependencia (predecesora) entre ambas tareas
Sin dependencia, las tareas son independientes y no se afectan mutuamente
Confirme que escribió correctamente el código WBS en la columna Pred.
La ruta crítica no muestra ninguna tarea
Asegúrese de que existan dependencias entre las tareas
Sin dependencias, todas las tareas son independientes y el cálculo no produce una ruta significativa
Establezca al menos una cadena de dependencias de principio a fin del proyecto
Todas las tareas aparecen como críticas
Revise si encadenó todas las tareas en serie (cada una depende de la anterior)
Identifique actividades que pueden ser paralelas y elimine dependencias innecesarias
Un proyecto donde todo es crítico indica falta de paralelismo en la programación
La programación financiera no muestra datos
Verifique que las tareas tengan costo asignado (columna Costo)
Solo se incluyen tareas hoja con costo mayor a cero
Si importó un presupuesto, los costos se asignan automáticamente
Las tareas manuales no tienen costo a menos que el presupuesto se los asigne
El archivo de programación guardado no se abre
El archivo debe ser un JSON generado por QOSTUM Programación (contiene la marca _qostumGantt)
No confunda un archivo de presupuesto (.json de Presupuestos) con uno de programación (.json de Gantt). Use Abrir Presupuesto para el primero y Abrir Programación Guardada para el segundo
Si el archivo fue editado manualmente, puede haberse corrompido. El sistema intentará reparar inconsistencias
El PDF del diagrama sale cortado o ilegible
Aumente el número de páginas de ancho en las opciones de exportación
Use un tamaño de papel más grande (A3, Tabloide, A2)
Active la opción “Ajustar en una página” para escalado automático
Contraiga las tareas resumen antes de exportar para reducir el número de filas
Los costos de las tareas aparecen en cero
Los costos provienen del presupuesto importado. Si no importó presupuesto, las tareas no tendrán costo
Verifique que la profundidad de importación sea suficiente para incluir las partidas con costo
Las tareas resumen no muestran costo propio; sus costos se reflejan en las tareas hoja
Al cambiar la jornada laboral, las fechas cambiaron drásticamente
Esto es el comportamiento esperado. Las duraciones están en días hábiles; cambiar los días hábiles cambia cuántos días calendario se necesitan
Ejemplo: 10 días hábiles con Lun-Vie = 14 calendario, pero con Lun-Sáb = 12 calendario
Si el cambio fue accidental, vuelva a la configuración anterior
No puedo editar la duración de una tarea
Solo las tareas hoja tienen duración editable. Las tareas resumen calculan su duración automáticamente
Los hitos tienen duración fija de 0 días
Haga clic directamente en la celda de la columna Duración para activar la edición
Soporte
Si necesita más ayuda, escríbanos a hola@qostum.com. Respondemos en menos de 24 horas hábiles. Si puede, incluya una captura de pantalla del problema y el código WBS de la tarea afectada.