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 67 (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 (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-Anmeldelink anzeigenLink / Admin-CodeCode), setzen.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-<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, 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 (nurAdmin mitoder Key)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

        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“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