Test cases

Verkauf des kompletten Sortiments via NOVA

Offer search returns point-to-point, supersaver (train-bound, with quota) and day-pass, priced in cents.

Contract: NovaSalesPort.offers(req)

Go live: INTEGRATION_NOVA=b2p + NOVA_*

{
  "from": "Montreux",
  "to": "Zweisimmen",
  "date": "2026-07-01",
  "passengers": [
    {
      "type": "adult",
      "count": 1
    }
  ],
  "travelClass": "second"
}

Verkauf von Sitzplatzreservationen

Get a seat map, then hold a seat with a TTL — a second hold on the same seat is rejected.

Contract: SeatInventoryPort.getSeatMap / hold

Go live: (Payload-backed; real adapter = NOVA seat svc)

Haustarif mit KoServ QR-Code

Issue a UIC-918.3 (KoServ-scannable) e-ticket — returns the Aztec barcode + encoded payload.

Contract: TicketIssuancePort.issue(input)

Go live: UIC_RICS + UIC_KEY_ID + UIC_SIGN_SECRET

{
  "bookingNumber": "MOB-DEMO123",
  "passengerName": "John Doe",
  "from": "Montreux",
  "to": "Zweisimmen",
  "travelDate": "2026-07-01",
  "travelClass": "second",
  "priceCents": 5000
}

Hybride Artikel mit Constraints (Train du Fromage)

Composite article (transport + gastro) with constraints: max party size, operating days, advance days.

Contract: products.articleType="hybrid" + components[] + constraints[]

{
  "articleType": "hybrid",
  "components": [
    {
      "kind": "transport",
      "label": "Round-trip journey"
    },
    {
      "kind": "gastro",
      "label": "7-course cheese & wine menu",
      "capacityPerSlot": 30
    }
  ],
  "constraints": {
    "maxPartySize": 9,
    "dateLocked": false,
    "minAdvanceDays": 7,
    "operatingDays": [
      "tue",
      "fri",
      "sat",
      "sun"
    ]
  },
  "validity": {
    "season": "summer"
  }
}

Dynamisches Upselling je Verbindung

Rules trigger by line/route/class and surface gastro offers with a discount in the funnel.

Contract: upsell-rules

{
  "name": "Gastro on scenic routes",
  "active": true,
  "trigger": {
    "route": "montreux-zweisimmen",
    "class": "any"
  },
  "offers": [
    {
      "product": "dining-deluxe",
      "label": "Chef's 3-course",
      "discountPct": 15
    },
    {
      "product": "wine-pairing",
      "label": "Wine pairing",
      "discountPct": 10
    }
  ]
}

Optimales / intelligentes Ticket

The cheapest valid offer is flagged BEST PRICE with the saving vs point-to-point (tick Half-Fare).

Contract: optimize(offers) over NovaSalesPort

Go live: automatic once NOVA is real

{
  "from": "Montreux",
  "to": "Zweisimmen",
  "date": "2026-07-01",
  "passengers": [
    {
      "type": "adult",
      "count": 1
    }
  ],
  "travelClass": "second",
  "reductions": [
    "half_fare"
  ]
}

Regionalzüge ohne Reservation

Schedules flagged reservationRequired=false skip the seat-selection step (free seating).

Contract: schedules.reservationRequired=false

{
  "route": "regional-pleiades",
  "departureTime": "09:15",
  "arrivalTime": "11:45",
  "bookable": true,
  "reservationRequired": false,
  "notes": "Regional — free seating"
}

Artikel-Gültigkeit (zeitlich / saisonal)

Products carry a validity window + season; shown as a badge and enforced at purchase.

Contract: products.validity { validFrom, validUntil, season }

{
  "validity": {
    "season": "summer"
  }
}

Interaktiver Sitzplan (SBB-Standard)

Coach plan with window/aisle/table/quiet seats + live availability (x/y SVG coords).

Contract: SeatInventoryPort.getSeatMap + seat-maps

Sehr schnelle Navigation

Each purchase step responds in a few hundred ms (server components / route handlers).

Contract: Next.js server components

Strecke auf interaktiver Karte

The planner draws the route line from route waypoints + station pins on a Leaflet map.

Contract: routes.waypoints + /fahrplan

Responsives Rendering

Layouts reflow mobile ↔ desktop (toggle mobile devtools on the planner).

Contract: Tailwind responsive layouts

