Skip to content
qr3.app Docs

GDPR & Cosaint Sonraí

Cosaint Sonraí de réir Deartha

Tá qr3.app tógtha ó bhonn chun a bheith comhlíontach le GDPR:

  • Bréagainmniú IP — Déantar seoltaí IP a thiontú láithreach ina mbréagainmneacha laethúla UTC HMAC-SHA-256 sa Edge Worker. Ní stóráiltear an bunseoladh IP riamh; fanann an bréagainm ina shonraí pearsanta.
  • Íoslaghdú Sonraí — Ní bhailítear ach na sonraí atá riachtanach don oibriú.

Privacy-API

Achoimre Sonraí (Airteagal 15 GDPR)

GET /v1/account/privacy — Seolann sé seo achoimre ar na sonraí stóráilte go léir ar ais.

Terminal window
curl https://qr3.app/v1/account/privacy \
  -H "Authorization: Bearer qr3_sk_..."

Freagra:

{
  "data": {
    "workspace_id": "ws_xxx",
    "organization_id": "org_xxx",
    "account": {
      "email": "[email protected]",
      "name": "Alex Example",
      "locale": "en",
      "created_at": "2026-01-15T09:00:00.000Z"
    },
    "stored_data": {
      "qr_codes": 42,
      "scan_records": 15000,
      "dpp_scan_records": 3200,
      "dashboard_activity_records": 0,
      "dashboard_document_activity_records": 36,
      "api_operation_records": 180,
      "webhook_delivery_records": 640,
      "api_keys": 2,
      "webhooks": 1,
      "dpp_passports": 12,
      "dpp_documents": 30,
      "files": 4,
      "gs1_identifiers": 2,
      "gs1_verification_requests": 1,
      "code_comments": 5,
      "audit_log_entries": 0,
      "dpp_import_jobs": 1,
      "workspace_members": 3,
      "scan_quota_alerts": 1
    },
    "gdpr_rights": {
      "access": "GET /v1/account/privacy",
      "export": "GET /v1/account/export",
      "erasure": "DELETE /v1/account",
      "consents": "GET /v1/account/privacy/consents"
    },
    "data_processing": {
      "ip_storage": "Purpose-separated HMAC-SHA-256 UTC-day IP pseudonym — pseudonymous personal data",
      "scan_retention": "90 days by default",
      "usage_retention": "90 UTC days",
      "webhook_delivery_retention": "90 UTC days",
      "pii_in_export": true,
      "erasure": "DELETE /v1/account erases the person's account: organizations they own with all workspaces and data (unless another org admin takes them over), their memberships in other organizations, their login and their Stripe customer. A running subscription ends immediately, without refund.",
      "backup_retention": "Erased rows stay restorable from the database backups (Cloudflare D1 Time Travel) for up to 30 days, then they are gone.",
      "billing_records": "Invoices stay with Stripe for the statutory retention period (7 years, § 132 BAO)."
    }
  },
  "meta": { "request_id": "req_xxx" }
}

Comhaireann stored_data na hiontrálacha stóráilte. Is scananna de chóid QR iad scan_records, agus is iarratais ar phasanna táirge tríd an DPP Resolver poiblí iad dpp_scan_records. Tá an bréagainm IP sa dá cheann.

Comhaireann dashboard_activity_records agus dashboard_document_activity_records na laethanta ar oscail ball an Deais (dhá tábla), comhaireann api_operation_records na n-áirimh iarratas laethúla in aghaidh eochrach API, oibríochta agus toraidh, agus comhaireann webhook_delivery_records na n-iarrachtaí seachadta Webhook, lena n-áirítear iad siúd de Webhooks scriosta. Ní stórálann aon cheann acu seoladh IP ná User-Agent; stórálann an lóg seachadta, áfach, payload an imeachta agus an chéad kilobyte (1 KB) de fhreagra an fhaighteora. Scriostar na ceithre cinn acu tar éis 90 lá UTC (usage_retention, webhook_delivery_retention).

