Wie wir eine komplexe EdTech-Plattform ohne Dokumentation erfolgreich übernommen und weiterentwickelt haben
Berufsbildungsportal
Einleitung
Unser Kunde wandte sich an uns, als die Weiterentwicklung einer bestehenden Bildungsplattform ins Stocken geraten war: Das ursprüngliche Entwicklerteam hatte das Projekt verlassen, ohne eine technische Dokumentation zu hinterlassen. Dies gefährdete den Start neuer Kurse, führte zu Verzögerungen und drohenden finanziellen Verlusten.
Da die Plattform bereits aktiv genutzt wurde, war es entscheidend, schnell wieder die Kontrolle über das System zu gewinnen, um Unterbrechungen im Betrieb zu vermeiden. Wir halfen dem Kunden, die technische Kontrolle wiederherzustellen, die Release-Prozesse neu zu etablieren und die Plattform zuverlässig weiterzuentwickeln – ohne bei null beginnen zu müssen.
Systembeschreibung
Das Projekt umfasste eine groß angelegte EdTech-Plattform mit umfangreichen Funktionen:
- Verwaltung von Kursen, Videolektionen und Vorlesungen
- Online-Prüfungen und -Tests
- Persönliche Dashboards für Studierende und Lehrkräfte
- Verwaltung von Lerngruppen, Zeitplänen und Rollenrechten
- Analyse von Lernerfolg und Nutzeraktivität
Die Plattform basierte auf einer Microservice-Architektur:
- 17 Laravel-basierte Microservices mit Kommunikation über REST-APIs
- Clientseitige Anwendung mit Nuxt.js (SSR) für hohe Performance und gute SEO
- Individuelle Oberfläche für jeden Benutzertyp
- Spitzenlast von bis zu 600 Requests pro Sekunde
- Über 20.000 aktive Nutzer
- Anbindungen an externe Video-Hosting- und Authentifizierungsdienste
Besondere Herausforderung: Anstelle des Laravel-Standards Eloquent wurde ein selbst entwickelter Data Mapper eingesetzt. Dieses interne ORM war nicht dokumentiert und wich stark von bekannten Lösungen ab, was die Einarbeitung erheblich erschwerte.
Problem: Keine technische Dokumentation
Ausgangslage
Die Plattform war zwar produktiv, aber technisch intransparent: zahlreiche Microservices, keine Übersicht, keine Schemata oder API-Dokumentationen. Frühere Entwickler standen nicht mehr zur Verfügung, um Hilfestellung zu leisten.
Vorgehen
- Deployment in einer isolierten Testumgebung und vollständiges technisches Audit
- Erstellung einer Übersicht über die internen API-Verbindungen
- Aufbau einer internen Dokumentation der wichtigsten Module
- Abstimmung mit den QA- und DevOps-Teams des Kunden
- Identifikation von Schwachstellen und Risiken in der Architektur
Ergebnis
Bereits in den ersten beiden Tagen begann das Team, einfache Änderungen an der Anwendung vorzunehmen. Mit jedem weiteren Tag wurden zunehmend komplexere Aufgaben übernommen. So entwickelten wir ein ganzheitliches Verständnis der Systemarchitektur und lernten, ihre Elemente mit den geschäftlichen Anforderungen in Beziehung zu setzen, wodurch es uns möglich wurde, geschäftliche Aufgaben sicher und zuverlässig umzusetzen.
Problem: Arbeiten mit einem nicht standardisierten Data Mapper
Ausgangslage
Die Plattform verwendete kein Eloquent, sondern einen individuell entwickelten Data Mapper – ohne Tests, ohne Dokumentation und ohne Bezug zu etablierten Libraries (z. B. Doctrine, Laravel-DataMapper usw.).
Vorgehen
Ein Austausch des ORM hätte zu viel Zeit gekostet und ein erhebliches Risiko dargestellt. Stattdessen konzentrierten wir uns darauf, die bestehende Lösung durch praktische Beispiele und systematische Analyse vollständig zu verstehen:
- Manuelle Rekonstruktion der Logik anhand von Tests und gezielten Szenarien
- Erstellung interner Nachschlagewerke und Leitfäden
- Schulung unseres Teams anhand realer Praxisbeispiele und Code-Reviews
- Etablierung einheitlicher Arbeitsweisen im Umgang mit dem Data Mapper
Ergebnis
Der Kunde konnte auf einer stabilen Grundlage weiterentwickeln – ohne das ORM neu aufsetzen zu müssen. Unser Team verstand die Architektur vollständig und konnte neue Features sicher und effizient implementieren.
Ergebnisse
Fazit
Wenn Sie ein bestehendes Projekt ohne technische Übergabe übernehmen müssen, zeigt dieser Fall, dass ein erfolgreicher Neustart möglich ist – ohne den laufenden Betrieb zu unterbrechen. Statt alles neu zu entwickeln, analysierten wir die vorhandene Architektur, brachten unser Team schnell auf Flughöhe und stellten die Handlungsfähigkeit wieder her.
Solche Ergebnisse sind kein Zufall. Sie entstehen durch methodische Entwicklungsprozesse, fundiertes Architekturverständnis und Erfahrung im Umgang mit komplexem Code. Die Fähigkeit, ohne Dokumentation produktiv zu werden, bestehende Systeme zu verstehen und sich rasch in laufende Projekte einzugliedern, zeichnet Webdelo aus. Wir übernehmen Verantwortung in kritischen Situationen und liefern Ergebnisse – nicht auf Basis leerer Versprechen, sondern auf Basis technischer Kompetenz und klarer Methoden.