Files
sorsfonalak/services/frontend
fecoandClaude Opus 5.5 4676f7860f
CI / test (push) Successful in 1m38s
CI / build (push) Successful in 5m50s
CI / deploy (push) Skipped
Review fixes: no duplicate invoices, safer logins and redirects, one charge per click
Invoicing: the invoice request is marked before it goes to Billingo; a
retry after a lost answer looks the invoice up under the invoice's own
partner instead of issuing a second one. An invoice issued but never
e-mailed counts as issued (downloadable). A Hungarian company with only
an EU VAT number is invoiced without a domestic tax number, the EU
number in the comment.

Security: the login redirect takes only plain local paths (no
backslash); the waitlist rate limit and share visits use X-Real-IP,
which Caddy sets from Cloudflare's address, not the spoofable first
X-Forwarded-For entry; a Google/Apple sign-in to an unconfirmed
password account removes its password and sessions; a person's birth
data can no longer be published through a share.

Credits and jobs: analysis requests are serialized per user, so a
double click queues and pays once; a forecast analysis also fixes a
person's birth data; admins can restart stuck tarot readings; a worker
forgets an attempt an admin restarted, so a stop does not requeue it;
two people accepting one comparison invite at once get one comparison.
Expired invitations are no longer accepted by e-mail, and unsubscribing
revokes the invitation's promo codes too.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-20 20:17:13 +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).