Módulo de Análisis de Proyectos e Issues — Guía operativa, reglas de negocio, cálculo de métricas financieras y procedimientos de vinculación.
El Módulo de Análisis de Proyectos e Issues es una extensión de inteligencia operativa construida sobre la plataforma Proyectos HW. Su propósito fundamental es resolver la fragmentación de información que ocurre cuando un proyecto u objetivo real de software se prolonga a lo largo de múltiples meses o cortes de facturación.
Consolida automáticamente todos los registros mensuales de AppGini que pertenecen a un mismo objetivo bajo una sola entidad.
Compara presupuesto inicial comprometido, horas reales invertidas por el equipo y horas facturadas al cliente.
Mapea colaboradores, tiempos de inicio/fin y tareas específicas invertidas en el ciclo de vida del Issue.
| Proyecto Mensual (Corte en AppGini) | Issue Real (Módulo de Análisis) |
|---|---|
| Representa la rebanada de facturación de un mes específico (ej. Proyecto #4473 de Octubre, Proyecto #4500 de Noviembre). | Representa el objetivo funcional completo (ej. Issue 1195: Fase 2 - Proyección noviembre). |
| Su presupuesto se reinicia o traspasa mes a mes. | Conserva el presupuesto original asignado en el primer corte sin duplicarlo. |
| Sólo registra las horas y tareas ejecutadas dentro del mes. | Acumula la sumatoria total de horas reales y de factura de todos los cortes vinculados. |
Cada Issue puede encontrarse en uno de los 3 estados operativos. El estado se puede alternar con un solo clic desde la ficha de detalle:
`activo = 1`: Proyectos en ejecución o desarrollo activo. Aparecen prioritariamente en los tableros y KPIs principales.
`activo = 2`: Issues en fila de espera, planeación o listos para revisión previa antes de comenzar desarrollo.
`activo = 0`: Issues concluidos, entregados o cerrados. Se conservan para análisis retroactivo y auditoría.
Regla: El presupuesto de un Issue no es acumulativo. Al realizar cortes mensuales, el saldo disponible se traspasa entre registros de AppGini. Por ende, el presupuesto real del Issue es el valor presupuesto del proyecto vinculado con el menor ID (Corte Inicial).
Regla: Tanto las horas facturadas como las horas reales invertidas por los desarrolladores sí se acumulan a lo largo de todos los cortes.
Regla: Representa el saldo disponible respecto al presupuesto original. Si el valor es positivo (verde), hubo ahorro de horas; si es negativo (rojo), hubo sobregasto.
Regla: Evalúa la rentabilidad de las horas trabajadas comparando cuántas horas se facturan respecto a cuántas se invierten en el proyecto.
proyectos.fecha_entrega del corte con menor ID (corte inicial).proyectos.responsable_id del corte con menor ID.proyectos.incluir del corte con mayor ID (corte más reciente).El Tablero General ofrece la vista global de salud operativa de la empresa. Contiene:
Muestran el desglose por estado (En Curso, Backlog, Históricos), Presupuesto Total y Horas Reales. Se recalculan de forma dinámica en tiempo real al aplicar filtros por texto, responsable o estado, reflejando siempre la métrica exacta de la selección actual. Además, al hacer clic sobre las tarjetas de estado se activa o alterna dicho filtro rápidamente.
Permite conmutar instantáneamente entre estados (Todos, En Curso, Backlog, Históricos y el filtro inteligente 🎯 Listos para Archivar), filtrar por Responsable asignado, aplicar el selector de Último Corte (para excluir terminados o aislar etapas) y buscar por texto libre en tiempo real.
Permite supervisar el estado técnico más reciente (ej. Terminado, Instalado en prod) junto con su estado de facturación (ej. Cobrada 3, En tránsito 2), identificando de un vistazo si el proyecto ya no debe recibir horas adicionales.
Permite ordenar la tabla de forma ascendente o descendente al hacer clic en los encabezados: Issue, Descripción, Clientes, Responsable, Presupuesto, Reales, Desviación, % Avance, Último Corte, F. Entrega y F. Reprog.
Para facilitar el seguimiento operativo diario y evitar la dispersión visual con proyectos que ya fueron concluidos pero aún no se han archivado contablemente, el Tablero General dispone del selector interactivo multiselección Último Corte con casillas de verificación (checkboxes) y atajos rápidos:
activo = 1 en la base de datos, presentados en el bloque superior con distintivo verde Activo.Para mantener el tablero limpio y evitar que se sigan registrando horas en tareas que ya concluyeron su ciclo productivo y contable, el sistema incluye un mecanismo de archivado masivo:
activo = 1) cuyo último corte está en estado concluido (Terminado 9, Instalado en producción 7 o Espera recepción 16, o avance ≥ 100%) y cuya factura está en estado final (Cobrada 3, o históricas internas 8: Administración histórica, 12: Inversión histórica, 13: No cobrable histórico, 14: Exceso presupuestal histórico).activo = 0).Esta vista especializada está diseñada para la dirección, administración y auditoría operativa. Desglosa el presupuesto inicial en 3 cifras fundamentales y detecta inconsistencias operativas:
Suma de horas en proyectos con estado de factura efectivamente cobrada.
Horas en cortes con estado Pendiente (1), En tránsito (2) o Pre-factura (6).
Diferencia entre el Presupuesto Inicial y lo ya facturado o en proceso (saldo por devengar).
En la pestaña Bandeja de Cobranza (CxC), los administradores pueden gestionar el cobro final de las facturas emitidas:
3: Cobrada es definitiva y protege el registro contra modificaciones posteriores en toda la plataforma.Diseñado específicamente para evaluar a los líderes de proyecto o responsables iniciales:
El motor analiza continuamente la base de datos de Proyectos HW mediante expresiones regulares (ej. Issue 1195, Task 982) para detectar proyectos no vinculados:
horas_reales > 0). Los proyectos con cero horas reales no entran al análisis ni al seguimiento hasta que el equipo registre tareas.
Permite aprobar una sugerencia asignándola a un Issue nuevo o seleccionando un Issue existente del catálogo.
Selecciona múltiples casillas de verificación y presiona "Aprobar Seleccionados" para vincular decenas de proyectos en un solo paso.
Utiliza esta interfaz cuando un proyecto no cumpla con el formato estándar de coincidencia automática:
4500) o escribe palabras clave del cliente o nombre del proyecto.La ficha de detalle consolida toda la historia del Issue y proporciona herramientas de edición directa:
Permite corregir el número/nombre del Issue, modificar la descripción del objetivo y actualizar las 3 fechas clave (Reprogramación, Instalación Prod y Aceptación Cliente).
Ubicada en la esquina superior derecha con el distintivo "Acción Operativa" para diferenciarla categóricamente de los botones de filtro del tablero. Al pulsar entre ▶ En Curso, ⏳ Backlog o 🗄️ Histórico, el sistema solicita confirmación y modifica directamente el estado del registro en la base de datos (`proyectos.activo`).
Los identificadores de corte (ej. #4473 ↗) son enlaces directos a la ficha original en Proyectos HW para revisar tareas específicas.
Muestra la lista de todos los desarrolladores que registraron tareas, sus horas invertidas y el rango de fechas de su intervención.
El módulo de seguimiento semanal es el centro de control operativo ágil para supervisar el avance de tareas en curso, capturar directamente el estado técnico y porcentaje completado, sincronizar horas facturables y gestionar la transición de proyectos concluidos:
Permite modificar directamente en cada fila de la tabla:
• Estado del Proyecto: Menú desplegable con todos los estados operativos (En resolución, Instalado, Terminado, etc.).
• % de Avance (`incluir`): Campo numérico editable (0 a 100%) con barra visual de progreso.
• Estado de Factura: Selector desplegable con todas las facturas disponibles.
• Presupuesto y Horas Factura: Inputs numéricos editables con guardado inmediato vía AJAX y registro de auditoría (`fecha_modificacion = NOW()`).
• ⚡ Panorama del Mes (Activas + Pre-factura): Vista predeterminada que unifica los proyectos donde se reportan horas (activa = 1) con aquellos proyectos concluidos que ya pasaron a Pre factura (6), brindando una visibilidad integral del avance y facturación del período.
• Multiselección de Facturas: Desplegable interactivo con checkboxes y botón de acceso rápido Activas + Pre-fac para seleccionar en un clic todas las facturas en operación y las pre-facturas del mes, además de los atajos *Solo Activas*, *Todas* y *Ninguna*.
• Multiselección de Estado del Proyecto: Selector múltiple con casillas de verificación y presets inmediatos: En curso (aísla proyectos técnicos vigentes sin concluir ni cancelar), Concluidos (proyectos en estado 7 Instalado en producción o 9 Terminado), Todos y Ninguno.
• Multiselección de Responsables (Prioridad Colaboradores Activos): Selector múltiple jerarquizado en dos bloques: primero los Colaboradores Activos (`activo = 1`) con insignia verde, seguidos del historial de Inactivos / Históricos (`activo = 0`). Incluye el atajo rápido `⚡ Solo Activos` para filtrar en un solo clic únicamente a los colaboradores vigentes del equipo, además de *Todos* y *Ninguno*.
• Selector Rápido de Factura Activa: Permite conmutar entre ⚡ Panorama del Mes, Solo Activas, Solo Pre-facturas, Todas o Inactivas / Históricas.
• Enfoque Operativo y Anomalías: Filtro especializado para aislar 📋 En Pre-factura (Concluidos listos para Cierre Mensual), 📑 Candidatos a Transición, sobregasto y proyectos sin presupuesto.
Horas Factura Sugeridas = min(ceil(Horas Reales * 4) / 4, Presupuesto).
Las horas reales se ajustan al cuarto de hora superior (0.25, 0.50, 0.75 o 1.00). Si superan el presupuesto asignado, la sugerencia queda topada al presupuesto para proteger la rentabilidad.
Mediante la barra de acciones masivas, selecciona los proyectos requeridos y presiona "Actualizar Horas Factura Sugeridas (Lote)" para sincronizar de forma atómica y automática las horas topadas de los proyectos seleccionados.
Un proyecto se considera concluido cuando su estado técnico es 7 (Instalado en producción), 9 (Terminado) o su porcentaje de avance alcanza el 100%. Al cumplirse esta condición, el sistema habilita automáticamente la transición correspondiente según el tipo de factura de reporte:
| ID Origen | Factura de Reporte (Origen) | Activa | Transición a | Factura Destino (Conclusión) | Efecto Operativo |
|---|---|---|---|---|---|
| 1 | Pendiente | 1 | ➔ 6 | Pre factura | Pasa a revisión de cobro con horas acordadas para el cliente. |
| 4 | No cobrable | 1 | ➔ 13 | No cobrable histórico | Se archiva el esfuerzo no facturable concluido. |
| 5 | Inversión | 1 | ➔ 12 | Inversión histórica | Se archiva la inversión interna finalizada. |
| 9 | Administración | 1 | ➔ 8 | Administración Histórica | Se archivan actividades administrativas concluidas. |
| 10 | Exceso presupuestal | 1 | ➔ 14 | Exceso presupuestal histórico | Se archiva el sobreesfuerzo sin cobro una vez finalizada la tarea. |
Pasar a Pre factura (6) o Pasar a Inversión histórica (12)).
factura_id != 3). Incorpora proyectos vinculados a Issues en Curso (activo = 1), en Backlog (activo = 2) y proyectos huérfanos sin Issue, garantizando que ninguna tarea con factura activa (Pendiente, Inversión, Admón, Exceso, etc.) o pre-factura quede fuera del control del gestor. Solo en facturas activas (1, 4, 5, 9, 10) se reportan horas de esfuerzo técnico y aplican alertas de desactualización.Pre-factura en la celda de factura y en la columna de alertas. Las fichas superiores de Proyectos Activos y Hrs Factura Actual desglosan automáticamente la cantidad y suma de horas en estado Pre-factura.El Cierre Mensual es el proceso operativo ejecutado una vez por mes en seguimiento/mensual.php para consolidar el corte contable de las actividades desarrolladas en el período. A diferencia del seguimiento semanal (que solo sugiere horas), el cierre mensual modifica formalmente los estados de la factura y crea nuevos proyectos en la base de datos para continuar los esfuerzos que siguen vigentes.
activo = 1), proyectos en Backlog (activo = 2) y proyectos internos sin issue (ej. Inversión HW o Administración). Se consideran expresamente los proyectos en backlog porque durante el mes algunas iniciativas se suspenden temporalmente o se concluyen técnicamente quedando en espera de validación, autorización o revisión final del cliente; dichas tareas acumularon esfuerzo e inversión en el período que debe ser cobrada o transicionada en el cierre. Los Issues históricos concluidos y archivados (activo = 0) se excluyen automáticamente para evitar reprocesar trabajo de meses anteriores.
Proyectos concluidos: Proyectos previamente marcados como Pre-factura (estados 7 Instalado o 9 Terminado) pasan a En tránsito (2) para trámite de cobro ante el cliente. No generan proyecto espejo porque el objetivo del proyecto fue completado.
Cálculo: $\text{Disponible} = \text{Presupuesto} - \text{Horas Factura}$.
Si $\text{Disponible} > 0$, el corte actual pasa a En tránsito (2) y se crea un proyecto espejo con el presupuesto disponible, estado 3 En resolución, factura en Pendiente (1) y horas en $0.00$.
Presupuesto agotado: Si $\text{Disponible} \le 0$, el corte actual pasa a En tránsito (2) y se crea un proyecto espejo con presupuesto 0.00, estado de factura 10 Exceso presupuestal y el estado del proyecto se mantiene en 3 En resolución, permitiendo reportar el esfuerzo de horas invertido para concluir la tarea sin generar cobro indebido.
• Administración (9) ➔ Admón Histórica (8): Se archiva el corte del mes y se crea un proyecto espejo en factura 9 Administración para el siguiente mes.
• Inversión (5) ➔ Inversión Histórica (12): Se archiva el corte de inversión del período.
continuacion o continuar con la tarea, el sistema anexa automáticamente el posfijo:[Nombre del Proyecto Original] - Continuar con la tarea
issue_proyectos asociado al mismo Issue padre, preservando el histórico completo de cortes.