Comentariile din cod sunt pe jumătate în română
Jumătate din comentariile acestui repo sunt scrise în română, cealaltă jumătate în engleză, uneori în același fișier. Regula casei e engleza pentru cod, denumiri și comentarii; româna rămâne pentru ce vede vizitatorul și pentru panoul de admin. Nimic din asta nu se vede pe site și nimic nu strică producția — costul e că cine deschide proiectul peste șase luni citește două limbi și nu poate căuta un concept într-una singură.
Issue-ul #22 (closed) a curățat deja partea care se vede când un test pică sau când cineva citește jurnalul serverului: mesajele de jurnal, o eroare aruncată și toate cele 284 de nume de teste. backend/tests și frontend/src/test nu mai au niciun nume în română. A rămas restul.
Cât e
Numărat pe ramura main de acum, cu o comandă reproductibilă — linii de comentariu care conțin diacritice românești:
git grep -nP '^\s*(//|\*|/\*|#|--)' -- <cale> | grep -P '[ăâîșțĂÂÎȘȚ]'
| Zonă | Linii | Fișiere |
|---|---|---|
backend/src |
211 | 23 |
frontend/src |
209 | 38 |
backend/prisma/schema.prisma |
44 | 1 |
backend/prisma/*.ts (scripturi) |
13 | 2 |
.gitlab-ci.yml |
9 | 1 |
backend/prisma/migrations/* |
24 | 8 |
510 linii în 73 de fișiere. Cifra e un minim: prinde doar liniile cu diacritice, deci un comentariu românesc scris fără ele nu apare aici.
Concentrarea nu e uniformă și asta ajută. Româna stă în zona admin/comenzi/reduceri/carduri cadou; tot ce s-a scris în etapa SEO e deja în engleză (render-page.ts, page-meta.ts, app-shell.ts, routes/render.ts, nginx.conf, deploy/). Cele mai grele fișiere: backend/src/lib/schemas.ts 39, frontend/src/lib/cart.tsx 25, backend/src/services/gift-card-service.ts 24, backend/src/routes/admin/discounts.ts 24, backend/src/lib/permissions.ts 24, backend/src/services/discount-service.ts 23.
Pe lângă comentarii, testele de e-mail și de reduceri au identificatori în română — comanda, transportFals, trimise, liniaCard, otrava, PRODUS, CARD, BAZA. Aproximativ 17 declarații, plus folosirile lor.
Ce nu se atinge
- Textele văzute de vizitator: e-mailurile de comandă din
email-service.ts, bonul dinorderPdf.ts,company.ts, întrebările dinFaq.tsx, totfrontend/src/locales/și datele de produs. - Panoul de admin: interfața rămâne în română, e o decizie de produs.
- Comentariile în engleză care citează un cuvânt românesc pentru că despre el e vorba — de exemplu
rename-elite-to-premier.ts:33și:69, sautherapyIcon.test.ts:6.
Capcană, de reținut înainte de a începe
Un MR care atinge .gitlab-ci.yml nu primește pipeline deloc în această instanță (regula din workflow.rules). Cele 9 linii de acolo se fac într-un MR separat, iar după merge se pornește un pipeline manual.
schema.prisma nu are comentarii obișnuite: /// ajunge în tipurile clientului generat, deci după modificare se rulează npm run prisma:generate. Nu e migrație, baza nu se atinge.
Comentariile din backend/prisma/migrations/* sunt un istoric fără valoare înainte. S-a verificat empiric pe o copie a bazei că prisma migrate deploy nu se supără dacă textul se schimbă (checksum-ul e pe SQL-ul executat), dar tot nu merită atinse.
De făcut
-
backend/src— 211 linii în 23 de fișiere -
frontend/src(fără panoul de admin, care rămâne în română) — 209 linii în 38 de fișiere -
backend/prisma/schema.prisma— 44 de linii, apoinpm run prisma:generate -
backend/prisma/backfill-collection-content.tsșiseed.ts— 13 linii -
Identificatorii în română din backend/tests/order-emails.test.tsșidiscounts.test.ts -
.gitlab-ci.yml— 9 linii, într-un MR separat, cu pipeline manual după merge
Criteriu de acceptare
- Comanda de mai sus întoarce 0 linii pe
backend/src,frontend/srcfărăpages/adminșicomponents/admin,schema.prismași scripturile dinbackend/prisma/. -
npm run buildșinpm testtrec în ambele aplicații; nicio linie de cod nu se schimbă, doar comentarii și denumiri locale. - Textele văzute de vizitator rămân neatinse:
git diffnu arată nicio modificare înfrontend/src/locales/,email-service.tssub linia 240,orderPdf.tssaucompany.ts.