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 (Ausstehend)
       ↓
Payment Success → Bestätigt

Booking-Status

Guest Access Token

Jede Booking erhalt einen einzigartigen, sicher gehashten Token:

• 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)
       ↓
Zahlung bestätigt
       ↓
Booking Status → Bestätigt
       ↓
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 "Aktiv"

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: 30 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 Minuten
• 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

• Stündlich: 50 AI-Requests pro Account
• Täglich: 200 AI-Requests pro Account
• 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