TZ en rastreador en lugar de Word para desarrolladores

Requisitos en el Tracker en Lugar de Word: Optimizando el Proceso de SRS

En el desarrollo corporativo, los documentos de Word para las Especificaciones de Requisitos de Software (SRS) llevan a la descomposición manual de requisitos en trackers como Jira. El cliente redacta el texto, lo aprueba, lo firma y luego el contratista reescribe manualmente cada punto. Esto crea cuellos de botella: errores de copiar y pegar, pérdida de trazabilidad y retrasos en el proyecto.

Confluence resuelve parte del problema: es una plataforma web para edición colaborativa con comentarios y notificaciones. Pero incluso exportar a Word no elimina el trabajo manual por parte del contratista. Cada párrafo del SRS debe ser un requisito atómico con un identificador único para referenciar en código, pruebas e informes.

El Flujo de Trabajo Óptimo: Empezar en el Tracker

Cambia a redactar el SRS directamente dentro del tracker. El proceso se ve así:

Cliente crea tareas de requisitos en el tracker ->
  Discusión en comentarios con notificaciones ->
  Establecer estados (aceptado/rechazado/inviable) ->
  Generar el SRS en PDF/Word con IDs de tareas ->
  Firma ->
  Importar al tracker del contratista

Cada requisito es una tarea separada con campos: descripción, prioridad, criterios de aceptación, ID del sistema. Los participantes comentan en línea, evitando cadenas interminables de correos electrónicos. Después de la aprobación, un botón "Generar SRS" crea un documento con enlaces trazables a las tareas.

Ventajas:

• Trazabilidad: Los IDs de tareas en el PDF permiten importación automatizada.
• Colaboración: Discusiones en tiempo real sin conflictos de versiones.
• Automatización: Sin entrada manual de datos: las tareas se sincronizan automáticamente.
• Consistencia: Los cambios se bloquean después de que los requisitos se congelan.

Entorno Corporativo vs. Licitaciones

Dentro de una empresa, el tracker es accesible para todos: no se necesitan firmas. Congela la lista de requisitos, asigna estados y el proceso está completo. Jira, YouTrack o Redmine admiten flujos de trabajo personalizados para esto.

Para licitaciones, el problema es que el tracker del contratista es desconocido. La solución es una herramienta SaaS unificada con exportación a formatos estándar (CSV, JSON) para importar en Jira/Redmine. Busca herramientas como ReqView o Polarion con APIs para generación de documentos.

// Ejemplo de exportación de tarea en JSON para importar
[
  {
    "id": "REQ-001",
    "title": "Autorización OAuth",
    "description": "Soporte para flujo PKCE",
    "status": "aprobado"
  }
]

Este formato permite que un script cargue requisitos sin volver a escribir.

Implementación Práctica

En 2018, creamos SRS en Redmine como una jerarquía de tareas, exportando a Word a través de un plugin. Hoy, integra:

• Jira Requirements: Un módulo para historias de usuario con capacidades de exportación.
• Integración Confluence + Jira: Macros para sincronizar páginas y tareas.
• Scripts Personalizados: Python con atlassian-python-api para generación de PDF.

Asegúrate de:

• Atomicidad: Un requisito por tarea.
• Control de versiones: Historial de cambios similar a Git.
• Permisos: Roles para cliente/contratista.

Conclusiones Clave

• Redacta el SRS en el tracker para automatizar la descomposición y garantizar trazabilidad.
• Usa requisitos atómicos con IDs para referenciar en código y pruebas.
• Para licitaciones, elige herramientas SaaS con exportación a formatos universales.
• En entornos corporativos, omite firmas: congelar estados es suficiente.
• Integra Confluence/Jira para un enfoque híbrido durante períodos de transición.

— Editorial Team