Pakeitimų žurnalas

Atrinkti svarbiausi pastarųjų leidimų akcentai. Norėdami sužinoti apie pilnas API versijas ir esminių pakeitimų politiką (Breaking-Change-Policy), žr. API versijavimas ir LTS politika.

Išsamūs atskirų galinių taškų (endpoints) pakeitimai: OpenAPI specifikacija ir interaktyvi API nuoroda.

2026-04 · Valdymo skydelio analitika kiekvienam QR kodui

Valdymo skydelis: Analitikos mygtukas QR kodų sąraše dabar atidaro atitinkamo QR kodo statistikos puslapį adresu /dashboard/codes/{id}.
Routing: Alternatyvus adresas (alias) /dashboard/codes ir toliau nukreipia į /dashboard, tačiau nebeperima detalių maršrutų, tokių kaip /dashboard/codes/{id}.
API: Detalusis puslapis įkelia QR kodą tiesiogiai per GET /v1/codes/:id; dėl to jis nebėra priklausomas nuo sąrašo puslapiavimo (pagination) ribojimų.
Testai: Regresijos testai apima alternatyvaus adreso nukreipimą (alias redirect) ir tiesioginį kodo įkėlimą.

2026-04 · QR kodų trynimo dialogas valdymo skydelyje

Valdymo skydelis: Šiukšliadėžės piktograma QR kodų sąraše dabar atidaro atskirą React dialogą, o ne naršyklės iššokantį langą (popup).
Feedback: Ištrynus pasirodo iškylantysis pranešimas (toast) apie sėkmę arba klaidą.
Testai: packages/dashboard/tests/dashboard.test.ts apsaugo nuo regresijų naudojant confirm() QR kodo trynimo sraute.

2026-04 · Trumpųjų nuorodų testas dinaminiams QR kodams valdymo skydelyje

Valdymo skydelis: Trumpieji kodai (shortcodes) QR kodų sąraše dabar yra tiesiogiai spustelėjami als išorinės nukreipimo nuorodos. Išorinės nuorodos piktograma šalia, pvz., wu3qaa, atidaro https://qr3.app/{shortCode} naujame skirtuke.
i18n: Pridėti patarimų (tooltip) tekstai vokiečių ir anglų kalbomis.
Testai: packages/dashboard/tests/dashboard.test.ts apsaugo nuorodos „href“, naujo skirtuko elgseną, noopener noreferrer ir piktogramą nuo regresijų.

2026-04 · Nukreipimo Worker maršrutas dinaminiams QR kodams

Fix: Dinaminius QR kodus adresu https://qr3.app/{shortCode} vėl apdoroja nukreipimo Worker. Gamybinis (production) maršrutas dabar naudoja qr3.app/*, nes Cloudflare Worker maršrutai nepalaiko :code kelio parametrų.
Sustiprinimas: Neatitinkantys keliai perduodami į pradinę svetainę (landing origin), kad nukreipimo Worker neblokuotų įprastų puslapių, tokių kaip /de/pricing.
Testai: packages/redirect/tests/unit/redirect.test.ts tikrina pakaitos simbolio (wildcard) maršrutą, trumpojo kodo apdorojimą ir pradinės svetainės praleidimą (origin pass-through).

2026-04 · Darbo srities DPP nuskaitymų apžvalga (Q3.4.2)

Nauja: GET /v1/workspace/stats/dpp?days=30 — agreguoja visus API rakto darbo srities (workspace) dpp_scans (active_dpps, scans_by_day, top_dpps su produkto pavadinimu / kategorija).
Valdymo skydelis: Kortelė pradiniame puslapyje (/dashboard) su 30 dienų stulpeline diagrama + populiariausių sąrašais — lygiagrečiai su QR kodo kortelėmis.
Public: Rinkodaros trumpoji nuoroda GET /dpp/dpp_<id> (vienas segmentas) tiesioginėms demonstracijoms, lygiagrečiai su /dpp/{gtin}/{serial}.

2026-04 · DPP nuskaitymų analitika (Q3.4.1)

Nauja: GET /v1/dpp/:id/stats?days=30 — agreguoti viešojo GS1 atpažintuvo (resolver) nuskaitymai vienam DPP. Laukai: total_scans, period_scans, scans_by_day, top_countries, top_devices, top_representations.
Nauja: Lentelė dpp_scans (migracija 0011) — atskirta nuo scans (nukreipimo Worker). IP adresai maišomi (hashed) naudojant kasdien keičiamą druską (salt), neapdoroti IP adresai niekada nepasiekia D1.
Valdymo skydelis: Mini diagramos kortelė (SVG, nenaudojant diagramų bibliotekos) adresu /dashboard/dpp/:dppId su 30 dienų stulpeliais + 3 populiariausių pasiskirstymais. Tuščia būsena (empty-state), kai tik DPP yra paskelbtas, bet dar neturėjo nuskaitymų.

