OGV Haushaltsplan – Technische Dokumentation
· @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.
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 |
|---|---|
|
|
Anmeldung, Selbst-Anmeldung, Seitengerüst für angemeldete Nutzer |
|
|
JSON-Schnittstelle für Laden, Speichern, Versionen, Konto, Admin-Funktionen |
|
|
Speicher, Sitzung, Anmeldung, Bereinigung, Berechnung, Änderungsvergleich, AVR-Tabelle; direkt aufgerufen 403 |
|
|
Oberfläche: Tabelle, Kategorien, Live-Rechnung, Markierungen, CSV-Export, Abfrage alle 20 s |
|
|
Gestaltung, heller und dunkler Modus, Signalfarben |
|
|
Umschalten zwischen Anmelden und Zugang einrichten |
|
|
kein Verzeichnislisting, |
|
|
sperrt den Datenordner komplett |
Datenhaltung und Datenmodell
Alle Daten liegen im Ordner data/ als JSON in PHP-Dateien mit vorangestelltem <?php exit; ?>. 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 |
|---|---|
|
|
Aktueller Plan: |
|
|
Zugänge: Kennwort-Hash (bcrypt), Rolle, Anzeigename, Farbe, |
|
|
Einladungscode als Hash, Migrationsstand |
|
|
Fehlversuche je IP (als SHA-256-Hash), Sperrzeit |
|
|
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-CSRFbzw. 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=<aktion>, 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 |
|---|---|---|---|
|
|
GET |
alle |
Plan, Vorgaben, Markierungen, Zugänge, eigener Zugang, CSRF-Token |
|
|
POST |
alle* |
|
|
|
GET |
alle |
Liste der Versionen mit Zeit, Person, Summen |
|
|
GET |
alle |
|
|
|
POST |
alle |
|
|
|
POST |
Admin* |
Markierungen zurücksetzen (Stand festschreiben) |
|
|
POST |
Admin* |
|
|
|
POST |
Admin* |
|
|
|
POST |
Admin* |
|
|
|
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
bu20dg26etper FTP in das Hauptverzeichnis der Website laden (nebenwp-config.php), inklusive.htaccess-Dateien. - Schreibrechte für
data/unddata/history/setzen (meist 755 oder 775). - Prüfen:
/bu20dg26et/data/state.phpzeigt 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.
No comments to display
No comments to display