Files
sorsfonalak/services/backend
fecoandClaude Opus 5.5 e789e5a981 Chart page with a drawn wheel; reuse saved charts for identical birth data
- New /kepletek/[id] page: chart wheel (SVG), big three, elements,
  modalities, moon phase, positions and an aspects table. /keplet opens
  the user's own chart; the home page goes there after login.
- The profile only shows the birth data, with a link to the chart.
- Saving the same birth data again returns the stored chart (200)
  instead of calculating a new one.
- Charts without a birth time (angles null) render without houses.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-16 06:37:59 +00:00
..

backend

Felhasználók, belépés, mentett születési képletek, szinasztriák és meghívók, szöveges elemzések, kreditek és nyilvános megosztás. A képleteket a horoscope-api számolja, az adatok PostgreSQL-ben vannak. A migrációk a crates/db/migrations mappában vannak, és induláskor lefutnak.

Konfiguráció (környezeti változók)

Változó Alapérték Jelentés
DATABASE_URL – (kötelező) PostgreSQL kapcsolat
HOROSCOPE_API_URL http://localhost:8080 a számító szolgáltatás
PUBLIC_BASE_URL http://localhost:3000 a frontend címe; erre mutatnak a meghívó-, e-mail- és megosztási linkek
CORS_ALLOWED_ORIGINS PUBLIC_BASE_URL vesszővel elválasztott origin-lista; csak ezekről küld a böngésző sütit
COOKIE_SECURE true csak helyi, sima HTTP-s fejlesztéshez legyen false
COOKIE_DOMAIN – pl. .sorsfonalak.hu, ha a frontend és az API más aldomainen fut
SESSION_TTL_DAYS 30 a munkamenet élettartama
GOOGLE_CLIENT_IDS – Google OAuth kliens-azonosító(k); üresen a Google-belépés ki van kapcsolva
BOOTSTRAP_ADMIN_EMAILS – ezek a címek regisztrációkor vagy belépéskor admin szerepet kapnak (így lesz meg az első admin)
SUPPORTED_LOCALES hu,en felület- és elemzésnyelvek; az első az alapértelmezett
MONTHLY_FREE_CREDITS 10 havi ingyenes kreditkeret
ANALYSIS_COST 1 egy új elemzés ára kreditben azoknál a modelleknél, amelyeknél az LLM_MODELS nem ad meg árat
LLM_MODELS lásd lent választható modellek modell[=kredit][@szerep] alakban, vesszővel elválasztva; az első az alapértelmezett, és ahhoz nem kellhet szerep
ANALYSIS_PROMPT_VERSION v1 a prompt verziója (az elemzés-gyorsítótár kulcsának része)
MAX_CHARTS_PER_USER 50 ennyi képletet menthet egy felhasználó
BIND_ADDR, LOG_FORMAT, RUST_LOG 0.0.0.0:8081, text, info

Belépés és jogosultság

  • Munkamenet: véletlen token, HttpOnly + SameSite=Lax sütiben (sf_session). A belépési válasz törzsében is ott van, hogy nem böngészős kliens Authorization: Bearer <token> fejléccel küldhesse vissza. Az adatbázis csak a token SHA-256 hash-ét tárolja, így a munkamenet visszavonható (kijelentkezés, jelszócsere, fióktörlés).
  • E-mail + jelszó:
    • a jelszó legalább 10 karakter, Argon2id hash-sel tárolva;
    • címenként 15 percen belül 10 hibás próbálkozás után átmenetileg tiltás jár;
    • ismeretlen címnél is ugyanannyi ideig tart a válasz.
  • Google: a frontend a Google Identity Services gombbal vagy a One Tap felülettel szerez ID tokent, és elküldi a POST /v1/auth/google végpontra. A backend Google kulcsaival ellenőrzi az aláírást, a kiállítót és a kliens-azonosítót.
    • Ismeretlen Google-fióknál, ha a Google által igazolt e-mail-címmel már van felhasználó, ahhoz kapcsolja; ha nincs, újat hoz létre.
    • Ugyanaz a felhasználó több belépési móddal is rendelkezhet (auth_identities). A Facebook, az Apple és a passkey ugyanígy adható hozzá.
  • Szerepek (users.roles, tömb): user (alap), creator (cikkírás, 2. fázis), premium és vip (előfizetési szintek, amíg nincs fizetés, az admin osztja ki), admin.
  • Guardok:
    • AuthUser: belépés kell (401);
    • AdminUser: admin szerep is kell (403).
    • Más felhasználó erőforrására 404 a válasz, így a létezése sem derül ki.
    • Minden /v1/public/... végpont nyilvános.

Végpontok

