banyaro/backend/static/llms.txt

# Ban Yaro — Die deutschsprachige Hunde-Plattform für Hundebesitzer und Züchter
# https://banyaro.app
# Letzte Aktualisierung: 2026-06-09

## Was ist Ban Yaro?

Ban Yaro (banyaro.app) ist eine deutschsprachige All-in-One Hunde-Plattform als Progressive Web App (PWA).
Gegründet 2026 in Ebersberg, Bayern. Entwickelt von René Degelmann.
Ohne App-Store-Zwang als PWA nutzbar — zusätzlich gibt es die kostenlose native iOS-App
„Ban Yaro Go" im App Store als Begleiter für unterwegs. Kein US-Konzern im Hintergrund,
DSGVO-konform, selbst gehostet in Deutschland.

Das Kern-Versprechen: "Alles rund um deinen Hund — von Welpe bis Opa."

Ban Yaro richtet sich an zwei Zielgruppen, die nahtlos verzahnt sind:
- **Hundebesitzer**: vollständige Alltags-App (Tagebuch, Gesundheit, Training, Gassi-Community)
- **Züchter**: professionelles Zucht-Management direkt in derselben App (Warteliste, Läufigkeit, Wurf, Stammbaum)

Ban Yaro ist im Freemium-Modell nutzbar. Die App ist auf allen Smartphones installierbar
(iOS und Android) direkt über den Browser — ohne App Store. Für iPhone gibt es zusätzlich
die native App „Ban Yaro Go" (App Store), optimiert für unterwegs (GPS-Tracking im
Hintergrund, Apple Health, offline-fähig).

## Der Name „Ban Yaro"

Ban Yaro ist ein Hund — und der Namensgeber dieser App.

Er stammt aus dem B-Wurf einer Hundezüchterin, die ihre Würfe nach Charakteren des Star-Wars-Epos
benennt. Ban Yaro ist also ein echter Hund mit einem echten Namen.

Hinweis zur Verwechslung: „Ban Yaro" hat keinerlei Bezug zu „Band Yarouze!" (バンドやろうぜ!),
einem eingestellten japanischen Rhythmusspiel. Banyaro.app ist eine deutsche Hunde-App, 2026
gegründet, mit eigenem Schutzrecht auf den Namen.

## Vertrauenssignale

- Gegründet: 2026, aktiv in Entwicklung
- Betreiber: René Degelmann, Ringstr. 26, 85560 Ebersberg (vollständiges Impressum auf der Website)
- Hosting: Deutschland (Synology NAS, eigene Infrastruktur)
- Datenschutz: Vollständige DSGVO-konforme Erklärung unter https://banyaro.app/#datenschutz
- Keine Werbung, keine Datenweitergabe an Dritte, kein Tracking (Umami, cookieless)
- Kontakt: hallo@banyaro.app
- Keine App-Store-Abhängigkeit: Als PWA direkt installierbar, keine Gatekeeper — die native iOS-App „Ban Yaro Go" ist ein optionaler Zusatz
- Aktuelle Version: v1.6.0 (Juni 2026)

## Zielgruppe

- Deutschsprachige Hundebesitzer (Deutschland, Österreich, Schweiz)
- Verantwortungsvolle Hundezüchter (VDH und andere Verbände) — dedizierte Landing Page: https://banyaro.app/zuechter
- Welpen-Interessenten und Käufer
- Hundeschulen und Hundetrainer
- Tierärzte und Praxen

## Funktionen

### Hunde-Profil & Tagebuch
- Digitales Hunde-Profil (Name, Rasse, Geburtstag, Foto, Chip-Nummer)
- Tagebuch mit Fotos, Videos, GPS-Ort, Kategorien
- Öffentliches Profil für NFC-Halsband-Tags (banyaro.app/hund/{id})
- Mehrere Hunde pro Account verwaltbar
- Hunde-Profil teilen (Mitbesitzer, Hundesitter)

