Abfallkalender-Integration (ICS-Import + Erinnerung)

[MeisterAdebar]

Hi,

hab in meinem Fork den Import eines Abfallkalender eingebaut: https://github.com/MeisterAdebar/fewohbee/tree/feature/waste-calendar

Datenquelle: ICS-Datei-Upload oder ICS-URL (viele kommunale Entsorger bieten sowas an), konfigurierbar unter Einstellungen → Allgemein. Unterstützt Einzeltermine und wiederkehrende Events (RRULE), da sich ICS-Dialekte je nach Anbieter unterscheiden.

Anzeige: Farblich markiert + Popover in der Jahresübersicht, direkt neben der bestehenden Feiertagsanzeige. Per Schalter in den Tabellen-Einstellungen ein-/ausschaltbar (standardmäßig aus).

Erinnerung: Ein Tag vor der Abholung (und am Abholtag selbst, falls noch nicht bestätigt) erscheint ein Hinweis-Button in der Reservierungsübersicht, analog zum bestehenden "Importe prüfen"-Mechanismus – man muss aktiv bestätigen, dass die Tonne(n) rausgestellt wurden. Die Erinnerung ist an denselben Schalter gekoppelt wie die Anzeige: ist die Jahresübersicht-Anzeige aus, ist auch die Erinnerung aus.

Technisch:

• Neue Dependency: sabre/vobject fürs ICS-Parsing
• Neue Tabelle waste_collection_date, drei neue Spalten auf app_settings
• Speicherung der ICS-Datei über einen neuen, nicht-öffentlichen Flysystem-Storage-Bucket (analog zu den bestehenden Image-Buckets)

Ich hab das komplett fertig und getestet (10 Commits, sauber getrennt nach Funktionsbereich).

Gibts von deiner Seite Vorbehalte gegen den Import oder der Umsetzung?

Gruß Thomas

[developeregrem]

Hi @MeisterAdebar, danke erst mal, dass du dich damit beschäftigst 👍
Eine Art Kalenderimport für Termine, Veranstaltungen etc. schwebt mir auch vor. Siehe auch #207. Eine Spezialisierung nur auf ein Thema würde ich aber ungern einbauen. Speziell für waste collection gibt es andere Projekte, die das hervorragend in Home Assistant oder FHEM integrieren. Ich sehe diese spezielle Funktion tatsächlich nicht in FewohBee. Da es hier keinen Standard über Kommunen hinweg gibt, wäre das ein Fass ohne Boden, das nach FewohBee zu holen. 😔 Allerdings könntest du das was du da geschaffen hast verallgemeinern und im besten Fall auch eine manuelle Anlage von Einträgen ermöglichen. Ich denke die Basis dafür hast du schon sehr gut dafür geschaffen. Am Ende kann man halt alles importieren, Mülltermine, Ferien, etc.

[MeisterAdebar]

Basierend auf dem Feedback und einmal darüber schlafen hab ich meine Gedanken dazu mal bauen lassen und festgehalten. Hat von allen angesprochenen Themen schon was drin. Ist quasi im Baby-Erste-Krabbelversuche-Stadium – läuft grundsätzlich. Morgen geht's weiter...

[MeisterAdebar]

Bin gespannt was Du davon hältst 😎

https://github.com/MeisterAdebar/fewohbee/tree/feature/multi-calendar

---

Verallgemeinerung des Abfallkalenders zu einem Mehrfach-Kalender-System mit Facility-Übersicht

Der bisher fest eingebaute "Abfallkalender" (ein ICS-Upload/URL, eine feste Menge an Abholterminen) wurde durch ein generisches Kalender-System ersetzt, das beliebig viele unabhängig konfigurierte Kalender unterstützt (Abfallabfuhr, Urlaub, Veranstaltungen, Wartung, ...) – jeder mit eigenem Namen, eigener Akzentfarbe, eigener ICS-Quelle und optionaler "Bestätigung erforderlich"-Markierung für Tag-vorher-Erinnerungen.

Datenmodell

• Calendar: Name, Farbe, Bestätigungspflicht, ICS-Quelle (Datei-Upload oder URL), letzter Sync-Zeitpunkt/-Anzahl.
• CalendarEntry: Datum, Titel, ICS-UID (für wiederholbare Importe), optional Bestätigungszeitpunkt + bestätigender Benutzer. Ersetzt die alte WasteCollectionDate-Entität; manuell angelegte Einträge (nicht aus einer ICS-Quelle) bekommen eine generierte "manual-*"-UID.
• Der Sync-Service importiert ICS-Inhalte (einzelne Termine und wiederkehrende per RRULE) und aktualisiert per UID. Ein erneuter Import löscht jetzt nie mehr bestehende Einträge, die in der neuen Datei/URL fehlen – ein bestätigter Eintrag ist ein historischer Nachweis (siehe Facility-Übersicht) und darf durch einen rollierenden oder ersetzten Feed nicht stillschweigend verschwinden.

