Comhlíonadh AE a Sheiceáil

Cuimsíonn qr3.app Bailíochtóir AE comhtháite le haghaidh DPPanna. Seiceálann sé do chuid DPPanna i gcoinne rialacha ábhartha an AE (ESPR, Loi AGEC) agus soláthraíonn sé saincheisteanna struchtúrtha le Déine (Severity), cosán réimse, leideanna agus suaitheantas roghnach ESPR-ready.

Tá trí phointe iontrála ann:

Ar thaobh an fhreastalaí, DPPanna atá sábháilte cheana féin — GET /v1/dpp/:id/eu-compliance
Réamhamharc beo san fhoirm chruthaithe — POST /v1/dpp/validate
Insamhlóir beo go mion — POST /v1/dpp/:id/validate-update

Soláthraíonn an triúr acu an cruth (Shape) céanna EuComplianceResult — mar sin ní gá duit an mheastóireacht a chur i bhfeidhm ach uair amháin.

Cruth an Toraidh

{
  "compliant": false,
  "espr_ready": true,
  "issues": [
    {
      "code": "TEXTILE_AGEC_REQUIRED",
      "severity": "error",
      "field": "textile_data.country_weaving_knitting",
      "message": "AGEC chain country is required for products sold on the French market",
      "hints": { "market": "FR" }
    },
    {
      "code": "TEXTILE_GREENWASHING",
      "severity": "warning",
      "field": "product_name",
      "message": "\"natural\" is a prohibited term under AGEC",
      "hints": { "term": "natural", "locale": "en", "category": "generic" }
    }
  ],
  "summary": { "errors": 1, "warnings": 1, "info": 0 }
}

compliant: true ⇔ summary.errors === 0
espr_ready: true ⇔ gach réimse roghnach (Opt-in) ESPR socraithe (féach ar DPP Teicstíle)
tá issues[] sórtáilte go cobhsaí de réir Déine (error → warning → info) agus ansin de réir Cóid

Leibhéil Déine

Déine (Severity)	Ciall	Sampla
`error`	Cuireann sé bac ar chomhlíonadh an AE; ba cheart é a dheisiú roimh an scaoileadh	`TEXTILE_AGEC_REQUIRED` má tá FR sa mhargadh agus má tá an slabhra tionscnaimh neamhiomlán
`warning`	Moladh; is féidir leis an gcustaiméir sábháil, ach ba cheart dó gníomhú	`TEXTILE_GREENWASHING` lasmuigh de FR
`info`	Comhartha stádais gan gá le gníomh	`TEXTILE_ESPR_READY` — gach réimse roghnach (Opt-in) ESPR iomlán

Catalóg na Rialacha (Teicstíle + Ceallra)

Teicstíle (Q3.3.4)

Cód	Leibhéal Déine	Truicear
`TEXTILE_AGEC_REQUIRED`	`error` (FR) · `warning` (seachas sin)	Slabhra AGEC (Fíodóireacht/Dathú/Déanamh) neamhiomlán, FR sa mhargadh
`TEXTILE_MICROPLASTICS_CONSISTENCY`	`error`	Sintéiseach ≥ 50% ach `contains_microplastics !== true`
`TEXTILE_SVHC_THRESHOLD`	`warning`	Iontráil SVHC gan uimhir CAS nó tiúchan
`TEXTILE_GREENWASHING`	`error` (FR) · `warning` (seachas sin)	Téarma ón liosta toirmiscthe in `product_name`/`material`
`TEXTILE_ESPR_READY`	`info`	Gach réimse ESPR B7–B15 iomlán

Ceallra (Céim 4a)

Seiceálann an bailíochtóir teorainneacha ó Rialachán Ceallraí an AE 2023/1542 (tairseacha Ábhair Athchúrsáilte, aicmí lorg carbóin, íosráthaíocht, srl.). Sonraí i ndoiciméadúchán DPP Ceallraí.

Réamhamharc Beo san fhoirm chruthaithe

Chomh luath agus a chruthaíonn tú DPP sa deais (/dashboard/dpp/new), ritheann an bailíochtóir céanna gan staid (stateless) le gach turas cruinn bailíochtaithe — gan gá an pas a shábháil. Feictear an rannán eu_compliance go díreach faoin bpainéal bailíochtaithe reatha agus aibhsíonn sé earráidí agus rabhaidh roimh an gcur isteach (Submit).

Rochtain dhíreach API:

curl -X POST https://qr3.app/v1/dpp/validate \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Workspace-Id: $WS_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "category": "textile",
    "gtin": "04012345678901",
    "product_name": "Natural Cotton T-Shirt",
    "manufacturer": "EcoWear GmbH",
    "origin_country": "PT",
    "market_countries": ["FR"],
    "textile_data": { "fiber_composition": [{ "material": "cotton", "percentage": 100, "recycled_pct": 0 }] }
  }'

