Files
sorsfonalak/services/frontend
fecoandClaude Opus 5.5 d46cd7a445
CI / test (push) Successful in 1m12s
CI / build (push) Successful in 5m12s
CI / deploy (push) Skipped
Frontend: justified generated text, mobile layout without sideways scrolling
Summaries, analyses and answers are justified with hyphenation in the
text's own language. Grid tracks can no longer grow past the screen
(minmax(0, 1fr), min(…, 100%)), form fields may shrink, the privacy table
scrolls on its own, and the body clips horizontal overflow as a safety net.
Phones get tighter spacing and smaller headings; the facts lists stack.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-19 06:10:38 +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ó.
  • Összevetések (/osszevetesek, szinasztria): a saját és a felvett személyek képletei közül bármelyik kettő összevethető; a személykártyán és a személy képletoldalán „Összevetés velem” gomb is van. Az összevetés oldala (/osszevetesek/{id}):
    • kettős kör: belül az első fél bolygói és házai, kívül a második fél bolygói, középen a köztük lévő főfényszögek;
    • a fényszögek jelleg szerint (harmonikus, feszültebb, együttállás);
    • fülek: fizetős kapcsolati elemzés (synastry egység), a két fél közti fényszögmátrix, házátfedések, kompozit, részletes lista.
  • 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);
    • Promptok (/admin/promptok): a tömör összefoglaló, a részletes és a kapcsolati elemzés system promptja szerkeszthető, változatokkal; mentés előtt egy saját képleten vagy összevetésen kipróbálható.
  • 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).