Files
sorsfonalak/docs/megosztas.md
T
fecoandClaude Opus 5.5 a6ddfc6924
CI / test (push) Successful in 1m44s
CI / build (push) Successful in 5m55s
CI / deploy (push) Skipped
robots.txt: block only AI training crawlers, let AI search in slowly
AI search engines and chat fetchers (OAI-SearchBot, ChatGPT-User,
Claude-SearchBot, PerplexityBot, ...) may now read the public pages,
with Crawl-delay: 10, so they can cite the site. Training crawlers stay
disallowed. Docs: the matching Cloudflare AI policy settings, and the
referral note no longer mentions localStorage.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
2026-11-22 05:56:41 +00:00

5.9 KiB
Raw Blame History

Megosztás

A képletoldalon, a rövid összefoglaló alatt van a Megosztás gomb. Ez egy nyilvános linket ad (/s/<kód>), amelyen a képlet rajza és a legfrissebb rövid összefoglaló látszik. Név és születési adatok nem kerülnek rá.

  • Ugyanaz a link: ha ugyanazt a képletet újra megosztod, a már nyitott link jön vissza (POST /v1/shares: új linknél 201, meglévőnél 200).
  • Visszavonás: a „Link visszavonása” gomb után az oldal és a kép is 404-et ad.
  • Keresők: az oldal noindex, a keresők nem listázzák.

Jutalom a megosztásért

Egy kattintás önmagában semmit nem bizonyít, ezért kétféle jutalom van:

  • Ajándék kérdés (megtekintésért): felhasználónként egyszer +1 kérdés, amikor valaki más először megnyitja a megosztott linkjét. A gomb apró betűvel: „+1 ajándék kérdés, ha valaki megnézi”.
  • Ajándék képletelemzés (új felhasználóért): +1 képletelemzés, ha valaki a megosztott linkről regisztrál és elkészíti a saját képletét. Felhasználónként legfeljebb 3 (REFERRAL_LIMIT). Az élesítésig ki van kapcsolva (REFERRAL_REWARDS=false), mert meghívásos regisztrációnál a linkről úgysem lehet regisztrálni.

Megtekintés számolása:

  • A böngésző jelez: a megosztott oldal betöltése után maga a látogató böngészője jelzi a látogatást (POST /v1/public/shares/{slug}/visit). Az előnézet-robotok nem futtatják az oldal szkriptjét, így ők nem számítanak.
  • Ami nem számít:
    • robotnak látszó vagy hiányzó böngészőazonosító;
    • a belépett tulajdonos;
    • látogatás arról az IP-címről, ahonnan a linket létrehozták. A cím a sluggal sózva, hash-ként van tárolva (shares.owner_ip_hash).
  • Számláló: a shares.view_count csak ezeket a valódi látogatásokat számolja.
  • Jutalom egyszer: a share_reward sor egyedi indexszel felhasználónként egyszer jöhet létre.

Új felhasználó:

  • Megjegyzés: a megosztott oldal belépés linkje viszi a link kódját (/belepes?ref=<slug>), a böngészőben semmi nem tárolódik. A regisztráció (Google, Apple, e-mail) elküldi (referral), és a backend a referrals táblába írja, hogy kit ki hozott. Saját link, visszavont link vagy kikapcsolt jutalom esetén nem írja be.
  • Jutalom: amikor az új felhasználó elkészíti a saját képletét, a megosztó +1 képletelemzést kap (referral_reward), ha még nem érte el a hármat. Új felhasználónként egyszer.
  • /v1/me: a share_reward_granted és a referral_rewards ({earned, limit}) mezők mutatják az állapotot.

Robotok

  • Az olvasás nem ír. A megosztott tartalom lekérése (GET /v1/public/shares/{slug}) semmit nem ír az adatbázisba.
  • Gyorsítótár: a frontend 5 percig tartja (fetch revalidate: 300, shares tag), így a sűrűn visszatérő robotok el sem jutnak a backendig. Visszavonáskor az /api/v1 proxy azonnal törli a taget.
  • robots.txt (src/app/robots.ts), három csoport:
    • Tanító robotok: kitiltva. Amelyek AI-modell tanításához gyűjtenek, vagy tanítóadatnak adják el a tartalmat (GPTBot, ClaudeBot, CCBot, Google-Extended, Applebot-Extended, Bytespider, meta-externalagent stb.), plusz a nehéz és itt haszontalan PetalBot és Scrapy. A Google-Extended csak a Gemini-tanítást tiltja, a Google-keresést és az AI-áttekintést nem érinti.
    • AI-keresők és -ügynökök: jöhetnek, legfeljebb 10 másodpercenként egy oldal (Crawl-delay: 10, amelyik betartja). OAI-SearchBot, ChatGPT-User, Claude-SearchBot, Claude-User, PerplexityBot, Perplexity-User, DuckAssistBot stb. Ezek idézhetik az oldalt, és látogatót hozhatnak.
    • Mindenki más (Googlebot, Bingbot, az előnézet-robotok: facebookexternalhit, Slackbot, WhatsApp, Twitterbot, LinkedInBot): jöhet, a belépés mögötti útvonalak kivételével.
  • Kis terhelés: belépési süti nélkül a nyilvános oldalak nem hívják a backendet, a horoszkópszámítást pedig csak a böngészőben futó szkript indítja (IP-címenként óránként 30). Egy robotlátogatás így csak egy HTML-oldal előállítása.
  • Cloudflare: a robots.txt-t be nem tartó robotokra a Security → Settings → Bot traffic → AI Crawler and Agent access policies való: Training: Block, Search: Allow, Agents: Allow. Ez az előnézet-robotokat nem érinti. A „Bot Fight Mode” viszont az előnézeteket is elronthatja, azt ne kapcsoljuk be.

Előnézet (Facebook, Messenger, WhatsApp, LinkedIn, X)

Az oldal og: és twitter: meta tagjei:

Tag Tartalom
cím az összefoglaló címe
leírás az összefoglaló első ~200 karaktere
kép /s/<kód>/kep/<verzió>.png

A kép egy 1200×630-as PNG. A Next.js beépített képgenerálója (next/og) készíti kérésre, a következőkkel:

  • a radix (src/lib/wheelSvg.ts; ugyanaz a <ChartWheel>, mint az oldalon, beégetett színekkel);
  • a cím és a szöveg eleje;
  • a Nap, a Hold és az Aszcendens jegye.

Működése:

  • Betűtípusok: a src/assets/og mappából olvassa őket. Hiányzó karakter miatt soha nem tölt le fontot az internetről, mert a nem betű, szám vagy írásjel karaktereket kiszűri.
  • Verzió: a fájlnévben lévő verzió az összefoglaló azonosítójából és elkészültének idejéből készül. Ha az összefoglaló újragenerálódik, új címet kap a kép, és a Facebook újra letölti.
  • Gyorsítótár: Cache-Control: public, max-age=3600, s-maxage=86400. A Cloudflare egy napig tartja, így egy visszavont link képe legfeljebb egy napig marad ott. A Facebook a saját példányát a saját szabályai szerint tartja meg, nagyjából 30 napig.
  • Frissítés kézzel: a Facebook megosztás-ellenőrzőjében (Sharing Debugger) a „Scrape Again” gombbal.

A frontend a PUBLIC_BASE_URL alapján írja az abszolút címeket; élesben ez https://${DOMAIN}.