rene 756e17faba Projektstruktur und Roadmap initial

2026-04-12 16:17:20 +02:00

10 KiB

Raw Blame History

Ban Yaro — Die Hunde-Plattform

"Ban-yaro" ist ein Jedi-Meister aus der Clone-Wars-Ära (Wookieepedia/Jedipedia). Der Name wurde von der Züchterin für einen Wurf vergeben — daher kein Namensrechts-Konflikt.

Vision

Ban Yaro ist die erste deutschsprachige All-in-One Hunde-Plattform: kein US-Konzern, kein App Store Zwang, DSGVO-konform, selbst gehostet.

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

Zielgruppe

Primär: Deutschsprachige Hundebesitzer, 25-55 Jahre, smartphone-affin Sekundär: Hundeschulen, Tierärzte, Züchter, lokale Shops Markt: ~10 Mio. Hunde in Deutschland, ~34 Mio. in DACH

Tech-Stack

Konsistent mit akku-werkstatt (bewährt, bekannt):

Backend:   FastAPI + SQLite (WAL-Modus)
Frontend:  Vanilla JS/HTML + CSS (PWA)
Auth:      JWT (HttpOnly Cookie + Bearer Token)
Deploy:    Docker auf Synology DS1621
Reverse:   NPM (Nginx Proxy Manager)
Domain:    banyaro.de (zu registrieren)
KI:        LM Studio lokal + Claude API für komplexere Tasks
Push:      Web Push API (pywebpush)
Maps:      Leaflet.js + OpenStreetMap (kostenlos, kein Google-Lock)

PWA-First Strategie

Kein App Store nötig → sofort updatebar
"Zum Homescreen hinzufügen" auf iOS und Android
Offline-fähig via Service Worker
Web Share Target: App empfängt Fotos/Links aus anderen Apps

Feature-Roadmap

Phase 1 — MVP (Version 1.0)

Ziel: Echter Nutzen ohne Community-Masse. Funktioniert auch für einen einzelnen Nutzer.

1.1 Hunde-Profil & Tagebuch (Herzstück)

Hunde-Profil anlegen (Name, Rasse, Geburtstag, Foto, Chip-Nr.)
Tagebuch: Einträge mit Foto, Text, Datum, GPS-Ort (optional)
Milestone-Karten automatisch ("Ban Yaro ist heute 1 Jahr alt!")
Jahresrückblick-Generator (Premium)
PDF/Printbook-Export (Premium)
Öffentliches Profil optional (banyaro.de/hund/name)

1.2 Gesundheit & Impfpass

Impfungen, Entwurmungen, Tierarztbesuche digital
Medikamenten-Reminder (Push Notification)
Gewichtsverlauf-Chart
Einfacher Symptom-Checker (KI-gestützt, Triage: beobachten/Tierarzt/Notfall)

1.3 Giftköder-Alarm

Fundort melden (GPS + Foto + Beschreibung)
Push Notification für alle Nutzer im konfigurierbaren Radius
Karte mit aktiven Meldungen (OpenStreetMap/Leaflet)
Ablaufdatum (7 Tage ohne Bestätigung → automatisch inaktiv)
Bestätigungs- und Moderationssystem
Statistiken (Hotspots, saisonale Muster)

1.4 Wetter-Alert

Täglicher Push wenn Asphalt-Temperatur kritisch (>40°C)
Pollenflug-Alert (für allergische Hunde)
Gewitterwarnung mit Tipps für angstvolle Hunde
Datenquelle: Open-Meteo API (kostenlos)

1.5 NFC-Halsband-Tag

Hunde-Profil als öffentliche URL (ohne Login sichtbar)
Notfallkontakte ohne Nummer preiszugeben (vermittelt via App)
"Ich habe diesen Hund gefunden" Button → Owner bekommt Push + Finder-Standort
NFC-Tags als physisches Produkt anbieten (Shop-Integration, erste Monetarisierung)

Phase 2 — Community (Version 2.0)

Ziel: Netzwerkeffekte aufbauen. Features die besser werden je mehr Nutzer dabei sind.

2.1 Gassi-Community

Gassi-Treffen erstellen (Ort, Zeit, Hunde willkommen)
Live-Standort teilen während Spaziergang (opt-in)
Gassi-Route aufzeichnen (GPS-Track)
Routen bewerten (Untergrund, Schatten, Leinenpflicht, Sicherheit)
Routen filtern (Dauer, Schwierigkeit, hundefreundlich)

