MediPlan Schritt für Schritt

MediPlan ist eine selbst gehostete Anwendung zum Erfassen, Sortieren, Anzeigen, Importieren, Exportieren und Drucken von Medikationsplänen. Benutzer, Rollen und Einstellungen liegen in einer lokalen SQLite-Datei. Jeder Patient beziehungsweise Mandant besitzt eine eigene XML-Datei.

1. 1
   ZIP entpacken

   Den enthaltenen Ordner mediplan nach C:\laragon\www\mediplan kopieren.

2. 2
   Laragon neu laden

   In Laragon Reload ausführen, damit mediplan.test eingerichtet wird.

3. 3
   Installer öffnen

   http://mediplan.test/install.php im Browser aufrufen.

4. 4
   Administrator anlegen

   Design wählen, Zugangsdaten eingeben und optional Demo-Mandanten, Beispiele sowie QR-Code aktivieren.

5. 5
   Anmelden

   Nach Abschluss über http://mediplan.test/login.php einloggen.

Lade das aktuelle Release-Archiv mit einem Namen wie mediplan-opensource-v0.7.0.zip herunter. Das öffentliche Paket enthält nur neutrale Beispiel- und Demodaten.

Voraussetzungen

Laragon

Fehlende Erweiterungen lassen sich normalerweise über Menu → PHP → Extensions aktivieren. Nach einer Änderung PHP beziehungsweise Laragon neu starten.

Webhosting

Den Projektordner hochladen, PHP 8.1 oder neuer einstellen und sicherstellen, dass storage beschreibbar, aber nicht direkt aus dem Web erreichbar ist. Für den produktiven Betrieb HTTPS verwenden.

Der Installer führt durch die grundlegende Einrichtung:

1. Erscheinungsbild: Neutral, Light oder Dark auswählen.
2. Erster Administrator: Anzeigename, Benutzername und ein Passwort mit mindestens zehn Zeichen eingeben.
3. Startdaten: Optional zwei fiktive Demo-Mandanten und die Beispielbibliothek installieren.
4. QR-Code: Nur aktivieren, wenn die PHP-Erweiterung GD verfügbar ist.
5. Erster Medikationsplan: Patientendaten erfassen und entweder eine XML-Datei hochladen oder eine neutrale Vorlage verwenden.

Nach der Installation erfolgt die Anmeldung mit Benutzername und Passwort. Nach fünf fehlgeschlagenen Versuchen gilt eine Wartezeit von 15 Minuten.

Die Übersicht zeigt Patient, Geburtsdatum, Aktualisierungsstand, Medikationsliste und – sofern aktiviert – einen QR-Code. Benutzer mit Zugriff auf mehrere Pläne können oben den aktuellen Patienten wechseln.

Der Bereich Bearbeiten steht Administratoren und Benutzern mit Bearbeiter-Recht zur Verfügung. Dort lassen sich bestehende Einträge ändern, neue Medikamente ergänzen oder nicht mehr verwendete Einträge kennzeichnen.

• Handelsname und Wirkstoff möglichst vollständig eintragen.
• Stärke, Einheit und Form entsprechend Packung oder Verordnung erfassen.
• Morgens, mittags, abends und zur Nacht können Zahlen, Brüche oder kurze Angaben enthalten.
• Neu, aktiv und abgesetzt steuern Markierung, Filter und Druckausgabe.
• Hinweis und Grund sind Freitextfelder für zusätzliche Angaben.

Nur Administratoren sehen den Verwaltungsbereich. Die Startseite bündelt vier Aufgaben:

Ein Benutzer kann einem oder mehreren Medikationsplänen zugeordnet werden. Die konkrete Zuordnung entscheidet, welche Patienten sichtbar sind.

Jeder Medikationsplan ist ein eigener Mandant mit Patientenname, optionalem Geburtsdatum und einer getrennten XML-Datei. Beim Anlegen gibt es drei Möglichkeiten:

1. einen leeren Plan erzeugen;
2. eine vorhandene Medikationsplan-XML hochladen;
3. eine installierte Beispielvorlage verwenden.

Die internen Verzeichnisnamen bestehen aus zufälligen IDs und enthalten keine Patientennamen. Vor Änderungen an einer XML-Datei wird automatisch eine Sicherung im jeweiligen Mandantenordner angelegt.

Die Nachbestellseite übernimmt ausschließlich aktive und nicht abgesetzte Medikamente des aktuell gewählten Plans. Ein Medikament wird ausgewählt, mit Menge und optionaler Notiz ergänzt und der Liste hinzugefügt.

Die Liste lässt sich drucken oder als Text kopieren. Notizen können für Anzeige und Druck ein- oder ausgeschaltet werden. Die aktuelle Nachbestellliste wird lokal im Browser für den jeweiligen Plan gespeichert und ist daher an dieses Gerät beziehungsweise Browserprofil gebunden.