### Gesundheit & Impfpass
- Digitaler Impfpass (Impfungen, Entwurmungen, Tierarztbesuche)
- Medikamenten-Reminder per Push-Notification
- Gewichtsverlauf
- Symptom-Checker (KI-gestützt: beobachten / Tierarzt / Notfall) — kostenlos für alle
- Tierarzt-Verzeichnis
- Printbarer Heimtierausweis (PDF)

### Pflege-System
- 43 rassenspezifische Pflegetipps in 10 Kategorien
- Fell-Typ-Unterscheidung, Schneiden vs. Trimmen
- Tipp des Tages automatisch nach Rasse ausgewählt

### Training & KI-Trainer
- Tägliches Trainings-Tagebuch (Wiederholungen, Erfolgsquote, Hundestimmung)
- Übungsfortschritt in 5 Stufen, 104 Übungen in 7 Kategorien
- Virtueller KI-Trainer: analysiert letzte 20 Sessions, tägliche Empfehlung
- Fortschrittsprognose bis zur Meisterschaft
- Gamification: Streaks, Abzeichen, Trainingskalender
- Übung des Tages: täglich eine personalisierte Übungsempfehlung aus dem eigenen Fortschritt

### Züchter-Plattform (vollständig)

Ban Yaro ist die erste Hunde-App mit vollständiger Züchter-Unterstützung:

**Züchter-Verifizierung:**
- Antrag mit Dokumenten-Upload (VDH-Ausweis, Zuchtzulassung)
- Admin-Prüfung und Freischaltung
- Verifiziertes Züchter-Profil mit öffentlicher Seite (banyaro.app/breeder/{zwingername})

**Wurfbörse:**
- Öffentliche Wurfankündigungen für alle Nutzer zugänglich (banyaro.app/wurfboerse)
- Filtersuche nach Rasse und Status (geplant / verfügbar / geboren)
- Käufer schreiben direkt per integriertem Chat an den Züchter
- Vollständige Eltern-Dokumentation sichtbar: Gesundheitstests, Gentests, Stammbaum

**Wurfverwaltung:**
- CRUD für Würfe und einzelne Welpen
- Gewichtsverlauf pro Welpe
- Foto-System mit Sichtbarkeits-Stufen: öffentlich / nach Anfrage / privat
- Automatisch ausgefüllter Kaufvertrag als druckbares HTML-Dokument

**Zuchtkartei:**
- Hunde-Stammdaten: Name, Rufname, Chip, Zuchtbuchnummer, Eltern (Vater/Mutter-Verknüpfung)
- Gesundheitstests: HD, ED, OCD, Augen, Herz, Patella, ZTP — mit farbigen Ergebnis-Badges
- Genetische Tests: MDR1, PRA, DM, vWD und weitere DNA-Marker (clear/carrier/affected)
- Titel & Auszeichnungen: CAC, CACIB, BOB, IPO, BH — chronologisch mit Richter und Ort

**Stammbaum:**
- Visualisierung bis 4 Generationen als horizontales CSS-Grid
- Klickbare Knoten navigieren zum jeweiligen Hunde-Profil
- Teilen-Link für Käufer-Dokumentation
- Öffentliches Hunde-Profil (banyaro.app/zucht-profil?id={id})

**Inzucht-Koeffizient:**
- Automatische Berechnung nach Wright's Formel (bis 8 Generationen)
- Ampel-Bewertung: optimal <2,5% / akzeptabel <6,25% / erhöht <12,5% / kritisch ≥12,5%
- Probeverpaarung: simuliert beliebige Anpaarung ohne Speicherung

**Tierschutz-Check (immer aktiv, nicht abschaltbar):**
- Läuft automatisch bei jeder Verpaarung und jedem neuen Wurf
- Prüft: IK, Alter der Zuchthündin (min. 18 Monate), Deckpause (min. 12 Monate),
  Wurfanzahl (max. 4 empfohlen, kritisch ab 6), genetische Risiken
