Files
sorsfonalak/services/frontend
fecoandClaude Opus 5.5 b0fc547b73
CI / test (push) Successful in 1m29s
CI / build (push) Successful in 5m52s
CI / deploy (push) Skipped
Tarot readings: AI-written, drawn on the server, sold as units
A new Kártyajóslás page: choose a spread (1, 3 or 5 cards), ask a
question, pick the cards from the fanned deck and watch them turn over;
the reading is written by the detailed-analysis model from the cards,
their positions and base meanings, the question and the reader's Sun,
Moon and Ascendant. The server shuffles and draws, so nobody can draw
again for free. A reading is a 'tarot' analysis (worker, retries,
fallback, refunds and admin regeneration as for analyses), uses one
'tarot' unit, and survives recalculations; deleting the account
deletes it.

Packages carry 2/5/10 readings, the new +5 kártyajóslás addon costs
1 000 Ft. The card artwork comes from the tarot design studio
(celestial astrolabe style); the deck JSON is shared by the frontend
and the prompt. A public example is at /kartyajoslas/pelda.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-20 14:35:50 +00:00
..
2026-11-19 11:39:32 +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).