Über Drucken öffnet sich zunächst ein Optionsfenster:

• Nur aktive Medikamente: Inaktive und abgesetzte Einträge werden ausgelassen.
• Alle Medikamente: Inaktive und abgesetzte Einträge können grau dargestellt werden.
• Sortierung: Reihenfolge wie eingetragen, Handelsname A–Z oder Z–A.

Das Stylesheet legt die Ausgabe fest auf A4 im Querformat fest. Je nach Browser können zusätzliche Kopf- und Fußzeilen erscheinen; diese lassen sich im Druckdialog des Browsers meist deaktivieren.

Einstellungen pro Medikationsplan

Bearbeiter können unter Einstellungen Standardsortierung, Reihenfolge, Tabellen- oder Kartenansicht, Druckmodus und Graudarstellung speichern.

Globale Systemeinstellungen

Administratoren können Neutral, Light oder Dark wählen, den QR-Code aktivieren beziehungsweise deaktivieren und die Beispielbibliothek installieren oder aktualisieren.

QR-Code

Der QR-Code öffnet die URL der geschützten Anwendung. Er macht den Medikationsplan nicht öffentlich; die Anmeldung bleibt erforderlich. Für die Bildausgabe wird die PHP-Erweiterung GD benötigt.

Storage sichern

Unter Administration → Datensicherung wird ein geprüftes ZIP mit SQLite-Datenbank, Mandanten, XML-Plänen, XML-Sicherungen, installierten Beispielen und Installationsdaten erzeugt. Das Archiv besitzt ein Manifest mit SHA-256-Prüfsummen.

Automatisch erkannter Update-Modus

Ab Version 0.5.0 erkennt install.php eine vorhandene SQLite-Datenbank automatisch. Statt der Ersteinrichtung erscheint dann der geschützte Update-Modus. Benutzer, Mandanten, Einstellungen und XML-Medikationspläne werden übernommen.

1. Neue Programmdateien über die vorhandene Installation kopieren.
2. Das bestehende Verzeichnis storage unbedingt behalten.
3. install.php öffnen und als Administrator anmelden.
4. Die vorausgewählte vollständige Storage-Sicherung aktiviert lassen.
5. Update starten und anschließend Anmeldung, Pläne, QR-Code, Druck und Nachbestellung prüfen.

Sicherung zurückspielen

Vor der Wiederherstellung prüft MediPlan Archivpfade, Prüfsummen, SQLite-Integrität und XML-Dateien. Zusätzlich wird automatisch der aktuelle Stand gesichert. Nach dem Zurückspielen endet die Sitzung, da die Sicherung andere Benutzer und Passwörter enthalten kann.

Die Medikationspläne bleiben als XML-Dateien erhalten. Dadurch lassen sie sich unabhängig von der Benutzerverwaltung sichern, austauschen und erneut importieren.

Export

In der Übersicht lädt die Schaltfläche XML den aktuellen Plan herunter. Die Datei enthält den Medikationsplan, aber keine Benutzerkonten oder Passwörter.

Import

Beim Anlegen eines Mandanten kann eine bestehende XML hochgeladen werden. Die Anwendung akzeptiert nur einen gültigen Wurzelknoten <medikationsplan> und blockiert DOCTYPE- sowie ENTITY-Deklarationen.

Medikationsdaten sind Gesundheitsdaten. Die technische Anwendung ersetzt keine rechtliche und organisatorische Datenschutzprüfung.

• Produktiv ausschließlich über HTTPS betreiben.
• storage, Sicherungsarchive und private XML-Dateien vor direktem Webzugriff schützen.
• Starke, individuelle Passwörter verwenden und nicht gemeinsam nutzen.
• Sicherungen verschlüsselt und getrennt vom Webspace aufbewahren.
• Nur notwendige Benutzer und Plan-Zuordnungen anlegen.
• Keine echten Gesundheitsdaten in GitHub, Supportforen oder öffentliche Fehlerberichte kopieren.
• Vor einer öffentlichen Registrierung Datenschutzkonzept, Löschung, Einwilligungen und Sicherheitsprüfung ergänzen.

MediPlan lädt keine externen Analyse-, Werbe- oder Trackingdienste und überträgt Medikationsdaten nicht absichtlich an Drittanbieter.

MediPlan wird als freie Open-Source-Software unter der Lizenz AGPL-3.0-or-later entwickelt. Fehlerberichte, Verbesserungsvorschläge und Beiträge zum Quellcode sind willkommen.

EntwicklungJohannes Teitgejohannes@teitge.de

Entwicklung und Projektpflege. Kontakt für technische Hinweise zur Software – keine medizinische Beratung.