# Mitmachen

Fehlerberichte, Verbesserungen und neue Kameraanbindungen sind willkommen.
Dieses Projekt ist zum Nachbauen gedacht — wer es aufbaut und dabei über eine
rauhe Kante stolpert, hilft mit einem Hinweis mehr als mit Schweigen.

## Fehler melden

Am nützlichsten ist ein Bericht, aus dem hervorgeht, **was du erwartet hast und
was stattdessen passiert ist**. Dazu:

- Welche Kamera (Pi Zero, ESP32-S3, etwas anderes) und welche Auflösung
- Die letzten Zeilen aus dem Protokoll des Detectors
- Bei Erkennungsfehlern: wenn möglich das Bild, um das es geht

⚠️ **Schwärze deine Zugangsdaten**, bevor du ein Protokoll einfügst — Tokens
stehen dort im Klartext.

## Code beisteuern

1. Bevor du etwas Größeres baust: ein Issue aufmachen und kurz abstimmen. Das
   erspart dir die Arbeit, die ich vielleicht gerade selbst mache.
2. Die Tests müssen durchlaufen — **aus dem Ordner `web/` heraus**, sonst
   findet Django keinen einzigen Test und meldet trotzdem Erfolg:

   ```bash
   cd web && ../venv/bin/python manage.py test
   ```

   Es sind derzeit 105.
3. Kommentare und Oberfläche sind auf Deutsch, der Code folgt dem Stil der
   Umgebung, in der er steht.

## Lizenz deines Beitrags

Dieses Projekt steht unter der **GNU AGPL-3.0** (siehe [LICENSE](LICENSE)), und
dein Beitrag wird unter derselben Lizenz veröffentlicht.

🔑 **Zusätzlich räumst du mir mit dem Einreichen eines Beitrags das Recht ein,
ihn auch unter anderen Lizenzbedingungen zu verwenden** — einschließlich einer
kommerziellen Lizenz. Das Recht ist einfach, zeitlich und räumlich unbeschränkt
und übertragbar. Die Urheberschaft bleibt bei dir, und dein Beitrag bleibt
selbstverständlich auch unter der AGPL verfügbar.

**Warum das nötig ist, offen gesagt:** Vogelalbum wird zusätzlich kommerziell
lizenziert — wer es in einem Produkt einsetzen will, ohne seinen eigenen
Quelltext offenlegen zu müssen, kann eine solche Lizenz erwerben. Doppelt
lizenzieren darf aber nur, wem alle Rechte am Werk zustehen. Ohne diese
Einräumung könnte ein einziger fremder Beitrag diesen Weg für das ganze
Projekt versperren, und das ließe sich später kaum noch reparieren, weil
dafür jeder Mitwirkende einzeln zustimmen müsste.

Wenn du damit nicht einverstanden bist, sag es bitte **vor** dem Einreichen.
Dann finden wir einen anderen Weg — ein Fehlerbericht mit genauer Beschreibung
ist oft genauso wertvoll wie fertiger Code, und für ihn gilt das alles nicht.