Végpont Guard Leírás
GET /v1/config – Google kliens-azonosító, nyelvek, modellek, kreditárak
POST /v1/auth/register – {email, password, display_name?, locale?} → munkamenet; megerősítő e-mailt küld
POST /v1/auth/login – {email, password}
POST /v1/auth/google – {id_token}; created: true, ha most jött létre a fiók
POST /v1/auth/logout, /logout-all user kijelentkezés erről, illetve minden eszközről
POST /v1/auth/verify-email – {token} az e-mailben kapott linkből
POST /v1/auth/resend-verification user
POST /v1/auth/password-reset – {email}; mindig 202
POST /v1/auth/password-reset/confirm – {token, password}; minden munkamenet megszűnik
GET/PATCH/DELETE /v1/me user profil (display_name, locale); törlés: {confirm: "DELETE"}
POST /v1/me/password user {current_password?, new_password}; Google-fiókhoz jelszót is ad
GET /v1/me/export user GDPR: minden adat egy JSON-ban
GET /v1/credits user egyenleg és kreditmozgások
GET/POST /v1/charts user képletek listája; új képlet: {label, is_primary, birth}, ahol a birth a horoscope-api /v1/natal kérésformátuma
GET/PATCH/DELETE /v1/charts/{id} tulajdonos a születési adat nem módosítható: a javított képlet új képlet
GET/POST /v1/synastries user {chart1_id, chart2_id}, mindkét képlet a sajátod
GET/DELETE /v1/synastries/{id} résztvevő
GET/POST /v1/invites user „Mennyire illünk össze?” link; alapból a saját (primary) képlettel
DELETE /v1/invites/{id} meghívó visszavonás
GET /v1/public/invites/{token} – a meghívó landing oldalának adatai
POST /v1/invites/accept user {token, chart_id?}: elkészül a szinasztria, mindketten látják, a meghívó e-mailt kap
GET/POST /v1/charts/{id}/analyses tulajdonos {language?, model?}
GET/POST /v1/synastries/{id}/analyses résztvevő
GET /v1/analyses/{id} jogosult
GET/POST /v1/shares, DELETE /v1/shares/{id} user {kind: chart|synastry|analysis, target_id, title?, show_birth_data?}
GET /v1/public/shares/{slug} – a megosztott tartalom (oldal + OG-kép adatai)
GET /v1/admin/users?q= admin felhasználók kereséssel, szerepekkel, kreditekkel
PATCH /v1/admin/users/{id} admin {roles: [...]}; a saját admin szerep nem vehető el
POST /v1/admin/users/{id}/credits admin {delta, note?}

Hibák formátuma: {"error": {"code", "message"}}. A születési adatok hibái (például ismeretlen hely, javaslatokkal együtt) változatlanul jönnek tovább a horoscope-api-ból.

Adatmodell

Tábla Mire
users e-mail, megerősítés, név, nyelv, roles text[]
auth_identities belépési módok: password (hash) / google (sub) / később facebook, apple
sessions, auth_tokens munkamenetek; egyszer használatos e-mail-tokenek (megerősítés, jelszó-visszaállítás)
charts a felhasználó képletei: birth_data (kérés), result (teljes számítás), chart_hash, is_primary (legfeljebb egy)
synastries két képlet összevetése (result: fényszögek, házak, kompozit), synastry_hash
synastry_invites meghívó linkek: token hash, lejárat, ki fogadta el, melyik szinasztria lett belőle
analyses szöveges elemzések: típus, nyelv, modell, promptverzió, cache_key, állapot (pending → running → done/failed), strukturált content
credit_ledger csak hozzáírható kreditnapló; az egyenleg SUM(delta); havi keret lustán, egyszer havonta
shares nyilvános linkek: véletlen slug, mit mutat, show_birth_data, nézettség, visszavonás
email_outbox kimenő e-mailek; a worker küldi ki (újrapróbálással)

Adatvédelem:

  • A születési adatokból a name mező nem kerül tárolásra, és nem megy tovább a számításhoz (később az LLM-hez sem).
  • A nyilvános megosztás alapból nem mutat születési dátumot, időt és helyet. A show_birth_data: true csak a megosztó saját képletére vonatkozik, a partneréire soha.
  • A szinasztria másik fele csak a pozíciókat látja, a születési adatokat nem.
  • A fiók törlése mindent töröl, ami a felhasználóhoz tartozik, beleértve a más által létrehozott, de az ő képletét használó szinasztriákat is.

Elemzések és kreditek

  • Modellek és szintek: az alapértelmezett beállítás

    LLM_MODELS=anthropic/claude-haiku-5.5=1,openai/gpt-5.6-terra=3@premium,anthropic/claude-opus-5.5=10@vip
    
    • Haiku 5.5: az ingyenes szint, 1 kredit.
    • GPT-5.6 Terra: premium szerep kell hozzá, 3 kredit.
    • Opus 5.5: privát/VIP célra, vip szerep kell hozzá, 10 kredit.

    A vip szerep a premium modelleket is megnyitja, az admin mindent. Szerep nélkül 403 forbidden a válasz. A GET /v1/config és a GET /v1/credits visszaadja a listát (llm_models: [{id, credits, role}], illetve default_model). A választás egy 2026-11-ben, egy asztrológus értékelésével lefutott összevetésen alapul (lásd services/worker/README.md).

  • Kérés: a POST .../analyses ({language?, model?}) létrehoz egy pending elemzést, és levonja a választott modell kreditárát; a szöveget a worker írja meg, általában 1–2 perc alatt. A kliens a GET /v1/analyses/{id} végponton kérdezi le az állapotát. Ha nincs elég kredit, 402 insufficient_credits a válasz.

  • Gyorsítótár: a kulcs sha256(típus | képlet- vagy szinasztria-hash | promptverzió | modell | nyelv).

    • Ha ugyanarra a képletre már kértek ilyet, ugyanazt adja vissza (200).
    • Ha bárhol van kész elemzés ugyanezzel a kulccsal (például ugyanaz a születési adat egy másik felhasználónál), ingyen átmásolja (201, done).

Háttérmunkák

A worker kiküldi az e-maileket, megírja az elemzéseket (OpenRouter, strukturált JSON; hibánál visszaadja a kreditet), és óránként takarít. Még hátravan az elemzés streamelése a frontend felé.