Files
sorsfonalak/docs/indulasi-otletek.md
fecoandClaude Opus 5.5 3a84110565 Add horoscope-api, synastry, and backend services
- horoscope-api: Swiss Ephemeris natal charts, timezone/place resolution,
  POST /v1/natal and POST /v1/synastry
- backend: users with roles, email/password and Google login, saved charts,
  synastries and invites, analyses with credit ledger, public shares, admin
- shared crates: astro-engine, db (migrations), horoscope-client, service-kit
- docker-compose with postgres, legacy Java project for reference

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-15 10:25:35 +00:00

35 lines
3.4 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# sorsfonalak.hu – architektúra és indulási ötletek
## Tervezett konténerek
- **horoszkop-szamito** (Rust) – születési adatok alapján számol. KÉSZ.
- **backend** – user, cikk, LLM-kezelés, Facebook-megosztás.
- **chat-motor** – websocket.
- **worker + Redis** – e-mailek, háttérjobok.
- **frontend** (Next.js) – a backendet és a chatmotort használja. Itt készül a radix is, interaktív SVG-komponensként (hover és kattintás a bolygókon, aspektusokon), cserélhető témával. Nincs külön rajzoló szerviz.
Funkciók fázisokban: 1) személyi horoszkóp + radix, belépés (Facebook, Apple, Google, user/jelszó), LLM-elemzés OpenRouteren (választható modell, a stílus promptban definiálva), Facebook-megosztás → 2) AI által generált cikkmodul képekkel, alattuk chat → jogosultságok: admin, creator, user. Többnyelvű lesz az indulástól.
## Amit már indulásra érdemes betenni
1. **Megosztható kártya (OG-kép)** – a frontend egy szerveroldali Next.js route-ja (pl. /api/og) ugyanabból a radix SVG-komponensből PNG-t renderel (resvg). Ebből lesz az 1200×630-as kép (radix + név + 2-3 mondat), és álló 1080×1920-ast story-hoz. A Facebook 2018 óta nem enged automatikusan posztolni, csak a Share Dialog marad, ezért a megosztás sikere a képen múlik.
2. **„Mennyire illünk össze?" meghívó (szinasztria)** – a felhasználó linket küld, a meghívott beírja a születési adatait, regisztrál, és mindketten kompatibilitási elemzést kapnak. Ez hozza a legtöbb új felhasználót.
3. **Beszélgetés a saját horoszkóppal** – a chatmotor megkapja a user radixát JSON-ként, és arról lehet kérdezni. Később ez lehet a fizetős funkció.
4. **Kreditrendszer az elejétől** – egyszerű kredit-főkönyv minden LLM-hívásra (havi ingyenes keret). Ez tartja kordában a költséget, véd a visszaélés ellen, és később nem kell átírni, ha fizetőssé válik.
## Technikai dolgok, amik most olcsók, később drágák
- **Gyorsítótár az elemzésekre**: a kulcs `hash(radix) + promptverzió + modell`. Így nem fizetünk kétszer, és a promptokat A/B tesztelni is lehet.
- **Strukturált LLM-válasz (JSON)**: összefoglaló, erősségek, kihívások, hosszú szöveg külön mezőben. Ebből jön a kártya szövege, az oldal szakaszai és a fordítás.
- **Streaming (SSE vagy websocket)**: az elemzés 20-40 másodperc, ezért menet közben kell kiírni.
- **Langfuse önhosztolva** az LLM-hívások követésére (prompt, költség, késleltetés); a Sentry mellé.
- **Passkey belépés** a social és jelszavas mellé, mert az 50+ célközönségnek ez a kényelmes.
- **Ismeretlen születési idő mód**: déli horoszkóp, házak nélkül.
- **GDPR**: adatexport, fióktörlés, és az LLM felé név nélkül megy az adat.
- A hosszú LLM-hívások (elemzés, cikkírás) is a worker/Redis soron menjenek, ne a backend kérésében.
- A radix SVG-komponens legyen tiszta, adatvezérelt (nincs böngésző-függés), hogy ugyanaz a kód rajzolja az interaktív nézetet és a szerveroldali OG-képet.
## Második kör
- Napi személyre szabott horoszkóp a tranzitok alapján (a worker küldi e-mailben vagy push-ban).
- PWA + web push a natív app előtt.
- Felolvasott elemzés (TTS).
- Kozmikus naptár (holdfázisok, retrográd időszakok) és hozzá generált cikkek.
- MCP szerver a számító szerviz elé, hogy Claude-ból vagy ChatGPT-ből is lekérhető legyen a horoszkóp.