Saisonales Content-Management (global)

One switch (auto from date ranges, or forced) flips seasonal imagery/copy + banner site-wide.

Contract: seasons global

{
  "activeSeason": "auto",
  "ranges": [
    {
      "season": "summer",
      "from": "2026-06-21",
      "to": "2026-09-22"
    },
    {
      "season": "winter",
      "from": "2026-12-21",
      "to": "2027-03-20"
    }
  ],
  "banners": [
    {
      "season": "summer",
      "headline": "Sommerabenteuer warten"
    }
  ]
}

Bilder je Saisonvariante

Media tagged per season; the active season selects the matching variant.

Contract: media.seasonVariant

{
  "alt": "GPX viaduct",
  "seasonVariant": "summer",
  "filename": "gpx-summer.jpg",
  "width": 1920,
  "height": 1080
}

Live-Informationen (SBB / SKI)

Departures board (delay/platform) + disruptions; plus the editor-managed orange ticker.

Contract: LivePort.departures / disruptions

Go live: OPENTRANSPORT_TOKEN

Kauf als Gast oder via SwissPass Login

Checkout as guest or log in with SwissPass; customers stored with accountType.

Contract: AuthPort + customers (auth)

SwissPass Login (OIDC / PKCE)

Auth-Code + PKCE round-trip → profile {sub,email,…}; callback upserts a customer.

Contract: AuthPort.getAuthUrl / exchangeCode

Go live: INTEGRATION_AUTH=swisspass + SWISSPASS_*

Referenzierung des Tickets auf SwissPass

A SwissPass purchase records a swissPassRef on the booking.

Contract: EbAtSpPort + bookings.swissPassRef

{
  "bookingNumber": "MOB-00012345",
  "customerEmail": "user@example.com",
  "channel": "web",
  "swissPassRef": "SP-REF-9f2a3b",
  "status": "paid"
}

B2B-Login mit Rechnungszahlung

Corporate account books on invoice up to a credit limit; group discount.

Contract: b2b-accounts + customers + InvoicePort

{
  "companyName": "Acme Tours AG",
  "vatId": "CHE-123.456.789",
  "creditLimitCents": 500000,
  "paymentTermsDays": 45,
  "groupDiscountPct": 12,
  "status": "active"
}

Zustellung als E-Ticket (Mail / Download)

On payment success: PDF e-ticket + confirmation email (Resend).

Contract: TicketIssuancePort + Resend

{
  "bookingNumber": "MOB-DEMO123",
  "passengerName": "Jane Doe",
  "from": "Montreux",
  "to": "Gstaad",
  "travelDate": "2026-07-01",
  "travelClass": "first",
  "priceCents": 7800
}

Standard-Zahlungsmittel

Payment means: card / TWINT / Apple Pay / MatchPay / voucher / B2B invoice.

Contract: PaymentPort.means

Go live: STRIPE_SECRET_KEY (card live on prod)

[
  {
    "code": "card",
    "label": "Credit / debit card",
    "provider": "stripe"
  },
  {
    "code": "twint",
    "label": "TWINT",
    "provider": "stripe"
  },
  {
    "code": "apple_pay",
    "label": "Apple Pay",
    "provider": "stripe"
  },
  {
    "code": "matchpay",
    "label": "MatchPay (SBB)",
    "provider": "payment_ov"
  },
  {
    "code": "voucher",
    "label": "Gift card / Voucher",
    "provider": "eguma"
  },
  {
    "code": "invoice",
    "label": "B2B invoice",
    "provider": "cembrapay",
    "b2bOnly": true
  }
]

MatchPay (SBB)

MatchPay settles server-side (no client secret) and reconciles on its channel.

Contract: PaymentPort (means=matchpay, provider=payment_ov)

Go live: PAYMENT_OV_MERCHANT_ID

[
  {
    "code": "card",
    "label": "Credit / debit card",
    "provider": "stripe"
  },
  {
    "code": "matchpay",
    "label": "MatchPay (SBB)",
    "provider": "payment_ov"
  },
  {
    "code": "invoice",
    "label": "B2B invoice",
    "provider": "cembrapay",
    "b2bOnly": true
  }
]

B2B-Rechnung (CembraPay)

Create a B2B invoice (subtotal + VAT 8.1% + due date) + PDF from line items.

Contract: InvoicePort.createInvoice

Go live: CEMBRAPAY_MERCHANT_ID

