AI-assistent

AI-chat-widget i admin-panelet der svarer på spørgsmål om systemet, slår data op direkte i din tenant og kan udføre udvalgte handlinger. Hver tenant er isoleret — assistenten kan kun læse/skrive på din egen tenant.

Kernebegreber

• Read-tools: Henter data (opslag på medlemmer, hold, omsætning, betalinger m.m.). Aktiv på ALLE tenants.
• Write-tools: Ændrer data. Aktiv på fitteryoga (under videre validering). Kører altid med to-trins bekræftelse — første kald = preview (gult kort "Bekræft handling" i chatten), andet kald = eksekvering EFTER du har trykket knappen Bekræft på kortet. Et "ja" i chatten er ikke nok: bekræftelsen er et server-udstedt engangs-token bundet til præcis den preview (samme handling + argumenter, gyldigt 10 min), så assistenten kan ikke bekræfte på dine vegne.
• Knowledge base: Alle 62 hjælpe-guides på /admin/hjaelp/* er komprimeret til en KB. Assistenten har et INDEKS over dem i sig (titel, admin-stier, relaterede guides, kernebegreber, emner, FAQ-spørgsmål) og henter den enkelte guides fulde tekst når den skal bruge den — guiderne for den side du står på er altid hentet på forhånd. Fandt den ikke svaret i første guide, slår den op i en beslægtet (højst 3 opslag pr. svar). Spørger du om et område systemet ikke dækker, henviser den til support.
• Secret-vagt: Stripe-, MobilePay-, Frisbii-, webhook- og widget-nøgler blokeres før de sendes til AI'en eller logges. Indsæt aldrig hemmeligheder i chatten alligevel.
• Conversation-log: Alle samtaler logges i assistant_chat_logs (session_id, bruger, sti, beskeder, token-forbrug). Bruges til debugging og audit.

Hvad assistenten KAN

Læse-opslag:

• Studie-overblik og indstillinger
• Hold (find, attendance, holdtyper, venteliste)
• Medlemmer (find, profil, betalingshistorik, udløbende medlemskaber)
• Bookinger (én booking i detalje, no-shows)
• Omsætning og attendance-statistik
• Instruktører (plan, løn pr. måned)
• Gavekort, rabatkoder, kontakthenvendelser, behandlinger
• Betalingsfejl (failed charges)

Skrive-handlinger (kun fitteryoga, med bekræftelse):

• Aflys hold (cancel_class) — fuld refund af MobilePay/Stripe/klip, valgfri email-broadcast, auto-SMS hvis tenanten har det slået til
• Aflys én booking (cancel_booking) — returnerer klip, rykker venteliste op, valgfri MobilePay/Stripe-refund
• Skift instruktør (substitute_or_swap_instructor) — skift primær eller registrér vikar på et hold
• Rediger hold (update_class_details) — tid, lokale, kapacitet, drop-in-pris, navn, beskrivelse, special-udstyr
• Opret ugentlige hold (create_recurring_class_series) — opret template + auto-generér op til 26 ugers instanser
• Justér klippekort (adjust_member_credits) — tilføj/træk klip med begrundelse, logges i credit-historik
• Tilføj admin-note (add_admin_note) — append-only på medlemsprofil
• Skift status på kontakthenvendelse (update_contact_request_status) — pending/responded/closed
• Opret hold fra eksisterende (create_class_from_existing) — ét nyt hold som kopi af et eksisterende; felter arves, overstyr fx dato/tid
• Opret behandlings-skabelon fra eksisterende (create_treatment_template_from_existing) — ny behandlings-type kopieret fra en eksisterende, titel påkrævet, behandlere kopieres som standard
• Opret behandlingstider (create_treatment_slots) — bookbare slots hos én behandler, enkelt eller bulk i vindue (max 24/kald), overlap blokerer

Hvad den IKKE kan

• Sende emails eller SMS direkte til medlemmer (kun som side-effekt af cancel_class hvis du vælger det)
• Oprette eller redigere pris-planer og medlemskabsprodukter (klip, abonnementer)
• Ændre priser, abonnementer eller medlemskabs-typer
• Pause eller genoptage medlemskaber (Stripe-integration udskudt — kompleksitet med agreement-styring)
• Refundere arbitrære beløb (kun fuld refund tilknyttet booking-aflysning)
• Tilgå data på andre tenants
• Slette noter, bookinger, medlemmer eller andet — alt er append/cancel, ikke delete
• Køre write-tools på andre tenants end fitteryoga (read er på for alle)

Regler / grænser

• Max 8 tool-kald pr. tur (hard cap)
• Rate limit: 30 tool-kald/minut pr. tenant
• Tool-use kræver admin-login (samme auth som resten af /admin)
• Write-tools kræver tryk på Bekræft på preview-kortet (ikke blot et "ja") — preview er ALDRIG en handling; Afvis annullerer
• Sessions gemmes lokalt i browseren (storage key holdstyring-assistant-...)

Aktivering

• Read-tools er ON for ALLE tenants på prod.
• Write-tools er ON for fitteryoga på prod. Hvis du vil have write-tools slået til på din tenant, kontakt support — vi udvider gradvist.
• Staging (STAGING=true): begge slået til for alle tenants.

FAQ

• Kan assistenten se mine kunders kreditkort? — Nej. Kortdata ligger hos Stripe/MobilePay og er aldrig i vores database. Assistenten ser kun referencer (paymentIntentId, agreementId).
• Hvorfor svarer den "jeg kan ikke se det i min viden om systemet"? — KB dækker ikke alle features. Den nægter at gætte. Henvis til support.
• Hvad sker når jeg trykker Bekræft på en write-action? — Dit tryk sender et engangs-token med; assistenten kalder toolet med confirm: true, og serveren udfører kun når tokenet matcher præcis den preview (samme handling + argumenter, max 10 min). Skriver du blot "ja" uden at trykke, afvises kaldet og assistenten beder dig trykke Bekræft.
• Kan jeg fortryde en write? — Cancel-flows (klasse, booking) kan ikke un-cancel'es; refunds er endelige. Klip-justeringer kan rulles tilbage med modsat-rettet justering. Admin-noter er append-only. Status-skift på kontakthenvendelser kan rulles tilbage manuelt. Ugentlige hold kan slettes individuelt via /admin/classes hvis serien skal trækkes tilbage.
• Hvor langt frem kan jeg oprette ugentlige hold? — Max 26 uger ad gangen (et halvt år). Skal du længere, kør tool'et igen efter første batch.
• Hvad sker når jeg justerer klip? — Klip ændres på det nyeste aktive klippekort (eller et specifikt membershipId hvis du angiver det). Ændringen logges i klip-historikken med din begrundelse — afsnittet "Klip-historik" findes på selve klippekortet under Medlemskaber, ikke på medlemmets profil.
• Hvor logges samtalerne? — assistant_chat_logs-tabellen. Indeholder bruger, tenant, sti, beskeder og token-forbrug. Bruges til debugging og audit.
• Får jeg AI-svar offline? — Nej. Widget kalder Anthropic via /api/admin/assistant/chat på hver besked.