# 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, 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`, 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); - 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 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=.apps.googleusercontent.com BOOTSTRAP_ADMIN_EMAILS= ``` A `BOOTSTRAP_ADMIN_EMAILS` címek az első belépéskor admin szerepkört kapnak. 4. `docker compose up -d backend` ## Fejlesztés ```bash 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).