Konzepte

Diese Seite erklart die grundlegenden Konzepte von Stayoa und wie sie zusammenarbeiten. Ein solides Verstandnis dieser Konzepte hilft dir, die Plattform effektiv zu nutzen.

---

Property (Unterkunft)

Eine Property ist die zentrale Einheit in Stayoa – deine Unterkunft, die du vermietest.

Eigenschaften

• Status: Draft (Entwurf), Published (Veroffentlicht), Archived (Archiviert)
• Slug: Eindeutige URL (z.B. villa-alpenblick → villa-alpenblick.stayoa.app)
• Type: Apartment, House, Villa, Cabin, etc.
• Details: Adresse, Gäste, Schlafzimmer, Badezimmer, Betten
• Media: Bilder, Hero Image, Galerie
• Design: Individuelle Farben, Logo, Layout

Property Lifecycle

Draft → Published → Archived
  ↓         ↓
Preview   Live

• Draft: Sichtbar nur für dich, nicht buchbar
• Published: Live und buchbar für Gäste
• Archived: Nicht mehr aktiv, aber Daten bleiben erhalten

---

Bookings (Buchungen)

Eine Booking reprasentiert eine Gäste-Reservierung für deine Property.

Booking-Flow

Guest selects dates
       ↓
Review & Price Calculation
       ↓
Payment (Stripe)
       ↓
Booking Created (PENDING)
       ↓
Payment Success → CONFIRMED

Booking-Status

Guest Access Token

Jede Booking erhalt einen einzigartigen Token (SHA-256 Hash):

• Gäste konnen ihre Buchung über Token aufrufen
• Token ist 90 Tage nach Check-out gültig
• Gäste konnen über Token stornieren
• Zugang zu Dokumenten (PDF, iCal)

---

Pricing (Preisgestaltung)

Stayoa bietet ein flexibles Pricing-System mit mehreren Ebenen.

Preiskomponenten

Base Price (pro Nacht)
  ↓
+ Weekend Pricing (Fr/Sa Multiplikator)
  ↓
+ Seasonal Pricing (Zeitraum-basiert)
  ↓
- Discounts (Weekly/Monthly)
  ↓
+ Fees (Cleaning, Security, Additional Guests, Tourist Tax)
  ↓
= Total Price

Base Price

Der Grundpreis pro Nacht in deiner gewunschten Wahrung (CHF, EUR, USD).

Weekend Pricing

Multiplier für Freitag und Samstag:

• Freitag: z.B. 1.2 (= 20% mehr)
• Samstag: z.B. 1.3 (= 30% mehr)

Seasonal Pricing

Zeitraum-basierte Preise:

{
  "startDate": "2026-07-01",
  "endDate": "2026-08-31",
  "pricePerNight": 200.00,
  "minNights": 7
}

Discounts

• Weekly: Rabatt ab 7 Nachten (z.B. 10%)
• Monthly: Rabatt ab 28 Nachten (z.B. 20%)

Fees

• Cleaning Fee: Einmalig pro Aufenthalt
• Security Deposit: Wird via Stripe Hold blockiert (nicht charged)
• Additional Guest Fee: Pro Person über Basis-Gäste
• Tourist Tax: Pro Gast pro Nacht

Preis-Berechnung Beispiel

Base Price: 150 CHF/Nacht × 5 Nachte = 750 CHF
Weekend Pricing (1 Sa): +45 CHF
Weekly Discount (7+ Nachte): -0 CHF
Cleaning Fee: +80 CHF
Additional Guests (1): +25 CHF
Tourist Tax (2 Gäste × 5 Nachte): +20 CHF
─────────────────────────────────────
Total: 920 CHF

---

Payment System

Stayoa nutzt Stripe Connect für sichere Zahlungsabwicklung.

Stripe Connect

• Direct Charges: 100% Revenue geht direkt an dich
• Keine Stayoa Commission: Wir nehmen keine Provision
• Stripe Fees: Ca. 1.4% + 0.25 CHF (Stripe Processing Fee)

Payment Flow

Guest enters card details
       ↓
Stripe Payment Intent Created
       ↓
Payment Processing (Stripe)
       ↓
Webhook Event (payment_intent.succeeded)
       ↓
Booking Status → CONFIRMED
       ↓
Confirmation Email sent

Refunds

Bei Stornierung:

• Cancellation Policy wird gepruft

• Refund Amount wird berechnet

• Automatic Refund via Stripe API

• Cancellation Email an Gast

---

Domains & Subdomains

Stayoa unterstutzt zwei Arten von Domains für deine Buchungsseite.

Subdomain (Standard)

Automatisch für jede Property:

{slug}.stayoa.app

Beispiel: villa-alpenblick.stayoa.app

Custom Domain

Verbinde deine eigene Domain:

buchen.deine-domain.de
book.yourdomain.com

Setup:

• Domain in Stayoa hinzufügen

• DNS CNAME Record erstellen: CNAME → cname.vercel-dns.com

