banyaro/backend/static/llms.txt

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

## 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)
- Hundeschulen und Hundetrainer
- Tierärzte und Praxen
- Züchter

## Funktionen (aktuell verfügbar)

### 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, Krallen, Zähne, Ohren, Augen, Pfoten, Parasiten, Saisonal, Gesundheitsvorsorge, Welpen-Pflege
- Fell-Typ-Unterscheidung: kurz / lang / lockig / Doppelmantel
- Unterscheidung Schneiden vs. Trimmen
- Tipp des Tages automatisch nach Rasse und Fell-Typ ausgewählt
- Rassen-Autocomplete im Profil verknüpft mit Pflege-Tipps

### Training & KI-Trainer
- Tägliches Trainings-Tagebuch (Wiederholungen, Erfolgsquote 0–100%, Hundestimmung, Zufriedenheit)
- Übungsfortschritt in 5 Stufen — von "noch nicht gezeigt" bis "sitzt sicher"
- Virtueller KI-Trainer: analysiert letzte 20 Sessions, empfiehlt täglich welche Übungen anstehen
- Fortschrittsprognose bis zur Meisterschaft (Trendanalyse)
- 104 Übungen in 7 Kategorien
- KI-Trainingsplan erstellen (Plus-Feature)
- Trainingskalender im Habit-Tracker-Stil
- Gamification: Streaks, Abzeichen, XP
- Kommandos & Fähigkeiten sichtbar im Hunde-Profil (für Hundesitter)

### Wöchentlicher Lober (KI)
- Jeden Montag schreibt die KI automatisch 2-3 Sätze Lob für die Trainingsvorwoche
- Nur Lob, kein Rat, kein Druck — positive Bestärkung
- Basiert auf den geloggten Trainingseinheiten der Vorwoche

### Wetter & Zecken-Warnung
- Wetter-Chip direkt in der App (Open-Meteo API, ohne API-Key)
- Zecken-Warnung regelbasiert: aktiv März–Oktober bei Temperatur >7°C
- Push-Benachrichtigungen für Zecken-Saison

### Giftköder-Alarm
- Giftköder-Meldungen mit GPS-Koordinaten und Foto
- Push-Benachrichtigung für alle Nutzer im konfigurierbaren Umkreis
- Interaktive Karte (OpenStreetMap/Leaflet)
- Automatisches Ablaufdatum nach 7 Tagen

### Sicherheit & Community-Alerts
- Verlorener Hund: Alert mit Foto und letzter GPS-Position
- Nearby-Alerts: Push-Benachrichtigungen für Ereignisse in der Nähe

### NFC-Halsband-Tags
- Jeder Hund hat eine öffentliche URL (ohne Login sichtbar)
- "Ich habe diesen Hund gefunden"-Button → Besitzer bekommt Push-Benachrichtigung
- Notfallkontakt ohne Telefonnummer preiszugeben
- Physische NFC-Tags erhältlich (Shop)

### Gassi-Community
- Gassi-Treffen erstellen und beitreten
- GPS-Routen aufzeichnen und teilen (mit Anti-Cheat-Validierung)
- Routen bewerten (Untergrund, Schatten, Leinenpflicht, Sicherheit)
- Beliebte Routen entdecken

### Hundesitting-Netzwerk
- Sitter-Profile mit Erfahrung und Bewertungen
- Buchungsanfragen und Kalender
- Nur 8% Provision (vs. 20% bei Rover/Pawshake)
- Bewertungen verifizierter Buchungen

### Forum
- Rassen-basierte Foren
- KI-Zusammenfassung langer Threads
- Experten-Badge (Tierarzt, Trainer)

### Hunde-Wiki — Rassendatenbank
- 1003 Hunderassen, 97,6% KI-angereichert via Wikipedia-grounded Recherche
- Inhalte: Charakter, Größe, Aktivität, Eignung, Lebensdauer, Temperament
- Community-Fotos im Wiki: User können Fotos einreichen (mit Bildrechte-Bestätigung)
- Moderatoren geben Community-Fotos frei, anschließend Galerie-Ansicht
- Wiki-Foto-Badge als Gamification-Belohnung für Foto-Einreicher
- "Passt diese Rasse zu mir?" Quiz für angehende Hundebesitzer

### Hunde-Knigge
- Ratgeber für Begegnungen (fremder Hund, Kinder, Radfahrer)
- Regeln in ÖPNV und öffentlichen Orten
- Haftpflicht-Ratgeber

### Events & Kultur
- Agility-Turniere und Hundeausstellungen (VDH-Import)
- Hundefilme-Datenbank mit "Stirbt der Hund?"-Rubrik
- Veranstaltungskalender

### Hundefreundliche Orte
- Crowd-sourced Datenbank hundefreundlicher Orte
- Restaurants, Parks, Geschäfte
- Detaillierte Bewertungen

