A click proves little, so the first visit of a shared link now earns a question (once per user) instead of a natal analysis. A natal analysis is earned by bringing a new user: the share page remembers the link, the Google sign-up sends it, and when that user makes their own chart the sharer gets one, at most three (referrals table, referral_reward). This is off until sign-up opens (REFERRAL_REWARDS, default false). The share button and its small print follow; /v1/me tells what was earned. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_012vLHzh5qUhFtmJhzkcTbXL
4.8 KiB
4.8 KiB
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_countcsak ezeket a valódi látogatásokat számolja. - Jutalom egyszer: a
share_rewardsor egyedi indexszel felhasználónként egyszer jöhet létre.
Új felhasználó:
- Megjegyzés: a megosztott oldal a böngészőben megjegyzi a link kódját (
localStoragesf_ref). A Google-regisztráció elküldi (referral), és a backend areferralstá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: ashare_reward_grantedés areferral_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 (
fetchrevalidate: 300,sharestag), így a sűrűn visszatérő robotok el sem jutnak a backendig. Visszavonáskor az/api/v1proxy azonnal törli a taget. - robots.txt (
src/app/robots.ts): kitiltja az ismert AI-robotokat (GPTBot, ClaudeBot, CCBot, PerplexityBot, Bytespider, meta-externalagent stb.). Az előnézet-robotok (facebookexternalhit, Slackbot, WhatsApp, Twitterbot, LinkedInBot) engedélyezve maradnak. - Cloudflare: a robots.txt-t be nem tartó robotokra a Cloudflare „Block AI bots” beállítása való (Security → Bots). Ez az előnézet-robotokat nem tiltja le. 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/ogmappá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}.