8 lines
1.5 KiB
Markdown
8 lines
1.5 KiB
Markdown
# Clarity collection
|
||
|
||
Scope: only scripts/seo-performance; backend/storefront/schema paths are owned by concurrent developers. Base source SHA 312fcc2acc8f07dcf20d3d6ee0165ba8e619122e; shared worktree dirty outside this scope. No frontend/backend changes or graph regeneration required; direct worker and DTO/service contracts inspected. Existing graph is unbound navigation only.
|
||
|
||
Collect real read-only Clarity dashboard aggregates from the official endpoint with Bearer token, redirects disabled and bounded timeout. Token is loaded in-process from provisioned dotenv, never printed. Keep rolling UTC 1–3 day window independent of GSC/GA4 dates. No historical reconstruction or keyword/order attribution. Preserve catalog-only commerce state.
|
||
|
||
Acceptance: durable project/UTC-day/window/dimensions cache reuses one request across articles and process reopen; account for attempted calls before transport and cap at ten per project/day; fail closed on invalid/missing credentials, HTTP, network or malformed/partial data; cache failures too. Store only allowlisted numeric aggregate fields and hashed exact URL identities, no raw URLs, PII, bodies or token. Default project aggregate collection is explicitly not article data. Optional URL breakdown may be article-scoped only for exact URL matches; no guessed or normalized matching, no pagination and 1000-row truncation disclosed. Backend sourceMetadata receives clarity provenance without assigning it to the snapshot's Google dates. No remote backend mutations, deployment, scheduling or restart authorized.
|