Error → user report

Errors specs/errors/reporting.kmd

Step diagram

  1. Error surfaces in KoderErrorBanner

    App

    Humanized title + actionable detail + canonical error ID (PRODUCT-CAT-CODE-SEQ).

    specs/errors/user-facing-messages.kmd

  2. User taps Report

    User

    Only available when reporting consent is ON in Settings. Default OFF.

  3. Confirm dialog

    App

    Shows exactly what will be sent: error ID, anonymized stack, optional comment box. No PII unless the user adds it explicitly.

  4. User confirms

    User

    Tap Send.

  5. SDK posts to the reporter

    SDK

    KoderErrorReporter ships the bundle to services/foundation/reporter; queues offline.

    specs/errors/reporting.kmd

  6. Server acknowledges

    Server

    Reporter returns a tracking ID the user can quote in support requests.

Common pitfalls