services/frontend (Next.js 16, App Router) runs on port 3001 in compose. The browser only talks to the frontend: /api/v1/* is proxied to the backend, so the session cookie lives on the frontend's host, and /api/geo/* exposes the country list and place search of the horoscope-api. - /belepes: Google Identity Services button, client id from /v1/config - /profil: account facts, display name and language, own birth data with place search, DST ambiguity prompt and the chart's positions - /admin: user search, role toggles, credit grants (admins only, 404 otherwise) Services now tolerate migrations newer than their binary, so they can be rebuilt one at a time. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
3.7 KiB
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 aPOST /v1/auth/googlevé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, kreditek;
- 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, csakadminszerepkörrel; másnak 404):- felhasználók keresése;
- szerepkörök be- és kikapcsolása (felhasználó, prémium, VIP, szerző, admin);
- kredit jóváírása.
- 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
-
A Google Cloud Console-ban (APIs & Services → Credentials) hozz létre egy OAuth client ID-t Web application típussal.
-
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://vagylocalhostcí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őbenhttp://localhost:3001. -
A repó gyökerében lévő
.envfá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_EMAILScímek az első belépéskor admin szerepkört kapnak. -
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).