{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-configuration-externalization",
  "id": "configuration-externalization",
  "kind": "principle",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-resource-core",
    "json": "https://banes-lab.com/json/records/layer/resource-core",
    "label": "Resource Core",
    "markdown": "https://banes-lab.com/records/layer/resource-core.md",
    "ref": "layer:resource-core"
  },
  "name": "Configuration Externalization",
  "ref": "architecture:configuration-externalization",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-config-schema",
          "json": "https://banes-lab.com/json/records/lexicon/config-schema",
          "label": "Config Schema",
          "markdown": "https://banes-lab.com/records/lexicon/config-schema.md",
          "ref": "lexicon:config-schema"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-secure-config-handling",
          "json": "https://banes-lab.com/json/records/lexicon/secure-config-handling",
          "label": "Secure Config Handling",
          "markdown": "https://banes-lab.com/records/lexicon/secure-config-handling.md",
          "ref": "lexicon:secure-config-handling"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-portability",
          "json": "https://banes-lab.com/json/records/architecture/portability",
          "label": "Portability",
          "markdown": "https://banes-lab.com/records/architecture/portability.md",
          "ref": "architecture:portability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-environment-parity",
          "json": "https://banes-lab.com/json/records/architecture/environment-parity",
          "label": "Environment Parity",
          "markdown": "https://banes-lab.com/records/architecture/environment-parity.md",
          "ref": "architecture:environment-parity"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-environment-specific-deployment",
          "json": "https://banes-lab.com/json/records/lexicon/environment-specific-deployment",
          "label": "Environment-Specific Deployment",
          "markdown": "https://banes-lab.com/records/lexicon/environment-specific-deployment.md",
          "ref": "lexicon:environment-specific-deployment"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-hardcoded-configuration",
          "json": "https://banes-lab.com/json/records/architecture/hardcoded-configuration",
          "label": "Hardcoded Configuration",
          "markdown": "https://banes-lab.com/records/architecture/hardcoded-configuration.md",
          "ref": "architecture:hardcoded-configuration"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-config-sprawl",
          "json": "https://banes-lab.com/json/records/lexicon/config-sprawl",
          "label": "Config Sprawl",
          "markdown": "https://banes-lab.com/records/lexicon/config-sprawl.md",
          "ref": "lexicon:config-sprawl"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-config-sprawl-configuration-externalization",
          "json": "https://banes-lab.com/json/records/tension/config-sprawl-configuration-externalization",
          "label": "Configuration Externalization / Config Sprawl",
          "markdown": "https://banes-lab.com/records/tension/config-sprawl-configuration-externalization.md",
          "ref": "tension:config-sprawl-configuration-externalization"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-hardcoded-configuration",
          "json": "https://banes-lab.com/json/records/architecture/hardcoded-configuration",
          "label": "Hardcoded Configuration",
          "markdown": "https://banes-lab.com/records/architecture/hardcoded-configuration.md",
          "ref": "architecture:hardcoded-configuration"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-externalize-configuration",
          "json": "https://banes-lab.com/json/records/lexicon/externalize-configuration",
          "label": "Externalize Configuration",
          "markdown": "https://banes-lab.com/records/lexicon/externalize-configuration.md",
          "ref": "lexicon:externalize-configuration"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-validate-at-the-boundary",
          "json": "https://banes-lab.com/json/records/lexicon/validate-at-the-boundary",
          "label": "Validate at the Boundary",
          "markdown": "https://banes-lab.com/records/lexicon/validate-at-the-boundary.md",
          "ref": "lexicon:validate-at-the-boundary"
        }
      ],
      "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-portability-infrastructure-deployment",
          "json": "https://banes-lab.com/json/records/architecture-category/portability-infrastructure-deployment",
          "label": "Portability / Infrastructure / Deployment",
          "markdown": "https://banes-lab.com/records/architecture-category/portability-infrastructure-deployment.md",
          "ref": "architecture-category:portability-infrastructure-deployment"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/anatomy/governance#file-governance-rules-eslint-no-port-literal-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/no-port-literal.eslint.rule.ts",
          "label": "rules/eslint/no-port-literal.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/no-port-literal.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-no-port-literal-eslint-rule-ts"
        }
      ],
      "relation": "enforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/pag/guide#tool-invocation",
          "json": "https://banes-lab.com/json/pag/guide/tool-invocation",
          "label": "Semantic operations",
          "markdown": "https://banes-lab.com/pag/guide/tool-invocation.md",
          "ref": "chapter:/pag/guide#tool-invocation"
        },
        {
          "href": "https://banes-lab.com/disciplined-methodology#the-behavior-document",
          "json": "https://banes-lab.com/json/disciplined-methodology/start/the-behavior-document",
          "label": "The behavior document",
          "markdown": "https://banes-lab.com/disciplined-methodology/start/the-behavior-document.md",
          "ref": "chapter:/disciplined-methodology#the-behavior-document"
        },
        {
          "href": "https://banes-lab.com/disciplined-methodology#onboarding",
          "json": "https://banes-lab.com/json/disciplined-methodology/start/onboarding",
          "label": "The drop-in",
          "markdown": "https://banes-lab.com/disciplined-methodology/start/onboarding.md",
          "ref": "chapter:/disciplined-methodology#onboarding"
        },
        {
          "href": "https://banes-lab.com/disciplined-methodology/build#one-home",
          "json": "https://banes-lab.com/json/disciplined-methodology/build/one-home",
          "label": "One home",
          "markdown": "https://banes-lab.com/disciplined-methodology/build/one-home.md",
          "ref": "chapter:/disciplined-methodology/build#one-home"
        },
        {
          "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-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-portability-infrastructure-deployment",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-portability-infrastructure-deployment",
          "label": "Portability / Infrastructure / Deployment",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-portability-infrastructure-deployment.md",
          "ref": "chapter:/ontology#architecture-category-portability-infrastructure-deployment"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-control-coordination-centralization",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-control-coordination-centralization",
          "label": "Control / Coordination / Centralization",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-control-coordination-centralization.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-control-coordination-centralization"
        },
        {
          "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-portability-infrastructure-deployment",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-portability-infrastructure-deployment",
          "label": "Portability / Infrastructure / Deployment",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-portability-infrastructure-deployment.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-portability-infrastructure-deployment"
        },
        {
          "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-port-literal-eslint-rule-ts",
          "json": "https://banes-lab.com/json/source/governance/rules/eslint/no-port-literal.eslint.rule.ts",
          "label": "rules/eslint/no-port-literal.eslint.rule.ts",
          "markdown": "https://banes-lab.com/source/governance/rules/eslint/no-port-literal.eslint.rule.ts.md",
          "ref": "anatomy:file-governance-rules-eslint-no-port-literal-eslint-rule-ts"
        }
      ],
      "relation": "evidence"
    }
  ],
  "summary": "A design rule that environment-specific values are read from validated external configuration at startup.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-immutable-infrastructure",
      "json": "https://banes-lab.com/json/records/architecture/immutable-infrastructure",
      "label": "Immutable Infrastructure",
      "markdown": "https://banes-lab.com/records/architecture/immutable-infrastructure.md",
      "ref": "architecture:immutable-infrastructure"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-protocol-independence",
      "json": "https://banes-lab.com/json/records/architecture/protocol-independence",
      "label": "Protocol Independence",
      "markdown": "https://banes-lab.com/records/architecture/protocol-independence.md",
      "ref": "architecture:protocol-independence"
    }
  },
  "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": [
    "Externalized Configuration"
  ],
  "exemplar": {
    "after": "type FooConfig = Readonly<{ fooUrl: URL; retries: number }>;\nconst config = FooConfigSchema.parse({\n  fooUrl: process.env.FOO_URL,\n  retries: process.env.FOO_RETRIES,\n});",
    "before": "const config = {\n  fooUrl: \"https://foo.prod.example\",\n  retries: 3,\n};",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "application",
    "deployment",
    "runtime"
  ],
  "severity": "mandatory"
}