### Gamification & Push
- Badges, Streaks, XP — trägt zur Nutzerbindung bei
- Wiki-Foto-Badge für Community-Foto-Beiträge
- Push-Notifications für Alerts, Erinnerungen, Wöchentlicher Lober
- Offline-Modus via Service Worker

## KI-Integration

Ban Yaro nutzt KI an mehreren Stellen der Plattform:

- **Lokale KI**: LM Studio (Gemma-4-31B) auf eigenem Server — für datenschutzkritische Anfragen
- **Cloud-KI**: Claude (Anthropic, Modell: claude-sonnet-4-6) als Fallback und für rechenintensive Aufgaben
- **Symptom-Checker**: KI-gestützte Ersteinschätzung (kostenlos)
- **Virtueller KI-Trainer**: Analysiert letzte 20 Trainings-Sessions, erstellt täglich priorisierte Übungsempfehlung
- **Wöchentlicher Lober**: Vollautomatisch jeden Montag per APScheduler, lobt die Vorwoche in 2-3 Sätzen
- **Breed-Enricher**: Wikipedia-grounded Anreicherung von 1003 Rassen-Datensätzen (97,6% abgeschlossen)
- **KI-Trainingsplan** (Plus-Feature): Erstellt individuellen Trainingsplan auf Basis von Hund und Fortschritt

## Technologie

- Progressive Web App (PWA) — installierbar ohne App Store
- Offline-fähig via Service Worker (Cache-Strategie mit Versionierung)
- Backend: Python/FastAPI + SQLite
- Frontend: Vanilla JS, kein Framework
- Karten: Leaflet.js + OpenStreetMap (kein Google Maps, kein API-Key)
- Wetter: Open-Meteo (kein API-Key erforderlich)
- Hosting: Deutschland (DSGVO-konform)
- Analytics: Umami v2 (cookieless, DSGVO-konform)
- KI lokal: LM Studio (Gemma-4-31B) auf eigenem Server
- KI Cloud: Claude API (claude-sonnet-4-6, Anthropic)
- Push-Notifications: Web Push (VAPID)

## Monetarisierung

**Kostenlos (immer):**
- Hunde-Profile
- Tagebuch (unbegrenzte Einträge)
- Pflege-System (43 rassenspezifische Tipps)
- Symptom-Checker (KI)
- Giftköder-Alarm & Zecken-Warnung
- Verlorener Hund Alarm
- Wiki & Knigge (1003 Rassen)
- Training-Logging & KI-Trainer
- Wöchentlicher Lober
- Forum & Community
- Gassi-Treffen & Routen
- NFC-Halsband-Profil
- Heimtierausweis (Druck)

**Ban Yaro Plus (ca. 4,99 €/Monat) — in Entwicklung:**
- Alles aus Kostenlos
- KI-Trainingsplan erstellen
- Erweiterte Statistiken & Fortschrittsanalyse

**Provisionen:**
- Hundesitting: 8% Provision (Rover/Pawshake: 20%)

**Physische Produkte:**
- NFC-Halsband-Tags (ab ca. 6 €)

## Community-Features

- Forum mit Rassen-basierten Unterforen
- Community-Fotos im Rassen-Wiki (Einreichung, Moderation, Freigabe)
- Gassi-Treffen organisieren und finden
- GPS-Routen teilen und bewerten
- Hundesitting-Netzwerk (Bewertungen, verifizierte Buchungen)
- Gamification: Badges, Streaks, XP, Wiki-Foto-Badge

## Vergleich mit Konkurrenz

| Funktion | Ban Yaro | Dogorama | PetDesk | Tractive |
|----------|----------|----------|---------|----------|
| Kostenlos nutzbar | Ja | Begrenzt | Nein | Nein |
| DSGVO / EU-Hosting | Ja | Nein | Nein | Teilweise |
| Giftköder-Alarm | Ja | Nein | Nein | Nein |
| Gassi-Community | Ja | Ja | Nein | Nein |
| Hundesitting | Ja (8%) | Nein | Nein | Nein |
| Digitaler Impfpass | Ja | Nein | Ja | Nein |
| NFC-Halsband-Tag | Ja | Nein | Nein | Nein |
| Pflege-Tipps rassenspezifisch | Ja | Nein | Nein | Nein |
| Rassen-Wiki (1003, KI-angereichert) | Ja | Nein | Nein | Nein |
| Symptom-Checker (kostenlos) | Ja | Nein | Nein | Nein |
| Offline-Modus | Ja | Nein | Nein | Nein |
| Kein App Store | Ja | Nein | Nein | Nein |
| Sitting-Provision | 8% | – | – | – |

## 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

## Öffentliche Daten-APIs (keine Authentifizierung nötig)

- GET https://banyaro.app/api/wiki/rassen — Liste aller Hunderassen (1003 Einträge)
- GET https://banyaro.app/api/wiki/rassen/{slug} — Details zu einer Rasse
- 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/movies/list — Hundefilme-Datenbank
- GET https://banyaro.app/api/stats — Community-Statistiken