2.2 Verlorener Hund

Alert mit Foto + letzter GPS-Position
Alle Nutzer im Radius alarmieren
KI-Foto-Abgleich (ist das derselbe Hund?)
Automatische Meldung an Tierheime in der Region
"Held des Tages" Badge für erfolgreiche Finder

2.3 Hundesitting-Netzwerk

Sitter-Profil (Erfahrung, eigene Hunde, Kapazität)
Buchungsanfragen + Kalender
Bewertungen + verifizierte Buchungen
Provision: 8% (vs. 20% bei Rover/Pawshake)
Notfall-Netzwerk: Vertrauenspersonen definieren

2.4 Forum

Rassen-basierte Sub-Foren
Lokale Boards (PLZ-basiert)
KI-Zusammenfassung langer Threads
Experten-Badge (Tierarzt, Trainer verifiziert)
"Ähnliche Fragen" (KI-Duplikat-Erkennung)

2.5 Hundefreundliche Orte

Crowd-sourced Datenbank (differenziert: darf rein? Wasser? Leine?)
Foto vom Eingangsbereich
"War mit großem Hund da" spezifische Bewertungen
Negativbewertungen möglich ("Schild sagt ja, Personal sagt nein")

Phase 3 — Wissen & Content (Version 2.5)

Ziel: SEO-Traffic, Nutzerbindung auch ohne aktive Community-Nutzung

3.1 Hunde-Wiki

Rassen-Datenbank (Charakter, Gesundheit, Pflege)
"Passt diese Rasse zu mir?" Quiz
Gesundheits-Wiki (Zecken mit RKI-Risikogebiete-Karte, Vergiftungen, Erste Hilfe)
Recht & Regeln (Leinenpflicht, Rasselisten, Hundsteuer je Bundesland)
Community-Erfahrungsberichte je Rasse
Züchter-Verzeichnis (VDH-verifiziert)

3.2 Hunde-Knigge

Begegnungen (fremder Hund, Kinder, Radfahrer)
Öffentliche Orte (ÖPNV-Regeln je Stadt)
"Was wäre richtig?" Community-Szenarien mit Abstimmung
KI-Situationsberater
Haftpflicht-Ratgeber (Verbindung zu Versicherungspartner)

3.3 Events & Kultur

Agility-Turniere, Hundeausstellungen (VDH-Kalender scrapen)
Hundefilme (Datenbank + "Stirbt der Hund?" Rubrik)
Hundeberühmtheiten (historisch + Instagram/TikTok)
"Hund des Monats" Community-Voting

Phase 4 — Smart Features (Version 3.0)

Ziel: Premium-Differenzierung, Daten-Netzwerk-Effekte

4.1 Futter-Intelligence

Barcode-Scanner → Inhaltsstoffe gegen Hunde-Profil prüfen
Personalisiertes Rating (Rasse, Alter, Allergien)
Preis-Tracking (Zooplus, Fressnapf, Zooroyal)
Preisalarm via Push
Nachhaltigkeits-Score
Sammelbestellung (Gruppe kauft zusammen → Mengenrabatt)

4.2 Smart Collar Integration

Tractive API → GPS-Tracks in Ban Yaro einlesen
Fi Collar Integration
Automatisch: Route → Tagebuch
Geofence-Alarm → Notfall-Netzwerk aktivieren

4.3 EU-Reisepass

Einreiseregeln je Land (automatisch aktuell gehalten)
Checkliste für eigenen Hund ("Was brauche ich für Spanien?")
Zeitplan mit Tierarzt-Reminder
PDF-Export

4.4 Erziehungs-KI

Tägliches Trainings-Tagebuch (30-Sekunden-Eintrag)
Muster-Erkennung über Zeit ("Du trainierst erfolgreich morgens")
Vergleich mit anderen Hunden gleicher Rasse (anonym)
Automatischer Trainingsplan

Monetarisierung

FREEMIUM-MODELL:

Kostenlos (immer):
  - Hunde-Profil (max. 1 Hund)
  - Giftköder-Alarm
  - Verlorener Hund
  - Wiki & Knigge
  - Forum
  - Grundfunktionen Tagebuch

