
Ein Anforderungsdokument für eine App, kurz App-Spezifikation, ist ein kurzer schriftlicher Plan einer App, bevor jemand sie baut: wer sie nutzen wird, welche Bildschirme jede dieser Personen sieht, welche Informationen sie speichert, mit welchen Diensten sie sich verbindet, was vorerst wegbleibt und was der Build höchstens kosten kann. Sie lesen sie, hinterfragen sie und ändern sie, und erst wenn sie die App beschreibt, die Sie wirklich wollen, geben Sie sie frei.
Sie geben sie zuerst frei, weil eine Spezifikation der günstigste Ort ist, einen Fehler zu finden. Eine Zeile auf einer Seite zu verschieben, kostet nichts. Erst nach dem Build herauszufinden, dass Nachhilfelehrkräfte die Telefonnummer aller Eltern sehen können oder dass Gebühren nicht in Raten bezahlt werden können, bedeutet einen Neubau.
Was ist eine Softwarespezifikation, einfach erklärt?
In der Softwareentwicklung ist eine Spezifikation (in größeren Projekten oft Anforderungsdokument oder SRS genannt, für Software Requirements Specification) die Vereinbarung zwischen der Person, die die App braucht, und dem, der sie baut. Sie sagt, was die App leisten muss, nicht wie der Code es macht. Für einen Laden, einen Verein oder eine Schule reicht meist eine Seite, solange sie konkret und in einfachen Worten geschrieben ist.
Der Test für eine Spezifikation ist einfach: Könnten zwei verschiedene Builder sie lesen und ungefähr dieselbe App bauen? Wenn auf der Seite steht Schüler können ihre Ergebnisse sehen, ist das ein Wunsch. Wenn dort steht ein Schüler meldet sich mit seiner Telefonnummer an und sieht die Noten seiner eigenen Tests, nach Fach, neben dem Durchschnitt seiner Gruppe, ist das eine Anforderung, die jemand bauen und die Sie prüfen können.
Was gehört in ein einseitiges Anforderungsdokument für eine App?
Nehmen wir ein Nachhilfezentrum, das eine App für Kurse, Anwesenheit und Gebühren möchte. Eine nützliche einseitige Spezifikation dafür hat diese Teile:
| Teil der Spezifikation | Was darin steht | Beispiel für ein Nachhilfezentrum |
|---|---|---|
| Wer sie nutzt | Jede Art von Person, die sich anmeldet, und was sie tun darf | Inhaber, Nachhilfelehrkräfte, Schüler und Eltern; nur der Inhaber sieht die Gebührensummen |
| Bildschirme nach Rolle | Die Seiten, die jede Rolle sieht, und was sie dort tut | Nachhilfelehrkraft: heutige Kurse, Anwesenheit erfassen, Testnoten eintragen. Eltern: Anwesenheit, Noten, fällige Gebühren |
| Gespeicherte Daten | Die Daten, die die App speichert, und was jeder Eintrag enthält | Schüler, Kurse, Anwesenheit pro Stunde, Tests und Noten, Gebührenraten und Quittungen |
| Integrationen | Externe Dienste, mit denen sie sich verbindet, und wie | Online-Zahlung der Gebühren über einen Zahlungsanbieter, mit einer Quittung für jede Rate |
| Vorerst ausgelassen | Was diese Version nicht kann | Keine Prüfung auf Überschneidungen im Stundenplan; kein Import der Daten des Vorjahres |
| Kostenobergrenze | Was der Build höchstens kosten kann | Ein Höchstbetrag, der vor der Freigabe angezeigt wird, keine Schätzung nach der Arbeit |
Die Bildschirme nach Rolle sind der Teil, den viele nur überfliegen, und genau er ist am wichtigsten. Eine App besteht eigentlich aus mehreren Apps, die sich einen Datenbestand teilen: der Ansicht des Inhabers, der der Nachhilfelehrkraft und der der Eltern. Wenn Sie die Bildschirme Rolle für Rolle lesen, bemerken Sie, dass eine Nachhilfelehrkraft zwar die Anwesenheit erfassen kann, aber niemand einen Fehler darin korrigieren kann.
Die Zeile vorerst ausgelassen ist genauso wichtig. Sie sagt Ihnen, was Sie nicht bekommen, und das ist die übliche Quelle für Enttäuschungen nach einem Build. Eine kurze, ehrliche Liste von Ausschlüssen ist ein Zeichen für eine gute Spezifikation, nicht für eine schwache.
Wenn Sie Deployflix eine App beschreiben, folgt die Spezifikation, die es schreibt, diesem Aufbau: wer die App nutzt, ihre Bildschirme, die gespeicherten Daten, was vorerst wegbleibt und was der Build höchstens kosten kann, in der Sprache, in der Sie geschrieben haben. Wenn etwas in Ihrer Beschreibung unklar ist, fragt Deployflix nach, bevor es plant. So funktioniert es zeigt, wo die Spezifikation zwischen den Schritten steht.
Wie lesen und hinterfragen Sie eine App-Spezifikation?
Lesen Sie eine Spezifikation nicht wie einen Vertrag, von oben nach unten. Lesen Sie sie wie einen Tag in Ihrem Unternehmen.
- Gehen Sie einen echten Tag in jeder Rolle durch. Worauf tippt die Person, was sieht sie, was gibt sie ein? Machen Sie dann dasselbe für jede andere Rolle.
- Verfolgen Sie einen Datensatz von Anfang bis Ende. Wählen Sie einen einzelnen Schüler, eine Bestellung oder eine Buchung. Wer legt den Eintrag an, wer ändert ihn, wer kann ihn löschen, und wo landet er am Ende?
- Achten Sie auf die Fälle, in denen etwas schiefgeht. Eine stornierte Buchung, eine Erstattung, ein falscher Eintrag, eine fehlgeschlagene Zahlung, ein Mitglied, das austritt. Wenn die Spezifikation nur beschreibt, was gut läuft, fragen Sie, was passiert, wenn etwas schiefgeht.
- Prüfen Sie jede Zahl und jedes Wort, das Sie drucken würden. Rechnungsformate, Gebührenraten, Steuerzeilen und Quittungsnummern sollten dazu passen, wie Sie heute arbeiten. Wenn Ihre Rechnungen eine Steuer wie GST, Mehrwertsteuer oder Umsatzsteuer ausweisen müssen, prüfen Sie die Angaben mit Ihrem Steuerberater.
- Fragen Sie bei allem Vagen nach. Wörter wie verwalten, verfolgen, einfach und Berichte verbergen Entscheidungen. Fragen Sie: Welcher Bericht, mit welchem Inhalt, für wen?
Auf welche Lücken sollten Sie vor der Freigabe achten?
Die meisten Spezifikationen, die schiefgehen, sind nicht falsch, sondern unvollständig. Diese Lücken kommen am häufigsten vor.
Wer was sehen darf
Rollen sind leicht zu benennen und leicht vage zu lassen. Prüfen Sie, was jede Rolle sehen kann, nicht nur, was sie tun kann. Kann eine Nachhilfelehrkraft Gebühren sehen? Können Eltern die Noten eines anderen Kindes sehen? Kann ein Mitarbeiter die Kundenliste herunterladen? Wenn die App personenbezogene Informationen speichert, legen Sie jetzt fest, wer sie sehen darf.
Bearbeiten, Stornieren und Rückgängigmachen
Jeder Eintrag muss eines Tages korrigiert werden. Prüfen Sie, ob die Spezifikation sagt, wer einen Eintrag bearbeiten oder stornieren darf und ob der alte Wert erhalten bleibt.
Geld
Wenn die App Zahlungen annimmt, sollte die Spezifikation die Zahlungsschritte zeigen: wie Kunden bezahlen können (per Karte und mit lokalen Zahlungsmethoden), wofür bezahlt wird, ob Teilzahlungen möglich sind, was der Kunde anschließend erhält und was bei einer ausstehenden oder fehlgeschlagenen Zahlung passiert. Die Regeln für Rückerstattungen legen Sie als Unternehmen fest – halten Sie sie deshalb schriftlich fest. Zahlungsanbieter berechnen üblicherweise einen Prozentsatz pro Transaktion, in vielen Ländern zuzüglich einer festen Gebühr. Prüfen Sie deshalb die Preisseite Ihres Zahlungsanbieters. Deployflix-Apps nehmen Zahlungen über einen Zahlungsanbieter wie Razorpay oder Cashfree an; internationale Zahlungsanbieter folgen in Kürze. Unsere Integrationsseite zeigt, welche Anbindungen bereits verfügbar sind.
Nachrichten und Erinnerungen
Wenn Sie Erinnerungen erwarten, sagen Sie, wie sie die Menschen erreichen sollen: per E-Mail, in der App oder auf anderem Weg. Wenn die Spezifikation keinen Kanal nennt, gehen Sie davon aus, dass es keinen gibt.
Ihre vorhandenen Daten
Tabellen und alte Register müssen oft in die neue App übernommen werden. Fragen Sie, ob die Übernahme Teil der Spezifikation ist oder auf der Liste vorerst ausgelassen steht.
Geräte und Sprachen
Wird die App auf einem Handy, einem Computer an der Ladentheke oder auf beidem genutzt? Soll sie neben Englisch auch auf Spanisch, Arabisch, Französisch oder in einer anderen Sprache verfügbar sein? Diese Entscheidungen prägen die Oberflächen und sollten deshalb vor dem Build feststehen. Deployflix verfasst die Texte Ihrer App in der gewünschten Sprache und ist selbst in 41 Sprachen verfügbar.
Warum die Spezifikation freigeben, bevor irgendetwas gebaut wird?
Weil es günstiger ist, einen Satz zu ändern, als eine App zu ändern. Vor dem Build ist das Hinzufügen einer Rolle für Eltern oder einer Gebührenrate eine Änderung auf einer Seite. Nach dem Build kann dieselbe Änderung Bildschirme, Daten und Berechtigungen betreffen, die schon fertig waren.
Mit der Freigabe haben Sie außerdem etwas, woran Sie die fertige App messen können. Wenn der Build abgeschlossen ist, öffnen Sie die Spezifikation und haken Sie sie ab: jede Rolle, jeden Bildschirm, jede Art von Daten. Alles, was fehlt, dürfen Sie zu Recht ansprechen.
Die Spezifikation klärt auch die Kosten, bevor Sie sich festlegen. Wenn die maximalen Kosten eines Builds in der Spezifikation stehen, haben Sie diese Zahl bei Ihrer Entscheidung vor Augen. Bei Deployflix wird diese Obergrenze vor Ihrer Freigabe angezeigt. Sie zahlen nur für die Credits, die der Build tatsächlich verbraucht hat. Näheres erfahren Sie auf der Preisseite.
Wie werden Änderungen geplant, nachdem die App gebaut ist?
Eine App ist selten fertig. Ein neuer Kurs, ein zweiter Standort, eine neue Art, Gebühren einzuziehen: Jedes davon verdient dieselbe Sorgfalt wie der erste Build.
Planen Sie eine Änderung als eigene kleine Spezifikation: was sich ändert, welche Rollen und Bildschirme sie betrifft, welche Daten hinzukommen oder sich ändern, was gleich bleibt und was sie kosten kann. Lesen Sie sie mit denselben Fragen und geben Sie sie frei, bevor die Arbeit beginnt. Bewahren Sie die frühere Version auf, damit Sie zu einer funktionierenden zurückkehren können, wenn die Änderung schiefgeht.
So geht Deployflix mit Änderungen um: Sie sagen, was geändert werden soll, Deployflix plant die Änderung als nächste Version, und gebaut wird erst nach der Freigabe. Jede frühere Version bleibt erhalten. In einer Organisation können nur Personen freigeben, deren Rolle das erlaubt, wie die Seite Sicherheit beschreibt.
Eine Vorlage für App-Spezifikationen zum Verwenden
Wenn Sie Ihre eigene Spezifikation schreiben, kopieren Sie diese Überschriften und füllen Sie jede mit einfachen Sätzen:
- Die App in einem Satz: für wen sie ist und welche Aufgabe sie erfüllt.
- Rollen: jede Art von Nutzer und was sie sehen und tun darf.
- Bildschirme nach Rolle: für jede Rolle die Bildschirme und was auf jedem passiert.
- Gespeicherte Daten: jede Art von Eintrag und welche Angaben er enthält.
- Integrationen: Zahlungen, Ihre Domain, App-Stores, wo der Code liegt und alles andere, womit sie sich verbindet.
- Regeln: Gebühren, Grenzen, Fristen, Stornierungen und Erstattungen.
- Vorerst ausgelassen: was diese Version nicht kann.
- Kostenobergrenze und Freigabe: was sie höchstens kosten kann und wer sie abzeichnet.
Ausgearbeitete Beispiele für Rollen, Bildschirme und Daten finden Sie beim Gruppenverwaltungssystem für NachhilfeinstituteEN oder bei der Termin-App für PraxenEN. Wer als Gründer eine Idee testet, kann die Spezifikation noch kürzer halten, mit einer Rolle, ein paar Bildschirmen und einer festen Liste dessen, was wegbleibt, wie bei einer MVP-Web-App für Start-upsEN.
Fragen
Was ist der Unterschied zwischen einer App-Spezifikation und einem Anforderungsdokument?
Vor allem Länge und Förmlichkeit. Ein Anforderungsdokument für ein großes Projekt kann viele Seiten nummerierter Anforderungen umfassen. Eine App-Spezifikation für ein kleines Unternehmen deckt dasselbe ab (wer sie nutzt, was sie tut, was sie speichert), auf einer Seite und in einfachen Worten.
Wer sollte die App-Spezifikation schreiben?
Die Person, die das Unternehmen kennt, liefert den Inhalt: die Rollen, die tägliche Arbeit und die Regeln. Ein Builder kann daraus eine strukturierte Spezifikation machen, aber nur Sie können beurteilen, ob sie stimmt.
Kann ich die Spezifikation nach der Freigabe noch ändern?
Ja. Behandeln Sie es als Änderung: Beschreiben Sie, was anders ist, lesen Sie den aktualisierten Plan und geben Sie ihn erneut frei. Bewahren Sie die frühere Version auf, damit Sie vergleichen oder zurückgehen können.
Wie lang sollte eine App-Spezifikation sein?
Lang genug, dass nichts Wichtiges dem Raten überlassen bleibt, und kurz genug, dass Sie sie ganz lesen. Für die meisten Apps kleiner Unternehmen ist eine Seite richtig; wird sie deutlich länger, überlegen Sie, in Etappen zu bauen.
Beschreiben Sie Ihre App
Schreiben Sie in Ihren eigenen Worten, was Sie brauchen. Deployflix schreibt einen einseitigen Plan mit den Kosten und baut erst nach Ihrer Freigabe.
Kopiert. Fügen Sie es nach der Anmeldung in Deployflix ein.