Vogelalbum 1.0.0

Eine Kamera am Vogelhaus, ein Rechner der erkennt wer da war — und eine
Sammlung, die sich von allein fuellt.

Zwei neuronale Netze: eines findet den Vogel im Bild, eines bestimmt die
Art. 148 heimische Arten, auf Deutschland eingeschraenkt und neu normiert —
ohne diese Einschraenkung wird aus einer Kohlmeise eine nordamerikanische
Schwesterart. Daraus entsteht ein Sammelalbum: nummerierte Seiten,
gefundene Arten in Farbe, fehlende als Schatten, dazu Erstfang, Punkte,
Stufen und 15 Abzeichen.

Laeuft vollstaendig auf eigener Hardware. Kein Cloud-Dienst, kein Konto,
keine Telemetrie; die Bilder verlassen das eigene Netz nicht.

Zwei getrennt deploybare Teile: die Sammlung als Django-Anwendung, die
Erkennung als eigener Dienst. Der Erkennungs-Dienst fragt selbst an und
braucht deshalb weder eine erreichbare Adresse noch einen offenen Port —
er laeuft hinter einem gewoehnlichen Router.

Dabei: Firmware fuer Raspberry Pi und ESP32-S3, Anbindung an Home
Assistant ueber MQTT, Oberflaeche auf Deutsch und Englisch, Einstellungen
je Kamera aus dem Browser, und ein Weg fuer Fotos von unterwegs.

AGPL-3.0.

docs/datenquellen.md

@@ -0,0 +1,49 @@
+# Datenquellen und Lizenzen
+
+<sub>[← zurück zum Überblick](../README.md) · [alle Kapitel](README.md)</sub>
+
+Woher die Modelle und die Referenzfotos kommen, unter welcher Lizenz sie
+stehen — und warum dieses Projekt die AGPL trägt und nicht die GPL.
+
+| Was | Woher | Lizenz |
+|---|---|---|
+| Vogeldetektor | SSD-MobileNet v2 COCO, [google-coral/test_data](https://github.com/google-coral/test_data) | Apache 2.0 |
+| Artklassifikator | MobileNet v2 auf iNaturalist-Vögeln, ebenda | Apache 2.0 |
+| Referenzfotos | Wikipedia / Wikimedia Commons | überwiegend CC BY-SA, Urheber und Lizenz werden je Bild gespeichert und angezeigt |
+| Artdaten und Texte | selbst geschrieben | AGPL-3.0, siehe unten |
+
+Die Modelle liegen nicht im Repo; `scripts/fetch_models.sh` holt sie.
+
+### Die Lizenz dieses Projekts
+
+Vogelalbum steht unter der **GNU Affero General Public License 3.0**
+([LICENSE](../LICENSE)). Du darfst es benutzen, verändern und weitergeben.
+
+⚠️ **Das „Affero" ist der Unterschied zur gewöhnlichen GPL und hier Absicht:**
+Wer eine veränderte Fassung **als Dienst über ein Netz anbietet**, muss den
+Quelltext dieser Fassung den Nutzern zugänglich machen — auch ohne sie als
+Programm weiterzugeben. Für den Betrieb im eigenen Garten ändert das nichts.
+
+**Kommerzielle Nutzung ohne Offenlegung** ist über eine gesonderte Lizenz
+möglich; Anfragen an <webmaster@gaertner.onl>. Das ist der Grund für die
+Rechteeinräumung in [CONTRIBUTING.md](../CONTRIBUTING.md) — doppelt lizenzieren
+kann nur, wem alle Rechte am Werk zustehen.
+
+Die Referenzfotos aus Wikimedia Commons behalten ihre eigene Lizenz (CC BY-SA)
+und sind von der AGPL nicht betroffen. Dasselbe gilt für die Modelle, die unter
+Apache 2.0 stehen.
+
+Die Referenzfotos werden mit Urheber, Lizenz und Quelle gespeichert und in der
+Oberfläche angezeigt — die Namensnennung ist Lizenzbedingung, keine
+Höflichkeit. Eigene Kameraaufnahmen sind davon nicht betroffen.
+
+Die Gestaltung folgt der Idee eines **Sammelalbums**: nummerierte Einträge,
+gesehene Arten in Farbe, fehlende als Schatten. Das ist so alt wie
+Klebebildchen und gehört niemandem.
+
+---
+
+<sub>Kein Bild dieses Projekts verlässt das eigene Netz, außer man deployt die
+Web-App selbst irgendwohin. Es gibt keine Telemetrie und keine Aufrufe an
+Dritte außer den ausdrücklich angestoßenen Downloads von Modellen und
+Referenzfotos.</sub>