Requerimientos
Cada módulo del sistema se traduce en historias de usuario y casos de uso, con sus criterios de aceptación correspondientes.
6.0Trazabilidad
6.1Definición de Listo y de Terminado
Definición de Listo
- La historia está redactada en formato Como/Quiero/Para, con sus criterios de aceptación explícitos.
- Las dependencias de datos están identificadas: qué entidades del modelo toca (ver Diseño del sistema).
- El equipo la estimó en la planificación del sprint.
- No tiene bloqueos de diseño pendientes.
Definición de Terminado
- El código está integrado y revisado por al menos un compañero del equipo.
- Los criterios de aceptación están verificados, manualmente o con Cypress según el caso.
- El caso de prueba correspondiente fue ejecutado (ver capítulo de Pruebas del sistema).
- Se demostró en el Sprint Review sin errores bloqueantes.
6.2Requerimientos por módulo
Los puntos miden complejidad relativa, no horas (ver capítulo Sprints para el desglose real). El sprint asignado surge del origen ya documentado de cada módulo.
La prioridad no viene relevada del legajo original (no hay una priorización individual por historia más allá del orden del Story Map), así que acá se reconstruye con un criterio explícito: Alta para lo que es prerequisito de todo lo demás (cuentas, proyectos, servicios, el registro y cálculo de cobros), Media para lo que enriquece ese núcleo (seguimiento de tareas, gráficos de avance, Gantt/PERT, portal del cliente) y Baja para conteos informativos, validaciones secundarias y analítica/optimización.
Cuentas de usuario y cliente
Antes de gestionar un solo proyecto, el sistema necesita saber quién es cada persona que lo usa: el cliente que contrató al estudio y el usuario interno (arquitecto o administrativo) que opera el día a día. Estas historias consolidan el backlog original de los Sprints 1 a 3, que no llegó a redactarse como historias de usuario en su momento.
Sprints 1-3 (consolidado a partir del Product Backlog)
Cobertura de pruebas: Cubierto por los casos de prueba Login Usuario, Login Cliente, Clientes y Usuario del capítulo de Pruebas.
Como administrativo del estudio, quiero registrar los datos de contacto de un cliente nuevo (nombre, apellido, domicilio, DNI, correo electrónico y teléfono), para tener su información centralizada antes de asignarle un proyecto.
Criterios de aceptación
El sistema debe asignar automáticamente un número de cliente y una contraseña inicial; todos los campos de contacto deben poder modificarse después del alta sin perder el número asignado.
Como socio del estudio, quiero dar de alta a un usuario interno con su nombre, domicilio, DNI, correo y teléfono, para que cada arquitecto o administrativo tenga su propia cuenta dentro del sistema.
Criterios de aceptación
El sistema debe generar un número y una contraseña de usuario; el alta debe permitir asignar uno o más roles y modificarlos después sin recrear la cuenta.
Como socio del estudio, quiero asignar y modificar roles a cada usuario interno, para que el acceso a cada módulo respete la estructura horizontal de decisiones del estudio.
Criterios de aceptación
Debe existir al menos un rol por función (administración de proyectos, gestión de cobros, gestión de tareas); un usuario puede tener más de un rol a la vez.
Como usuario interno, quiero iniciar sesión con mi usuario y contraseña, para acceder únicamente a la información que me corresponde según mi rol.
Criterios de aceptación
El sistema debe validar usuario y contraseña antes de conceder acceso, permitir mostrar u ocultar la contraseña mientras se escribe, y permitir cambiarla desde la sesión activa.
Como cliente, quiero iniciar sesión con mi propio usuario y contraseña, para consultar el estado de mis proyectos sin depender de que el estudio me lo informe por teléfono o mail.
Criterios de aceptación
El acceso del cliente debe quedar limitado a sus propios proyectos; debe poder cambiar su contraseña y elegir si visualizarla mientras la escribe, igual que el usuario interno.
Proyectos y tipología
Con cliente y usuario identificados, el sistema necesita poder crear el proyecto en sí y clasificarlo: la tipología (anteproyecto, proyecto con detalle o gestión y conducción de obra) determina qué servicios y tareas se le asignan más adelante.
Sprint 4 (consolidado a partir del Product Backlog)
Cobertura de pruebas: Cubierto por los casos de prueba Proyectos y Tipologías.
Como usuario interno, quiero registrar un proyecto nuevo con su nombre y el cliente al que corresponde, para empezar a asociarle tareas, servicios y cobros.
Criterios de aceptación
El proyecto debe quedar vinculado a un cliente ya existente; el nombre y el cliente asignado deben poder modificarse después del alta sin perder el historial de tareas ya cargadas.
Como usuario interno, quiero asignar una tipología a cada proyecto (anteproyecto, proyecto con detalle o gestión y conducción de obra), para que el sistema y el cliente entiendan en qué etapa se encuentra.
Criterios de aceptación
La tipología debe poder modificarse si el proyecto avanza de etapa, por ejemplo de anteproyecto a proyecto con detalle, sin perder los datos ya cargados.
Como usuario interno, quiero generar un informe imprimible de un proyecto, para compartir su estado, requerimientos y comentarios sin depender del acceso al sistema.
Criterios de aceptación
El informe debe incluir el estado actual del proyecto, sus requerimientos y los comentarios cargados, y debe poder imprimirse o guardarse en PDF desde el navegador.
Como usuario interno, quiero exportar el listado de proyectos a Excel, para analizarlo o compartirlo fuera del sistema.
Criterios de aceptación
El archivo exportado debe incluir los mismos proyectos visibles en el filtro aplicado, con sus columnas principales (cliente, tipología, estado, avance).
Estadísticas generales
Antes de entrar al detalle de cada proyecto, el estudio necesita una fotografía general de la operación: cuántos usuarios, clientes y proyectos hay activos en un momento dado.
Sprint 5 (consolidado a partir del Product Backlog)
Cobertura de pruebas: Sin caso de prueba específico relevado en el plan de testing.
Como socio del estudio, quiero ver la cantidad total de usuarios internos y cuántos están activos o inactivos, para dimensionar el equipo disponible.
Criterios de aceptación
El conteo debe distinguir activos de inactivos y actualizarse automáticamente al dar de alta o baja a un usuario.
Como socio del estudio, quiero ver la cantidad total de clientes y cuántos están activos o inactivos, para entender el tamaño real de la cartera.
Criterios de aceptación
El conteo debe distinguir activos de inactivos y actualizarse automáticamente al dar de alta o baja a un cliente.
Como socio del estudio, quiero ver la cantidad total de proyectos y cuántos están activos o inactivos, para dimensionar la carga de trabajo en curso.
Criterios de aceptación
El conteo debe distinguir activos de inactivos y actualizarse automáticamente al cambiar el estado de un proyecto.
Servicios y tareas de servicio
Cada proyecto ofrece servicios (por ejemplo, anteproyecto o dirección de obra), y cada servicio trae consigo un set de tareas predeterminadas que se pueden ajustar.
Sprint 6 (historias de usuario relevadas con el equipo)
Cobertura de pruebas: Cubierto por el caso de prueba Servicios; las tareas de servicio no tienen caso propio.
Como usuario interno quiero poder crear un nuevo servicio en el proyecto para que podamos ofrecer nuevas funcionalidades a nuestros usuarios.
Criterios de aceptación
El usuario debe poder ingresar el nombre y descripción del nuevo servicio; el sistema debe validar que el nombre no exista previamente y confirmar la creación.
Como usuario interno quiero ver una lista de todos los servicios asociados a un proyecto para tener una visión general de los servicios existentes.
Criterios de aceptación
Se deben listar los servicios con su nombre y breve descripción; la lista debe actualizarse en tiempo real con las últimas adiciones o modificaciones.
Como usuario interno quiero poder modificar el nombre de un servicio existente para que refleje mejor sus funcionalidades.
Criterios de aceptación
El usuario debe poder seleccionar un servicio de la lista para modificar su nombre; el sistema debe validar que el nuevo nombre no esté en uso y confirmar la modificación.
Como usuario interno quiero poder eliminar un servicio que ya no se necesite para que el proyecto se mantenga actualizado y relevante.
Criterios de aceptación
El sistema debe pedir confirmación antes de eliminar un servicio y notificar al usuario una vez eliminado.
Como usuario interno quiero poder visualizar las tareas asociadas a un servicio para comprender mejor el trabajo pendiente o completado en ese servicio.
Criterios de aceptación
Al seleccionar un servicio se deben mostrar todas las tareas relacionadas, incluyendo su estado (pendiente, en progreso, completado).
Como usuario interno quiero poder añadir nuevas tareas a un servicio para organizar el trabajo necesario para desarrollarlo.
Criterios de aceptación
El usuario debe poder definir título, descripción y estado inicial de la tarea; debe recibir confirmación una vez creada.
Como usuario interno quiero ver una lista de todas las tareas de un proyecto, independientemente del servicio al que pertenezcan, para tener una visión completa del trabajo pendiente.
Criterios de aceptación
Debe poder listarse cada tarea con título, descripción, estado y servicio asociado, actualizándose automáticamente con cualquier cambio.
Como usuario interno quiero poder modificar los detalles de una tarea existente para que la información esté actualizada y sea relevante.
Criterios de aceptación
El usuario debe poder cambiar título, descripción y estado de una tarea, con confirmación tras la modificación.
Como usuario interno quiero poder eliminar tareas que ya no sean necesarias o estén completadas para que el proyecto se mantenga limpio y organizado.
Criterios de aceptación
El sistema debe solicitar confirmación antes de eliminar una tarea y notificar al usuario una vez eliminada.
Tareas del proyecto
Además de las tareas heredadas de un servicio, el proyecto necesita su propio seguimiento operativo: fechas, adjuntos y compromisos que se comunican al equipo.
Sprint 7 (historias de usuario relevadas con el equipo)
Cobertura de pruebas: Cubierto parcialmente por el caso de prueba Proyectos (asignación de tareas); sin caso de prueba dedicado a la gestión de tareas en sí.
Como usuario interno quiero poder registrar nuevas tareas en el sistema, para organizar y planificar el trabajo que necesita ser realizado.
Criterios de aceptación
El usuario debe poder acceder a un formulario con título, fecha de inicio, fecha de compromiso, descripción y adjuntos; debe poder elegir un estado inicial (pendiente, en progreso, completado) y recibir confirmación al guardar.
Como usuario interno quiero registrar las fechas de inicio y de compromiso de las tareas, para que todos los miembros del equipo tengan claridad sobre los plazos.
Criterios de aceptación
El registro y la edición deben ofrecer selección de fecha por calendario para ambas fechas; el sistema debe validar que la fecha de compromiso no sea anterior a la de inicio y notificar si la combinación no es válida.
Como usuario interno quiero adjuntar archivos a las tareas, para proporcionar o consultar material de referencia relevante.
Criterios de aceptación
Debe poder adjuntarse uno o varios archivos durante el registro o la edición, soportando formatos de documento, PDF e imagen.
Como usuario interno quiero registrar un compromiso y enviar un mensaje relacionado con él, para comunicar de manera efectiva las expectativas y responsabilidades asociadas a la tarea.
Criterios de aceptación
Al registrar o actualizar una tarea debe poder agregarse un compromiso con un campo de texto para el mensaje; debe existir la opción de enviarlo a los miembros del equipo relacionados y el sistema debe confirmar el envío.
Como usuario interno quiero agregar nuevos ítems a una tarea existente, para reflejar cambios o adiciones a los requerimientos o al alcance de la tarea.
Criterios de aceptación
Debe poder agregarse nuevos ítems o subtareas a una tarea principal, cada uno con su propia descripción, fechas y archivos adjuntos; el sistema debe confirmar cuando el ítem se agregó exitosamente.
Gráfico de avance de tareas
El progreso de las tareas necesita traducirse en una lectura visual rápida, tanto para el equipo interno como para el cliente que consulta su proyecto.
Sprint 8 (historias de usuario relevadas con el equipo)
Cobertura de pruebas: Cubierto parcialmente por el caso de prueba Proyectos (verificación de avances mediante gráficos); sin caso de prueba dedicado.
Como usuario interno, quiero que exista un módulo que genere gráficos de avance de tareas, para tener una representación visual del progreso del proyecto.
Criterios de aceptación
Debe implementarse un módulo dedicado a la generación de estos gráficos, integrado a la ficha de cada proyecto.
Como usuario interno, deseo poder ver el avance de las tareas directamente en la interfaz, para una rápida comprensión del estado del proyecto.
Criterios de aceptación
La visualización del avance debe estar disponible sin necesidad de navegar a una pantalla aparte.
Como usuario interno, necesito que el sistema calcule el progreso de las tareas y le asigne un color, para una lectura visual clara.
Criterios de aceptación
El cálculo del porcentaje de avance y la asignación de color deben ser automáticos, sin intervención manual del usuario.
Como usuario interno, quiero que los gráficos muestren el porcentaje de avance mediante barras de progreso, para una comprensión rápida y precisa.
Criterios de aceptación
Cada barra de progreso debe reflejar el porcentaje calculado en tiempo real.
Como usuario interno, necesito visualizar tareas en distintos estados (iniciadas, en espera, completadas), para una mejor gestión del trabajo pendiente.
Criterios de aceptación
El gráfico debe distinguir visualmente cada estado posible de una tarea.
Como usuario interno, quiero que los gráficos puedan reflejar valores negativos, para identificar tareas retrasadas.
Criterios de aceptación
El sistema debe representar los atrasos con un indicador claramente diferenciado del avance normal.
Cobros
El estudio necesita registrar lo que cobra por cada proyecto y saber en todo momento cuánto queda pendiente sobre el presupuesto acordado.
Sprint 9 (historias de usuario relevadas con el equipo)
Cobertura de pruebas: Cubierto parcialmente por el caso de prueba Proyectos (registro de cobros); sin caso de prueba dedicado a la gestión de cobros.
Como usuario interno quiero ver un botón "Cobros" claramente visible en la interfaz de proyectos, para acceder fácilmente a la gestión de cobros.
Criterios de aceptación
Debe agregarse un botón etiquetado como "Cobros" en la interfaz de proyectos, visible y de fácil acceso.
Como usuario interno quiero tener una página dedicada a la gestión de cobros, para gestionar eficientemente los cobros asociados a los proyectos.
Criterios de aceptación
La página debe incluir todas las funciones necesarias para gestionar los cobros de manera efectiva.
Como usuario interno quiero un formulario que me permita ingresar la fecha y el monto cobrado, para registrar nuevos cobros de manera precisa.
Criterios de aceptación
El formulario debe incluir campos obligatorios para fecha y monto cobrado, que garanticen la precisión de los registros.
Como usuario interno quiero que el sistema calcule automáticamente el saldo del proyecto considerando el presupuesto y los cobros realizados.
Criterios de aceptación
El saldo debe calcularse a partir del monto presupuestado y los cobros realizados, y actualizarse automáticamente al registrar un nuevo cobro.
Como usuario interno quiero poder editar y eliminar cobros existentes, para corregir errores o eliminar registros innecesarios.
Criterios de aceptación
Los cambios y eliminaciones deben reflejarse correctamente en el saldo del proyecto.
Como usuario interno quiero que el sistema valide el formulario de ingreso de cobros, para asegurar la precisión de los datos.
Criterios de aceptación
El sistema debe validar los campos de fecha y monto cobrado para garantizar la integridad de la información ingresada.
Como usuario interno, quiero que la gestión de cobros haya sido probada exhaustivamente antes de usarla en producción, para confiar en que los montos y saldos que el sistema calcula son correctos.
Criterios de aceptación
Deben realizarse pruebas de funcionalidad y usabilidad sobre todas las funciones relacionadas con la gestión de cobros.
Como usuario interno quiero registrar un plazo de vencimiento para un cobro pendiente, para saber a tiempo cuándo se acerca la fecha sin tener que revisarlo a mano.
Criterios de aceptación
El sistema debe permitir asociar una fecha de vencimiento a un cobro pendiente y mostrar una alerta visible cuando esa fecha está próxima o vencida.
Gráficos de Gantt y PERT
Para proyectos con muchas actividades dependientes entre sí, el estudio necesita una vista de cronograma más avanzada que el simple listado de tareas: un Gantt (barras por actividad en el tiempo) y un PERT (red de nodos que muestra dependencias y rutas críticas).
Sprint 10 (historias de usuario relevadas con el equipo)
Cobertura de pruebas: Sin caso de prueba específico relevado en el plan de testing.
Como usuario interno, quiero que se diseñe la interfaz del Diagrama de Gantt, incluyendo actividades, fechas de inicio y duración.
Criterios de aceptación
La interfaz debe incluir elementos para definir actividades, fechas de inicio y duración de manera clara y precisa.
Como usuario interno, necesito poder agregar, modificar y eliminar actividades en el Diagrama de Gantt.
Criterios de aceptación
Debe ser posible agregar, modificar y eliminar actividades de manera intuitiva desde la interfaz del diagrama.
Como usuario interno, deseo poder establecer dependencias entre las actividades en el Diagrama de Gantt.
Criterios de aceptación
Debe implementarse la capacidad de establecer dependencias entre actividades de manera flexible y sencilla.
Como usuario interno, necesito que el sistema calcule automáticamente las fechas de finalización previstas, considerando dependencias y duración.
Criterios de aceptación
El sistema debe calcular automáticamente las fechas de finalización de todas las actividades, teniendo en cuenta sus dependencias y duración.
Como usuario interno, quiero ver el Diagrama de PERT con nodos y flechas que representen las actividades y sus dependencias, identificando la ruta crítica.
Criterios de aceptación
El diagrama debe construirse automáticamente a partir de las actividades cargadas, mostrar la ruta crítica claramente diferenciada del resto, y representar cada dependencia con una flecha entre los nodos correspondientes.
Como usuario interno, deseo poder ajustar las actividades y sus dependencias en el Diagrama de PERT.
Criterios de aceptación
Debe ser posible ajustar actividades y dependencias de manera interactiva, recalculando la ruta crítica al confirmar el cambio.
Portal del cliente
El objetivo original del proyecto se cierra acá: darle al cliente visibilidad directa de sus propios proyectos, sin depender de que el estudio se la reporte manualmente.
Sprint 11 (historias de usuario relevadas con el equipo)
Cobertura de pruebas: Cubierto por el caso de prueba Login Cliente para el acceso; el contenido del portal (proyectos, compromisos) no tiene caso de prueba propio.
Como cliente quiero poder visualizar una lista de todos mis proyectos, para tener una vista general y rápida de todos los proyectos en curso.
Criterios de aceptación
La interfaz debe listar todos los proyectos asociados a cada cliente, fácilmente accesible desde la página principal de la interfaz de clientes.
Como cliente quiero poder visualizar información detallada de cada proyecto al seleccionarlo, para entender mejor sus especificaciones y necesidades.
Criterios de aceptación
Al seleccionar un proyecto debe mostrarse una sección con toda la información detallada, incluyendo objetivos, alcance, presupuesto y cronograma.
Como cliente quiero ver el arquitecto asignado a cada uno de mis proyectos, para saber quién está a cargo y poder contactarlo si es necesario.
Criterios de aceptación
Cada proyecto debe incluir el nombre del arquitecto asignado y un medio directo (como un enlace a su correo) para contactarlo desde la interfaz.
Como cliente quiero visualizar la tipología de cada uno de mis proyectos, para entender el enfoque y la metodología de trabajo aplicada.
Criterios de aceptación
La tipología debe ser visible en la información general de cada proyecto, con una breve descripción si se selecciona.
Como cliente quiero visualizar el estado actual y el avance de cada uno de mis proyectos, para conocer su progreso y si se están cumpliendo los plazos.
Criterios de aceptación
El estado y avance deben actualizarse regularmente y mostrarse con una vista gráfica (barra de progreso) para una comprensión rápida.
Como cliente quiero visualizar los compromisos relacionados con cada proyecto, para estar al tanto de entregas, pagos y otros hitos importantes.
Criterios de aceptación
Los compromisos deben listarse de forma clara dentro de los detalles del proyecto, con fechas, descripciones y estado (completado, pendiente).
Como cliente quiero ordenar y filtrar la lista de proyectos por nombre, estado o avance, para personalizar la visualización según mis necesidades.
Criterios de aceptación
Debe existir una funcionalidad intuitiva para ordenar la lista según el criterio seleccionado, y un filtro que muestre solo los proyectos que coincidan con el estado elegido.
Estadísticas y reportes gráficos
Con el sistema ya operando, el estudio necesita poder leer patrones agregados, no solo el estado de un proyecto puntual, para tomar decisiones de negocio.
Sprint 12 (historias de usuario relevadas con el equipo)
Cobertura de pruebas: Sin caso de prueba específico relevado en el plan de testing.
Como usuario interno, necesito un diseño de interfaz intuitivo que facilite la interacción con las visualizaciones gráficas interactivas.
Criterios de aceptación
La interfaz debe ser visualmente atractiva, con controles claros para manipular y explorar los datos.
Como usuario interno, quiero poder filtrar datos por periodos de tiempo, para analizar la evolución de los proyectos y los cobros realizados.
Criterios de aceptación
Debe implementarse un filtro que permita seleccionar y visualizar datos de periodos definidos, fácil de usar.
Como usuario interno, necesito gráficos que categoricen los proyectos según su estado, para una mejor comprensión de su progreso y rendimiento.
Criterios de aceptación
Los gráficos deben mostrar claramente la distribución de proyectos según su estado (iniciados, en progreso, completados, etc.), de forma fácil de interpretar.
Como usuario interno, deseo gráficos detallados sobre los cobros realizados según el medio de pago, para comprender mejor los patrones de pago.
Criterios de aceptación
Los gráficos deben clasificar los cobros por medio de pago (transferencia, tarjeta, etc.) y ofrecer una visión completa de su distribución.
Como usuario interno, quiero ver el porcentaje de participación de cada medio en el total cobrado, para evaluar su importancia relativa.
Criterios de aceptación
Los gráficos de medio de pago deben incluir el porcentaje de participación, visible y comprensible.
Como usuario interno, necesito ajustes de diseño y optimización de rendimiento en las visualizaciones, para una experiencia fluida y eficiente.
Criterios de aceptación
Debe mejorarse la estética y legibilidad, y optimizarse el rendimiento incluso con grandes cantidades de datos.
6.3Story Map
Organizado por actividad de alto nivel: izquierda a derecha, el recorrido del usuario; arriba a abajo, prioridad. Las cinco columnas de abajo son el MVP construido y entregado. "Fuera de esta versión" es backlog para una futura iteración.
Gestionar identidad
- Alta y roles de usuarios internos
- Alta y acceso del cliente
Gestionar proyectos
- Crear y clasificar proyectos por tipología
- Ver estadísticas generales de la operación
Ejecutar el trabajo
- Servicios y tareas por proyecto
- Seguimiento visual del avance
- Cronograma con Gantt y PERT
Cobrar
- Registrar y validar cobros
- Alertar vencimientos pendientes
Dar visibilidad al cliente
- Portal de consulta propio
- Reportes y estadísticas gráficas
Fuera de esta versión
Entidades del modelo de datos sin pantalla ni controlador propio, pendientes para una futura iteración.
Mensajería interna entre usuarios
Modelada en el dominio real (entidad Message), pero ningún controlador ni servicio la usa: no llegó a tener pantalla propia.
Notificaciones automáticas
Modelada en el dominio real (entidad Notification), sin lógica de disparo conectada a ningún flujo.
Envío de mails desde el sistema
Modelada en el dominio real (entidad Mail), sin integración con un proveedor de correo.
Gestión de documentos e imágenes fuera de los adjuntos de tarea
Modeladas por separado del adjunto de una tarea (entidades Document e Image), sin uso real.
Reportes adicionales más allá de los ya construidos
Modelada como catálogo propio (entidad Report), sin pantalla que la consuma.
6.4Casos de uso
Diagramas de casos de uso reconstruidos a partir de las historias de usuario, agrupando cada una por el actor que la protagoniza. El objetivo de cada caso es el mismo título del catálogo de requerimientos de arriba.