HandleAgent/KRAV.md

Callsign-generator

##1. Syfte Skapa en webbaserad tj??nst som genererar CB-handles/callsigns med hj??lp av en LLM. Anv??ndaren ska kunna ge grundparametrar och eventuellt f??rfina dessa via f??ljdfr??gor innan generering.

##2. M??lbild Tj??nsten ska:

• generera ett realistiskt callsign baserat p?? anv??ndarens input
• ge en kort motivering till varf??r callsignet passar
• vara konsekvent, f??ruts??gbar och snabb att anv??nda
• k??nnas ???dialogisk??? genom adaptiva f??ljdfr??gor

##3. Anv??ndarfl??de (MVP)

Steg 1 - Initial input via UI

Anv??ndaren besvarar initiala val s??som:

• Stil (t.ex. Milit??r / Humor / Klassisk CB / Annan ??? fritext)
• Ton (t.ex. Seri??s / Aggressiv / Lekfull)
• Fritextbeskrivning (valfritt)

Steg 2 - Val

Efter initiala svar finns tv?? knappar:

[ Generera ]    [ Fler fr??gor ]

Steg 3A - Generera

• Backend skickar sammanst??lld prompt till LLM
• LLM returnerar JSON med:
  • callsign
  • motivering

Steg 3B - Fler fr??gor

• Backend skickar prompt till LLM som genererar 1???3 relevanta f??ljdfr??gor
• Anv??ndaren besvarar fr??gorna
• Svaren lagras i state
• Anv??ndaren kan d??refter v??lja "Generera" eller "Fler fr??gor" igen

4. Funktionella krav

4.1 Input

• Systemet ska st??dja:
• val via dropdown/radioknappar
• fritext
• ??terkommande f??ljdfr??gor

4.2 Output

Systemet ska returnera JSON i stabilt format:

{
  "callsign": "<string>",
  "reason": "<string>"
}

4.3 F??ljdfr??gor

F??ljdfr??gorna ska:

• baseras p?? anv??ndarens tidigare svar
• vara relevanta och korta
• komma i 1???3 fr??gor ??t g??ngen
• returneras som JSON:

{ "questions": [ "fr??ga 1", "fr??ga 2" ] }

4.4 State Management

Frontend ska lagra:

answers = {
  initial_params: {...},
  follow_up_answers: {...}
}

4.5 Spr??k

MVP riktas mot svenska men ska kunna ut??kas till andra spr??k.

5. Icke-funktionella krav

• LLM-styrning: Stabilt via templade prompts och JSON-utdata
• Prestanda: Svar inom < 2 sekunder f??r majoriteten av anrop (exkl. cold start)
• Skalbarhet: Designad s?? backend kan distribueras vid behov
• Robusthet: Systemet ska inte ???balla ur??? med l??nga poetiska svar
• Utbyggbarhet: Framtida logotyp-/TTS-/fonetikmoduler m??jliga
• Kostnadskontroll: Kan inf??ras via rate-limit + begr??nsad iteration

6. Systemarkitektur

Frontend

• Visar formul??r + resultat
• Renderar f??ljdfr??gor
• H??ller state med anv??ndarsvar
• Anropar backend via REST/HTTPS

Backend

• API som hanterar tv?? endpointtyper:

POST /questions
Input: answers
Output: JSON med f??ljdfr??gor

POST /generate
Input: answers
Output: JSON med callsign + motivering

• Backend ansvarar f??r:
  • promptkonstruktion
  • validering
  • OpenRouter-anrop
  • eventuella caches

LLM (via OpenRouter)

• Backend anropar LLM
• LLM returnerar JSON enligt definierad struktur

7. S??kerhets- och ??tkomstkrav

• API-nyckel f??r OpenRouter f??r inte exponeras i frontend
• Backend signerar samtliga anrop internt
• M??jlighet till rate-limit per IP

8. Implementationsteknik (rekommenderad)

Frontend:

• SvelteKit / React / Vue (valfritt)

Backend:

• Python (FastAPI) eller Node (Fastify)

Host-varianter:

• docker med docker-compose

LLM:

• OpenRouter, valfri modell (t.ex. GPT-4, Claude etc)