• Domain Verification (automatisch)

• Status wird zu "ACTIVE"

---

Team & Permissions

Arbeite mit deinem Team an Properties.

Roles

Property Members

Jedes Property kann eigene Members haben:

• Member wird per E-Mail eingeladen
• Invitation Token (7 Tage gültig)
• Member kann mehrere Properties verwalten
• Permission System auf Property-Level

Invitation Flow

Owner invites Member
       ↓
Invitation Email sent (with Token)
       ↓
Member clicks Link & accepts
       ↓
Member assigned to Property

---

Analytics & Tracking

Stayoa bietet Privacy-first Analytics (GDPR-compliant).

Tracked Metrics

• Page Views: Anzahl Seitenaufrufe
• Unique Visitors: Einzigartige Besucher (Session-basiert)
• Conversion Rate: Booking Conversion %
• Engagement: Dwell Time, Scroll Depth
• Traffic Sources: UTM Parameters, Referrer
• Device & Locale: Gerate und Sprachen

Privacy Features

• IP Hashing: IPs werden gehasht (nicht gespeichert)
• No Cookies: Kein Cookie-Banner notig
• Bot Filtering: Bots und Prefetch Traffic gefiltert
• Data Retention: 90 Tage
• Analytics Opt-Out: Gäste konnen opt-out

Reports

Verfügbare Reports:

• Revenue Report: Umsatz über Zeit
• Booking Report: Buchungen pro Property
• Occupancy Report: Auslastungsraten
• Tax Report: Steuerbericht (Kurtaxe)

Alle Reports sind als CSV exportierbar.

---

iCal Synchronisation

Verhindere Doppelbuchungen durch Kalender-Sync.

Import (Von externen Plattformen)

Importiere Buchungen von Airbnb, Booking.com, VRBO:

• Kopiere iCal URL von externer Plattform

• Fuge URL in Stayoa ein

• Klicke "Sync Now"

• Externe Buchungen werden als Calendar Blocks angelegt

Export (Fur externe Plattformen)

Exportiere Stayoa-Buchungen:

• Kopiere Stayoa iCal Export URL

• Fuge URL in Airbnb/Booking.com ein

• Externe Plattform synchronisiert automatisch

Automatische Synchronisation

• Interval: Alle 30-60 Minuten (Cron Job)
• Timeout: 10 Sekunden pro Request
• Retry Logic: Bei Fehler Retry nach 1h

---

Email Automation

Automatische E-Mails für Gäste und Gastgeber.

Email Types

Email Content

Jede E-Mail enthalt:

• Booking Details (Datum, Gäste, Property)
• Guest Access Token Link
• Property Address & Check-in Info
• Cancellation Policy
• Host Contact

Email Preferences

Gastgeber konnen konfigurieren:

• Welche E-Mails sie erhalten möchten
• E-Mail-Sprache (DE/EN)
• Copy to Guest (bei Host Emails)

---

AI Features

KI-gestützte Tools für Content-Erstellung.

Description Generator

Generiert Property-Beschreibungen:

• Languages: DE/EN
• Tone: Professional, Friendly, Exclusive
• Length: Short (100 Worter), Medium (200), Long (300)
• Context: Location, Type, Amenities, Highlights

Title Generator

Generiert SEO-optimierte Titel:

• Styles: Modern, Traditional, Luxury, Cozy
• Length: 40-60 Zeichen
• SEO: Keywords basierend auf Location & Type

Translation Helper

Übersetzt Inhalte automatisch:

• Auto-Detection: Erkennt Sprache (DE ↔ EN)
• Tone: Natural, Formal, Casual
• Context-aware: Property Name, Field Type

Usage Limits

• PRO Plan: 100 AI-Requests/Tag
• PREMIUM Plan: 500 AI-Requests/Tag
• Rate Limiting: Automatisch enforced

---

SEO & Discovery

Stayoa ist SEO-optimiert für bessere Google-Sichtbarkeit.

Structured Data

Automatisches Schema.org Markup:

{
  "@type": "VacationRental",
  "name": "Villa Alpenblick",
  "address": { ... },
  "geo": { ... },
  "offers": { ... }
}

SEO Features

• Meta Tags: Title, Description, Keywords
• Open Graph: Social Media Previews
• Canonical URLs: Vermeidet Duplicate Content
• Sitemap: Automatisch generiert (/sitemap.xml)
• Robots.txt: Domain-aware

Multilingual SEO

• hreflang Tags: DE/EN Language Variants
• Localized URLs: /de/ und /en/ Prefixes
• Alternate Links: Fur Sprachvarianten

---

Nachste Schritte

Jetzt verstehst du die Kernkonzepte von Stayoa!

Empfohlene nachste Schritte:

• Dashboard Guide – Detaillierte Dashboard-Anleitung

• Property Management – Properties verwalten

• Bookings – Buchungen verwalten

• FAQ – Häufig gestellte Fragen