Vorstand OGV Haushaltsplan – Technische Dokumentation 7. Okt. 2026 · @Matthias Boeddinghaus Überblick Der OGV-Haushaltsplan ist eine kleine PHP-Webanwendung unter ohofer-verband.de/bu20dg26et, mit der der Vorstand den Haushalt gemeinsam plant. Sie läuft ohne Datenbank auf dem vorhandenen WordPress-Hosting und speichert alles in geschützten Dateien. Bereich Umfang Nutzer 1 Admin, 10 Zugänge (01a–10a), davon 7 per Einladungscode selbst einrichtbar Planung Kategorien A–D, Betrag = Vorgabe × Faktor, Beträge in ganzen Euro Personal AG-Brutto aus AVR-DD-Tabelle (gültig ab 01.09.2026) nach EG und Stufe Nachvollziehbarkeit Änderungsmarkierung je Zugang in fester Farbe, Änderungsliste, 40 Versionen Export CSV (Semikolon, UTF-8 mit BOM, für Excel) Eine zweite, getrennte Fassung läuft als Artifact in Claude; sie teilt keine Daten mit der Webversion. Architektur und Dateien Die App liegt als eigener Ordner bu20dg26et/ im WordPress-Webroot; WordPress leitet nur Anfragen um, für die es keine Datei gibt, und lässt den Ordner daher in Ruhe. [embed: node/ae3f626a-f259] Der Browser holt die Seite über index.php und arbeitet danach nur noch über api.php; beide nutzen lib.php, das allein auf data/ zugreift. Datei Aufgabe index.php Anmeldung, Selbst-Anmeldung, Seitengerüst für angemeldete Nutzer api.php JSON-Schnittstelle für Laden, Speichern, Versionen, Konto, Admin-Funktionen lib.php Speicher, Sitzung, Anmeldung, Bereinigung, Berechnung, Änderungsvergleich, AVR-Tabelle; direkt aufgerufen 403 app.js Oberfläche: Tabelle, Kategorien, Live-Rechnung, Markierungen, CSV-Export, Abfrage alle 20 s app.css Gestaltung, heller und dunkler Modus, Signalfarben login.js Umschalten zwischen Anmelden und Zugang einrichten .htaccess kein Verzeichnislisting, lib.php gesperrt, noindex data/.htaccess sperrt den Datenordner komplett Datenhaltung und Datenmodell Alle Daten liegen im Ordner data/ als JSON in PHP-Dateien mit vorangestelltem . Direkt aufgerufen liefern sie nichts; zusätzlich sperrt data/.htaccess den Zugriff. Schreibvorgänge laufen unter einer Dateisperre ( data/.lock) und werden über eine Temporärdatei atomar ersetzt. Datei Inhalt data/state.php Aktueller Plan: version, plan, cfg, marks, savedAt, savedBy data/users.php Zugänge: Kennwort-Hash (bcrypt), Rolle, Anzeigename, Farbe, open, mustChange data/settings.php Einladungscode als Hash, Migrationsstand v2 data/attempts.php Fehlversuche je IP (als SHA-256-Hash), Sperrzeit data/history/-.php Je Speichern ein Stand mit Plan, Vorgaben und Summen; die neuesten 40 bleiben Plan ( plan) – title, year, rows[]. Jede Zeile: id, name, cat (A–D), f2 (Faktor), f2typ ( pct oder qty), ein (Einnahme/Refinanzierung in €), stufe (1–5). Vorgaben ( cfg) – agPct (AG-Nebenkosten in %), jsz (Jahressonderzahlung in Monatsentgelten), v{zeilen-id} mit f1 (Vorgabe in €), tarif (leer oder AVR-DD), eg (1–13). Vorgaben liegen getrennt vom Plan, damit nur der Admin sie ändern kann. Markierungen ( marks) – je Zeile und Feld: wer ( by), wann ( at), Ausgangswert ( from); dazu meta für Titel, Jahr und AVR-Werte, removed[] für gelöschte Zeilen und since für den zuletzt festgeschriebenen Stand. Anmeldung, Rollen und Sicherheit Der Server prüft jede Berechtigung selbst; die Oberfläche blendet nur aus, was ohnehin abgelehnt würde. Aktion Admin Zugang Titel, Faktor, Stufe, Einnahmen ändern, Zeilen anlegen/löschen ja ja Vorgabe, Tarif, EG, AG-Nebenkosten, Jahressonderzahlung ja nein (vom Server ignoriert) Stand festschreiben, Anzeigenamen, Einladungscode, Plätze freigeben ja nein Eigenes Kennwort ändern, CSV-Export, Versionen laden ja ja Selbst-Anmeldung – Mit gültigem Einladungscode, Name und eigenem Kennwort (mind. 10 Zeichen) belegt eine Person den nächsten freien Platz 01a–07a und sieht danach ihren Benutzernamen. Ohne gesetzten Code ist die Selbst-Anmeldung aus. Doppelte Namen werden abgewiesen. Pflicht-Kennwortwechsel – Zugänge mit mustChange (Musterkennwort, Admin nach Zurücksetzen) sehen nur das Kennwortformular; save, ack, names, invite und slot liefern bis dahin 403. Schutzmaßnahmen Kennwörter und Einladungscode nur als bcrypt-Hash ( password_hash) Nach 5 Fehlversuchen 15 Minuten Sperre je IP, zusätzlich 0,4 s Verzögerung je Fehlversuch Sitzungscookie OGVHP: HttpOnly, Secure, SameSite=Strict, auf den Ordner begrenzt; Abmeldung nach 4 Std. Inaktivität; neue Sitzungs-ID bei Anmeldung und Kennwortwechsel CSRF-Token bei jedem POST (Header X-CSRF bzw. Formularfeld) Header: Content-Security-Policy (Skripte nur vom eigenen Server), X-Frame-Options: DENY, noindex, no-store Eingaben werden serverseitig bereinigt: Längen, Zahlenbereiche, erlaubte Werte, max. 200 Zeilen, max. 500 KB je Anfrage Berechnungslogik Jede Zeile ergibt einen Betrag aus Vorgabe und Faktor, auf ganze Euro gerundet; Summen addieren die gerundeten Zeilen. Browser ( app.js) und Server ( lib.php) rechnen identisch, der Server für Versionen und Summen. \text{Betrag} = \operatorname{round}\left(\lvert \text{Vorgabe} \rvert \cdot \text{Faktor}\right), \quad \text{Faktor} = \begin{cases} f_2 / 100 & \text{bei \%} \\ f_2 & \text{bei Anzahl} \end{cases} Kategorie A (Einnahmen): Betrag zählt als Einnahme. Kategorien B–D: Betrag zählt als Ausgabe; das Feld „Einnahmen“ der Zeile (Refinanzierung) zählt zusätzlich als Einnahme. Saldo = Summe Einnahmen − Summe Ausgaben; Kostendeckung = Einnahmen ÷ Ausgaben. AVR-DD-Zeilen – Ist der Tarif AVR-DD, ersetzt das AG-Brutto die frei eingetragene Vorgabe: \text{AG-Brutto} = \operatorname{round}\left(M_{EG,Stufe} \cdot (12 + \text{JSZ}) \cdot \left(1 + \tfrac{\text{AG-Nebenkosten}}{100}\right)\right) M ist das Monatsentgelt Vollzeit (39 Std.) aus der eingebauten Tabelle EG 1–13, Stufe 1–5, gültig ab 01.09.2026. Voreinstellung: JSZ = 1,0 Monatsentgelt, AG-Nebenkosten = 25 % (Schätzwert, mit Lohnbuchhaltung abgleichen). Stufen, die es in einer EG nicht gibt (z. B. EG 1, Stufe 1), sind nicht wählbar. Die Tabellenwerte stammen von tarifvertrag-online.de und tarif-gehalt.de; vor Beschlüssen mit der offiziellen ARK.DD-Tabelle abgleichen. Änderungsverfolgung und Versionen Der Server vergleicht beim Speichern den neuen mit dem gespeicherten Stand und trägt jede Abweichung mit dem angemeldeten Zugang ein; der Browser kann den Urheber nicht vorgeben. Farben: fest je Zugang (Admin 0, Zugang 01–10 = Farbe 1–10), in hellem und dunklem Modus definiert. Markierung: farbiger Balken und Hintergrund am geänderten Feld, Tooltip mit Person, Zeit und Vorher-Wert. Änderungen in ausgeblendeten Spalten markieren zusätzlich den Titel. Zugeklappte Kategorien zeigen Farbpunkte im Kopf. Ungespeichert: gestrichelter Rahmen in der eigenen Farbe, nur im eigenen Browser. Rückkehr zum Ausgangswert: Wird ein Feld auf den festgeschriebenen Wert zurückgesetzt, verschwindet die Markierung. Festschreiben (Admin): setzt alle Markierungen zurück; der aktuelle Stand wird neuer Ausgangspunkt ( marks.since). Gleichzeitiges Arbeiten – Jeder Stand hat eine version. Speichern sendet die Basisversion mit; weicht sie ab, antwortet der Server mit 409 und dem neuen Stand. Die eigenen Eingaben bleiben erhalten, ein Hinweis bietet „Neuere Fassung laden“ an. Alle 20 Sekunden fragt die Seite neue Stände ab (nicht bei verstecktem Tab). Versionen – Jedes Speichern mit Änderungen legt eine Datei in data/history/ an; ältere als die 40 neuesten werden gelöscht. „Laden“ holt einen Stand in den Editor, übernommen wird er erst mit „Speichern“. Ein Zugang ohne Admin-Recht lädt nur den Plan, die Vorgaben bleiben. API-Referenz Alle Aufrufe gehen an api.php?a=, brauchen eine gültige Sitzung (sonst 401) und antworten mit JSON. POST-Aufrufe brauchen den Header X-CSRF und einen JSON-Körper. Aktion Methode Recht Zweck state GET alle Plan, Vorgaben, Markierungen, Zugänge, eigener Zugang, CSRF-Token save POST alle* {base, plan, cfg?} speichern; 409 bei veralteter base; cfg nur vom Admin history GET alle Liste der Versionen mit Zeit, Person, Summen version GET alle &id= einen Stand laden ( plan, cfg) passwd POST alle {old, new}, mind. 10 Zeichen, hebt mustChange auf ack POST Admin* Markierungen zurücksetzen (Stand festschreiben) names POST Admin* {names:{login: name}} Anzeigenamen setzen invite POST Admin* {code} Einladungscode setzen (mind. 8 Zeichen), leer = abschalten slot POST Admin* {login} Platz 01a–07a freigeben (Kennwort löschen) logout POST alle Sitzung beenden * gesperrt (403), solange der Zugang sein Kennwort ändern muss. Anmeldung und Selbst-Anmeldung laufen nicht über die API, sondern als Formular-POST an index.php (Felder login/ pass bzw. reg, code, name, p1, p2, jeweils mit csrf). Betrieb Wichtigste Regel: Bei Updates nur Programmdateien überschreiben, den Ordner data/ nie hochladen – sonst gehen Planstände, Zugänge und Kennwörter verloren. Voraussetzungen – Apache mit .htaccess (AllowOverride), PHP ab 7.4, Schreibrechte des Webservers auf data/ und data/history/. Das WordPress-Hosting erfüllt das. Erstinstallation Ordner bu20dg26et per FTP in das Hauptverzeichnis der Website laden (neben wp-config.php), inklusive .htaccess-Dateien. Schreibrechte für data/ und data/history/ setzen (meist 755 oder 775). Prüfen: /bu20dg26et/data/state.php zeigt nichts oder 403. Als Admin anmelden, Start-Kennwort ändern, Einladungscode setzen. Update – Geänderte Dateien aus index.php, api.php, lib.php, app.js, app.css, login.js überschreiben. In index.php die Variable $v erhöhen, damit Browser neue CSS/JS laden; danach Strg + F5. Datenänderungen (z. B. Migration v2) laufen beim ersten Aufruf automatisch. Sicherung – Ordner data/ regelmäßig per FTP herunterladen. Wiederherstellen = Ordner zurückspielen. Admin-Kennwort vergessen – Einmal-Datei reset-admin.php hochladen und aufrufen: setzt das Admin-Kennwort auf das Start-Kennwort mit Pflichtwechsel, hebt Sperren auf und löscht sich selbst. Danach prüfen, dass die Datei weg ist. Neue AVR-DD-Tabelle – Die Werte stehen doppelt: AVR in lib.php und in app.js. Beide gleich ändern, Gültigkeitsdatum anpassen, $v erhöhen. Grenzen und offene Punkte Ein Plan: Es gibt genau einen Haushaltsplan; für ein neues Jahr wird er überschrieben (Versionen bleiben). Mehrere Jahre parallel bräuchten eine Erweiterung. Konflikte: Gleichzeitiges Speichern wird erkannt, aber nicht zusammengeführt; die zweite Person prüft und speichert erneut. Musterkennwörter 08a–10a: solange ungenutzt, mit bekanntem Muster anmeldbar (Pflichtwechsel greift). Bei Bedarf freigeben oder zufällige Kennwörter setzen. Kein Kennwort-Reset per E-Mail: Vergessene Kennwörter setzt der Admin über „Freigeben“ zurück (01a–07a); der Admin selbst über reset-admin.php. AVR-DD-Werte doppelt im Code: muss bei jeder Tarifrunde von Hand nachgezogen werden. AG-Nebenkosten pauschal: ein Prozentsatz für alle Stellen; Beitragsbemessungsgrenzen und Zusatzversorgung im Einzelnen sind nicht abgebildet. Claude-Fassung getrennt: Änderungen dort erreichen die Webversion nicht.