{
  "meta": {
    "version": "1.4.1",
    "date": "2026-10-31",
    "draft": false,
    "pilotNotice": "Billing-based degradation applies only to codes beyond the three oldest unremoved codes: those three keep their current state and free rights. For the remaining codes, grace applies while paid_until <= now < paid_until + 89 full UTC days; frozen starts at that boundary with no end date. materialization is asynchronous and may lag the boundary. Year 2 means no automatic end caused by non-payment; it does not prevent later payment, pause, abuse action or deletion."
  },
  "states": [
    {
      "id": "active",
      "label": "Active",
      "when": "The code is paid for or on the free plan.",
      "scanner": {
        "text": "Redirect (302) to the destination the owner set.",
        "status": "enforced"
      },
      "owner": {
        "text": "Full control: change the destination, pause, delete.",
        "status": "enforced"
      }
    },
    {
      "id": "grace",
      "label": "Grace",
      "when": "From paid_until through 89 full UTC days without payment.",
      "scanner": {
        "text": "Exactly what an active code does: redirect to the owner’s destination. Billing state does not change the answer, and the scan path has no access to account or billing records.",
        "status": "enforced"
      },
      "owner": {
        "text": "Full control, with a notice in the panel that payment is due and paid features may be unavailable.",
        "status": "enforced"
      }
    },
    {
      "id": "frozen",
      "label": "Frozen",
      "when": "At paid_until + 89 full UTC days, with no end date.",
      "scanner": {
        "text": "Exactly what an active code does: redirect to the last destination the owner set.",
        "status": "enforced"
      },
      "owner": {
        "text": "The destination can no longer be changed after the grace schedule reaches day 90, while the code keeps redirecting with no end date.",
        "status": "enforced"
      }
    },
    {
      "id": "paused",
      "label": "Paused by the owner",
      "when": "Only when the owner pauses the code.",
      "scanner": {
        "text": "Redirect to the owner’s fallback address if they set one; otherwise a plain DurableQR page saying the code is paused by its owner, has not expired and will never be reassigned. No advertising.",
        "status": "enforced"
      },
      "owner": {
        "text": "Pause and resume from the panel.",
        "status": "enforced"
      }
    },
    {
      "id": "blocked",
      "label": "Blocked for abuse",
      "when": "Only when the destination is found to be malicious (the one exception to the rules below).",
      "scanner": {
        "text": "A plain DurableQR warning page instead of the redirect, naming the address for appeals.",
        "status": "enforced"
      },
      "owner": {
        "text": "Appeal by writing to the abuse address; a person reviews the appeal and restores the previous state when the block was wrong.",
        "status": "committed"
      }
    },
    {
      "id": "deleted",
      "label": "Deleted by the owner",
      "when": "Only when the owner deletes the code.",
      "scanner": {
        "text": "The same “unknown code” answer (404) as an identifier that never existed. The identifier is never issued again.",
        "status": "enforced"
      },
      "owner": {
        "text": "Deletion is final.",
        "status": "enforced"
      }
    }
  ],
  "timeline": [
    {
      "at": "paid_until (Day 1 without payment)",
      "state": "grace",
      "transition": {
        "text": "For codes beyond the three oldest unremoved codes, the code enters Grace after payment is due while paid_until <= now < paid_until + 89 full UTC days; the projection is asynchronous. The three oldest codes keep their current state and free rights.",
        "status": "enforced"
      },
      "scanner": {
        "text": "The owner’s destination, unchanged, or the owner’s fallback when the destination is marked unhealthy, exactly as for an active code.",
        "status": "enforced"
      }
    },
    {
      "at": "paid_until + 89 full UTC days (Day 90 without payment)",
      "state": "frozen",
      "transition": {
        "text": "For codes beyond the three oldest unremoved codes, the code enters Frozen at paid_until + 89 full UTC days; it stays there with no end date. The projection is asynchronous, and the three oldest codes keep their current state and free rights.",
        "status": "enforced"
      },
      "scanner": {
        "text": "The owner’s last destination, unchanged, or the owner’s fallback when that destination is marked unhealthy, exactly as for an active code.",
        "status": "enforced"
      }
    },
    {
      "at": "Year 2 without payment",
      "state": "frozen",
      "transition": {
        "text": "For codes beyond the three oldest unremoved codes, the code stays Frozen with no end date. Year 2 means no automatic end caused by non-payment; it does not prevent later payment, pause, abuse action or deletion, and the projection remains asynchronous. The three oldest codes keep their current state and free rights.",
        "status": "enforced"
      },
      "scanner": {
        "text": "The owner’s last destination, unchanged, or the owner’s fallback when that destination is marked unhealthy, exactly as for an active code.",
        "status": "enforced"
      }
    }
  ],
  "never": [
    {
      "text": "A code never shows advertising and never redirects to a DurableQR page, a vendor page or anything other than the owner’s destination, the owner’s fallback or the plain notes above.",
      "status": "enforced"
    },
    {
      "text": "If the owner set a fallback address and the destination is marked unhealthy, a scan of an active, grace or frozen code goes to the fallback instead.",
      "status": "enforced"
    },
    {
      "text": "Destinations are checked automatically and marked unhealthy when they fail; until then every destination counts as healthy.",
      "status": "enforced"
    },
    {
      "text": "Routing records carry no expiry, so no code disappears because time passed or nobody logged in.",
      "status": "enforced"
    },
    {
      "text": "A code is never deleted for inactivity or for non-payment. Only its owner deletes it.",
      "status": "contractual"
    },
    {
      "text": "An identifier is never issued a second time: a new code cannot take an identifier that already has a record.",
      "status": "enforced"
    },
    {
      "text": "An identifier is never sold, and never moved to another customer without its owner’s consent.",
      "status": "contractual"
    },
    {
      "text": "Every answer the scan service itself gives carries Cache-Control: no-store and Referrer-Policy: no-referrer, so no browser or shared cache may keep a scan answer and the destination site does not learn the code identifier from the Referer header. Two answers come from the underlying infrastructure instead and may lack these headers: an error (5xx) when the code record cannot be read, and the refusal of any request other than GET or HEAD. Neither is a redirect.",
      "status": "enforced"
    }
  ],
  "jurisdiction": {
    "text": "Polish law; disputes are resolved by the common court competent for the service provider's seat.",
    "status": "contractual"
  },
  "regions": [
    {
      "region": "eu-central-1 (Frankfurt, Germany)",
      "services": "Amazon DynamoDB (codes, destinations, scan counters, paid scan analytics pseudonyms, countries and daily aggregates), AWS Lambda (scan path, API, file rendering, sign-up check), Amazon Cognito (accounts), Amazon API Gateway (API), Amazon CloudWatch Logs (operational logs), Amazon S3",
      "status": "enforced"
    },
    {
      "region": "us-east-1 (N. Virginia, USA)",
      "services": "AWS Certificate Manager: the TLS certificate CloudFront requires to be issued there. It holds no customer data.",
      "status": "enforced"
    },
    {
      "region": "CloudFront edge locations worldwide",
      "services": "Amazon CloudFront delivers durableqr.com, qr.durableqr.com (scans) and render.durableqr.com (file downloads). Scan responses are never cached. Downloaded files are cached, see below.",
      "status": "enforced"
    }
  ],
  "appeal": {
    "procedure": {
      "text": "Appeal by writing to the abuse address; a person reviews the appeal and restores the previous state when the block was wrong.",
      "status": "committed"
    },
    "contact": {
      "text": "abuse@durableqr.com",
      "status": "enforced"
    },
    "note": "Mail sent to these addresses is forwarded to DurableQR."
  },
  "export": {
    "formatVersion": 1,
    "encodings": [
      "csv",
      "jsonl"
    ],
    "checksum": "sha256",
    "columns": [
      "stable_id",
      "current_url",
      "fallback_url",
      "updated_at",
      "actor",
      "version",
      "state"
    ],
    "description": {
      "text": "The routing map file format is fully specified and published; the specification defines version 1 with CSV and JSONL encodings, SHA-256 checksums and the current record of every code, without destination history.",
      "status": "enforced"
    },
    "availability": {
      "text": "The account’s routing map can be exported from the panel and through the API.",
      "status": "enforced"
    }
  },
  "referenceResolver": {
    "url": null,
    "license": "Apache-2.0",
    "description": {
      "text": "Public release of the open-source (Apache-2.0) reference resolver for the map file format, as a separate repository, is pending.",
      "status": "committed"
    }
  }
}
