# Autoreminder für FFDO Freifunktermine
Hier wird Installation und Betrieb der remind Pythonroutine beschrieben, die 2 oder 4 Tage vor dem Termin eine Erinnerung an die FFDO Mailingliste(n) verschickt.

# Systemvoraussetzungen und Installation
- Installiertes Python3 (ist bei debian 10 buster und ubuntu 20.4 erfüllt)
- Es wird das iCalendar python module benötigt
  
    sudo apt install python3, falls nicht vh  
    sudo apt install python3-pip, falls nicht vh  
    sudo python3 -m pip install icalendar  

- remind in die tägliche cron Ausführung einstellen
  
    bei Debian / Ubuntu remind nach /etc/cron.daily kopieren  
    remind darf nicht remind.py heißen, da run-parts, das die cronjobs abarbeitet, die Datei sonst ignoriert.  

- z.Zt. läuft remind auf der APU berghofen.ffdo.net  

# Interna
- remind verwendet als Absender reminder@freifunk-dortmund.de. Diesen account gibt es nicht, er ist aber für die Listen freifunk-do@list.free.de, freifunk-do-infra@list.free.de und freifunk-do-verein@list.free.de als Nichtmitglied postberechtigt eingetragen. Dies geht über Listenadministration -> Abo-regeln und Adressfilter -> Absender-filter -> Anti-spam-filter.

Die Vorwarnzeit in Tagen ist im Programm  verdrahtet:

    REM_TREFFEN_MONAT = 4           # Tage vorher erinnern an Monatstreffen
    REM_TREFFEN_TOPS  = REM_TREFFEN_MONAT + 2 # Tage vorher erinnern an TOP ergänzen
    REM_STANDARD = 2                # Tage vorher erinnern an FF@home, ...
    REM_INTERVALL = 6               # heute + x Tage Termine prüfen  
Die Termindaten im iCal Format werden von der Freifunk Webseite geholt für den laufenden Monat und eventuell den nächsten, falls das Prüfintervall in den nächsten Monat zeigt.

- Beispieleintrag  
BEGIN:VEVENT  
DTSTART;TZID=Europe/Berlin:20210325T140000  
DTEND;TZID=Europe/Berlin:20210325T170000  
DTSTAMP:20210319T211111  
CREATED:20210311T170027Z  
LAST-MODIFIED:20210311T170059Z  
UID:553-1616680800-1616691600@www.freifunk-dortmund.de  
SUMMARY:FF@home  
DESCRIPTION:  
URL:https://www.freifunk-dortmund.de/termin/ffhome-4/  
LOCATION:https://meet.nerd.re/FreifunkDortmund  
ORGANIZER;CN="FFDO%20e.V.":MAILTO:info@freifunk-dortmund.de  
END:VEVENT  

Mit dem SUMMARY Eintrag wird die Empfangsliste bestimmt, z.Zt. geht Erinnerungen mit FF@home an die infra liste, Öffentlichkeitsarbeit an die Vereinsliste, alle andern an die freifunk-do Liste.  
Für das Monatstreffen wird 2 Tage vor der Erinnerung die Aufforderung zur Ergänzung der TOPs verschickt inklusive der bisher eingetragenen TOPs.  
Die Ausführung oder Fehler werden im systemd Journal und im syslog protokolliert.