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-<id>@code.invalid). - Karte verloren: Familien → Kind → „Neuer Code“ → neue Zufallsendung, alter Code/QR sofort ungültig.
- QR-Code =
https://…/app/?p=code&c=<code>; 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: inconfig.php'notfall_zugang' => truesetzen,diagnose.php?key=CRON_KEYaufrufen (Admin-Link / Admin-Code), danach sofort wiederfalse.
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 Datensicherungdata/backup/kita-YYYY-MM-<Zeit>.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, Umfangessen(Standard) oderbeitrag):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), Absenderinfo@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,Froder1,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.htaccessgesperrt (Require all denied) – live geprüft 18.11.2026: alle 403. - Content-Security-Policy (nur eigene Quellen), Permissions-Policy,
display_errorsaus (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.sqliteist 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.phpunddata/per FTP überschreiben. - App einmal aufrufen (oder
diagnose.php) → Datenbank wird automatisch aktualisiert. - In
diagnose.phpprü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 |
No comments to display
No comments to display