Skip to content
Het fundament eronderTrust and privacy

Fouten en gebruikssignalen

Weet wat stukging, zonder iemand te volgen die nee zei.

Als een verzoek mislukt, krijg je een korte verwijzing zoals APP-CAPACITY-002 en een gewone melding, en die verwijzing hoort bij precies één regel in een register. Productanalyse blijft stil en doet niets tot iemand de analysecookie accepteert, ook als dat halverwege een sessie gebeurt.

  • 0

    tracking events before consent

  • 1

    place where every error code lives

  • 2

    tools that leave the build when unset

Het probleem dat dit oplost

Zonder een gedeelde basis bouwt elk team deze randgevallen opnieuw, en anders.

The consent check someone missed

Analytics that fires on page load with a banner bolted on afterwards needs a guard at every call site, and one missed guard is a real problem. Here the guard is inside the tracking call itself.

A failure report with nothing in it

Someone says it broke, with no reference, or pastes a stack trace. There is nothing stable to match against what was actually captured. A short reference solves that in one line.

Tools that break without their keys

SDKs that assume their keys exist crash local development or behave differently between environments. Here both wrappers are safe to call unconfigured and disappear from the build entirely.

Hoe het werkt

Het mechanisme van begin tot eind, zoals het in de repository is geïmplementeerd.

  1. 1

    Consent comes first

    Every tracking call checks the analytics cookie choice. On acceptance the tracker loads lazily, and a change listener covers a yes that arrives later in the session.

  2. 2

    Errors are captured with context

    Reporting filters noise and tags each event with structured context such as organization, project and job. In development, events log locally rather than being sent.

  3. 3

    People get a stable reference

    Every failure resolves through one registry to a reference such as APP-CAPACITY-001 and a safe public message. Operator meanings stay in the repository docs.

  4. 4

    Missing keys cost nothing

    Without analytics or error-reporting keys every helper becomes a no-op and the build drops the unused tools.

Interactief voorbeeld

Bekijk het in werking

Deze rondleiding toont het geïmplementeerde backendcontract zonder account, credentials of providercalls.

Interactief voorbeeld

Explore the decisions this makes

Kies een voorbeeldstatus
Analytics suppressed

Alleen deterministische voorbeelddata. De interactie gebruikt geen account-, provider- of netwerkverbinding.

Kernpunten

Waarom dit belangrijk is

Tracking waits for a yes

Every tracking call checks the consent choice first. The tracker loads lazily on acceptance, and a listener covers someone who accepts mid-session.

Errors carry context

Reports are tagged with organization, project, job and AI details, so a failure can be placed without digging through raw payloads.

Failures come with a reference

Every API error maps through one registry to a support reference and a safe public message. A released reference always means the same thing.

Technische garanties

Wat dit wel en niet belooft

Veiligheidsgrens

Foutrapportage wordt los van de analysetoestemming ingesteld, en deze pagina doet niet alsof dat anders is. Wat er in onze foutcontext mag staan en hoe lang die bewaard blijft, is aan ons om te bepalen en niet iets wat de code beslecht.

Implementatiebewijs

De grens hierboven is geen claim maar code. Deze bestanden dragen het contract:

  • src/lib/analytics.ts
  • src/lib/sentry.ts
  • src/registries/error-codes.ts
  • docs/ERROR-CODES.md
Vragen

Veelgestelde vragen

Waar Fouten en gebruikssignalen op rust

De documentatie beschrijft dezelfde contracten die deze pagina demonstreert.