{
  "resourceType": "CodeSystem",
  "status": "draft",
  "content": "complete",
  "name": "DocumentReferenceReadonlyCS",
  "id": "document-reference-readonly",
  "title": "Document Reference Readonly Tag CodeSystem",
  "description": "Marks a `DocumentReference` as system-provisioned: a record the software creates and maintains,\nwhich a user interface must not offer to delete or rewrite. Carried as a tag on\n`DocumentReference.meta.tag`, where this is the tag's `system`. Seeded form templates -- the\ntenant-wide blanks a filled form is started from -- are the population that carries it today.\n\n**A tag, not an extension.** The address identifies the `system` of a `Coding` in `meta.tag`, which\nis why it is declared as a code system. The vocabulary is the unusual part: the codes are the\nliteral strings `true` and `false`.\n\n**Absent means not readonly, and only `true` is written.** A missing tag, the code `false`, and any\nunexpected value all mean the same thing to the readers in this estate, none of which raises an\nerror. `false` is declared because a reader has to handle it, not because a writer emits it. Codes\nare written in lower case and compared case-insensitively.\n\n**It is provenance with a UI consequence, not an authorization.** It says the system owns the record\nand will reassert it -- a deletion is undone at the next reconciliation and an edit is overwritten,\nwhich is why the actions are withheld rather than allowed to fail. It grants and withholds no\naccess; that is decided by the scopes on the request. Nor does it say anything about the document's\ncontent, its status, or whether a form filled from it may be edited.\n\n**MIGRATION.** Nexus EMR writes this tag today at\n`https://fhir.apps.health/tags/document-reference/readonly`. That address is on this guide's own\nbase but not at a published artifact path -- artifacts here are published at\n`/[artifact-type]/[artifact-id]`, and `tags` is not an artifact type -- so it is a pre-migration\naddress like any other, and is live in stored `meta.tag` codings and in code on both the server and\nthe client. Write the canonical declared here; expect both until the migration completes, and match\nboth addresses exactly rather than deriving one from the other.",
  "url": "https://fhir.apps.health/CodeSystem/document-reference-readonly",
  "concept": [
    {
      "code": "true",
      "display": "Readonly",
      "definition": "The document is system-provisioned. It is created and maintained by the software, is reasserted if removed or altered, and a user interface must not offer to delete it or rewrite its file."
    },
    {
      "code": "false",
      "display": "Not readonly",
      "definition": "The document is an ordinary chart record. Carries nothing an absent tag does not -- it exists so the flag can be cleared in place rather than by removing the coding, and a reader should treat `false` and absent as the same fact."
    }
  ],
  "experimental": false,
  "caseSensitive": false,
  "count": 2
}