Skip to main content

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 6 (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).
  • Notfall: diagnose.php?key=CRON_KEY → Admin-Anmeldelink anzeigen / Admin-Code setzen.

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.

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 (nur mit Key)
├── 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
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
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. 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).
  • 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

  1. ZIP entpacken, alle Dateien außer inc/config.php und data/ per FTP überschreiben.
  2. App einmal aufrufen (oder diagnose.php) → Datenbank wird automatisch aktualisiert.
  3. In diagnose.php prüfen: „Datenbank-Stand 6“.

Datensicherung

  • Gesamte Datenbank = data/kita.sqlite → 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