Viaora Dokumentation

Öffentliche Doku für Produkt, Architektur, Betrieb und Testing

Diese Docs-App ist die öffentliche Dokumentationsfläche für Viaora. Sie soll den 1.0-Testing-Guide, das Produkthandbuch, Architektur-Referenzen und Release-Gates abbilden, ohne Produkt-Login-Verhalten zu erben.

1.0-prepnext2026-05-15

Eine Produkterzählung

Ops, Hotel, Advertiser und Guest werden als ein zusammenhängendes Produktsystem erklärt statt als vier getrennte Apps.

Ein operativer Testing Guide

Der Testing Guide ist für QA, Sales und interne Release-Checks geschrieben, damit dieselben Routen und Erwartungen wiederverwendet werden.

Eine eigene Deployment-Fläche

Die Docs-App ist von Produkt-Auth und Middleware-Regeln isoliert, damit sie öffentlich und unabhängig deploybar bleibt.

Was dieser erste Stand enthält

Die App ist bewusst zuerst strukturell sauber aufgebaut und nicht nur als lose Sammlung von Markdown-Seiten. Sie enthält das dauerhafte Layout, gemeinsame Page-Primitives, eine zentrale Navigation, eine öffentliche Proxy-Schicht und die ersten Viaora-spezifischen Seiten, die jetzt stabil seitenweise ausgebaut werden können.

Initialer Scope

Was diese Docs-App zuerst beweisen muss

  • Viaora muss seine Cross-App-Workflows klar genug für externe Tester und Sales-Demos erklären.
  • Die öffentliche Docs-Route muss unabhängig unter docs.viaora.app deploybar sein.
  • Der 1.0-Testing-Guide braucht einen kanonischen Routenpfad statt ad hoc Chat-Anweisungen.
  • Die Architektur-Sektion muss erklären, wo Wahrheit zwischen Builder, Guest-Runtime, Contracts und Core lebt.

Quellmaterial

Die ersten Seiten verdichten die bereits vorhandenen Arbeitsdokumente im Repo, darunter Master-Plan, Produkt-PRD, technisches Handbuch, Release-Gates, Deployment-Notizen und operative Rollout-Playbooks.

Ziel ist der Übergang von vielen internen Markdown-Dateien zu einer stabilen öffentlichen Erzählung, ohne die wichtigen operativen Details zu verlieren.

Für wen diese Doku geschrieben ist

Ops / Admin

Legt Hotels an, ordnet Advertiser zu, kontrolliert Rollout und prüft, dass die Plattform als Gesamtsystem funktioniert.

Hotels

Pflegen Identity, Services, Discover, Journeys und die gesamte sichtbare Hotelerzählung in der Guest App.

Advertiser

Pflegen ihre eigene Profil-Truth: Karten-Copy, Detailtexte, Assets und veröffentlichte Inhalte für Relationsflächen.

QA / Sales

Nutzen diese Doku, um Demo-Hotels, Erwartungsbilder, Routen und den End-to-End-Testpfad verlässlich nachzuvollziehen.

So benutzt du diese Doku sinnvoll

  1. Starte mit Erster Tag, wenn du die Plattform oder das lokale Setup erst verstehen musst.
  2. Gehe zu Bereiche und Routen, wenn du wissen willst, welche App für welche Aufgabe zuständig ist.
  3. Nutze das Handbuch, wenn du konkret wissen willst, was in Ops, im Hotel-Builder, im Advertiser-Builder oder in Guest passiert.
  4. Nutze Testing, wenn du einen vollständigen End-to-End-Durchlauf für QA, Sales oder Release fahren willst.
  5. Nutze Architektur und Betrieb, wenn du Truth-Regeln, Deployments oder Boards einordnen musst.