Tá an méid seo a leanas sa fhreagra:

data.valid — bailíocht chomhréire (Zod)
data.errors[] — gnáthearráidí Zod
data.jsonld_preview — réamhamharc JSON-LD
data.eu_compliance — toradh Bhailíochtóir AE (null má theipeann ar bhailíochtú Zod)

Má tá eu_compliance.summary.errors > 0, rindreálann an deais bratach Save-Guard go díreach os cionn an chnaipe Submit — ní chuirtear bac ar an sábháil, ach feiceann tú na hiarmhairtí roimh an gcliceáil.

Insamhlóir Beo go mion

Ar /dashboard/dpp/:dppId, tá cárta insamhlóra faoin rannán comhlíonta. Ligeann sé seo duit an dá réimse is ábhartha don chomhlíonadh (status agus market_countries) a athrú agus an tionchar a fheiceáil láithreach — gan cur isteach auf na sonraí reatha. Sreabhadh tipiciúil:

Réamhamharc: “Cad a tharlóidh má chuirim FR sa raon táirgí?” → Roghnaigh slisín “FR” → “Preview EU impact” → éiríonn TEXTILE_AGEC_REQUIRED infheicthe
Deisiú: Comhlánaigh an slabhra tionscnaimh (lasmuigh den insamhlóir sa sreabhadh cruthaithe nó mórshreabhadh)
Sábháil: Sábhálann “Save changes” an stádas/liosta margaidh go díreach trí PUT /v1/dpp/:id

Rochtain dhíreach API:

curl -X POST https://qr3.app/v1/dpp/$DPP_ID/validate-update \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Workspace-Id: $WS_ID" \
  -H "Content-Type: application/json" \
  -d '{ "market_countries": ["DE", "FR"], "status": "live" }'

Leathnaíonn an freagra an toradh caighdeánach le réad preview:

{
  "data": {
    "compliant": false,
    "espr_ready": false,
    "issues": [/* … */],
    "summary": { "errors": 1, "warnings": 0, "info": 0 },
    "preview": {
      "status": "live",
      "landing_locale": "de",
      "market_countries": ["DE", "FR"],
      "changed_fields": ["status", "market_countries"]
    }
  }
}

Ní liostaíonn changed_fields[] ach réimsí a d’athródh dáiríre — ar an mbealach seo is féidir leat, mar shampla, na slisíní athraithe amháin a aibhsiú i gcomhéadan úsáideora (UI).

Tá corp folamh ceadaithe agus soláthraíonn sé an measúnú comhlíonta reatha (athsheiceáil ar an staid reatha).

Uathoibriú

Píblíne CI

Seiceáil tipiciúil CI:

STATUS=$(curl -s -o /tmp/out.json -w "%{http_code}" \
  https://qr3.app/v1/dpp/$DPP_ID/eu-compliance \
  -H "Authorization: Bearer $API_KEY" \
  -H "X-Workspace-Id: $WS_ID")

if [ "$STATUS" != "200" ]; then
  exit 1
fi

jq -e '.data.summary.errors == 0' /tmp/out.json > /dev/null

Freastalaí MCP

Cuireann an @qr3/mcp-server atá san áireamh uirlis validate_dpp ar fáil i measc rudaí eile — is féidir le gníomhairí AI é a úsáid chun a sheiceáil an gcomhlíonann na sonraí reatha rialacha AGEC roimh an nglaoch cruthaithe.

Earráidí Coitianta

Saincheist (Issue)	Cúis	Deisiú (Fix)
`TEXTILE_MICROPLASTICS_CONSISTENCY`	Cion poileistear ≥ 50%, ach tá an bratach `false`	socraigh `contains_microplastics: true`
`TEXTILE_AGEC_REQUIRED` le `hints.market: "FR"`	FR sa mhargadh, an slabhra neamhiomlán	socraigh `country_weaving_knitting`, `country_dyeing_printing`, `country_assembly`
`TEXTILE_GREENWASHING` mar `error`	Téarma toirmiscthe + FR sa mhargadh	bain an téarma as `product_name` nó athraigh an margadh
`TEXTILE_SVHC_THRESHOLD`	Substaint SVHC gan CAS	cuir isteach an uimhir CAS ó liosta REACH

Na Céad Chéimeanna Eile

DPP Teicstíle — Scéimre, slabhra tionscnaimh, bosca rabhaidh micreaplaisteach
DPP Ceallraí — Réimsí éigeantacha do phas ceallraí
Tagairt API — mionsonraí ar gach críochphointe comhlíonta AE