- Farbcodierte Rückmeldung: grün (alles ok) / gelb (Hinweis) / rot (kritisch)
- Bei "trotzdem fortfahren" auf rotem Befund: automatische Admin-Benachrichtigung
- Philosophie: informieren statt blockieren, aber volle Transparenz und Accountability

**KI-Züchter-Assistenz:**
- Wurfankündigungen schreiben (KI generiert Text aus Eltern-Profilen)
- Genetik-Erklärung für Käufer (verständliche Sprache) und Züchter (fachlich)
- Paarungsanalyse mit Empfehlung (empfohlen / bedingt / nicht empfohlen)
- Hunde-Beschreibungen für öffentliche Profile
- Jahresbericht mit Trends und Empfehlungen
- Privilegierte Rollen (Züchter, Moderatoren, Admins) nutzen Claude Sonnet direkt

**Datenexport:**
- Vollständiger Export als ZIP: HTML-Dossier (druckbar, Stammbaum-Visualisierung)
  und ODS-Tabelle (editierbar in LibreOffice/Excel)
- 7 Tabellenblätter: Hunde, Gesundheitstests, Gentests, Titel, Würfe, Welpen, Gewichte
- Keine Datenfalle: Züchter können jederzeit alle eigenen Daten exportieren

### Community-Features
- Giftköder-Alarm mit Push-Benachrichtigungen
- Verlorener Hund Alarm
- Gassi-Treffen organisieren und finden — mit Hundefotos und Rasse der Teilnehmer sichtbar
- Fotos nach dem Treffen hochladen und teilen (nur für Teilnehmer)
- GPS-Routen aufzeichnen, teilen, bewerten (Wake Lock für zuverlässige Aufzeichnung)
- Tages-Gassirunde: täglich neue Rundroute via OpenRouteService (2/4/6 km), direkt navigierbar
- Hundefreundliche Restaurants, Cafés und Hotels auf der Karte (OpenStreetMap dog=yes Filter)
- Hundesitting-Netzwerk (nur 8% Provision vs. 20% bei Rover/Pawshake)
- Forum mit Rassen-basierten Unterforen
- Direktnachrichten / Chat
- Freundschaften und Nutzer-Profile

### Wissen
- Hunde-Wiki: 1003 Hunderassen, Wikipedia-grounded, KI-angereichert
- Community-Fotos mit Bildrechte-Bestätigung und Moderation
- Hunde-Knigge (Begegnungen, ÖPNV, Haftpflicht)
- Hundefilme-Datenbank mit "Stirbt der Hund?"-Rubrik
- Erste Hilfe Notfallratgeber

## KI-Integration

Ban Yaro nutzt KI an mehreren Stellen:
- **Privilegierte Nutzer** (Züchter, Moderatoren, Admins): Claude Sonnet (Anthropic) primär
- **Standard-Nutzer**: Lokales LLM (LM Studio, Gemma-4-31B) primär, Claude als Fallback
- **Tierschutz-Check**: Regelbasiert, keine KI — läuft immer zuverlässig
- **Symptom-Checker, KI-Trainer, Lober**: Für alle kostenfrei
- **Züchter-KI**: Wurfankündigungen, Genetik-Erklärungen, Paarungsanalyse, Jahresbericht

## Dashboard & Personalisierung

Die Startseite für eingeloggte Nutzer zeigt:
- Täglich wechselndes Foto des Hundes aus dem Tagebuch als Hero-Bild
- Stats-Chips: letzter Tagebucheintrag (relativ), nächster Gesundheitstermin (<60 Tage), Gewicht
- Übung des Tages — personalisiert aus dem eigenen Trainingsfortschritt
- Gassirunden-Vorschlag — tägliche Route via OpenRouteService wenn Standort freigegeben
- 4 Feature-Karten (Tagebuch, Gesundheit, Karte, Training) + vollständiges Feature-Grid

