Hydraulik im Browser: ein Planungsassistent für Entwässerungsrinnen

Ausgangslage

Entwässerungsrinnen sieht man überall: auf Parkplätzen, an Tankstellen, in Fußgängerzonen und vor Garagen. Welche Rinne an welcher Stelle die richtige ist, hängt von Fläche, Regenmenge, Gefälle und Belastung ab. Planer mussten diese hydraulische Auslegung mit Tabellen, Formeln und Erfahrung selbst vornehmen. Das war aufwendig und fehleranfällig.

Ein Hersteller von Entwässerungssystemen wollte seinen Kunden diese Arbeit abnehmen: mit einem Online-Assistenten, der aus den Projektdaten die passende Rinne berechnet und eine fertige Planungsunterlage erzeugt.

Die Ausgangsbasis war anspruchsvoll. Die Website des Herstellers lief auf TYPO3 in vier Sprachen, und die Produktdaten kamen aus einem AS/400-Warenwirtschaftssystem, mit dem die Website täglich synchronisiert wurde. Der Assistent musste sich in diese Landschaft einfügen.

Ich habe das Projekt 2008 für CrossData-Tools konzipiert und umgesetzt.

Mein Beitrag

Ich habe das Projekt komplett in einer Hand umgesetzt:

• Ausarbeitung der Spezifikation: Ablauf, Datenfluss, Berechnung, PDF-Ausgabe
• Programmierung des Assistenten
• Einbindung in die bestehende TYPO3-Website und den Datenbestand aus dem AS/400-System
• PDF-Erzeugung der Planungsunterlagen

Technische Umsetzung

Datenfluss. Die Produktdaten stammten aus dem AS/400-System und kamen über die tägliche Synchronisation in die TYPO3-Website. Der Assistent griff auf diesen Datenbestand zu. So arbeitete er immer mit den aktuellen Produkten und Abmessungen, ohne dass Daten ein zweites Mal gepflegt werden mussten.

Interaktiver Assistent. Der Planer gibt Schritt für Schritt die hydraulischen Daten seines Projekts in ein Formular ein. Damit das ohne ständiges Neuladen der Seite funktioniert, habe ich den Assistenten mit Ajax und dem Dojo-Toolkit gebaut. 2008 war das noch keine Selbstverständlichkeit, für eine flüssige Bedienung aber entscheidend. Aus den Eingaben berechnet der Assistent die Dimensionierung der Rinne und schlägt passende Produkte vor.

Fertige Planungsunterlage als PDF. Am Ende steht kein Bildschirmergebnis, sondern ein Dokument, das der Planer weitergeben kann. Die PDF-Ausgabe habe ich mit PDFlib umgesetzt, zusammen mit PDI, der Erweiterung zum Einbinden bestehender PDF-Seiten. So ließen sich vorhandene Produktunterlagen des Herstellers als Vorlagen direkt in das erzeugte Dokument übernehmen, statt sie nachzubauen.

Sauberer Code. Die Anwendung ist objektorientiert in PHP 5 geschrieben. Dokumentiert habe ich mit PHPDoc, der Code folgt dem Zend Coding Standard. Das macht ihn für spätere Erweiterungen und andere Entwickler lesbar.

Ergebnis

• Ein Online-Assistent, der die hydraulische Auslegung von Entwässerungsrinnen übernimmt
• Automatisch erzeugte Planungsunterlagen als PDF, mit eingebundenen Herstellervorlagen
• Produktdaten direkt aus dem AS/400-System, ohne doppelte Pflege
• Eingebettet in eine bestehende viersprachige TYPO3-Website
• Konzept, Spezifikation und Umsetzung aus einer Hand

Was ich daraus mitnehme

Das Projekt liegt lange zurück, und die eingesetzte Technik ist heute überholt. Das Muster dahinter begegnet mir aber bis heute immer wieder: Fachwissen, das bisher in Tabellen und Köpfen steckte, wird zu einem Werkzeug, das Kunden selbst bedienen. Dafür braucht man drei Dinge: verlässliche Daten aus dem bestehenden System, eine Bedienung, die den Fachanwender nicht ausbremst, und ein Ergebnis, das er direkt weiterverwenden kann. Meistens ist das ein Dokument.

Gelernt habe ich auch, wie viel eine gute Spezifikation wert ist. Wer Ablauf, Daten und Ausgabe vorher genau beschreibt, kann eine Fachanwendung auch allein sauber umsetzen.