Mobile-App-Dokumentation: Checkliste für die Projektübergabe

Was Auftraggeber wirklich übernehmen müssen

Nicht jedes Ergebnis ist ein Dokument. Ein Teil besteht aus Konten, Rollen, Vorführungen und funktionierenden Abläufen.

Der Umfang muss zum Produkt passen. Eine kleine interne Anwendung braucht weniger Unterlagen als ein Marktplatz mit Zahlungen. Dennoch gilt für beide: Kritisches Wissen darf nicht ausschließlich im Kopf einer Person liegen.

Eigentum und Zugriff sind nicht dasselbe

Ein Projektleiter kann Zugriff auf ein Konto haben, ohne es kontrollieren zu können. Entscheidend sind Kontoinhaber, höchste Verwaltungsrolle, Rechnungsadresse und Wiederherstellungsmethode.

Erstellen Sie ein Diensteregister. Es nennt für jeden Anbieter Zweck, Projektname, Inhaber, Administratoren, Zahlungsweg, Verlängerung und Notfallkontakt. Typische Einträge sind Apple Developer, Google Play Console, Cloud-Anbieter, Datenbank, Domain, E-Mail-Versand, SMS, Karten, Zahlungen, Analyse, Absturzberichte und Kundendienst.

Geschäftskritische Konten sollten bei einer Auftragsentwicklung in der Regel dem Auftraggeber gehören. Die Agentur erhält rollenbasierten Zugang. Persönliche Gemeinschaftskonten sind bequem, erschweren aber den Entzug von Rechten und hinterlassen kaum nachvollziehbare Spuren.

Diese Frage gehört bereits in die Auswahlphase. Unsere Fragen an eine App-Agentur helfen, Eigentum, Wartung und Übergabe vor Vertragsbeginn zu klären.

Der Quellcode muss die veröffentlichte Version ergeben

Verlangen Sie die Repositories für mobile Anwendung, Serverteil, Verwaltungsoberfläche und gegebenenfalls Infrastrukturkonfiguration. Ein ZIP-Archiv ist als zusätzliche Sicherung nützlich, aber kein Ersatz für Versionsverlauf, Freigabemarkierungen und nachvollziehbare Änderungen.

Eine kurze Einrichtungsanleitung nennt Werkzeugversionen, Abhängigkeiten, erforderliche Umgebungsvariablen, Startschritte, Testbefehle und den Weg zu einer Testversion. Geheime Schlüssel gehören nicht in diese Datei. Sie werden in einem sicheren, vom Unternehmen kontrollierten Zugang verwaltet.

Der beste Test wird von einem Entwickler durchgeführt, der das Projekt bisher nicht kennt. Er richtet einen sauberen Rechner ein, folgt nur der Anleitung und erstellt die Anwendung. Die Quellcode-Übergabecheckliste von Koder beschreibt ebenfalls eine reproduzierbare Erstellung als zentrale Abnahme.

Dokumentieren Sie außerdem, welcher Quellcodestand zu welcher Store-Version und welcher Serverversion gehört. Sonst kann eine kleine Fehlerkorrektur versehentlich auf eine unpassende Grundlage gesetzt werden.

Gestaltung und fachliche Entscheidungen müssen weiterleben

Exportierte Bilder reichen für die Pflege einer Benutzeroberfläche nicht aus. Übergeben werden die bearbeitbaren Figma-Dateien oder entsprechende Quellen, wiederverwendbare Komponenten, Zustände, Schriften, Symbole und Lizenzangaben.

Ein knappes Entscheidungsprotokoll erklärt Regeln, die sich aus dem Bildschirm nicht ablesen lassen. Wann wird eine Buchung verbindlich? Weshalb darf ein Lieferstatus nicht zurückgesetzt werden? Welche Daten werden beim Löschen eines Kontos erhalten? Solche Entscheidungen betreffen häufig Geld, Datenschutz und Kundendienst.

Auch offene Punkte gehören dazu. Trennen Sie bestätigte Fehler, bewusst aufgeschobene Arbeiten und neue Ideen. Notieren Sie Auswirkung, betroffene Version, Zwischenlösung und Priorität. Kein echtes Produkt ist ohne offene Arbeit; eine ehrliche Liste erleichtert dem nächsten Team den Einstieg.

Daten und Wiederherstellung werden praktisch geprüft

Eine verständliche Systemskizze zeigt App, Server, Datenbank, Dateispeicher, externe Dienste und Verwaltungsoberfläche. Sie muss keine technischen Einzelheiten überladen. Wichtig ist, dass der Verantwortliche Abhängigkeiten und Datenwege erkennt.

Für die Datenbank sollten Schemaquelle, Änderungen, Aufbewahrungsregeln, Ausfuhr und Sicherungsplan beschrieben sein. Stellen Sie anschließend eine aktuelle Sicherung in einer ungefährlichen Testumgebung wieder her. Ein grünes Häkchen im Cloud-Portal beweist noch keine nutzbare Sicherung.

Zur Übergabe gehören auch Warnmeldungen. Wer erfährt heute von Abstürzen, Serverfehlern oder fehlgeschlagenen Zahlungen? Ändern Sie Empfänger und Eskalationsweg, bevor die alte Mannschaft ihre Zugänge verliert.

