Mathorizon
Platformă de pregătire pentru BAC la matematică.
Rulare locală
Un singur server de dezvoltare, care servește atât fișierele statice cât și
rutele /api/*:
node server.js
# sau
npm start
La pornire, terminalul afișează URL-ul de deschis și confirmă că API-ul e activ:
Mathorizon dev server
→ open: http://localhost:8080
→ API: enabled (all /api/* routes are live on this port)
Deschide http://localhost:8080.
Nu mai există un al doilea server static-only (devserver.js). Exista
anterior pentru servire rapidă de fișiere statice, dar nu avea rutele
/api/* — orice funcționalitate care depinde de backend (ex: formularul de
waitlist) dădea 404 pe acel port. A fost eliminat ca să nu mai existe
ambiguitate despre „pe care server rulez".
Pagina Capitole — React + TypeScript
Paginile sunt în continuare fișiere .html statice. Singura excepție e
capitole.html, unde tot conținutul de sub bara de navigare (hero,
statistici, cardurile de capitole, banner-ul Simulare BAC) e o „insulă"
React montată în <div id="root">. Restul taburilor (Simulare, Antrenament,
Clase, Pachete) rămân vanilla; bara de navigare e comună tuturor și nu e
migrată.
- sursa:
src/capitole/ (React 19 + TypeScript, Framer Motion, lucide-react)
- build:
npm run build:react → assets/react/capitole-<hash>.js|css
- în timpul dezvoltării:
npm run dev:react (rebuild la fiecare salvare)
- verificare de tipuri:
npm run typecheck
Bundle-ul din assets/react/ se comite în git: producția servește
fișierele din repo, fără pas de build. Scriptul de build e denumit
build:react, nu build, tocmai ca hostingul static să nu-l pornească
singur la deploy și să schimbe felul în care e publicat site-ul.
Numele fișierelor conțin un hash de conținut, așa că tag-urile
<link>/<script> din capitole.html sunt generate: după fiecare build,
scripts/sync-react-tags.js rescrie blocurile marcate cu
REACT-ISLAND-CSS / REACT-ISLAND-JS. Nu le edita manual — și nu șterge
comentariile-marker, fără ele scriptul se oprește cu eroare.
Datele sunt aceleași ca înainte: React citește prin window.BM
(js/data.js, js/storage.js) și se reîmprospătează pe evenimentele
bmauth:synced / bmauth:streak-updated emise de js/auth.js, care e cel
care sincronizează Supabase → localStorage pe toate paginile. Nu există un
al doilea strat de acces la Supabase în src/.
Variabile de mediu
server.js citește .env (via dotenv). Cheile necesare pentru rutele API:
GEMINI_API_KEY — generare exerciții (Gemini)SUPABASE_SERVICE_ROLE_KEY — operații server-side pe Supabase (înregistrare
cu nume de utilizator, waitlist, citire date admin)
Opționale, pentru reglarea apelurilor Gemini (api/_gemini-retry.js):
GEMINI_TIMEOUT_MS — limita unei singure încercări (implicit 90000).
Ține-o sub maxDuration al funcției de pe host (ex. 50000 la o limită de
60s), ca eroarea noastră în română să ajungă la browser înaintea paginii de
504 a gateway-ului.GEMINI_BUDGET_MS — limita totală a unui apel, cu tot cu reîncercări
(implicit 200000).GEMINI_RETRIES — câte reîncercări după prima (implicit 1).
Verificarea planului cheii:
node scripts/check-gemini-key.js # doar validează cheia (gratis)
node scripts/check-gemini-key.js --generate # + o generare reală, arată tier-ul
Atenție la planul cheii Gemini. Pe planul gratuit, gemini-3.5-flash
permite ~20 de cereri pe zi per proiect, iar cererile sunt servite cu
prioritate scăzută (același apel poate dura 8s sau 250s). Când cota zilnică
se termină, API-ul răspunde 429 și platforma afișează mesajul
„Cota ZILNICĂ Gemini a fost epuizată…". Facturarea se activează pe proiectul
Google AI Studio căruia îi aparține cheia.
PORT — portul serverului de dezvoltare (implicit 8080).
