Backend (FastAPI)

Teknologistack

  • Python 3.10+
  • FastAPI
  • google-genai (Gemini)
  • pyodbc
  • python-dotenv

Ansvar

Backend er ansvarlig for:

  • Mottak av chat-forespørsler
  • Lasting av klubbkontekst fra cache
  • Bygging av systeminstruks med sikkerhetsregler
  • Kall til AI-modell
  • Logging av spørsmål/svar per klubb

Viktige deler i app.py

  • Miljøvariabler lastes fra .env
  • API-nøkkel kreves ved oppstart
  • CORS er aktivert
  • build_system_prompt(tenant_id) bygger kontekst
  • log_interaction() lagrer chat-historikk

Promptregler

Systemprompten inneholder:

  • Norsk språkkrav
  • Klubbspesifikk faktaprioritet
  • Personvernregel om kontaktdata
  • Regel om å ikke finne på klubbfakta
  • Prioritetsblokk for banestatus

Feilhåndtering

  • Manglende nøkkel stopper oppstart
  • Ugyldig AI-kall returnerer HTTP 500 med kontrollert feilmelding
  • Manglende cache gir fallback-instruks