TZ im Tracker statt Word für Entwickler

Anforderungen im Tracker statt Word: Optimierung des SRS-Prozesses

In der Unternehmensentwicklung führen Word-Dokumente für Software-Anforderungsspezifikationen (SRS) zu manueller Zerlegung von Anforderungen in Tracker wie Jira. Der Kunde verfasst den Text, lässt ihn genehmigen, unterzeichnet ihn, und dann schreibt der Auftragnehmer jeden Punkt manuell um. Dies führt zu Engpässen: Copy-Paste-Fehler, Verlust der Nachverfolgbarkeit und Projektverzögerungen.

Confluence löst einen Teil des Problems – es ist eine webbasierte Plattform für kollaboratives Bearbeiten mit Kommentaren und Benachrichtigungen. Aber selbst der Export nach Word beseitigt nicht die manuelle Arbeit aufseiten des Auftragnehmers. Jeder Absatz der SRS sollte eine atomare Anforderung mit einer eindeutigen Kennung für die Referenzierung in Code, Tests und Berichten sein.

Der optimale Workflow: Im Tracker beginnen

Wechseln Sie zur Erstellung der SRS direkt im Tracker. Der Prozess sieht so aus:

Kunde erstellt Anforderungsaufgaben im Tracker ->
  Diskussion in Kommentaren mit Benachrichtigungen ->
  Festlegen von Status (angenommen/abgelehnt/nicht umsetzbar) ->
  Generieren der SRS in PDF/Word mit Aufgaben-IDs ->
  Unterzeichnung ->
  Import in den Tracker des Auftragnehmers

Jede Anforderung ist eine separate Aufgabe mit Feldern: Beschreibung, Priorität, Abnahmekriterien, System-ID. Teilnehmer kommentieren direkt, um endlose E-Mail-Ketten zu vermeiden. Nach der Genehmigung erstellt ein "SRS generieren"-Button ein Dokument mit nachverfolgbaren Links zu den Aufgaben.

Vorteile:

• Nachverfolgbarkeit: Aufgaben-IDs im PDF ermöglichen automatischen Import.
• Zusammenarbeit: Echtzeit-Diskussionen ohne Versionskonflikte.
• Automatisierung: Keine manuelle Dateneingabe – Aufgaben synchronisieren automatisch.
• Konsistenz: Änderungen werden gesperrt, nachdem die Anforderungen eingefroren sind.

Unternehmensumgebung vs. Ausschreibungen

Innerhalb eines Unternehmens ist der Tracker für alle zugänglich – keine Unterschriften erforderlich. Friert die Anforderungsliste ein, weist Status zu, und der Prozess ist abgeschlossen. Jira, YouTrack oder Redmine unterstützen benutzerdefinierte Workflows dafür.

Bei Ausschreibungen ist das Problem, dass der Tracker des Auftragnehmers unbekannt ist. Die Lösung ist ein einheitliches SaaS-Tool mit Export in Standardformate (CSV, JSON) für den Import in Jira/Redmine. Suchen Sie nach Tools wie ReqView oder Polarion mit APIs zur Dokumentengenerierung.

// Beispiel-Aufgabenexport in JSON für den Import
[
  {
    "id": "REQ-001",
    "title": "OAuth-Autorisierung",
    "description": "PKCE-Flow unterstützen",
    "status": "genehmigt"
  }
]

Dieses Format ermöglicht es einem Skript, Anforderungen ohne Neuerfassung zu laden.

Praktische Umsetzung

2018 erstellten wir SRS in Redmine als Hierarchie von Aufgaben, exportierten über ein Plugin nach Word. Heute integrieren Sie:

• Jira Requirements: Ein Modul für User Stories mit Exportfunktionen.
• Confluence + Jira-Integration: Makros zum Synchronisieren von Seiten und Aufgaben.
• Benutzerdefinierte Skripte: Python mit atlassian-python-api für PDF-Generierung.

Sicherstellen:

• Atomarität: Eine Anforderung pro Aufgabe.
• Versionierung: Git-ähnliche Änderungshistorie.
• Berechtigungen: Rollen für Kunde/Auftragnehmer.

Wichtige Erkenntnisse

• Erstellen Sie die SRS im Tracker, um die Zerlegung zu automatisieren und Nachverfolgbarkeit zu gewährleisten.
• Verwenden Sie atomare Anforderungen mit IDs für die Referenzierung in Code und Tests.
• Wählen Sie für Ausschreibungen SaaS-Tools mit Export in universelle Formate.
• In Unternehmensumgebungen überspringen Sie Unterschriften – Einfrieren von Status ist ausreichend.
• Integrieren Sie Confluence/Jira für einen hybriden Ansatz während Übergangsphasen.

— Editorial Team