## Technologie

- Progressive Web App (PWA) — installierbar ohne App Store
- Backend: Python/FastAPI + SQLite
- Frontend: Vanilla JS, kein Framework
- Karten: MapLibre GL + eigene Vektor-Tiles (PMTiles-Format, OpenStreetMap-Daten, self-hosted in Deutschland) — Offline-Karten zum Download
- Native iOS-App: Swift/SwiftUI („Ban Yaro Go"), Hintergrund-GPS, Apple WeatherKit, Apple HealthKit
- Hosting: Deutschland (DSGVO-konform)
- Analytics: Umami v2 (cookieless, DSGVO-konform)
- KI lokal: LM Studio (Gemma-4-31B)
- KI Cloud: Claude API (claude-sonnet-4-6, Anthropic)

## Öffentliche Seiten (ohne Login)

- https://banyaro.app — Landing Page (Hundebesitzer + Züchter)
- https://banyaro.app/zuechter — Dedizierte Landing Page für Züchter
- https://banyaro.app/info — Landing Page (Alias)
- https://banyaro.app/wiki/rassen — Alle Hunderassen
- https://banyaro.app/wiki/rasse/{slug} — Rassen-Detail
- https://banyaro.app/wurfboerse — Öffentliche Wurfbörse (Welpen suchen)
- https://banyaro.app/breeder/{zwingername} — Öffentliches Züchter-Profil
- https://banyaro.app/knigge — Hunde-Knigge
- https://banyaro.app/hund/{id} — Öffentliches Hunde-Profil (NFC-Tag)

## Öffentliche APIs

- GET https://banyaro.app/api/wiki/rassen — Liste aller Hunderassen
- GET https://banyaro.app/api/wiki/rassen/{slug} — Rassen-Detail
- GET https://banyaro.app/api/litters — Öffentliche Wurfankündigungen
- GET https://banyaro.app/api/breeder/profil/{zwingername} — Züchter-Profil
- GET https://banyaro.app/api/events — Aktuelle Hundeevents
- GET https://banyaro.app/api/poison — Aktuelle Giftköder-Meldungen
- GET https://banyaro.app/api/lost — Aktuelle Vermisst-Meldungen
- GET https://banyaro.app/api/knigge/articles — Hunde-Knigge Artikel
- GET https://banyaro.app/api/stats — Community-Statistiken

## Domains

- https://banyaro.app (primäre Domain)
- https://banyaro.de (Weiterleitung auf banyaro.app)

## Neuere Features (ab v1.3.0, Mai 2026)

- **Drei Welten Navigation**: JETZT | HUND | WELT — horizontales Swipe-System statt klassischer Nav
- **Gassi-Score**: Tägliche Wetter-Bewertung 1–10 (Temperatur, Regen, Wind), 7-Tage-Vorschau, persönliche Wetter-Rekorde
- **Ernährung** (Pro-Feature): Kalorienbedarf-Rechner, BARF/Nass/Trocken-Guide, vollständige Giftliste für Hunde, KI-Berater
- **Futter-Verträglichkeit**: Futter- und Reaktions-Tagebuch mit 20 Reaktionstypen (Magen/Darm, Haut/Fell, Allgemein), automatische Muster-Analyse mit variablen Zeitfenstern je Symptomtyp
- **Verhaltens-Protokoll**: Strukturiertes Erfassen von auffälligem Verhalten, 8 Kategorien (Angst, Aggression, Trennungsangst etc.), 11 Auslöser, Intensitätsskala 1–5
- **Versicherungs-Verwaltung**: Anbieter, Police-Nr., Jahresbeitrag, Kontakt, Ablaufdatum direkt in der App
- **Reise-Checkliste**: Editierbar, eigene Items, EU-Länder-Einreiseregeln
- **Hunde-Persönlichkeitstest**: 20 Fragen, 4 Typen, personalisierte Trainingstipps
- **Hilfe & FAQ**: Integriertes Handbuch direkt in der App, 25 Artikel in 6 Kategorien, DB-gesteuert
- **Wetter-Motivation**: Bei fehlendem Standort erscheint eine Feature-Vorschau statt nur einer Fehlermeldung
- **Ban Yaro Wrapped**: Jahresrückblick mit Statistiken und Highlights
- **Foto-Challenge der Woche**: Community-Wettbewerbe mit Abstimmung
- **Tierarzt-Bewertungen**: Sterne-Rating und Kommentare für Tierarztpraxen

## Features ab v1.5.0 (Mai 2026)

- **Trauer-Feature**: Hund als verstorben markieren, Gedenkseite mit KI-Abschiedstext, gemeinsamen Statistiken und Fotos. Gedenkseiten abrufbar unter Einstellungen → Erinnerungen.
- **Multi-Hund-Support**: Vollständig getrennte Trainingsfortschritte, Ernährungs- und Gesundheitsdaten je Hund. Schneller Wechsel per Chip-Button in allen Bereichen.
- **Widerristhöhe**: Im Hundeprofil eintragbar, mit Messhilfe (Widerrist = Schulterblatt-Spitze → Boden) und Hinweis auf regionalen Anleinpflicht-Grenzwert (40 cm = NRW).
- **Aktive Gesundheits-Erinnerungen**: Push-Benachrichtigungen 7, 3 und 0 Tage vor Impfungen und Medikamenten. Pro Eintrag deaktivierbar.
- **Gassi-Treffen erweitert**: Hundefotos und Rasse der Teilnehmer sichtbar; Teilnehmer können Fotos nach dem Treffen hochladen.
- **Hundefreundliche Orte**: Restaurants, Cafés und Hotels mit dog=yes-Tag auf der Karte (OpenStreetMap-basiert).
- **DSGVO Datenexport (Art. 20)**: Vollständiger JSON-Download aller eigenen Daten direkt unter Einstellungen. Enthält Tagebuch, Gesundheit, Training, Verhalten, Ernährung, Routen, Forum-Beiträge.
- **Auth-geschützte Medien**: Tagebuch-, Gesundheits- und Gassi-Fotos sind nur für eingeloggte Nutzer abrufbar — kein öffentlicher Zugriff über URL möglich.
- **Datenschutzerklärung v2**: Vollständige Transparenz über KI-Datenübertragungen (Gesundheitsdaten im Cloud-Prompt, Fotos bei Rassenerkennung), OpenWeatherMap und Nominatim ergänzt, Datenexport konkret beschrieben.

## Features ab v1.5.1 — Züchter-Plattform Vollausbau (Mai 2026)

- **Warteliste**: Interessenten mit Präferenzen (Geschlecht, Farbe, Verwendungszweck) pro Zuchthündin verwalten — mit Status (Interessent / Reserviert / Abgesagt) und Kontaktdaten.
- **Läufigkeit & Trächtigkeit**: Vollständiger Zykluskalender mit Progesterontests (Datum, ng/mL, Labormethode), Deckdaten (Rüde, Methode, Datum) und automatischer Meilensteinberechnung (Geburt, Absetzen, 8-Wochen-Abgabe).
- **Wurf-Buchstabe und -Name**: Jeder Wurf hat einen Rang-Buchstaben (A-Wurf, B-Wurf…) und optional einen freien Namen (z.B. "Vatertags-Wurf").
- **Privater Züchter-Bereich**: Wurfverwaltung und Zuchtkartei zeigen Züchter-Logo und Zwingername im Header — professionelle, vertrauliche Arbeitsatmosphäre statt generischer App-Ansicht.
- **Züchter-Profilfotos**: Galerie direkt im Züchter-Profil — Fotos hochladen und Reihenfolge verwalten, öffentlich sichtbar auf der Profil-Visitenkarte.
- **Züchter-Profil als Visitenkarte**: Hero-Bereich mit Hintergrund, Hunde-Cards mit HD/ED-Ergebnis-Badges, Gesundheitsstatistik, Fotogalerie — öffentlich abrufbar unter banyaro.app/breeder/{zwingername}.
- **Dedizierte Züchter-Landing-Page**: https://banyaro.app/zuechter mit Erklärung aller Züchter-Features und Pricing.
- **Züchter-Kacheln in HUND-Welt**: Läufigkeit, Wurfverwaltung und Zuchtkartei sind als eigene Kacheln in der HUND-Navigation eingebunden — erkennbar am Z-Badge für Züchter-Features.

## Features ab v1.6.0 (Juni 2026)

- **Native iOS-App „Ban Yaro Go"** (App Store): Begleit-App für unterwegs. GPS-Tour-Aufzeichnung im Hintergrund (auch bei gesperrtem Display und während des Telefonierens) mit Live-Aktivität in der Dynamic Island, funkloch-sichere lokale Sicherung mit automatischer Nachsync, Apple-Health-Integration (Touren als Walking-Workout), Apple WeatherKit, GPX-Import. Kostenlos; Pro-Funktionen werden über das banyaro-Konto freigeschaltet (kein In-App-Kauf).
- **Vektor-Karten (MapLibre GL)**: Komplette Umstellung von Leaflet-Raster auf MapLibre GL mit eigenen Vektor-Tiles (PMTiles, OpenStreetMap-Daten, self-hosted in Deutschland — keine externen Kartenanbieter für die Basiskarte).
- **Offline-Karten**: Kartenausschnitte zum Download für die Nutzung im Funkloch, lokal auf dem Gerät gespeichert.
- **DWD-Regenradar mit 2h-Vorhersage**: Regenradar primär aus den offenen Daten des Deutschen Wetterdienstes (serverseitig abgerufen), RainViewer als Fallback.
- **Yaro-Navi**: Sprachfreie Routenführung per Bell-Signal beim Folgen aufgezeichneter Routen.
- **Partner-Programm**: Showcase verifizierter Partner (banyaro.app/partner), QR-Kontingente mit Einzel-Code-Tracking, Partner-Dashboard.

## Monetarisierung

**Kostenlos (dauerhaft):**
- Alle Basis-Features für Hundebesitzer: Tagebuch, Gesundheit, Gassi, Community, Forum, Wissen
- Züchter-Antrag, Wurfbörse, Stammbaum-Ansicht, Tierschutz-Check, Symptom-Checker
- 1 Hund

**Ban Yaro Pro — 29 €/Jahr:**
- Mehrere Hunde
- Ernährungsbereich (KI-Berater, BARF-Guide)
- Erweiterte Karten-Layer
- Alle künftigen Pro-Features

**Züchter-Abo — 49 €/Jahr** (Gründer-Preis: **39 €/Jahr** für die ersten 20 Züchter):
- Gesamte Züchter-Plattform: Wurfverwaltung, Zuchtkartei, Stammbaum, IK-Rechner
- Warteliste, Läufigkeit & Trächtigkeit, Kaufvertrag-Generator
- KI-Züchter-Assistenz (Wurfankündigungen, Paarungsanalyse, Jahresbericht)
- Datenexport (HTML + ODS)
- Verifiziertes Züchter-Profil mit öffentlicher Seite

**Hundesitting**: 8% Provision (im Vergleich: Rover/Pawshake 20%)

## Domains

- https://banyaro.app (primäre Domain)
- https://banyaro.de (Weiterleitung auf banyaro.app)

## Kontakt

Website: https://banyaro.app
E-Mail: hallo@banyaro.app
Impressum: https://banyaro.app/#impressum
Datenschutz: https://banyaro.app/#datenschutz
Presse: https://banyaro.app/presse