Praxisleitfaden · R, Shiny & individuelle Software
Eine bestehende R- oder Shiny-Anwendung übernehmen
Die Übernahme einer R- oder Shiny-Anwendung beginnt mit einer reproduzierbaren Ausgangsbasis und einem klaren Verständnis ihres analytischen Zwecks. System inventarisieren, repräsentative Ausgaben reproduzieren, Unterschiede untersuchen und Supportumfang vereinbaren: Diese Schritte gehen Änderungen voraus. Ein Rewrite ist eine mögliche Entscheidung, keine Ausgangsannahme.
Leap Dynamics GmbHAktualisiert:
1. Anwendung und Zuständigkeiten erfassen
Erfassen Sie autorisierten Quellcodezugang, Paketabhängigkeiten, R-Versionen, Datenschnittstellen, geplante Jobs, Authentifizierung, Deployment-Konfiguration und vorhandene Dokumentation. Benennen Sie die Personen, die Ausgaben fachlich verstehen, sowie die Infrastrukturverantwortlichen.
Bekannte Fehler werden getrennt von Verbesserungswünschen erfasst. Undokumentiertes Verhalten kann beabsichtigt, überholt oder fehlerhaft sein; die aktuelle Ausgabe allein beantwortet diese Frage nicht.
2. Repräsentative Ausgangsergebnisse reproduzieren
Führen Sie freigegebene Beispieleingaben in einer isolierten Umgebung aus und sichern Sie Tabellen, Dateien und relevantes Anwendungsverhalten. Fehlende Abhängigkeiten oder externe Dienste, die Reproduktion verhindern, werden dokumentiert.
Werkzeuge wie renv können R-Paketabhängigkeiten festhalten. Ein Lockfile ist hilfreich, reproduziert allein aber weder Datenbanken noch Systembibliotheken, Zugangsdaten oder Betriebssystemverhalten. Auch diese Abhängigkeiten gehören in die Dokumentation.
3. Entscheidendes Verhalten prüfen
Gezielte automatische Tests, etwa mit testthat, ergänzen die fachliche Ergebnisprüfung. Ändert sich eine Ausgabe, wird die Ursache untersucht und festgehalten, ob es sich um eine beabsichtigte Korrektur oder eine Regression handelt.
| Ebene | Sinnvolle Prüfungen |
|---|---|
| Analytische Logik | Bekannte Beispiele, Grenzfälle, fehlende Werte und vereinbarte numerische Vergleiche. |
| Datenschnittstellen | Schemaänderungen, leere Ergebnisse, Fehler und erwartete Transformationen. |
| Shiny-Interaktion | Wichtige Nutzerwege, reaktive Abhängigkeiten und Berichtsdownloads. |
| Deployment | Wiederholbarer Start, Konfiguration, Wiederherstellung und nutzbarer Rollback. |
4. Wartung, Modernisierung oder Neubau wählen
Gezielte Korrekturen und Dokumentation können den unmittelbaren Bedarf decken. Refactoring, Abhängigkeitsupdates und Leistungsverbesserungen erhöhen die Wartbarkeit schrittweise. Migration oder Rewrite benötigen eine technische und wirtschaftliche Begründung einschließlich des Aufwands, Vertrauen in Ergebnisse neu herzustellen.
Priorisieren Sie einen Backlog mit dem Anwendungsverantwortlichen. Definieren Sie unterstützte Komponenten, Reaktionsvereinbarungen, Änderungsfreigaben und Release-Zuständigkeiten. Softwarewartung und kontinuierlicher Infrastrukturbetrieb sind unterschiedliche Verantwortungen und werden ausdrücklich vereinbart.
5. Einen nutzbaren Übernahmenachweis liefern
Leap Dynamics kann diese Bestandsaufnahme eigenständig eingrenzen und daraus einen praktischen Wartungs- oder Entwicklungsbeitrag vereinbaren.
- Code- und Abhängigkeitsinventar mit dokumentierter Ausgangsbasis.
- Bekannte Probleme, Testergebnisse und Ausgabevergleiche.
- Priorisierte Verbesserungen, Zuständigkeiten und Wartungsumfang.
- Deployment-, Wiederherstellungs- und Übergabeanleitungen.