Reservierungsübersicht

• Jede Tageszelle bekommt pro Kalender mit Termin an dem Tag eine farbige Akzentlinie. Bei mehr als 4 Terminen stapeln sich die ersten 4 von oben, der Rest von unten.
• Klick auf einen Tag mit Terminen öffnet ein Popover mit Liste + Bearbeiten-Links; ein leerer Tag zeigt direkt "+ Neuer Termin" und öffnet das Formular ohne Umweg über das Popover.
• Popover schließen jetzt auch bei Klick außerhalb oder auf einen Link darin.
• Anlegen/Bearbeiten/Löschen läuft jetzt im selben Modal wie "+ Reservierung hinzufügen" statt auf einer eigenen Seite – inklusive "Bestätigung rückgängig machen", falls aus Versehen bestätigt wurde.

Bestätigungs-Erinnerungen

• Kalender mit Bestätigungspflicht zeigen eine Tag-vorher/Tag-selbst-Erinnerung; beim Bestätigen wird zusätzlich zum Zeitpunkt auch der Benutzer gespeichert.
• Bestätigungen lassen sich rückgängig machen.

Facility-Übersicht (unter Betrieb)

• Neue Seite "Facility" (neben Housekeeping und Rezeption Checkliste) zeigt bestätigte Abfallabfuhren pro Jahr: Datum, Tonne, Kalender, Bestätigungszeitpunkt und wer bestätigt hat.

Kalender verwalten (Einstellungen)

• Die Verwaltungsseite wurde im Stil der anderen Einstellungsseiten (Preisliste, Reservierungsherkunft, Reservierungsstatus) überarbeitet: gerahmte Tabelle, Anlegen/Bearbeiten im gemeinsamen Modal, Löschen über das bekannte Bestätigungs-Popover statt über einen Button im Bearbeiten-Formular.

---

[developeregrem]

Hi, freue mich schon mir das anzusehen. Bin jetzt nur kurz über den Code gegangen und habe ein paar erste Anmerkungen 😊

• den ganzen Migration Code von waste collection hin zu calendar brauchen wir hier nicht. Das hattest du ja nur bei dir initial so gebaut. Später in FewohBee reicht die Endausbaustufe ohne Migration von Zwischenschritten.
• Braucht es zwingend eine neue Bibliothek für iCal lesen? iCal ist ein recht einfaches Format. Evtl. kann man die vorhandenen Funktionen aus CalendarImportService nutzen oder die dort rausziehen und verallgemeinern.
• Ich konnte jetzt auf Anhieb nicht erkennen ob die Kalender als Datei gespeichert werden. Brauchen wir die Änderungen in flysystem überhaupt? Die Einträge in der dB sollten eigentlich ausreichend sein.
• Ich sehe da auch noch viele Legacy Änderung von waste collection, z.b. in appSettings. Das brauchen wir sicherlich nicht mehr und müsste vorher aufgeräumt werden

[MeisterAdebar]

1. Feedback aus dem Review umgesetzt

• Die drei Migrationsschritte (waste_collection_date → calendar/calendar_entry) zu einer einzigen Migration zusammengefasst.
• sabre/vobject entfernt - nutzt jetzt denselben handgeschriebenen ICS-Parser wie der bestehende Channel-Manager-Import (in eine gemeinsame Klasse ausgelagert). Einschränkung: keine RRULE-wiederkehrenden Termine mehr, jeder Termin braucht ein eigenes VEVENT in der Quelle.
• Flysystem-Speicherung für hochgeladene ICS-Dateien entfernt - ein Upload wird jetzt einmalig beim Speichern eingelesen, nur die Termine landen in der DB, die Datei selbst wird nirgends mehr abgelegt.
• Dabei einen Bug gefunden und behoben: Der Datei-Upload im Kalender-Modal hat wegen eines Fehlers im gemeinsamen AJAX-Helper nie tatsächlich funktioniert (Datei wurde beim Serialisieren stillschweigend verworfen).

2. Automatischer URL-Sync repariert

• Ein Kalender mit URL wurde bisher nur beim manuellen Speichern im Formular synchronisiert, obwohl der Hilfetext "täglich automatisch" versprach. Jetzt gibt es dafür einen stündlichen Cron-Job (calendars:sync), analog zum bestehenden Zimmer-Kalender-Import.

3. Kleine UI-Verbesserung

• Im Tages-Popover der Reservierungsübersicht gibt es jetzt eine Trennlinie zwischen Terminen unterschiedlicher Kalender (wie schon zwischen Feiertagen und Terminen).

[developeregrem]

magst du das mal direkt als PR anlegen? dann kann ich mir das einfacher ansehen.