Changelog

Odabrani naglasci iz nedavnih izdanja. Za potpune verzije API-ja i pravila o prekinutim promjenama pogledajte Verzioniranje API-ja i LTS pravila.

Detaljne promjene na pojedinačnim krajnjim točkama: OpenAPI specifikacija i interaktivna API referenca.

2026-04 · Analitika nadzorne ploče po QR kodu

Nadzorna ploča: Gumb za analitiku na popisu QR kodova sada otvara stranicu sa statistikama za odgovarajući QR kod na /dashboard/codes/{id}.
Usmjeravanje: Alias /dashboard/codes i dalje preusmjerava na /dashboard, ali više ne presreće detaljne rute poput /dashboard/codes/{id}.
API: Stranica s detaljima učitava QR kod izravno putem GET /v1/codes/:id; time više ne ovisi o ograničenjima paginacije popisa.
Testovi: Regresijski testovi pokrivaju preusmjeravanje aliasa i izravno učitavanje koda.

Nadzorna ploča: Ikona kante za smeće na popisu QR kodova sada otvara namjenski React dijalog umjesto izvornog skočnog prozora preglednika.
Povratna informacija: Nakon brisanja pojavljuje se toast obavijest o uspjehu ili pogrešci.
Testovi: packages/dashboard/tests/dashboard.test.ts sprječava regresije na confirm() u tijeku brisanja QR koda.

Nadzorna ploča: Kratki kodovi (shortcodes) na popisu QR kodova sada se mogu izravno kliknuti kao vanjske poveznice za preusmjeravanje. Ikona vanjske poveznice pokraj npr. wu3qaa otvara https://qr3.app/{shortCode} u novoj kartici.
i18n: Dodani tekstovi opisa (tooltips) za njemački i engleski jezik.
Testovi: packages/dashboard/tests/dashboard.test.ts štiti href poveznice, ponašanje nove kartice, noopener noreferrer i ikonu od regresija.

Ispravak: Dinamički QR kodovi na https://qr3.app/{shortCode} ponovno se obrađuju putem Redirect Workera. Produkcijska ruta sada koristi qr3.app/* jer Cloudflare rute Workera ne podržavaju parametre staze :code.
Učvršćivanje: Nepodudarne staze prosljeđuju se na izvorište odredišne stranice (landing origin) kako normalne stranice poput /de/pricing ne bi bile blokirane od strane Redirect Workera.
Testovi: packages/redirect/tests/unit/redirect.test.ts provjerava zamjensku (wildcard) rutu, obradu kratkog koda i prosljeđivanje izvorištu (origin pass-through).

Novo: GET /v1/workspace/stats/dpp?days=30 — agregira sva dpp_scans skeniranja radnog prostora API ključa (active_dpps, scans_by_day, top_dpps s nazivom proizvoda/kategorijom).
Nadzorna ploča: Kartica na početnoj stranici (/dashboard) s 30-dnevnim stupčastim grafikonom + top listama — paralelno s karticama QR kodova.
Javno: Marketinška kratka poveznica GET /dpp/dpp_<id> (jedan segment) za demonstracije uživo, paralelno s /dpp/{gtin}/{serial}.

Novo: GET /v1/dpp/:id/stats?days=30 — agregirana skeniranja javnog GS1 resolvera po DPP-u. Polja: total_scans, period_scans, scans_by_day, top_countries, top_devices, top_representations.
Novo: Tablica dpp_scans (migracija 0011) — odvojena od scans (Redirect Worker). IP adrese se hashiraju s dnevno rotirajućom soli (salt), sirove IP adrese nikada ne dolaze do D1.
Nadzorna ploča: Mini kartica s grafikonom (SVG, bez biblioteke za grafikone) na /dashboard/dpp/:dppId s 30-dnevnim stupcima + top 3 raščlambe. Prikaz praznog stanja (empty-state) čim je DPP aktivan, ali još nema skeniranja.

Novo: POST /v1/dpp/:id/validate-update — simulira djelomična ažuriranja bez stanja (stateless) (status, popis tržišta, …) bez perzistencije. Odgovor sadrži eu_compliance + preview.changed_fields.
Nadzorna ploča: Kartica simulatora u detaljima DPP-a (/dashboard/dpp/:dppId) — oznake (chips) za DE/AT/FR/IT/ES/NL + prilagođeno, padajući izbornik statusa, Preview EU impact / Save changes / Reset. Neblokirajuće putem Remix useFetcher.
Učvršćivanje: Izdvojeni pomoćni alati simulatora (readUpdatePatchFromForm, marketCountriesKey) + 18 novih jediničnih testova; ispravak pogreške: samostalni unos koji nije u ISO formatu više ne briše popis tržišta.

Izmijenjeno: POST /v1/dpp/validate dodatno isporučuje eu_compliance — isti validator kao GET /v1/dpp/:id/eu-compliance, bez stanja (stateless) prije spremanja.
Nadzorna ploča: Pregled ispod postojećeg panela za validaciju + novi Save-Guard-Banner ispred gumba za slanje ako postoje otvorene pogreške/upozorenja (i18n pluralizacija DE/EN).

Novo: Validator usklađenosti s EU propisima s 5 tekstilnih pravila (TEXTILE_AGEC_REQUIRED, TEXTILE_MICROPLASTICS_CONSISTENCY, TEXTILE_SVHC_THRESHOLD, TEXTILE_GREENWASHING, TEXTILE_ESPR_READY).
Novo: GET /v1/dpp/:id/eu-compliance s compliant / espr_ready / issues[] / summary.
Nadzorna ploča: Odjeljak za usklađenost s EU propisima u detaljima DPP-a (sažeti prikazi, grupirane kartice problema, ESPR-Ready značka u zaglavlju).

Novo: Kategorija textile s obveznim AGEC lancem (tkanje/pleenje → bojenje/tisak → konfekcija), po vlaknu origin_country + recycled_pct, svhc_substances[], ESPR-Opt-in (PEF, životni vijek, mogućnost recikliranja).
Novo: Osnovno polje market_countries: string[] (ISO 3166-1 alpha-2) na svim DPP kategorijama — upravlja specifičnim francuskim AGEC pravilima i obveznom napomenom za francuske potrošače.
Novo: HTML predložak za potrošače s AGEC okvirom upozorenja za mikroplastiku, trostupanjskim lancem podrijetla (oznake sa zastavicama), SVHC popisom te odjeljcima za trajnost i mogućnost recikliranja.
Migracija: 0010_dpp_market_countries (D1).

Novo: POST /v1/dpp/import prihvaća CSV i XLSX (kompatibilno s Workerima putem SheetJS xlsx, ~283 KB gzip paket).
Skalirano: ograničenje temeljeno na pretplati (Free 100 → Enterprise 10k) + podijeljeni db.batch() u serijama od 100 + ograničenje tijela zahtjeva od 5 MB.
Novo: Izvješće o pogreškama kao CSV u polju errors_csv odgovora 201; GET /v1/dpp/import/templates/:category?format=csv|xlsx pruža gotove predloške za baterije i tekstil.
Nadzorna ploča: Drag-and-drop prijenos na /dashboard/dpp/import s proxyjem predloška i ugrađenim preuzimanjem CSV-a.

Sve gore navedene promjene su aditivne:

Postojeći klijenti koji koriste POST /v1/dpp/validate zanemaruju novo polje eu_compliance bez potrebe za izmjenama.
Postojeći battery tijekovi ostaju nepromijenjeni.
market_countries je opcionalno polje i zadano je postavljeno na [].

Pogledajte Verzioniranje API-ja za pravila o prekinutim promjenama.