Premium — "Ban Yaro Plus" ~4,99€/Monat:
  - Unbegrenzte Hunde-Profile
  - Tagebuch PDF/Printbook-Export
  - Jahresrückblick
  - Symptom-Checker unlimitiert
  - Preisalarm (unbegrenzt viele Produkte)
  - Futter-Barcode Scanner
  - Smart Collar Integration
  - EU-Reisepass Checkliste
  - Erziehungs-KI

Provisions-Modell:
  - Hundesitting: 8% Provision (vs. 20% Rover)
  
Physische Produkte:
  - NFC-Halsband-Tags: ~6€ Stück (Marge ~70%)
  - Jahresrückblick als gedrucktes Fotobuch (Partnerschaft)

Partner-Modell (später):
  - Hundeschulen-Verzeichnis (verifizierter Badge)
  - Tierarzt-Telemedizin Weiterleitung (Affiliate)
  - Versicherungspartner (Haftpflicht-Ratgeber → Lead)

Go-to-Market

Launch-Strategie

Soft Launch mit Giftköder-Alarm allein → viral in Hundebesitzer-Facebook-Gruppen
Ban Yaro (der echte Hund) als Maskottchen / erster Tagebuch-Eintrag
Hundetrainer und Tierärzte als Multiplikatoren (Experten-Badge)
VDH-Vereinskooperation für Event-Kalender → Backlinks + Traffic
TikTok/Instagram mit "Stirbt der Hund?" Film-Rubrik → virales Potential

SEO-Angriffspunkte

"Giftköder [Stadt]" — stark lokaler Suchbegriff, hohe Emotion
"Hundefreundliche Restaurants [Stadt]"
"[Rasse] Erziehungstipps"
"Hund nach [Land] reisen"

Technische Architektur (Detail)

ban-yaro/
├── backend/
│   ├── main.py              # FastAPI App
│   ├── models.py            # SQLite Datenbankmodelle
│   ├── auth.py              # JWT Auth
│   ├── push.py              # Web Push (pywebpush)
│   ├── maps.py              # Leaflet/OSM Helpers
│   ├── ki.py                # KI-Integration (lokal + Claude)
│   ├── scraper/
│   │   ├── weather.py       # Open-Meteo API
│   │   ├── events.py        # VDH Turnierkalender
│   │   └── prices.py        # Futter-Preise (Phase 4)
│   └── static/
│       ├── index.html       # SPA Shell
│       ├── manifest.json    # PWA Manifest
│       ├── sw.js            # Service Worker
│       ├── shared.css       # Design System
│       └── pages/           # HTML-Seiten je Feature
│
├── docker-compose.yml
├── Dockerfile
└── PROJEKT.md               # Diese Datei

Datenbank-Kernmodelle

users           → id, email, pw_hash, rolle, push_sub, created_at
dogs            → id, user_id, name, rasse, geburtsdatum, chip_nr, foto
tagebuch        → id, dog_id, datum, text, foto, gps_lat, gps_lon, typ
gesundheit      → id, dog_id, typ, datum, naechstes_datum, notiz
giftkoedar      → id, user_id, lat, lon, foto, beschreibung, bestaetigt, expires_at
routen          → id, user_id, gps_track (JSON), bewertung, tags
events          → id, titel, datum, ort_lat, ort_lon, typ, quelle
orte            → id, name, lat, lon, typ, hund_erlaubt, bewertung
forum_posts     → id, user_id, dog_id, thread_id, text, created_at

Nächste Schritte

Domain banyaro.de registriert ✓
Domain banyaro.app registriert ✓ (banyaro.com = japanisches Rhythm-Game "バンドやろうぜ!", kein Konflikt) Strategie: banyaro.app = primäre Domain, banyaro.de → Redirect auf .app
Forgejo-Repo angelegt ✓ SSH: ssh://git@dsm.motocamp.de:2222/rene/banyaro.git HTTPS: https://git.motocamp.de/rene/banyaro.git
Docker-Grundstruktur aufsetzen (wie akku-werkstatt)
Phase 1 Feature 1.1 beginnen: Hunde-Profil + Tagebuch
Design-System definieren (Farben, Fonts — Hunde-Feeling aber modern)

Erstellt: 2026-04-12 Stack: FastAPI + SQLite + Vanilla PWA, Deploy auf DS1621

10 KiB Raw Blame History