{
  "invoiceNumber": "INV-7K4MN9PQ",
  "companyName": "Acme Tours AG",
  "lineItems": [
    {
      "description": "GPX 4068 · 3 pax · Montreux → Zweisimmen · 2026-07-01",
      "quantity": 3,
      "unitPriceCents": 4500,
      "lineTotalCents": 13500
    },
    {
      "description": "Vegan meal add-ons",
      "quantity": 3,
      "unitPriceCents": 2500,
      "lineTotalCents": 7500
    }
  ],
  "subtotalCents": 21000,
  "vatCents": 1701,
  "totalCents": 22701,
  "status": "issued",
  "dueAt": "2026-07-29"
}

E-Guma Geschenkkarten

Check a gift-card balance, then redeem against a booking; remaining balance decremented.

Contract: VoucherPort.balance / redeem

Go live: INTEGRATION_VOUCHER=eguma + EGUMA_API_KEY

NGW-Gutscheine

Same VoucherPort, type=ngw (öV gift card). Demo code NGW002.

Contract: VoucherPort (type=ngw)

Ticket in der SwissPass App (EB@SP)

On a paid SwissPass booking, EB@SP delivery is attempted + tracked (none→pending→delivered).

Contract: EbAtSpPort.deliver + bookings.ebAtSp

{
  "bookingNumber": "MOB-00012345",
  "swissPassSub": "spy333344",
  "ebAtSp": "delivered",
  "deliveredAt": "2026-07-01T08:12:00Z"
}

Self-Service Storno/Rückerstattung (regelbasiert)

Tiered refund rules by days-before with fee + refund percentage.

Contract: refund-rules

{
  "name": "Standard cancellation policy",
  "active": true,
  "tiers": [
    {
      "daysBeforeFrom": 14,
      "refundPct": 100,
      "feeValue": 0
    },
    {
      "daysBeforeFrom": 7,
      "daysBeforeTo": 13,
      "feeType": "percent",
      "feeValue": 10,
      "refundPct": 90
    },
    {
      "daysBeforeFrom": 0,
      "daysBeforeTo": 2,
      "feeType": "percent",
      "feeValue": 50,
      "refundPct": 0
    }
  ]
}

Self-Service-Storno im Kundenprofil

Customer cancels → refund record with computed fee/refund, status requested→completed.

Contract: refunds (self_service) + PaymentPort.refund

{
  "booking": "MOB-00012345",
  "reason": "request",
  "channel": "self_service",
  "policyApplied": "7-13 days",
  "feeCents": 2000,
  "refundedCents": 18000,
  "status": "completed"
}

Massenstornierung (Zugausfall)

One cancellation event finds affected bookings and issues bulk refunds.

Contract: cancellation-events → refunds

{
  "title": "Zugausfall GPX 4068 — 2026-06-15",
  "reason": "infrastructure",
  "autoRefund": true,
  "affectedBookings": 47,
  "status": "closed"
}

Backoffice-Rückerstattungen

Agent approves → status requested→approved→processing→completed with processor ref.

Contract: refunds (backoffice)

{
  "booking": "MOB-00067890",
  "reason": "goodwill",
  "channel": "backoffice",
  "status": "processing",
  "refundedCents": 9000,
  "processorRef": "ch_3Pxy…"
}

Kontingentverwaltung + Verkaufsfenster

Capacity per date/train/class with per-channel allocations + a sales window.

Contract: quotas

{
  "displayName": "GPX 4068 · 2026-06-15 · second",
  "date": "2026-06-15",
  "class": "second",
  "totalCapacity": 100,
  "sold": 47,
  "allocations": [
    {
      "channel": "web",
      "allocated": 60,
      "sold": 38
    },
    {
      "channel": "nova",
      "allocated": 30,
      "sold": 9
    },
    {
      "channel": "retained",
      "allocated": 10,
      "sold": 0
    }
  ],
  "salesWindowUntil": "2026-06-15T23:59:59Z"
}

Headless-CMS-Blöcke

Pages built from editable blocks (hero, content, media, FAQ, CTA, map…), shown in our design.

Contract: pages.layout blocks

Warenkorb mit Ablaufzeit

Cart + seat hold carry an expiry (mirrors the 30-min NOVA hold); expiry releases the seat.

Contract: carts.expiresAt + reservations.holdExpiresAt