2026-04 · Tiesioginis ES atitikties simuliatorius (Q3.3.7)

Nauja: POST /v1/dpp/:id/validate-update — simuliuoja dalinius atnaujinimus be būsenos išsaugojimo (stateless) (būsena, rinkų sąrašas, …) be išliekamumo. Atsakyme yra eu_compliance + preview.changed_fields.
Valdymo skydelis: Simuliatoriaus kortelė detaliame DPP puslapyje (/dashboard/dpp/:dppId) — žymos (chips) skirtos DE/AT/FR/IT/ES/NL + pasirinktinėms, būsenos išskleidžiamasis sąrašas, Preview EU impact / Save changes / Reset. Neblokuojantis veikimas per Remix useFetcher.
Sustiprinimas: Iškelti simuliatoriaus pagalbiniai įrankiai (helpers) (readUpdatePatchFromForm, marketCountriesKey) + 18 naujų vienetų testų (unit tests); klaidų pataisymas: vienišas ne ISO įvesties laukas nebeištrina rinkų sąrašo.

2026-04 · Tiesioginė ES atitikties peržiūra kūrimo formoje (Q3.3.6)

Pakeista: POST /v1/dpp/validate papildomai pateikia eu_compliance — tas pats tikrintuvas (validator) kaip ir GET /v1/dpp/:id/eu-compliance, veikiantis be būsenos išsaugojimo (stateless) prieš išsaugant.
Valdymo skydelis: Peržiūra po esamu patvirtinimo skydeliu + naujas apsauginis išsaugojimo skydelis (Save-Guard-Banner) prieš pateikimo mygtukus, jei yra klaidų / įspėjimų (i18n daugiskaitos formos DE/EN).

2026-04 · ES tikrintuvas + tekstilės vartotojo sąsaja (Q3.3.4 + Q3.3.5)

Nauja: ES atitikties tikrintuvas (EU-Compliance-Validator) su 5 tekstilės taisyklėmis (TEXTILE_AGEC_REQUIRED, TEXTILE_MICROPLASTICS_CONSISTENCY, TEXTILE_SVHC_THRESHOLD, TEXTILE_GREENWASHING, TEXTILE_ESPR_READY).
Nauja: GET /v1/dpp/:id/eu-compliance su compliant / espr_ready / issues[] / summary.
Valdymo skydelis: ES atitikties skiltis detaliame DPP puslapyje (suvestinės kortelės, sugrupuotos problemų kortelės, ESPR-Ready ženklelis antraštėje).

2026-04 · Tekstilės DPP schema (Q3.3.1–Q3.3.3)

Nauja: Kategorija textile su privaloma AGEC grandine (audimas / mezgimas → dažymas / spausdinimas → siuvimas / konfekcija), kiekvienam pluoštui origin_country + recycled_pct, svhc_substances[], ESPR-Opt-in (PEF, tarnavimo laikas, Recyclability).
Nauja: Bazinis laukas market_countries: string[] (ISO 3166-1 alpha-2) visose DPP kategorijose — valdo Prancūzijai būdingas AGEC taisykles ir privalomą prancūzišką pastabą vartotojui.
Nauja: Vartotojo HTML šablonas su AGEC mikroplastiko įspėjamuoju laukeliu, 3 pakopų kilmės grandine (vėliavėlių žymekliais), SVHC sąrašu, Durability ir Recyclability skiltimis.
Migracija: 0010_dpp_market_countries (D1).

2026-04 · Masinis DPP importas (Q3.2.1–Q3.2.5)

Nauja: POST /v1/dpp/import priima CSV ir XLSX (suderinama su Worker per SheetJS xlsx, ~283 KB gzip paketas).
Skaliuojama: planu pagrįstas limitas (Free 100 → Enterprise 10k) + suskaidytas db.batch() po 100 + 5 MB užklausos kūno (body) limitas.
Nauja: Klaidų ataskaita kaip CSV atsakymo 201 lauke errors_csv; GET /v1/dpp/import/templates/:category?format=csv|xlsx pateikia paruoštus šablonus baterijoms ir tekstilei.
Valdymo skydelis: Failų vilkimo ir nuleidimo (drag-and-drop) įkėlimas adresu /dashboard/dpp/import su šablonų tarpiniu serveriu (proxy) ir tiesioginiu CSV atsisiuntimu.

Neesminiai pakeitimai (Non-Breaking) — LTS išplėtimai

Visi aukščiau išvardyti pakeitimai yra papildomi:

Esami POST /v1/dpp/validate klientai ignoruoja naują eu_compliance lauką be jokių pakeitimų.
Esami battery srautai lieka nepakeisti.
market_countries yra neprivalomas ir jo numatytoji reikšmė yra [].

Žr. API versijavimas dėl esminių pakeitimų politikos (Breaking-Change-Policy).