Files
sorsfonalak/services/frontend
fecoandClaude Opus 5.5 b77dafdb26
CI / test (push) Successful in 46s
CI / build (push) Successful in 4m16s
CI / deploy (push) Skipped
Try draft prompts on own charts before saving
Under each prompt on /admin/promptok, "Kipróbálás" writes the summary or
detailed analysis with the text in the editor (saved or not) on one of the
admin's own charts. Test runs live in prompt_previews: never shown with the
chart, not cached, no credits, one attempt, at most three open per admin,
removed after 30 days. The worker writes them when no analysis is due. The
result shows the model, tokens, cost and time, and the draft can be loaded back.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-17 14:41:12 +00:00
..

Frontend

Next.js (App Router, TypeScript) webes felület. A compose-ban a 3001-es porton fut, mert a dev szerveren a 3000-est más használja.

Ami kész

  • Belépés (/belepes): Google-fiókkal, a Google Identity Services gombbal. A kapott ID tokent a POST /v1/auth/google végpont ellenőrzi; az első belépéskor létrejön a fiók.
  • Profil (/profil):
    • fiókadatok: e-mail, belépési mód, szerepkörök, megmaradt elemzések;
    • a megjelenített név és az elemzések nyelve szerkeszthető;
    • saját születési adatok: dátum, idő (vagy „nem tudom”), ország és település helykeresővel. Mentéskor kiszámolja a képletet, és megmutatja a pozíciókat (bolygók, tengelyek, házcsúcsok).
    • A javított adatokból új képlet lesz (a backend a születési adatot nem módosítja), és az lesz a saját képlet.
    • Ha a megadott időpont az óraátállítás miatt kétszer is előfordult, a felület megkérdezi, melyikről van szó.
  • Admin (/admin, csak admin szerepkörrel; másnak 404):
    • felhasználók keresése;
    • szerepkörök be- és kikapcsolása (felhasználó, prémium, VIP, szerző, admin);
    • elemzések jóváírása típusonként (képlet, szinasztria).
  • Jogosultság: a belépést nem igénylő oldalakon kívül minden oldal a szerveren ellenőrzi a munkamenetet; belépés nélkül a belépőoldalra irányít, majd vissza.

Felépítés

  • src/app/api/v1/[...path]: proxy a backend felé. A böngésző csak a frontend címét hívja, így a munkamenet-süti (sf_session, HttpOnly) a frontend domainjén él, és nem kell CORS.
  • src/app/api/geo/[kind]: a horoscope-api ország- és helykeresője (countries, places). Más végpontot nem enged át.
  • src/lib/server.ts: backend-hívás szerveroldalon a látogató munkamenetével (getMe, requireMe).
  • src/lib/api.ts: backend-hívás a böngészőből.
  • src/lib/astro.ts: magyar jegy- és bolygónevek, jelek, dátumformázás.
  • A színek és betűk a design-vászonból jönnek (src/app/globals.css): éjkék háttér, arany kiemelés, Cormorant Garamond és Inter.

Beállítás

Változó Alapérték Mire
BACKEND_URL http://localhost:8081 a backend belső címe
HOROSCOPE_API_URL http://localhost:8080 a horoscope-api belső címe (helykereső)

A Google kliens-azonosítót a frontend a backend GET /v1/config végpontjáról kapja, ezért a frontendnek nem kell külön beállítás.

Google-belépés beállítása

  1. A Google Cloud Console-ban (APIs & Services → Credentials) hozz létre egy OAuth client ID-t Web application típussal.

  2. Az Authorized JavaScript origins listába vedd fel azokat a címeket, ahonnan a felületet megnyitod, például:

    • http://localhost:3001 (fejlesztés);
    • később az éles domaint, https:// előtaggal.

    A Google csak https:// vagy localhost címet fogad el. A dev szervert ezért SSH-alagúton keresztül nyisd meg: ssh -L 3001:localhost:3001 dev, utána a böngészőben http://localhost:3001.

  3. A repó gyökerében lévő .env fájlba (nincs a gitben) írd be:

    GOOGLE_CLIENT_IDS=<kliens-azonosító>.apps.googleusercontent.com
    BOOTSTRAP_ADMIN_EMAILS=<a te Gmail-címed>
    

    A BOOTSTRAP_ADMIN_EMAILS címek az első belépéskor admin szerepkört kapnak.

  4. docker compose up -d backend

Fejlesztés

cd services/frontend
npm ci
BACKEND_URL=http://localhost:8081 HOROSCOPE_API_URL=http://localhost:8080 npm run dev   # http://localhost:3001
npm run typecheck

Később

  • interaktív radix SVG-komponens (ugyanaz rajzolja az OG-képet is);
  • szinasztria, meghívók, elemzések kérése és megjelenítése;
  • angol felület;
  • további belépési módok (e-mail és jelszó, Facebook, Apple, passkey).