Eine User Story sagt, wer was warum will
Eine User Story ist ein kurzer Satz, der aus Sicht einer Person beschreibt, was ein System für sie tun soll. Sie sagt, wer etwas will, was und wozu.
Mit Akzeptanzkriterien prüfen Sie, ob die Story erfüllt ist. So wissen alle im Team, wann die Arbeit fertig ist.
Am Ende dieser Lektion
Notiz
Ich kann eine User Story mit Akzeptanzkriterien schreiben, die sich prüfen lassen.
Schlüsselwörter
| Begriff | Was er bedeutet | Beispiel |
|---|---|---|
| User Story | ein Satz aus Sicht einer Person: Rolle, Ziel, Nutzen | |
| Rolle | wer etwas will | Bibliotheksmitarbeiterin |
| Akzeptanzkriterium | eine Prüfung, die zeigt, dass die Story erfüllt ist | |
| Gegeben, wenn, dann | drei Teile eines Kriteriums: Ausgangslage, Handlung, Ergebnis | |
| Backlog | die Liste der Stories, die noch zu bauen sind |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Eine Story hat drei Teile
Das übliche Muster lautet: Als Rolle möchte ich Ziel, damit Nutzen.
Die Rolle sagt, für wen. Das Ziel sagt, was. Der Nutzen sagt, wozu. Fehlt der Nutzen, weiß niemand, ob eine andere Lösung besser wäre.
Ein Beispiel: Stories für den Geräteverleih
| Rolle | Ziel | Nutzen |
|---|---|---|
| Mitarbeiterin der Bibliothek | eine Ausleihe eintragen | damit ich weiß, wo das Gerät ist |
| Studierende | die Leihdauer sehen | damit ich es rechtzeitig zurückbringe |
| Leiter der Bibliothek | alle offenen Ausleihen sehen | damit ich Verspätungen finde |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Akzeptanzkriterien machen die Story prüfbar
Ein Kriterium hat drei Teile: Gegeben eine Ausgangslage, wenn etwas geschieht, dann passiert ein Ergebnis.
Zum Beispiel: Gegeben eine Ausleihe von 20 Tagen, wenn sie gespeichert wird, dann wird sie abgelehnt. Eine Story hat zwei bis fünf solche Kriterien.
Im Lab prüfen Sie ein Kriterium wirklich
Die Story lautet: Als Mitarbeiterin der Bibliothek möchte ich eine Ausleihe eintragen, damit ich weiß, wo das Gerät ist. Die Leihdauer beträgt 1 bis 14 Tage.
Sie legen die Tabelle ausleihen an und prüfen drei Kriterien mit curl. Der Statuscode ist jeweils das Ergebnis.
psql das Passwort geben
export PGPASSWORD=shopHier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Von vorn beginnen
psql -h db -U shop -c "drop table if exists ausleihen"Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Die Tabelle ausleihen anlegen
psql -h db -U shop -c "create table ausleihen (id serial primary key, geraet text not null, person text not null, tage int not null check (tage between 1 and 14))"Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Der API sagen, dass sie neu schaut
psql -h db -U shop -c "notify pgrst, 'reload schema'"Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Kriterium 1: eine gültige Ausleihe
curl -s -o /dev/null -w "%{http_code}\n" -X POST -H "Content-Type: application/json" -d '{"geraet":"Notebook 1","person":"Lena","tage":7}' "http://api:3000/ausleihen"Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Kriterium 2: 15 Tage sind zu lang
curl -s -o /dev/null -w "%{http_code}\n" -X POST -H "Content-Type: application/json" -d '{"geraet":"Notebook 1","person":"Lena","tage":15}' "http://api:3000/ausleihen"Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Kriterium 3: ohne Person
curl -s -o /dev/null -w "%{http_code}\n" -X POST -H "Content-Type: application/json" -d '{"geraet":"Notebook 1","tage":7}' "http://api:3000/ausleihen"Hier angezeigt, nicht ausgeführt. Erstellen Sie ein kostenloses Konto, um „Ausführen“ zu drücken und ihn im Terminal Ihres eigenen Labs einzugeben.
Ein Beispiel: die drei Kriterien und ihr Ergebnis
| Gegeben | Wenn | Dann |
|---|---|---|
| Gerät, Person und 7 Tage | die Ausleihe gespeichert wird | Code 201, sie ist angelegt |
| Eine Leihdauer von 15 Tagen | die Ausleihe gespeichert wird | Code 400, sie wird abgelehnt |
| Eine Ausleihe ohne Person | die Ausleihe gespeichert wird | Code 400, sie wird abgelehnt |
Die Zellen, die Lernende ausfüllen, bleiben in dieser Vorschau leer.
Ein häufiger Fehler
Warnung
Viele schreiben Stories wie: Als Nutzende möchte ich ein System, damit alles besser wird. Das ist zu groß und nicht prüfbar. Teilen Sie die Story, bis sie ein Ziel hat und mindestens zwei Kriterien, die ein Test mit Ja oder Nein beantwortet.