{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-idempotency",
  "id": "idempotency",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-atomic-boundary",
    "json": "https://banes-lab.com/json/records/layer/atomic-boundary",
    "label": "Atomic Boundary",
    "markdown": "https://banes-lab.com/records/layer/atomic-boundary.md",
    "ref": "layer:atomic-boundary"
  },
  "name": "Idempotency",
  "ref": "architecture:idempotency",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-idempotency-key-or-deterministic-operation",
          "json": "https://banes-lab.com/json/records/lexicon/idempotency-key-or-deterministic-operation",
          "label": "Idempotency Key or Deterministic Operation",
          "markdown": "https://banes-lab.com/records/lexicon/idempotency-key-or-deterministic-operation.md",
          "ref": "lexicon:idempotency-key-or-deterministic-operation"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-retry-safety",
          "json": "https://banes-lab.com/json/records/lexicon/retry-safety",
          "label": "Retry Safety",
          "markdown": "https://banes-lab.com/records/lexicon/retry-safety.md",
          "ref": "lexicon:retry-safety"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-event-driven-architecture",
          "json": "https://banes-lab.com/json/records/architecture/event-driven-architecture",
          "label": "Event-Driven Architecture",
          "markdown": "https://banes-lab.com/records/architecture/event-driven-architecture.md",
          "ref": "architecture:event-driven-architecture"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-safe-retries",
          "json": "https://banes-lab.com/json/records/lexicon/safe-retries",
          "label": "Safe Retries",
          "markdown": "https://banes-lab.com/records/lexicon/safe-retries.md",
          "ref": "lexicon:safe-retries"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-non-repeatable-side-effects",
          "json": "https://banes-lab.com/json/records/lexicon/non-repeatable-side-effects",
          "label": "Non-Repeatable Side Effects",
          "markdown": "https://banes-lab.com/records/lexicon/non-repeatable-side-effects.md",
          "ref": "lexicon:non-repeatable-side-effects"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-state-tracking",
          "json": "https://banes-lab.com/json/records/lexicon/state-tracking",
          "label": "State Tracking",
          "markdown": "https://banes-lab.com/records/lexicon/state-tracking.md",
          "ref": "lexicon:state-tracking"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-idempotency-state-tracking",
          "json": "https://banes-lab.com/json/records/tension/idempotency-state-tracking",
          "label": "Idempotency / State Tracking",
          "markdown": "https://banes-lab.com/records/tension/idempotency-state-tracking.md",
          "ref": "tension:idempotency-state-tracking"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-non-idempotent-operation",
          "json": "https://banes-lab.com/json/records/lexicon/non-idempotent-operation",
          "label": "Non-Idempotent Operation",
          "markdown": "https://banes-lab.com/records/lexicon/non-idempotent-operation.md",
          "ref": "lexicon:non-idempotent-operation"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-duplicate-side-effects",
          "json": "https://banes-lab.com/json/records/lexicon/duplicate-side-effects",
          "label": "Duplicate Side Effects",
          "markdown": "https://banes-lab.com/records/lexicon/duplicate-side-effects.md",
          "ref": "lexicon:duplicate-side-effects"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-idempotency-key",
          "json": "https://banes-lab.com/json/records/lexicon/idempotency-key",
          "label": "Idempotency Key",
          "markdown": "https://banes-lab.com/records/lexicon/idempotency-key.md",
          "ref": "lexicon:idempotency-key"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-idempotent-consumer",
          "json": "https://banes-lab.com/json/records/architecture/idempotent-consumer",
          "label": "Idempotent Consumer",
          "markdown": "https://banes-lab.com/records/architecture/idempotent-consumer.md",
          "ref": "architecture:idempotent-consumer"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-mandatory",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-mandatory",
          "label": "mandatory",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-mandatory.md",
          "ref": "vocabulary:severity-mandatory"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-transactions-state-concurrency",
          "json": "https://banes-lab.com/json/records/architecture-category/transactions-state-concurrency",
          "label": "Transactions / State / Concurrency",
          "markdown": "https://banes-lab.com/records/architecture-category/transactions-state-concurrency.md",
          "ref": "architecture-category:transactions-state-concurrency"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-codemods-entrypoints-sink-entrypoint-ts",
          "json": "https://banes-lab.com/json/source/governance/codemods/entrypoints/sink.entrypoint.ts",
          "label": "codemods/entrypoints/sink.entrypoint.ts",
          "markdown": "https://banes-lab.com/source/governance/codemods/entrypoints/sink.entrypoint.ts.md",
          "ref": "anatomy:file-governance-codemods-entrypoints-sink-entrypoint-ts"
        },
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-rules-eslint-no-raw-file-write-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/no-raw-file-write.eslint.rule.ts",
          "label": "rules/eslint/no-raw-file-write.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/no-raw-file-write.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-no-raw-file-write-eslint-rule-ts"
        }
      ],
      "relation": "enforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-eventual-consistency",
          "json": "https://banes-lab.com/json/records/architecture/eventual-consistency",
          "label": "Eventual Consistency",
          "markdown": "https://banes-lab.com/records/architecture/eventual-consistency.md",
          "ref": "architecture:eventual-consistency"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-saga-pattern",
          "json": "https://banes-lab.com/json/records/architecture/saga-pattern",
          "label": "Saga Pattern",
          "markdown": "https://banes-lab.com/records/architecture/saga-pattern.md",
          "ref": "architecture:saga-pattern"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-retry-pattern",
          "json": "https://banes-lab.com/json/records/architecture/retry-pattern",
          "label": "Retry Pattern",
          "markdown": "https://banes-lab.com/records/architecture/retry-pattern.md",
          "ref": "architecture:retry-pattern"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-canonicalization",
          "json": "https://banes-lab.com/json/records/architecture/canonicalization",
          "label": "Canonicalization",
          "markdown": "https://banes-lab.com/records/architecture/canonicalization.md",
          "ref": "architecture:canonicalization"
        }
      ],
      "relation": "enabled-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/disciplined-methodology/collaborate#posting-and-waiting-are-one-operation",
          "json": "https://banes-lab.com/json/disciplined-methodology/collaborate/posting-and-waiting-are-one-operation",
          "label": "Posting and waiting are one operation",
          "markdown": "https://banes-lab.com/disciplined-methodology/collaborate/posting-and-waiting-are-one-operation.md",
          "ref": "chapter:/disciplined-methodology/collaborate#posting-and-waiting-are-one-operation"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#every-record-has-a-kind",
          "json": "https://banes-lab.com/json/software-architecture/principles/every-record-has-a-kind",
          "label": "Every record has a kind",
          "markdown": "https://banes-lab.com/software-architecture/principles/every-record-has-a-kind.md",
          "ref": "chapter:/software-architecture/principles#every-record-has-a-kind"
        },
        {
          "href": "https://banes-lab.com/software-architecture/principles#computation-and-resource",
          "json": "https://banes-lab.com/json/software-architecture/principles/computation-and-resource",
          "label": "Computation and resource",
          "markdown": "https://banes-lab.com/software-architecture/principles/computation-and-resource.md",
          "ref": "chapter:/software-architecture/principles#computation-and-resource"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-event-messaging-asynchronous-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-event-messaging-asynchronous-architecture",
          "label": "Event / Messaging / Asynchronous Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-event-messaging-asynchronous-architecture.md",
          "ref": "chapter:/ontology#architecture-category-event-messaging-asynchronous-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-error-handling-resilience",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-error-handling-resilience.md",
          "ref": "chapter:/ontology#architecture-category-error-handling-resilience"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-schema-canonical-data-semantics",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-schema-canonical-data-semantics",
          "label": "Schema / Canonical Data / Semantics",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-schema-canonical-data-semantics.md",
          "ref": "chapter:/ontology#architecture-category-schema-canonical-data-semantics"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-error-handling-resilience",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-error-handling-resilience",
          "label": "Error Handling / Resilience",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-error-handling-resilience.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-error-handling-resilience"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-event-messaging-async",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-event-messaging-async",
          "label": "Event Messaging Async",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-event-messaging-async.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-event-messaging-async"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-quality-attributes",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-quality-attributes",
          "label": "Quality Attributes",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-quality-attributes.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-quality-attributes"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-transactions-state-concurrency",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-transactions-state-concurrency",
          "label": "Transactions / State / Concurrency",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-transactions-state-concurrency.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-transactions-state-concurrency"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-rules-eslint-no-raw-file-write-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/no-raw-file-write.eslint.rule.ts",
          "label": "rules/eslint/no-raw-file-write.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/no-raw-file-write.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-no-raw-file-write-eslint-rule-ts"
        }
      ],
      "relation": "evidence"
    }
  ],
  "summary": "A design rule that repeating an operation with the same input has the same effect as running it once.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-atomicity",
      "json": "https://banes-lab.com/json/records/architecture/atomicity",
      "label": "Atomicity",
      "markdown": "https://banes-lab.com/records/architecture/atomicity.md",
      "ref": "architecture:atomicity"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-root-spine-files",
      "json": "https://banes-lab.com/json/records/architecture/root-spine-files",
      "label": "Root Spine Files",
      "markdown": "https://banes-lab.com/records/architecture/root-spine-files.md",
      "ref": "architecture:root-spine-files"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [
    "Idempotence"
  ],
  "exemplar": {
    "after": "app.post(\"/foo\", async request => {\n  const key = requireHeader(request, \"Idempotency-Key\");\n  const body = await request.json();\n  return idempotency.execute(key, () => fooStore.create(body));\n});",
    "before": "app.post(\"/foo\", async request => fooStore.create(await request.json()));",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "API",
    "command",
    "message handler"
  ],
  "severity": "mandatory"
}