Bei einer älteren Anwendung bietet sich gleichzeitig eine Prüfung auf Modernisierungsbedarf an. Der Leitfaden zu Wartungskosten hilft anschließend, notwendige Pflege von neuen Funktionen zu trennen.

Store-Konten brauchen einen geregelten Übergang

Die Veröffentlichungsanleitung beschreibt Versionsnummern, die Konfiguration der App-Version, Signierung, interne Testgruppen, Zugänge für die Store-Prüfung, Metadaten und die Vorgehensweise bei einer fehlgeschlagenen Freigabe.

Apple stellt ein formelles Verfahren für die Übertragung einer App in App Store Connect bereit. Google erläutert bei der Übertragung zwischen Entwicklerkonten, welche Inhalte mitgehen und welche Verknüpfungen neu eingerichtet werden müssen. Berichte, Testgruppen oder Berechtigungen verbundener Dienste können beispielsweise gesonderte Arbeit erfordern.

Signaturschlüssel sollten nicht ungeschützt per E-Mail versendet werden. Legen Sie Speicherort, berechtigte Personen und Austauschverfahren fest. Bei Google Play App Signing sind Upload-Schlüssel und eigentlicher App-Signaturschlüssel voneinander zu unterscheiden.

Lassen Sie den ausscheidenden Entwickler eine interne Veröffentlichung vorführen. Danach wiederholt die übernehmende Person den Ablauf. Ein kurzes Bildschirmvideo kann ergänzen, ersetzt aber die schriftliche, aktualisierbare Anleitung nicht.

Ein Abnahmetest mit fünf Ergebnissen

Eine lange Liste kann vollständig aussehen und trotzdem unbrauchbar sein. Prüfen Sie daher konkrete Ergebnisse:

1. Ein neuer Entwickler erzeugt auf einem sauberen System eine Testversion.
2. Der Auftraggeber findet im Admin-Bereich einen Vorgang und die dazugehörigen Protokolle.
3. Eine Datensicherung wird in einer Testumgebung wiederhergestellt.
4. Berechtigte Nutzer bereiten eine interne Store-Freigabe vor.
5. Ein Testzugang wird entzogen und der Vorgang bleibt nachvollziehbar.

Die offene Projektübergabecheckliste von Futurice behandelt die Übergabe zu Recht als eigenes kleines Projekt. Auch die Catalyst-Checkliste stellt die Weiterverwendung durch ein anderes Team in den Mittelpunkt.

So läuft die Übergabe ohne Endspurt

Während der Entwicklung liegen Code, Design und zentrale Konten bereits in gemeinsam kontrollierten Arbeitsbereichen. Wichtige Entscheidungen und veröffentlichte Stände werden fortlaufend markiert.

Vor der Abnahme folgen ein Build auf einem sauberen System, Rechteprüfung, Sicherungswiederherstellung, Fehlerliste und Testveröffentlichung. Danach braucht es einen begrenzten Zeitraum für Rückfragen sowie eine eindeutige Regelung zu Gewährleistung und laufendem Support.

Entziehen Sie nicht mehr benötigte Zugänge erst, wenn die Übernahme geprüft ist. Danach sollten persönliche oder zu weit gefasste Rechte konsequent entfernt werden.

Warnzeichen vor der Schlussabnahme

Stoppen Sie, wenn die App nur auf einem bestimmten Laptop gebaut werden kann, Store-Konten einer nicht erreichbaren Person gehören, Produktionsschlüssel im Code stehen oder nie eine Sicherung wiederhergestellt wurde.

Vage Formulierungen sind ebenfalls ein Risiko. "Liegt in der Cloud" oder "Analyse ist eingerichtet" reichen nicht. Benötigt werden Anbieter, Projekt, Administrator, Rechnungsinhaber und Wiederherstellungsweg.

Fragen zu Nutzungsrechten und geistigem Eigentum richten sich nach Vertrag und Rechtsordnung. Bei erheblichem Wert sollte juristischer Rat eingeholt werden. Eine technische Prüfung erkennt fehlende Bestandteile, ersetzt aber keine rechtliche Bewertung.

Wie Appfyl Kontinuität vorbereitet

Bei einem neuen Projekt erstellen wir früh eine Eigentumsübersicht für Code, Design, Stores, Daten, Infrastruktur, Fremddienste und Support. Dadurch werden wichtige Konten im Namen des Auftraggebers angelegt, bevor provisorische Lösungen dauerhaft werden.

Zur Freigabe verbinden wir die akzeptierte Produktversion mit dem passenden Quellcodestand, den Designdateien, den Umgebungen und der Liste bekannter Punkte. Bei einer übernommenen Altanwendung prüfen wir zuerst, was sich tatsächlich öffnen, bauen und verwalten lässt.

Mit dem interaktiven Appfyl-Projektbriefing lassen sich Rollen und Integrationen vorab sammeln. Genau diese Bestandteile brauchen später klare Eigentümer und Betriebsanleitungen.

Sehen Sie, wie Appfyl Funktionsumfang in veröffentlichte Produkte übersetzt. Appfyl Cases ansehen.

Häufige Fragen