Ainmníonn account an duine taobh thiar den iarratas — sa Deais an duine atá logáilte isteach, nó murab ann dó sin an duine a chruthaigh an eochair — le ríomhphost, ainm, teanga agus dáta cruthaithe; i gcás Publishable Key is é null an luach. Clúdaíonn na háirimh eile gach tábla eile ina bhfuil sonraí an chuntais: pasanna táirge, doiciméid DPP, comhaid, aitheantóirí GS1, tuairimí, iontrálacha iniúchta, ritheanna allmhairithe, baill an workspace agus fógraí cuóta na heagraíochta (scan_quota_alerts). Áirítear sraitheanna atá scriosta go bog, mar go bhfuil siad stóráilte fós. Déanann erasure, backup_retention agus billing_records cur síos ar a scriosann DELETE /v1/account agus ar a fhanann ar feadh tamaill; is true é pii_in_export toisc go n-ainmníonn an t-easpórtáil an duine (ríomhphost, ainm) — ní fhágann bréagainmneacha IP an bunachar sonraí riamh.

Easpórtáil Sonraí (Airteagal 20 GDPR — Inaistritheacht Sonraí)

GET /v1/account/export — Íoslódálann sé seo na sonraí go léir mar chomhad JSON.

Terminal window
curl https://qr3.app/v1/account/export \
  -H "Authorization: Bearer qr3_sk_..." \
  -o my-data.json

Cuimsíonn an t-easpórtáil:

  • Gach cód QR (lena n-áirítear cinn scriosta)
  • Staitisticí scanta comhiomlánaithe (gan aon haiseanna IP amha)
  • Iarratais DPP comhiomlánaithe in aghaidh an phas táirge (dpp_scan_aggregates, gan haiseanna IP ach an oiread)
  • Staitisticí úsáide mar chomhiomláin (dashboard_activity_aggregates, api_operation_aggregates): laethanta gníomhacha agus líon na n-úsáideoirí gníomhach in aghaidh an chainéil Deais, áirimh iarratas in aghaidh oibríochta agus toraidh — gan aitheantóirí úsáideoirí ná eochracha
  • Iarrachtaí seachadta Webhook in aghaidh an Webhook agus cineál an imeachta (webhook_delivery_aggregates), gan payload ná freagra
  • An duine taobh thiar den iarratas (account), an eagraíocht (organization; seoladh billeála agus fógraí do riarthóirí eagraíochta amháin) agus an workspace (workspace)
  • Pasanna táirge, meiteashonraí doiciméad DPP agus comhad (ní na comhaid féin), aitheantóirí GS1, iarratais ar a bhfíorú agus ritheanna allmhairithe (dpp_passports, dpp_documents, files, gs1_identifiers, gs1_verification_requests, dpp_import_jobs)
  • Tuairimí gan réimsí údair (code_comments), iontrálacha iniúchta mar chomhiomláin (audit_log_aggregates) agus baill de réir róil (member_aggregates)
  • Eochracha API gan ID ná hais (api_keys), Webhooks gan URL ná rún (webhooks) agus fógraí cuóta na heagraíochta (scan_quota_alerts)
  • Stampaí ama cruthaithe agus modhnaithe

Faigheann Publishable Keys (qr3_pk_) 403: tá seoltaí sprice agus nótaí gach cóid sa chomhad.

Cuntas a Scriosadh (Airteagal 17 GDPR — An Ceart chun Dearmad a Dhéanamh)

DELETE /v1/account — Scriosann sé cuntas an duine taobh thiar den iarratas, láithreach agus go do-aisiompaithe: sa Deais an duine atá logáilte isteach, nó murab ann dó sin an duine a chruthaigh an eochair. Tagann an scriosadh céanna as iarratas scriosta trí ríomhphost: scriosann an t-oibreoir an logáil isteach ag Clerk, agus ansin scriosann qr3 an cuntas.

Terminal window
curl -X DELETE https://qr3.app/v1/account \
  -H "Authorization: Bearer qr3_sk_..."

Cad a tharlaíonn:

  1. Eagraíochtaí ar leis an duine iad: scriostar iad lena n-uile workspace, cód, pas táirge, comhad, staitisticí agus logaí, a gcomhaid sa stóras san áireamh. Má tá riarthóir eagraíochta gníomhach eile ag eagraíocht den sórt sin, glacann an té is faide sa ról seilbh uirthi ina ionad sin, mar aon lena sonraí agus a síntiús.
  2. Síntiús: críochnaíonn síntiús reatha láithreach, gan aisíocaíocht chomhréireach agus gan sonrasc deiridh; ansin scriostar custaiméir Stripe. Fanann sonraisc ag Stripe ar feadh na tréimhse coinneála reachtúla (7 mbliana, § 132 BAO).
  3. Foirne: críochnaíonn ballraíocht an duine in eagraíochtaí eile; coinníonn na foirne sin a gcuid sonraí. Ní ainmníonn tuairimí an duine údar a thuilleadh, cailleann a iontrálacha iniúchta an bréagainm IP agus an user agent, agus cúlghairtear na heochracha API a chruthaigh sé nó sí ansin.
  4. An duine: scriostar an logáil isteach (Clerk) agus taifead an úsáideora.

