Verificación: documentos de CU vs sistema actual
Fecha original: 30/08/2026. Actualizado: 04/09/2026 (specs y pruebas v2026 de CU04, CU07, CU10, CU12 y Tablero).
Rol: verificador. La fuente de verdad es el sistema que corre hoy (sigma.3byte.com.ar / código en sigma/), no el zip de Construcción.
Este informe dice qué hay que cambiar en especificaciones de CU, casos de prueba y páginas del sitio para que describan el producto implantado. No propone rehacer el código para que vuelva al papel de 2024.
Corpus leído: los 13 CU de priorización, los PDF/DOCX de 03-Construccion/01- Analisis y Diseno/Casos de uso/, las tandas 2ª y 3ª de 03-Construccion/03- Pruebas/, el modelo de Elaboración, el manual, el código de sigma/app y sigma/gui/navbar.php, y el motor PCU de 2026-08-30 (CalculoPCU.Class.php + calculo-pcu.js). Login en vivo: solo Google; no se recorrió la app autenticada en este pase.
Veredicto
Los documentos de Construcción no describen el sistema actual. Tres problemas se mezclan:
- Huecos. CU01, CU06 y CU11 publicados son tapa + diagramas, sin flujo. CU04, CU07, CU10, CU12 y el Tablero de Sprint ya tienen spec y prueba v2026 en este sitio. Varios DOCX de 2024 siguen vacíos o tienen el contenido de otro CU.
- IDs cruzados. El mismo número apunta a cosas distintas en priorización, modelo de Elaboración, tests y código. CU08/CU09/CU10 y CU11/CU12/CU13 son los peores.
- El producto se movió. Navbar recortado, hub real en Modificar proyecto, PCU dinámico, reportes = gráfico + PDF, paneles distintos a la spec, Roles/Permisos/Actores/Login sin CU.
Hay que reescribir las specs y las pruebas contra la UI de hoy, y congelar los PDF del zip como evidencia histórica.
Sistema actual (fuente de verdad)
Navegación
El menú (gui/navbar.php) solo muestra Usuarios, Roles, Permisos, Proyectos, Salir. Iteraciones, Actores, Casos de uso, Historias, Sprints e Integrantes están comentados.
El listado proyectos.php es el hub visible: ver, editar, eliminar, Estimaciones (PCU) o Sprints (PHU), Tareas, más una columna de tipo de estimación.
El hub real de PCU/PHU está en Modificar proyecto (proyecto.modificar.php), no en Ver:
| Tipo del proyecto | Botones extra |
|---|---|
| PCU | Integrantes, Iteraciones, Casos de uso, Actores |
| PHU | Integrantes, Sprints, Historias de usuario |
proyecto.ver.php es solo lectura de nombre, descripción, tipo, fechas y estado.
Login y acceso
- Producción: solo Google. El Gmail tiene que existir ya en SIGMA.
- Roles de sistema (Administrador, Usuario Comun, …) y roles de proyecto (Gestor / Desarrollador / Invitado) son cosas distintas.
- Permisos reales: Usuarios, Roles, Permisos, Proyectos, Iteraciones, Actores, Casos_De_Uso, Sprints, Historias_Usuario, Estimaciones, Tareas, Miembros, Ingresar, Salir.
- Tras login: Administrador →
dashboard.php; Usuario Comun →dashboard_usuario.php; permiso Miembros →dashboard_Miembro.php(pantalla incompleta; hay un65hardcodeado de reportes). dashboard.phpexige permiso Usuarios y cuenta proyectos, PCU, PHU y usuarios. No consultaReportesGenerados.
PCU (lo que más se desvió)
Wizard epcu_proyecto.php (pestañas: iteración, actores, CU, T, E, esfuerzo, tabla) + barra Cálculo en vivo:
- Modo UAW:
por_cu(default SIGMA),por_tipo(Karner),por_cantidad(Excel). - h/UCP: 4 / 20 / 28 / 36.
- Personas, h/semana, 5 días hábiles o 7 calendario.
- Desglose = % del total (10/20/40/15/15), no ×2,5 sobre coding.
- Listado, gráfico y PDF usan el mismo motor. Si el día guardado ≠ recálculo, se muestra «guardado».
Detalle de fórmulas: sigma/docs/PCU_CALCULO.md en el repo de código.
Reportes
No hay pantalla «Generar Reportes». Desde la lista de estimaciones: Gráfico (ver_grafico.php, Chart.js) y PDF (pdf.php → reporte_iteracion_completo.pdf).
Tareas
Desde la fila del proyecto. Muestra iteración actual / fase / método. Alta: nombre, tipo (Análisis, Diseño, Codificación, Pruebas, Sobrecarga), horas, CU opcional, actividad opcional. Fusiona lo que la priorización llamó CU08 y CU09.
Inventario de especificaciones
Calidad del texto, no del código.
| ID priorización | Nombre oficial | Qué hay en el zip | Calidad | ¿Describe el sistema? |
|---|---|---|---|---|
| CU01 | Gestionar proyectos | PDF/DOCX publicados | Tapa + diagramas. DOCX extra vacío | No. Falta ABM, tipo PCU/PHU, hub en Modificar, integrantes como CU aparte |
| CU02 | Gestionar estimaciones | DOCX borrador (varias copias) | Flujo razonable (lista + alta/edición/baja → CU03) | Parcial. No dice que se entra por la fila del proyecto ni el recálculo del listado |
| CU03 | Calcular PCU | DOCX borrador | Flujo de persistencia; sin fórmulas ni controles | No. Ignora barra en vivo, modos UAW, h/UCP, 5/7 días, desglose |
| CU04 | Calcular PHU | Spec v2026: CU04 | Completa contra el ABM actual | Sí. Carga manual; no calcula PERT. Entrada: dashboard admin |
| CU05 | Generar reportes | PDF/DOCX | Única spec «completa» junto con CU10 | Parcial. Habla de PantallaEstimaciones → gráfico. Omite PDF y motor único |
| CU06 | Gestionar usuarios | PDF/DOCX publicados | Casi solo diagramas. Un extracto habla de actor Visitante | No. El ABM es de admin. Roles y Permisos son módulos extra |
| CU07 | Gestionar HU | Spec v2026: CU07 | Completa (Story Points, estado, sprint) | Sí. CRUD por backlog PHU desde Modificar |
| CU08 | Tiempo en CU | DOCX «Gestionar tareas» | El propio texto fusiona CU08+CU09 | Cerca de tareas.php, pero el ID oficial sigue siendo «tiempo en CU» |
| CU09 | Tareas ejecutadas | Sin spec propia | Absorbida por el DOCX de CU08 | El sistema tiene un solo ABM de tareas |
| CU10 | Panel de control | Spec v2026: CU10 | Completa contra los 3 PHP actuales + panel objetivo de cátedra | Sí para el as-is. El panel docente/KPI está especificado como a implementar |
| CU11 | Gestionar iteraciones | PDF/DOCX publicados | Tapa + «flujo alternativo: no existe» | No. Hay CRUD; entrada por Modificar (solo PCU) |
| CU12 | Gestión de sprint | Spec v2026: CU12 + Tablero | Completa (cierre, velocidad calculada, tablero) | Sí. CRUD + cierre + tablero; entrada por Modificar (solo PHU) |
| CU13 | Gestión de casos de uso | DOCX EspecificacionCU013 | Describe el cálculo PCU, no el ABM de CU | No. El ABM es casos_de_uso.php |
Módulos del sistema sin CU numerado: Login Google, Roles, Permisos, Actores (ABM de dominio, no de sistema).
Inventario de pruebas
La 1ª tanda (usuarios) no está en el zip del 30/08.
| Archivo | Dice que prueba | ID que usa | Estado | ¿Sirve hoy? |
|---|---|---|---|---|
prueba-cu01 | Gestionar proyecto | CU01 | Hecho | Parcial. Pasos de ABM sí; no cubre hub Modificar ni tipo inmutable |
prueba-cu02 | Gestionar estimaciones | CU02 | Hecho | Parcial. Menú «Estimaciones» del test no existe |
prueba-cu03 | Calcular PCU | CU03 | Hecho (el más largo) | No. Espera menú Estimaciones → PCU; validaciones que el sistema no muestra; números de 2024 (4 h × 3 × 20 × 7). Tester PCU.docx + CUENTAS TOTALES.xlsx tampoco coinciden con el motor 2026 |
| CU04 DOCX / prueba-cu04 | PHU | CU04 | 2024 FALTA; 2026 ejecutada | La ficha v2026 cubre el alta manual contra estimacionphu.crear.php |
prueba-cu06 | Gestionar integrantes | CU06 | Hecho | El ID está mal: eso no es Gestionar usuarios. Los pasos (Proyectos → Gestionar integrantes) sí existen, pero solo desde Modificar |
| CU07 DOCX / prueba-cu07 | Historias | CU07 | 2024 FALTA; 2026 ejecutada | Cubre alta con puntos, estado y sprint |
prueba-cu08 PDF | Tiempo por CU | CU08 | Hecho | UI vieja. El DOCX gemelo es «Tareas ejecutadas Falta» |
| CU08 DOCX | Tareas ejecutadas | CU08 | FALTA | Debería ser la prueba de tareas.php |
prueba-cu09 / prueba-cu10 | Panel de control | CU09 en el PDF 2024; CU10 en 2026 | PDF 2024 + ficha 2026 | El PDF viejo falló «Estimaciones no redirige»; CP01 de 2026 confirma que sigue. Cubrir admin, alumno, miembro y oráculo de KPI |
CU10 - Gestionar Iteraciones.docx | Iteraciones | CU10 | En 3ª tanda | ID incorrecto (iteraciones = CU11) |
prueba-cu11 / prueba-cu12 / prueba-cu-tablero | Gestionar sprint | CU11 en el PDF 2024; CU12 en 2026 | PDF 2024 + fichas 2026 | El PDF viejo usa ID incorrecto. Las fichas 2026 cubren cierre, velocidad y tablero |
prueba-cu12 | Gestionar casos de uso | CU12 | Hecho | ID incorrecto (gestionar CU = CU13) |
prueba-cu05 | Generar reportes | CU05 | Hecho | Hay que reescribir: gráfico + PDF desde la lista, no «Generar Reporte» |
Plantilla de prueba: copy-paste de PHPUnit / jUnit / Visual Paradigm / Windows 10. No aporta. Hay que recortarla.
Matriz verificador (CU × sistema × docs)
CU01 — Proyectos
Sistema: ABM en proyectos.php. Tipo PCU/PHU al crear; el código lo trata como fijo. Fechas validadas (inicio ≤ fin). Estados Planificado / En Progreso / Completado. Ver = ficha. Editar = ficha + botones del resto del dominio.
Spec: reescribir completa. Incluir campos, validaciones, tipo inmutable, y que no «incluye integrantes» en la misma pantalla: integrantes es un subflujo desde Modificar.
Prueba: rehacer pasos (menú Proyectos → Nuevo / Ver / Modificar / Eliminar). Añadir: tipo no editable; fechas invertidas; hub según PCU vs PHU.
CU01-bis / integrantes (hoy mal llamado CU06 en tests)
Sistema: usuarios_proyectos.php. Usuario existente + rol de proyecto.
Spec: o bien un CU propio «Gestionar integrantes», o un subflujo explícito de CU01. No mezclarlo con CU06 Usuarios.
Prueba: mover prueba-cu06 a este CU. Entrada: Modificar proyecto → Gestionar Integrantes. El menú Integrantes está apagado.
CU02 — Lista de estimaciones
Sistema: ver_estimaciones_proyecto.php desde la fila. Nueva estimación, gráfico, días recalculados + nota «guardado».
Spec: actualizar pantallas y precondiciones (permiso Estimaciones; no-admin solo ve proyectos asignados).
Prueba: no usar «menú Estimaciones». Cubrir recálculo vs valor histórico.
CU03 — Wizard PCU
Sistema: pestañas + barra en vivo + persistencia de modo_uaw, horas_ucp, personas, horas_semana, dias_por_semana. Fórmulas en docs/PCU_CALCULO.md.
Spec (prioridad máxima): propósito, precondiciones (proyecto PCU, iteración, actores y CU del backlog), flujo por pestaña, controles, fórmulas, tres escenarios (mejor / probable / peor), desglose %, postcondición (queda guardada y el listado/gráfico/PDF leen el mismo motor).
Prueba (prioridad máxima): tirar números de 2024. Casos: default SIGMA (por_cu, 4 h, 3 personas, 20 h, 7 días); preset Testify (por_tipo, 20 h, 4 personas, 40 h, 5 días); cambio de control sin guardar; validación real (no inventar mensajes que el PHP no muestra). El CP03 histórico ya falló validaciones que el sistema nunca implementó: o se implementan o se sacan del oráculo.
CU04 — PHU
Sistema: ABM global estimacionesphu.php (id + sprint). No está en el navbar; el dashboard admin sí enlaza.
Spec y prueba: listas. CU04 y prueba-cu04. No copiar el wizard PCU: es carga manual.
CU05 — Reportes
Sistema: gráfico Chart.js + PDF de la estimación. Sin entidad ReportesGenerados, sin Excel, sin pantalla por rol.
Spec: actores = usuario con permiso Estimaciones. Flujo: lista → Gráfico / PDF. Datos = motor PCU, no un snapshot de reportes.
Prueba: abrir gráfico de un proyecto con ≥1 estimación; exportar PDF; comprobar que los días coinciden con la barra.
CU06 — Usuarios
Sistema: usuarios.php en el navbar. Alta con rol de sistema. No es Visitante.
Spec: reescribir ABM + aclarar que no asigna gente a un proyecto (eso es integrantes).
Prueba: nueva (la 1ª tanda no está). No reutilizar la de integrantes.
CU-ROL y CU-PER (nuevos)
Sistema: roles.php, permisos.php en el navbar.
Spec y prueba: faltan. El manual ya los nombra; la priorización no.
CU07 — Historias
Sistema: CRUD por backlog; botón en Modificar si PHU. Campos: título, descripción, criterios, prioridad, puntos, estado, sprint.
Spec y prueba: listas. CU07 y prueba-cu07. Entrada: Modificar proyecto PHU. No exigir el ítem de menú (está apagado).
CU08 + CU09 → un solo CU «Gestionar tareas»
Sistema: tareas.php + tarea.crear.php.
Spec: adoptar el DOCX de fusión. Actualizar entrada (fila del proyecto, no «cargar tiempo» en una pantalla que no existe). Campos reales. CU08 «tiempo en CU» y CU09 «tareas ejecutadas» dejan de existir como dos CU.
Prueba: una sola, contra esas pantallas. Archivar el PDF de «tiempo por CU».
CU10 — Panel
Sistema: tres PHP distintos. Admin = 4 contadores (proyectos, PCU, PHU, usuarios). Usuario = proyectos y estimaciones propias. Miembro = incompleto (permiso Miembros inexistente).
Spec y prueba: listas. CU10 y prueba-cu10. El PDF 2024 queda histórico. El fallo «Estimaciones PCU → proyectos.php» y el logo que expulsa al alumno siguen; el panel docente/KPI es la sección «objetivo» de la spec.
CU11 — Iteraciones
Sistema: CRUD por proyecto PCU, desde Modificar.
Spec: reescribir (fechas, estado, etapa; inicio inmutable según el manual).
Prueba: no usar el DOCX mal nombrado de la 3ª tanda. Tester PCU.docx ya reportó que crear iteración falla si se entra sin id_proyecto: la entrada correcta es Modificar → Gestionar Iteraciones.
CU12 — Sprint
Sistema: CRUD por proyecto PHU, desde Modificar. Cierre con velocidad calculada, bloqueo de sprint cerrado y tablero por estado.
Spec: CU12 y Tablero. Prueba: prueba-cu12 y prueba-cu-tablero. El PDF prueba-cu11 queda como histórico (ID incorrecto).
CU13 — Casos de uso (del dominio)
Sistema: CRUD por backlog PCU, desde Modificar. Campos de título / transacciones / etc. para alimentar el wizard.
Spec: tirar EspecificacionCU013.docx (es PCU). Escribir el ABM.
Prueba: el PDF prueba-cu12 es este CU; renombrar a CU13.
Actores (sin número)
Sistema: actores.php desde Modificar (PCU). Peso simple / promedio / complejo.
Spec: o subflujo de CU13/CU03, o CU14. Hoy no hay documento.
Login (sin número)
Sistema: Google only.
Spec / prueba: el plan de pruebas y el manual de Elaboración aún pueden oler a usuario/clave. Alinear a Google + «el mail tiene que existir». El login.prueba.php es solo si SIGMA_TEST_LOGIN=1; no es flujo de usuario.
Caos de IDs (no volver a mezclar)
Tres numeraciones distintas conviven. Canónica para docs nuevos: priorización de Construcción (CU01–CU13), con las correcciones de abajo.
| Número | Elaboración (modelo) | Construcción (priorización) | Tests del zip | Sistema hoy |
|---|---|---|---|---|
| CU06 | Agregar integrante | Gestionar usuarios | Gestionar integrantes | Usuarios en navbar; integrantes en Modificar |
| CU07 | Gestionar usuarios | Gestionar HU | (FALTA HU) | HU en Modificar PHU |
| CU08 | Tiempo en CU | Tiempo en CU | Tiempo en CU o tareas | Un solo ABM de tareas |
| CU09 | Gestionar HU | Tareas ejecutadas | Panel | Tareas (fusionado) |
| CU10 | Product backlog | Panel | Panel o iteraciones | Dashboards |
| CU11 | Tareas ejecutadas | Iteraciones | Sprint | Iteraciones (PCU) |
| CU12 | Panel | Sprint | Casos de uso | Sprint (PHU) |
| CU13 | — | Casos de uso | — | Casos de uso (PCU) |
Product backlog del modelo de Elaboración no es una pantalla. El backlog es un registro interno (id_backlog) que cuelga del proyecto.
Qué modificar, por artefacto
1. Especificaciones de CU (papel / zip)
No editar los PDF históricos. Dejarlos en /archivos/construccion/ como «versión 2024». Redactar un juego v2026 (DOCX o MD) con el mismo estándar de CU del equipo:
| Acción | CU | Por qué |
|---|---|---|
| Reescribir de cero | CU01, CU03, CU06, CU11, CU13 | Publicados vacíos o con el tema equivocado |
| Reescribir | CU02, CU05, CU08 | Hay borrador útil, desfasado |
| Escribir (no existen) | Login, Roles, Permisos, Actores, Integrantes | El código ya está |
| Hecho v2026 | CU04, CU07, CU10, CU12, Tablero de Sprint | Spec + prueba en este sitio |
| Retirar como CU independiente | CU09 | Fusionado en CU08 Gestionar tareas |
| Archivar | EspecificacionCU001, 006, 007, 011 vacíos; copias extra de CU02/CU03; EspecificacionCU013 (es PCU) | Generan ruido |
Cada spec v2026 tiene que decir: actor real (permiso, no «Visitante»), URL/pantalla PHP, precondiciones, flujo con nombres de botones tal como están, postcondiciones, y qué no hace (menú apagado, tipo inmutable, etc.).
2. Casos de prueba
| Acción | Caso |
|---|---|
| Reescribir | CU01, CU02, CU03, CU05 |
| Renombrar y corregir entrada | prueba-cu06 → Integrantes; prueba-cu11 → CU12 Sprint; prueba-cu12 → CU13 Casos de uso |
| Escribir | CU06 Usuarios, CU08 Tareas (una sola), Roles, Permisos, Login Google, Actores |
| Hecho v2026 | CU04 PHU, CU07 HU, CU10 Panel, CU12 Sprint, Tablero |
| No re-ejecutar como oráculo | Tester PCU.docx / CUENTAS TOTALES.xlsx / CP de validación que el sistema nunca mostró |
| Recortar plantilla | Sacar PHPUnit/jUnit/VP de cada archivo; un anexo de ambiente alcanza |
| 1ª tanda | Si aparece, tratarla como histórica. La prueba viva de usuarios se escribe de nuevo |
Oráculo PCU: usar CalculoPCU / docs/PCU_CALCULO.md, no los Excel de 2024 salvo como escenario «preset Testify».
3. Páginas del sitio (este Docusaurus)
| Página | Qué cambiar |
|---|---|
| Especificaciones de CU | Marcar PDF publicados como históricos; link a este informe; lista canónica con «entrada en UI» y «estado spec» |
| Casos de prueba | Corregir IDs (panel no es CU09; sprint no es CU11; CU de dominio no es CU12); no contar «Hecho» como vigente |
| Modelo de CU | Dejar la tabla de 12 como historia de Elaboración. Añadir una línea: «la numeración que usa el código es la de Construcción (13)» |
| Requerimientos / ERS | Nota de desvío: no hay importar Excel, no hay exportar CSV genérico, reportes ≠ PCU vs PHU, login ≠ roles alumno/carga/visitante de Inicio |
| Manual de usuario | Corregir el mapa: navbar real; integrantes/iteraciones/CU/actores desde Modificar, no desde Ver; wizard + barra PCU; gráfico/PDF; dashboards. El PDF de 33 páginas del zip queda como captura de otra build |
| Plan de pruebas | Apuntar a este informe para el estado real de las tandas |
| Implementación | Sin cambio de CU; el PCU dinámico ya está en el repo |
4. Numeración canónica recomendada (docs nuevos)
Mantener CU01–CU13 de la priorización, con estas reglas de redacción:
- CU01 = solo el proyecto. Integrantes = subflujo CU01.S1 (o CU01b), nunca CU06.
- CU06 = solo usuarios de sistema.
- CU08 = Gestionar tareas. CU09 = retirado (fusionado en CU08).
- CU10 = panel. Nunca CU09.
- CU11 = iteraciones (PCU). CU12 = sprint (PHU). CU13 = casos de uso del backlog.
- Roles, Permisos, Actores, Login = apéndice «fuera de priorización» o CU14–CU17 si hace falta entregar papel.
Para CU04, CU07, CU10, CU12 y el Tablero, el contrato vigente son las specs v2026 enlazadas arriba. Para el resto, esta página sigue siendo el contrato.
Orden de trabajo sugerido
- Congelar el zip: no re-subir PDF viejos como si fueran vigentes.
- Actualizar las páginas del sitio (lista + manual + pruebas) — es lo que lee el equipo.
- Redactar spec+prueba de CU03 (núcleo del producto).
- Spec+prueba de CU01 + integrantes + CU06 + Roles/Permisos.
- Unificar CU08 tareas; retirar CU09.
- Reescribir CU05 contra gráfico/PDF. CU10 ya tiene spec y prueba v2026 (as-is + panel objetivo).
- Completar CU11, CU13, Actores, Login. CU04, CU07, CU10 y CU12 ya tienen spec y prueba v2026.
- Recién ahí re-ejecutar una tanda de regresión y guardar resultados 2026.
Relacionado
- Contraste numérico con Excel de alumnos:
sigma-fuera/CONTRASTE_ALUMNOS.md(no es este informe: allá se comparan días, acá documentos). - Motor PCU:
sigma/docs/PCU_CALCULO.md. - Originales: archivos.