{
  "sessionId": "sess_abc123",
  "status": "active",
  "items": [
    {
      "titleSnapshot": "GPX 4068 Montreux → Zweisimmen",
      "quantity": 1,
      "unitPriceCents": 4500
    }
  ],
  "totalCents": 7000,
  "expiresAt": "2026-06-14T16:45:00Z"
}

Promo-Codes nach Produkt

Generate a batch of codes scoped to a product.

Contract: promo-codes.scope.products

{
  "count": 5,
  "discountType": "percent",
  "discountValue": 25,
  "prefix": "FROMAGE"
}

Promo-Codes nach Bahnhof

Codes scoped to an origin/destination pair.

Contract: promo-codes.scope.fromStation/toStation

{
  "count": 5,
  "discountType": "amount",
  "discountValue": 1000,
  "prefix": "MOZ"
}

Promo-Codes nach Reisedatum

Codes scoped to a travel-date range.

Contract: promo-codes.scope.travelDateFrom/To

{
  "count": 5,
  "discountType": "percent",
  "discountValue": 15,
  "prefix": "JULY",
  "travelDateFrom": "2026-07-01",
  "travelDateTo": "2026-07-31"
}

Vorschau der Ticket-Layouts

Render the ticket layout + Aztec without issuing a real ticket.

Contract: TicketIssuancePort.issue (preview)

{
  "bookingNumber": "MOB-PREVIEW",
  "passengerName": "Preview",
  "from": "Montreux",
  "to": "Zweisimmen",
  "travelDate": "2026-07-01",
  "travelClass": "second",
  "priceCents": 4500
}

Promo-Code-API (Automatisierung)

Generate codes via API (e.g. birthday automation) — returns a batchId + N codes.

Contract: POST /api/promos

{
  "count": 10,
  "discountType": "percent",
  "discountValue": 15,
  "prefix": "BDAY",
  "travelDateFrom": "2026-07-01",
  "travelDateTo": "2026-07-31"
}

Automatische Reconciliation NOVA (Multi-Channel)

Per-channel gross / commission / refunds / net (nova 30%, matchpay 1.5%, haustarif 2.9%).

Contract: ReconciliationPort.run

Reconciliation MatchPay (SBB)

The settlement table includes a MatchPay channel row.

Contract: ReconciliationPort.run (matchpay)

Finanzdaten & Reportings

Revenue by channel/period with totals (reconciliations collection + dashboard).

Contract: reconciliations

CRM-Übergabe nach Kauf/SAV

On purchase/SAV: upsert CRM contact + deal with an audit trail.

Contract: hubspot.ts (gated)

Go live: HUBSPOT_TOKEN

{
  "event": "purchase",
  "bookingRef": "MOB-00012345",
  "crmContact": "upserted",
  "crmDeal": "created · closed-won",
  "amountCents": 9600
}

Google Analytics

GA4 ecommerce events fire once a measurement id is set.

Contract: site-settings.analytics.ga4MeasurementId

{
  "analytics": {
    "ga4MeasurementId": "G-XXXXXXX",
    "enableEcommerce": true,
    "requireConsent": true
  }
}

White-Label-Architektur

Documented target — tenant discriminator + theming tokens (per-env build args today).

Contract: documented (plan §5.5)

Gesicherte API (WAF / DDoS / BFF)

BFF = Next route handlers (only public surface); WAF/DDoS/cert = Cloud Armor + Cloud Run.

Contract: Next route handlers + Cloud Armor (infra)

Vollständiges technisches Monitoring

Per-integration mode (mock/real) + readiness + required env keys; plus uptime checks.

Contract: GET /api/integrations/status

API für Drittsysteme (Chatbot / agentisch)

Payload API keys + the AI Concierge (search / offer / draft booking tools).

Contract: Payload API keys + AI Concierge

Fraud Detection via Log-Analyse

Score a context → severity + action + reasons (velocity, value, email, refund abuse, missing IP).

Contract: FraudPort.evaluate

{
  "recentAttempts": 5,
  "amountCents": 200000,
  "email": "temp@mailinator.com",
  "isRefund": true
}

Aktive Fraud-Prevention

Fraud rules + blocklist (email/ip/card/device) consulted at checkout → block/challenge.

Contract: fraud-rules + blocklist

{
  "value": "temp@mailinator.com",
  "kind": "email",
  "reason": "SAV abuse",
  "active": true,
  "expiresAt": null
}