Is é 200 an freagra le status: "completed" agus na háirimh organizations_deleted, organizations_transferred, memberships_removed agus login_deleted. I gcás eagraíochtaí an-mhór ní leor iarratas amháin: is é 202 an freagra ansin le status: "in_progress", agus críochnaítear an scriosadh go huathoibríoch laistigh d’uaireanta.

Teastaíonn Secret Key nó Test Key le cearta scríbhneoireachta, nó seisiún Deais (ról ar bith, mar gur cuntas an duine féin atá i gceist). Faigheann Publishable Keys agus eochracha léite amháin 403, faigheann eochair gan duine taobh thiar di (created_by = 'system') 409. Ciallaíonn 503 go bhfuil rún atá de dhíth ar an scriosadh in easnamh ar an imscaradh; níor scriosadh aon rud.

Toilithe a Bhainistiú

GET /v1/account/privacy/consents — Faigh na toilithe reatha.

POST /v1/account/privacy/consents — Nuashonraigh na toilithe.

Terminal window
# Faigh na toilithe reatha
curl https://qr3.app/v1/account/privacy/consents \
  -H "Authorization: Bearer qr3_sk_..."


# Díchumasaigh ríomhphoist mhargaíochta
curl -X POST https://qr3.app/v1/account/privacy/consents \
  -H "Authorization: Bearer qr3_sk_..." \
  -H "Content-Type: application/json" \
  -d '{ "marketing_emails": false, "analytics": true, "product_updates": true }'

Réimsí Toilithe:

RéimseRéamhshocrúCur Síos
marketing_emailsfalseNuachtlitreacha agus ríomhphoist mhargaíochta
analyticstrueStaitisticí úsáide comhiomlánaithe
product_updatestrueNuashonruithe táirge agus logaí athruithe

Teastaíonn cearta scríbhneoireachta chun toilithe a athrú: faigheann an ról viewer agus Publishable Keys 403.

Cur i bhFeidhm Teicniúil GDPR

Bréagainmniú IP (Airteagal 25 GDPR)

Iarratas HTTP → Cloudflare Edge Worker
  ↓
Ceanntásc CF-Connecting-IP → HMAC-SHA-256(IP_HASH_SALT, cuspóir, lá UTC, IP)
  ↓
ip_hash (bréagainm laethúil) → bunachar sonraí D1
  ↓
Ní stóráiltear an bunseoladh IP riamh

Is rún máistir fadsaolach é IP_HASH_SALT; díorthaíonn cuspóir agus lá UTC bréagainmneacha laethúla ar leith go huathoibríoch. Níl bréagainmneacha ó laethanta UTC éagsúla mar an gcéanna go díreach, ach is féidir le sealbhóir an rúin iarrthóir IP aitheanta a athríomh do lá áirithe. Ní úsáidtear salann laethúil KV ná rothlú laethúil de láimh.

Coimeád Sonraí (Uathoibrithe)

PleanCoimeád
Gach plean90 lá

Coinnítear staitisticí úsáide (gníomhaíocht Deais, áirimh úsáide API) agus logaí seachadta Webhook ar feadh 90 lá UTC freisin: an lá UTC reatha móide an 89 lá roimhe sin. Scriosann an tasc cron laethúil céanna na sraitheanna níos sine (purgeOldDashboardActivity, purgeOldApiOperationUsage, purgeOldWebhookDeliveries).

DPA Fo-Phróiseálaithe

Próiseálann Cloudflare, Inc. sonraí mar phróiseálaí sonraí. Tá an DPA ar fáil ag cloudflare.com/cloudflare-customer-dpa.

Próiseálann Cloudflare sonraí le leid suímh do réigiún an AE (m.sh. Frankfurt); níl dlínse AE ráthaithe go conarthach curtha in áirithe faoi láthair. Ós rud é go bhfuil Cloudflare, Inc. lonnaithe sna Stáit Aontaithe, tá Clásail Chonarthacha Chaighdeánacha (SCCanna) de réir Airteagal 46 GDPR i bhfeidhm mar bhunús aistrithe.

Teagmháil