Eltern-App ·       Zweck Mittagessen buchen/abrechnen, Krank- und Gesundmeldung, Elterninfos, Zuschüsse (BuT), Monatsbeiträge, Bestätigungsmails Adresse https://kita-bleiche.de/app/ (mit und ohne www) Betreiber Ohofer Gemeinschaftsverband e.V. (Träger der Ev. Kita Bleiche) Hosting goneo Webspace (Apache 2.4, PHP ≥ 8.0) Datenhaltung SQLite-Datei data/kita.sqlite (Standard) – alternativ MySQL/MariaDB Abhängigkeiten keine (kein Composer, kein Framework); QR-Bibliothek assets/qrcode.js (MIT, Kazuhiko Arase) liegt bei Datenbank-Stand Version 7 (wird automatisch hochgezogen) Stand dieses Dokuments 18.11.2026 1. Funktionen im Überblick Eltern (Handy, als Web-App installierbar) Anmeldung per QR-Code oder Login-Code, bleibt 60 Tage angemeldet Mittagessen: Monatskalender je Kind, Tag antippen = buchen/abbestellen, Standard-Essenstage (Abo) Krankmeldung/Abmeldung (mehrere Geschwister gleichzeitig); Gesundmeldung = Krankmeldung verkürzen Elterninfos mit Lesestatus Abrechnung je Monat (alle Posten, Anteil Familie / Kostenträger) Konto: Mail-Adressen für Bestätigungen, QR-Code für weitere Handys, Zuschuss-Status, „Neuen Bescheid eingereicht“ Kita-Team / Admin Tagesliste je Gruppe (Essen, Krankmeldungen), Druck; tägliche Essensliste an die Küche per Mail Familien, Kinder, Mail-Adressen, Gruppen, Optigem-Nr., Login-Codes, QR-Karten Beiträge je Kind (Beitrag k0, Gruppengeld k1, Sonderzeit k3) mit Zahler und Zeitraum Zuschüsse (B1/B2/B3) mit Erinnerungslogik und Bestätigung durch die Leitung Elterninfos schreiben/mailen Monatsabrechnung im Layout der bisherigen Essensliste, CSV-Export für Optigem, Abrechnungsmail Einstellungen, Team-Zugänge, Mail-Protokoll 2. Rollen und Anmeldung Rolle Rechte Anmeldung eltern eigene Kinder, Essen, Krankmeldung, Infos, Abrechnung, Konto Eltern-Code oder QR kita zusätzlich Tagesliste, Familien, Infos, Abrechnung, Zuschüsse Team-Code admin zusätzlich Einstellungen, Team-Zugänge Team-Code Code-Aufbau   Muster Beispiel Eltern Präfix 287 + erste 4 Buchstaben Nachname + Optigem-Nr. des Kindes + 2 Zufallszeichen 287ebel3965u2 Team Präfix 986 + 4 Buchstaben + 4 Ziffern (frei vergeben) 986lead7396 Nachname wird normalisiert: klein, Umlaute → a/o/u, ß → s, Klammern/Leerzeichen/Bindestriche entfernt ( Syla (Bajrami) → syla, El Batoushi → elba). Zufallszeichen: Buchstabe + Ziffer 2–9, ohne i/l/o/0/1; gespeichert in children.code_suffix. Jeder Code eines Geschwisterkindes meldet die ganze Familie an (technisch: Konto familie-@code.invalid). Karte verloren: Familien → Kind → „Neuer Code“ → neue Zufallsendung, alter Code/QR sofort ungültig. QR-Code = https://…/app/?p=code&c=; Groß-/Kleinschreibung egal. Schutz: 10 Fehlversuche je IP in 15 Min. → Sperre ( login_fails). Mehrere Team-Konten dürfen dieselbe Mail-Adresse haben (Unterscheidung über Name + Code). Fallback: Anmeldelink per Mail (einmalig, 20 Min.; Token nur als SHA-256 gespeichert). Diagnose ( diagnose.php): für angemeldete Admins (Einstellungen → „Diagnose öffnen“). Notfall ohne Anmeldung: in config.php 'notfall_zugang' => true setzen, diagnose.php?key=CRON_KEY aufrufen (Admin-Link / Admin-Code), danach sofort wieder false. 3. Fachliche Regeln Regel Standard Einstellbar Essen ändern bis 1 Kita-Tag vorher, 12:00 Uhr ja Krankmeldung storniert Essen am selben Tag bis 08:00 Uhr; Folgetage immer ja Krankmeldung zurücknehmen nicht möglich für Eltern (nur Kita) – Gesundmeldung (früher wiederkommen) bis Vortag 14:00 Uhr; Essen wird ab Rückkehrtag wieder nach Abo gebucht ja Spät gemeldete Krankheitstage Essen wird berechnet, in Abrechnung markiert – Kita-Team darf alle Fristen übergehen – Feiertage Niedersachsen automatisch geschlossen (Neujahr, Karfreitag, Ostermontag, 1. Mai, Himmelfahrt, Pfingstmontag, 3.10., 31.10., 25./26.12.) an/aus Schließtage manuell (Einstellungen) ja Essenspreis mit Gültigkeit; ab 01.01.2027: 4,35 € ja Zuschuss-Erinnerung ab 42 Tagen vor Ablauf, wöchentlich, bis Leitung bestätigt ja Abo-Änderung gilt ab erstem noch änderbaren Tag; Historie bleibt (Tabelle meal_plans) – Antrag gestellt, Zusage fehlt (Warteliste) Leitung vermerkt unter Zuschüsse → „Antrag gestellt“ Kind, Kostenträger und Datum (Standard: heute = Tag der Bestätigung). Ab diesem Tag werden die betroffenen Kosten (B1/B2/B3: Mittagessen; A: Kita-Beitrag k0 ohne festen Zahler) weder Familie noch Amt berechnet, sondern auf die Warteliste gesetzt. Zusage eintragen (Zeitraum laut Bescheid): Wartelisten-Posten im Zeitraum gehen als Nachberechnung an den Kostenträger – im Monat der Zusage, mit ursprünglichem Leistungsmonat. Abgelehnt (oder Bescheid deckt Zeitraum nicht): Wartelisten-Posten gehen als Nachberechnung an die Familie – im Monat der Entscheidung. Bereits abgerechnete Monate ändern sich nicht: Eine Zusage wirkt erst ab Antragsdatum. Antragsdatum daher nicht in schon abgerechnete Monate legen. Eltern werden per Mail informiert (vermerkt / bestätigt / abgelehnt) und sehen zurückgestellte Beträge in ihrer Abrechnung. Schalter (Einstellungen → Allgemein) „Gruppen verwenden“ (Standard aus): aus = keine Gruppenauswahl, Tagesliste als eine Liste „Alle Kinder“, Infos immer an alle. „Eltern sehen Kosten“ (Standard aus): aus = kein Menüpunkt Kosten, keine Preise/Beträge für Eltern, kein Versand der Abrechnungsmail. Zuschuss-Erinnerungen laufen weiter. Login-Codes, QR-Codes und QR-Karten sieht nur die Rolle admin; „Neuer Code“ nur Admin. Monatsabschluss (nur Admin, Abrechnung → „Monat abschließen & sichern“) Erst nach Monatsende, Monate nur der Reihe nach. Beim Abschluss: Abrechnung wird eingefroren ( month_closes.snapshot), komplette Datensicherung data/backup/kita-YYYY-MM-.sqlite (SQLite: VACUUM INTO). Danach für diesen Monat gesperrt: Essen/Abo, Essens-Stornierung durch Krank-/Gesundmeldung, Beiträge (anlegen, löschen, Ende davor), Essenspreise, Schließtage, Antragsdatum. Abrechnung und CSV kommen ab dann immer aus der Sicherung. Wieder öffnen: nur der zuletzt abgeschlossene Monat, nur Admin, mit Pflicht-Begründung (Protokoll). Sicherungsdatei bleibt erhalten. Protokoll (nur Admin, Menü „Protokoll“) Jede Anmeldung (Code, QR, Mail-Link, Gerät/Browser), falsche Codes, Abmeldung. Jede Änderung (alle Formulare) mit Kind/Familie, wichtigen Werten und Ergebnis bzw. Fehlermeldung; Login-Codes maskiert. Filter nach Zeitraum, Familie, Art, Suche; CSV-Export; auf der Familienseite die letzten 15 Aktivitäten. Wer zahlt was (Abrechnung) Mittagessen: Tag für Tag – gilt an dem Tag ein bestätigter Zuschuss (B1/B2/B3), zahlt der Kostenträger, sonst die Familie. Beiträge (k0/k1/k3): ganzer Monat, wenn von ≤ Monat ≤ bis; Zahler je Eintrag (Familie oder Kürzel, z. B. A). Kostenträger (Einstellungen, je Zeile Kürzel|Name|Debitor|Umfang, Umfang essen (Standard) oder beitrag): B1|Jobcenter BuT|3780 · B2|Landkreis BuT|3843 · B3|Landkreis BuT|3879 · A|Agentur für Arbeit Gifhorn|3842|beitrag 4. Verzeichnisstruktur app/ ├── index.php Router (?p=…), Sicherheits-Header, Auto-Update der DB ├── cron.php Cronjobs (queue | kueche | taeglich) ├── diagnose.php Diagnose, Testmail mit SMTP-Protokoll, Notfall-Login (Admin oder Notfallzugang) ├── setup.php Ersteinrichtung – danach löschen ├── manifest.webmanifest Web-App (Startbildschirm) ├── .htaccess HTTPS erzwingen, interne Ordner sperren ├── inc/ (gesperrt) │ ├── config.php Zugangsdaten – NIE überschreiben │ ├── config.sample.php │ ├── bootstrap.php DB, Sitzung, CSRF, Login-Code, Migrationen, Beiträge │ ├── meals.php Kalender, Feiertage, Fristen, Abrechnung, Zuschüsse, Tagesliste │ ├── mailer.php SMTP-Client (STARTTLS/SSL, AUTH LOGIN), Mail-Vorlage, Warteschlange │ ├── header.php / footer.php ├── pages/ (gesperrt) Eltern: home, essen, krank, infos, abrechnung, konto, code, login, auth │ Kita: k_tag, k_familien, k_familie, k_import, k_infos, k_abrechnung, │ k_zuschuss, k_qr, k_einstellungen ├── install/ (gesperrt) schema_sqlite.sql, schema.sql (MySQL) ├── assets/ style.css, app.js, qrcode.js, Icons └── data/ (gesperrt) kita.sqlite, sessions/, mails/ (nur Testbetrieb) 5. Konfiguration ( inc/config.php) Schlüssel Bedeutung base_url z. B. https://www.kita-bleiche.de/app – ohne / am Ende; Basis für Mail- und QR-Links db.driver sqlite (Standard) oder mysql (+ host, name, user, pass) mail.* Absender info@kita-bleiche.de, SMTP-Host/Port/ tls| ssl, Benutzer, Passwort mail.dry_run true = Mails nur nach data/mails/ schreiben (Test) cron_key langer Zufallswert für cron.php (und diagnose.php im Notfall) notfall_zugang false; nur im Notfall true → diagnose.php?key=… ohne Anmeldung login_minutes Gültigkeit Mail-Anmeldelink (20) session_days angemeldet bleiben (60) Alle fachlichen Einstellungen (Fristen, Preise, Gruppen, Präfixe, Kostenträger, Sonderzeiten, Gruppengeld, Optigem-Artikel, Küchen-/Kita-Mail) liegen in der Tabelle settings und werden in der App unter Einstellungen gepflegt. 6. Datenbank Tabelle Inhalt families Familie, Debitor, Notiz, aktiv users Konten: Eltern-Mails, Familien-Code-Konto, Team; rolle, login_code (Team) children Kind, Gruppe, Ein-/Austritt, optigem_nr, login_code, code_suffix meal_plans Standard-Essenstage je Kind mit gueltig_ab meal_days Abweichungen je Tag ( an/ ab, Quelle eltern/krank/kita) meal_prices Essenspreis mit gueltig_ab absences Krank-/Abmeldungen (von, bis, Grund, Bemerkung) closures Schließtage subsidies Zuschüsse/Anträge: Träger, von/bis (YYYY-MM), Status beantragt/ bestaetigt/ abgelehnt/ eingereicht, antrag_am, entschieden_am, Erinnerung child_fees Monatsbeiträge: Art k0/k1/k3, Betrag (Cent), Zahler, von/bis posts, post_reads Elterninfos, Lesestatus login_tokens, login_fails Mail-Anmeldelinks, Fehlversuche mail_queue, mail_log Massenmail-Warteschlange, Versandprotokoll billing_runs versendete Monatsabrechnungen activity_log Protokoll: Anmeldungen und alle Änderungen (wer, Familie, Bereich, Aktion, Details, IP gekürzt), 12 Monate month_closes abgeschlossene Monate: Zeitpunkt, wer, eingefrorene Abrechnung (JSON), Dateiname der Datensicherung settings Einstellungen inkl. schema_version Migrationen laufen automatisch beim ersten Aufruf ( migrate() in bootstrap.php), auch über diagnose.php: Version Änderung 1 Grundschema 2 Login-Codes, Optigem-Nr., Zuschüsse, Fehlversuch-Sperre, Preis 4,35 € ab 01.2027 3 Zufallsendung der Eltern-Codes 4 Monatsbeiträge, Sonderzeiten, Gruppengeld, Kostenträger A 5 Mail-Adresse nicht mehr eindeutig (Team-Konten mit gleicher Adresse) 6 Anträge mit Warteliste ( antrag_am, entschieden_am), Kostenträger-Umfang 7 Aktivitätsprotokoll ( activity_log), Monatsabschluss ( month_closes) 7. Cronjobs (goneo Webcron Manager) Intervall Aufruf Aufgabe alle 5 Min. …/app/cron.php?key=KEY&job=queue Massenmails (Infos, Abrechnung, Erinnerungen) Mo–Fr 08:15 …/app/cron.php?key=KEY&job=kueche Essensliste an Küchen-Mail täglich 02:00 …/app/cron.php?key=KEY&job=taeglich Zuschuss-Erinnerungen, Bemerkungen > 6 Monate leeren, alte Tokens/Logs/Sitzungen löschen Nach Änderung des cron_key alle drei Adressen anpassen. 8. Mailversand Eigener SMTP-Client ( SmtpMailer), Absender info@kita-bleiche.de. Sofort: Bestätigungen (Essen, Abo, Krank-/Gesundmeldung, Zuschuss, Willkommensmail mit Code). Warteschlange ( mail_queue): Elterninfos, Monatsabrechnung, Zuschuss-Erinnerungen – 15 sofort, Rest per Cron. Krank-/Gesundmeldungen und eingereichte Bescheide gehen zusätzlich an kita_email. Eltern ohne Mail-Adresse bekommen keine Mails, sehen alle Hinweise aber in der App. Fehlerbild prüfen: diagnose.php → Testmail mit Protokoll; Einstellungen → Mail-Protokoll. 9. Import und Export CSV-Import (Familien → CSV-Import; Semikolon, UTF-8, Kopfzeile; eine Zeile je Kind): Familie;Debitor;E-Mail 1;E-Mail 2;Vorname Kind;Nachname Kind;Gruppe;Essenstage;Eintritt;Optigem-Nr; Zuschuss;Zuschuss von;Zuschuss bis;Beitrag;Beitrag Zahler;Sonderzeit;Gruppengeld;Eltern-Name Essenstage: Mo-Fr, Mo,Mi,Fr oder 1,3,5; Monate: 08.26, 8/2026, 2026-08. Abgleich: Kind über Optigem-Nr. (sonst Vorname in Familie), Familie über Debitor (sonst Name). Mehrfach einlesbar: Vorhandenes wird nicht doppelt angelegt; Beiträge nur, wenn für die Art noch keiner existiert. Die Kita-Adresse wird nie als Eltern-Mail übernommen. Danach „Einladungen versenden“ → Willkommensmail mit Code an Familien, die sich noch nie angemeldet haben. CSV-Export für Optigem (Abrechnung → CSV): ein Posten je Kind, Artikel und Zahler Zahler;Debitor;Optigem-Nr Kind;Familie;Kind;Gruppe;Leistungsmonat;Abrechnung;Artikel;Bezeichnung;Anzahl;Einzelpreis;Betrag;Tage Abrechnung = laufend oder Nachberechnung YYYY-MM (Posten aus der Warteliste, Leistungsmonat = ursprünglicher Monat). Posten auf der Warteliste erscheinen nicht im Export. Artikel: k0 Beitrag · k1 Gruppengeld · k2 Essen · k3 Sonderzeit (in Einstellungen änderbar). 10. Sicherheit und Datenschutz HTTPS erzwungen, HSTS; inc/ pages/ install/ data/ per .htaccess gesperrt ( Require all denied) – live geprüft 18.11.2026: alle 403. Content-Security-Policy (nur eigene Quellen), Permissions-Policy, display_errors aus (Fehler → data/php-fehler.log), GET-Arrays werden verworfen. CSV-Export gegen Formel-Injektion geschützt (Zellen mit = + - @ werden mit ' entschärft). Ab 50 fehlgeschlagenen Code-Anmeldungen pro Stunde (alle IPs) Warnmail an die Kita. CSRF-Token auf allen Formularen, Prepared Statements, X-Frame-Options: DENY, nosniff. Links innerhalb der App relativ; Mail-/QR-Links immer aus base_url (kein Host-Header-Missbrauch). Login-Codes stehen im Klartext in der DB (für QR-Nachdruck) – Datei data/kita.sqlite ist nicht öffentlich. Freitext zu Abmeldungen wird nach 6 Monaten geleert; nur Sitzungs-Cookie ( kitaapp, HttpOnly, SameSite=Lax). Rechtsgrundlage Art. 6 Abs. 1 lit. b DSGVO (Betreuungsvertrag); Hinweise unter ?p=datenschutz. Zugangsdaten ( config.php, Mail-Passwort, cron_key) nicht in Chats/Screenshots zeigen; bei Offenlegung sofort ändern. 11. Betrieb Update einspielen ZIP entpacken, alle Dateien außer inc/config.php und data/ per FTP überschreiben. App einmal aufrufen (oder diagnose.php) → Datenbank wird automatisch aktualisiert. In diagnose.php prüfen: „Datenbank-Stand 7“. Datensicherung Monatlich automatisch beim Monatsabschluss ( data/backup/), Download unter Abrechnung → „Sicherung herunterladen“. Gesamte Datenbank = data/kita.sqlite → zusätzlich regelmäßig per FTP herunterladen (abends). Wiederherstellen: Datei zurückkopieren. Ordner data/ nie löschen oder überschreiben. Neue Mitarbeitende Einstellungen → Team-Zugänge → Mail (darf mehrfach vorkommen), Name, Code 986xxxx0000, Rolle → Team-QR-Karte unter Familien → QR-Karten → „Auch Team-Karten“. Neues Kind Familien → Familie (oder neu) → Kind hinzufügen mit Optigem-Nr. → Login-Code entsteht automatisch → Beiträge/Zuschuss eintragen → QR-Karte drucken bzw. Mail-Adresse eintragen (Code per Mail). 12. Fehlersuche Symptom Ursache / Lösung „Code unbekannt“ Tippfehler, alter Code (neue Endung), Kind inaktiv, Team-Code nicht gesetzt (diagnose.php) „Sicherheitsprüfung fehlgeschlagen“ Sitzung verloren (z. B. Cookies gelöscht) → Seite neu laden „Zu viele Fehlversuche“ 15 Min. warten Seite bricht ab / leer diagnose.php → Datenbank-Stand und Fehlermeldung „no such table“ Datenbank leer → setup.php ausführen Mail kommt nicht diagnose.php → Testmail: 535 = Zugangsdaten; Timeout = Port/ ssl; angenommen = Spam-Ordner Massenmails hängen Cronjob queue prüfen; Elterninfos → „Jetzt weiter senden“ Abrechnung falsch Essenspreis/Gültigkeit, Zuschuss-Zeitraum, Beitrag von/bis, Schließtage prüfen