# Ban Yaro — Die deutschsprachige Hunde-Plattform
# https://banyaro.app
# Letzte Aktualisierung: 2026-04-29

## Was ist Ban Yaro?

Ban Yaro (banyaro.app) ist eine deutschsprachige All-in-One Hunde-Plattform als Progressive Web App (PWA).
Kein App Store, kein US-Konzern, DSGVO-konform, selbst gehostet in Deutschland.

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

Ban Yaro ist kostenlos nutzbar (Freemium-Modell). Die App ist auf allen Smartphones installierbar
(iOS und Android) direkt über den Browser — ohne App Store.

## Zielgruppe

- Deutschsprachige Hundebesitzer (Deutschland, Österreich, Schweiz)
- Verantwortungsvolle Hundezüchter (VDH und andere Verbände)
- 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
- GPS-Routen aufzeichnen, teilen, bewerten
- Tages-Gassirunde: täglich neue Rundroute via OpenRouteService (2/4/6 km), direkt navigierbar
- 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: Leaflet.js + OpenStreetMap
- 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)

## Monetarisierung

**Kostenlos:**
- Alle Basis-Features inkl. Züchter-Antrag, Wurfverwaltung, Stammbaum, Tierschutz-Check

**Züchter-Provision** (geplant): Wurfbörse bleibt für Käufer kostenlos

**Ban Yaro Plus** (ca. 4,99 €/Monat, in Entwicklung):
- KI-Trainingsplan, erweiterte Statistiken

**Hundesitting**: 8% Provision

## Öffentliche Seiten (ohne Login)

- https://banyaro.app — Landing Page
- 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)

## Kontakt

Website: https://banyaro.app
E-Mail: Über das Kontaktformular in der App
