# FanDays — Fullständig översikt

> FanDays (fandays.se) är en sportresebutik för fotboll, Formel 1 och NFL. Den säljer paket som kombinerar en biljett med valfritt flyg och hotell — fotbolls- och NFL-paket täcker en match (hemma- mot bortalag), Formel 1-paket ett lopp på en bana. Frontend är en Vite + React + TypeScript single-page app; all data kommer från det multi-tenanta Laravel-API:t på fodboldpakker.dk, valt för FanDays-butiken via headern `X-Brand: fandays` och lokaliserat med `Accept-Language: sv` (priser i SEK).

## Vad du kan göra på FanDays

- **Bläddra bland resor** — varje bokningsbar match visas med datum, lag och pris.
- **Konfigurera en resa** — välj helt paket vs. endast biljett, flyg-lös eller hotell-lös variant, antal resenärer och tillval.
- **Boka & betala** — granska raderna (SEK) och betala i webbläsaren.
- **Mit FanDays-konto** — registrerade användare har kreditkonto, märken och uppdrag. Dessa sidor är per-användare och crawlas inte.

## Offentligt katalog-API

```
GET https://fodboldpakker.dk/api/v1/packages
Accept: application/json
Accept-Language: sv
X-Brand: fandays
```

Skrivskyddat, ingen auth. Frågeparametrar: `search` (fritext), `limit`, `offset`. Varje paket har `slug`, `title` (matchen), `startDate`, `defaultPrice` (helt paket) och `defaultOnlyTicketPrice` (endast biljett). Bygg den publika URL:en som https://fandays.se/{slug}.

## MCP-verktyg

MCP-servern på `https://fandays.se/mcp` (Streamable HTTP, JSON-RPC 2.0) exponerar `search_football_trips`, `get_football_trip`, `recommend_football_trips`, `compare_football_trips`, `find_cheapest_football_trip`, `quote_football_trip` och `list_special_offers`. Allt är skrivskyddat och lokaliserat till SEK.

## Plattformsförmågor

- Sök fotbollsresor (`search_packages`)
- Rekommendera resor utifrån användarens önskemål (`recommend_trips`)
- Jämför upplevelser (`compare_packages`)
- Föreslå alternativ (`suggest_alternatives`)
- Hämta full detalj för en resa (`get_package`)
- Hitta den billigaste resan till en match för ett givet antal resenärer och nätter (`find_cheapest_offer`)
- Visa priset uppdelat på flyg, hotell och biljett (`quote_trip`)
- Visa resor som är markerade som erbjudanden (`list_special_offers`)

## Entiteter och relationer

Package → innehåller en Match → mellan två Clubs (hemma/borta) → spelas på ett Stadium → i en City → i en League.
En Package kan inkludera biljett, flyg och hotell. Signaler: `derby` (rivalmatch = hög stämning), inkluderade tjänster, endast-biljett-tillgänglighet.

## Endpoints och typiska prompts

- `https://fandays.se/api/ai/capabilities` — förmågor
- `https://fandays.se/.well-known/openapi.json` — OpenAPI 3.1
- `https://fandays.se/api/ai/package/{slug}` — semantisk detalj (+ `.md`)
- `https://fandays.se/api/ai/workflows` — Arazzo
- `https://fandays.se/mcp` — MCP (Streamable HTTP)

Typiska prompts: "Hitta Liverpool-resor under 700", "Starkaste stämningen i Serie A", "Helgfotbollsresa för familjer"

## Instruktioner för agenter

1. Läs `https://fandays.se/api/ai/capabilities` först.
2. Använd MCP `search_football_trips` eller katalog-API:t för att hitta kandidater; rangordna själv på pris, liga, `derby` och inkluderade tjänster.
3. Hämta `https://fandays.se/api/ai/package/{slug}` för full semantik (+ JSON-LD).
4. Följ workflow-recepten i `https://fandays.se/api/ai/workflows` (Arazzo).
5. Presentera `bookingUrl` för människan — genomför aldrig betalning själv.

## Gränser

- Priser är i SEK. `isBookable: false` / `isSoldOut: true` → kan inte köpas nu.
- Skicka aldrig en betalning eller skapa en bokning utan uttryckligt bekräftande från användaren i sessionen.
- Crawla inte `/fan/`, `/mit-fandays`, `/admin/`, `/auth`, `/reset-password`.