{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-controlled-side-effects",
  "id": "controlled-side-effects",
  "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": "Controlled Side Effects",
  "ref": "architecture:controlled-side-effects",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-effect-boundaries",
          "json": "https://banes-lab.com/json/records/lexicon/effect-boundaries",
          "label": "Effect Boundaries",
          "markdown": "https://banes-lab.com/records/lexicon/effect-boundaries.md",
          "ref": "lexicon:effect-boundaries"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-predictability",
          "json": "https://banes-lab.com/json/records/architecture/predictability",
          "label": "Predictability",
          "markdown": "https://banes-lab.com/records/architecture/predictability.md",
          "ref": "architecture:predictability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-testability",
          "json": "https://banes-lab.com/json/records/architecture/testability",
          "label": "Testability",
          "markdown": "https://banes-lab.com/records/architecture/testability.md",
          "ref": "architecture:testability"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-pure-core-imperative-shell",
          "json": "https://banes-lab.com/json/records/lexicon/pure-core-imperative-shell",
          "label": "Pure Core / Imperative Shell",
          "markdown": "https://banes-lab.com/records/lexicon/pure-core-imperative-shell.md",
          "ref": "lexicon:pure-core-imperative-shell"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-action-at-a-distance",
          "json": "https://banes-lab.com/json/records/architecture/action-at-a-distance",
          "label": "Action at a Distance",
          "markdown": "https://banes-lab.com/records/architecture/action-at-a-distance.md",
          "ref": "architecture:action-at-a-distance"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-hidden-side-effect",
          "json": "https://banes-lab.com/json/records/architecture/hidden-side-effect",
          "label": "Hidden Side Effect",
          "markdown": "https://banes-lab.com/records/architecture/hidden-side-effect.md",
          "ref": "architecture:hidden-side-effect"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-performance-optimization",
          "json": "https://banes-lab.com/json/records/lexicon/performance-optimization",
          "label": "Performance Optimization",
          "markdown": "https://banes-lab.com/records/lexicon/performance-optimization.md",
          "ref": "lexicon:performance-optimization"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-controlled-side-effects-performance-optimization",
          "json": "https://banes-lab.com/json/records/tension/controlled-side-effects-performance-optimization",
          "label": "Controlled Side Effects / Performance Optimization",
          "markdown": "https://banes-lab.com/records/tension/controlled-side-effects-performance-optimization.md",
          "ref": "tension:controlled-side-effects-performance-optimization"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-execution-core",
          "json": "https://banes-lab.com/json/records/algorithms/execution-core",
          "label": "Execution Core",
          "markdown": "https://banes-lab.com/records/algorithms/execution-core.md",
          "ref": "algorithms:execution-core"
        }
      ],
      "relation": "contracts"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-hidden-side-effect",
          "json": "https://banes-lab.com/json/records/architecture/hidden-side-effect",
          "label": "Hidden Side Effect",
          "markdown": "https://banes-lab.com/records/architecture/hidden-side-effect.md",
          "ref": "architecture:hidden-side-effect"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-make-effects-explicit",
          "json": "https://banes-lab.com/json/records/lexicon/make-effects-explicit",
          "label": "Make Effects Explicit",
          "markdown": "https://banes-lab.com/records/lexicon/make-effects-explicit.md",
          "ref": "lexicon:make-effects-explicit"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-separate-query-from-command",
          "json": "https://banes-lab.com/json/records/lexicon/separate-query-from-command",
          "label": "Separate Query from Command",
          "markdown": "https://banes-lab.com/records/lexicon/separate-query-from-command.md",
          "ref": "lexicon:separate-query-from-command"
        }
      ],
      "relation": "refactored-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-recommended",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-recommended",
          "label": "recommended",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-recommended.md",
          "ref": "vocabulary:severity-recommended"
        }
      ],
      "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/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md",
          "ref": "chapter:/ontology#architecture-category-anti-patterns"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology#architecture-category-correctness-determinism-verification"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-modular-design",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-modular-design.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-modular-design"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-correctness-determinism-verification",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-correctness-determinism-verification",
          "label": "Correctness / Determinism / Verification",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-correctness-determinism-verification.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-correctness-determinism-verification"
        },
        {
          "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/algorithms#algorithms-domain-architectural-clusters",
          "json": "https://banes-lab.com/json/ontology/algorithms/algorithms-domain-architectural-clusters",
          "label": "Architectural Clusters",
          "markdown": "https://banes-lab.com/ontology/algorithms/algorithms-domain-architectural-clusters.md",
          "ref": "chapter:/ontology/algorithms#algorithms-domain-architectural-clusters"
        },
        {
          "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"
    }
  ],
  "summary": "A design rule that mutation, I/O and persistence happen at declared boundaries, around a core of pure functions.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-petri-nets",
      "json": "https://banes-lab.com/json/records/architecture/petri-nets",
      "label": "Petri Nets",
      "markdown": "https://banes-lab.com/records/architecture/petri-nets.md",
      "ref": "architecture:petri-nets"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-state-isolation",
      "json": "https://banes-lab.com/json/records/architecture/state-isolation",
      "label": "State Isolation",
      "markdown": "https://banes-lab.com/records/architecture/state-isolation.md",
      "ref": "architecture:state-isolation"
    }
  },
  "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": [],
  "exemplar": {
    "after": "function nextFoo(foo: Foo): Foo { return { ...foo, count: foo.count + 1 }; }\nasync function applyFoo(foo: Foo, store: FooStore, log: Log) {\n  const next = nextFoo(foo);\n  log.write(next);\n  await store.save(next);\n  return next;\n}",
    "before": "function calculateFoo(foo: Foo) {\n  foo.count += 1;\n  fooLog.record(foo);\n  fooDb.save(foo);\n  return foo.count;\n}",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "function",
    "module",
    "boundary"
  ],
  "severity": "recommended"
}