{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-replaceability",
  "id": "replaceability",
  "kind": "quality-attribute",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-structural-core",
    "json": "https://banes-lab.com/json/records/layer/structural-core",
    "label": "Structural Core",
    "markdown": "https://banes-lab.com/records/layer/structural-core.md",
    "ref": "layer:structural-core"
  },
  "name": "Replaceability",
  "ref": "architecture:replaceability",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-stable-interfaces",
          "json": "https://banes-lab.com/json/records/architecture/stable-interfaces",
          "label": "Stable Interfaces",
          "markdown": "https://banes-lab.com/records/architecture/stable-interfaces.md",
          "ref": "architecture:stable-interfaces"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-low-coupling",
          "json": "https://banes-lab.com/json/records/architecture/low-coupling",
          "label": "Low Coupling",
          "markdown": "https://banes-lab.com/records/architecture/low-coupling.md",
          "ref": "architecture:low-coupling"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-dependency-inversion",
          "json": "https://banes-lab.com/json/records/architecture/dependency-inversion",
          "label": "Dependency Inversion Principle (DIP)",
          "markdown": "https://banes-lab.com/records/architecture/dependency-inversion.md",
          "ref": "architecture:dependency-inversion"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-ports-and-adapters-architecture",
          "json": "https://banes-lab.com/json/records/architecture/ports-and-adapters-architecture",
          "label": "Ports and Adapters Architecture",
          "markdown": "https://banes-lab.com/records/architecture/ports-and-adapters-architecture.md",
          "ref": "architecture:ports-and-adapters-architecture"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-vendor-swap",
          "json": "https://banes-lab.com/json/records/lexicon/vendor-swap",
          "label": "Vendor Swap",
          "markdown": "https://banes-lab.com/records/lexicon/vendor-swap.md",
          "ref": "lexicon:vendor-swap"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-plugin-architecture",
          "json": "https://banes-lab.com/json/records/architecture/plugin-architecture",
          "label": "Plugin Architecture",
          "markdown": "https://banes-lab.com/records/architecture/plugin-architecture.md",
          "ref": "architecture:plugin-architecture"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-concrete-coupling",
          "json": "https://banes-lab.com/json/records/architecture/concrete-coupling",
          "label": "Concrete Coupling",
          "markdown": "https://banes-lab.com/records/architecture/concrete-coupling.md",
          "ref": "architecture:concrete-coupling"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-deep-optimization",
          "json": "https://banes-lab.com/json/records/lexicon/deep-optimization",
          "label": "Deep Optimization",
          "markdown": "https://banes-lab.com/records/lexicon/deep-optimization.md",
          "ref": "lexicon:deep-optimization"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-deep-optimization-replaceability",
          "json": "https://banes-lab.com/json/records/tension/deep-optimization-replaceability",
          "label": "Replaceability / Deep Optimization",
          "markdown": "https://banes-lab.com/records/tension/deep-optimization-replaceability.md",
          "ref": "tension:deep-optimization-replaceability"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-vendor-lock-in-leakage",
          "json": "https://banes-lab.com/json/records/architecture/vendor-lock-in-leakage",
          "label": "Vendor Lock-In Leakage",
          "markdown": "https://banes-lab.com/records/architecture/vendor-lock-in-leakage.md",
          "ref": "architecture:vendor-lock-in-leakage"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-introduce-port",
          "json": "https://banes-lab.com/json/records/lexicon/introduce-port",
          "label": "Introduce Port",
          "markdown": "https://banes-lab.com/records/lexicon/introduce-port.md",
          "ref": "lexicon:introduce-port"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-extract-adapter",
          "json": "https://banes-lab.com/json/records/lexicon/extract-adapter",
          "label": "Extract Adapter",
          "markdown": "https://banes-lab.com/records/lexicon/extract-adapter.md",
          "ref": "lexicon:extract-adapter"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-invert-dependency",
          "json": "https://banes-lab.com/json/records/lexicon/invert-dependency",
          "label": "Invert Dependency",
          "markdown": "https://banes-lab.com/records/lexicon/invert-dependency.md",
          "ref": "lexicon:invert-dependency"
        }
      ],
      "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-core-modular-design",
          "json": "https://banes-lab.com/json/records/architecture-category/core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/records/architecture-category/core-modular-design.md",
          "ref": "architecture-category:core-modular-design"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-explicit-boundaries",
          "json": "https://banes-lab.com/json/records/architecture/explicit-boundaries",
          "label": "Explicit Boundaries",
          "markdown": "https://banes-lab.com/records/architecture/explicit-boundaries.md",
          "ref": "architecture:explicit-boundaries"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-single-responsibility",
          "json": "https://banes-lab.com/json/records/architecture/single-responsibility",
          "label": "Single Responsibility Principle",
          "markdown": "https://banes-lab.com/records/architecture/single-responsibility.md",
          "ref": "architecture:single-responsibility"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-separation-of-concerns",
          "json": "https://banes-lab.com/json/records/architecture/separation-of-concerns",
          "label": "Separation of Concerns",
          "markdown": "https://banes-lab.com/records/architecture/separation-of-concerns.md",
          "ref": "architecture:separation-of-concerns"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-high-cohesion",
          "json": "https://banes-lab.com/json/records/architecture/high-cohesion",
          "label": "High Cohesion",
          "markdown": "https://banes-lab.com/records/architecture/high-cohesion.md",
          "ref": "architecture:high-cohesion"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-abstraction",
          "json": "https://banes-lab.com/json/records/architecture/abstraction",
          "label": "Abstraction",
          "markdown": "https://banes-lab.com/records/architecture/abstraction.md",
          "ref": "architecture:abstraction"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-modularity",
          "json": "https://banes-lab.com/json/records/architecture/modularity",
          "label": "Modularity",
          "markdown": "https://banes-lab.com/records/architecture/modularity.md",
          "ref": "architecture:modularity"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-dependency-injection",
          "json": "https://banes-lab.com/json/records/architecture/dependency-injection",
          "label": "Dependency Injection",
          "markdown": "https://banes-lab.com/records/architecture/dependency-injection.md",
          "ref": "architecture:dependency-injection"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-component-based-architecture",
          "json": "https://banes-lab.com/json/records/architecture/component-based-architecture",
          "label": "Component-Based Architecture",
          "markdown": "https://banes-lab.com/records/architecture/component-based-architecture.md",
          "ref": "architecture:component-based-architecture"
        }
      ],
      "relation": "enabled-by"
    },
    {
      "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-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"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-information-hiding",
          "json": "https://banes-lab.com/json/records/architecture/information-hiding",
          "label": "Information Hiding",
          "markdown": "https://banes-lab.com/records/architecture/information-hiding.md",
          "ref": "architecture:information-hiding"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-composition-over-inheritance",
          "json": "https://banes-lab.com/json/records/architecture/composition-over-inheritance",
          "label": "Composition Over Inheritance",
          "markdown": "https://banes-lab.com/records/architecture/composition-over-inheritance.md",
          "ref": "architecture:composition-over-inheritance"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-interchangeability",
          "json": "https://banes-lab.com/json/records/architecture/interchangeability",
          "label": "Interchangeability",
          "markdown": "https://banes-lab.com/records/architecture/interchangeability.md",
          "ref": "architecture:interchangeability"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-adapter-pattern",
          "json": "https://banes-lab.com/json/records/architecture/adapter-pattern",
          "label": "Adapter Pattern",
          "markdown": "https://banes-lab.com/records/architecture/adapter-pattern.md",
          "ref": "architecture:adapter-pattern"
        }
      ],
      "relation": "reinforced-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/software-architecture/principles#principles-are-typed",
          "json": "https://banes-lab.com/json/software-architecture/principles/principles-are-typed",
          "label": "Principles are typed",
          "markdown": "https://banes-lab.com/software-architecture/principles/principles-are-typed.md",
          "ref": "chapter:/software-architecture/principles#principles-are-typed"
        },
        {
          "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-domain-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-domain-architecture",
          "label": "Domain Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-domain-architecture.md",
          "ref": "chapter:/ontology#architecture-category-domain-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology#architecture-category-contracts-interfaces-compatibility"
        },
        {
          "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#architecture-category-core-modular-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-core-modular-design",
          "label": "Core Modular Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-core-modular-design.md",
          "ref": "chapter:/ontology#architecture-category-core-modular-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-solid-object-oriented-design",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-solid-object-oriented-design",
          "label": "SOLID / Object-Oriented Design",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-solid-object-oriented-design.md",
          "ref": "chapter:/ontology#architecture-category-solid-object-oriented-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-structural-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-structural-patterns",
          "label": "Structural Patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-structural-patterns.md",
          "ref": "chapter:/ontology#architecture-category-structural-patterns"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-plugin-extensibility-ioc",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-plugin-extensibility-ioc",
          "label": "Plugin / Extensibility / IoC",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-plugin-extensibility-ioc.md",
          "ref": "chapter:/ontology#architecture-category-plugin-extensibility-ioc"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-codebase-system-architecture-styles",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-codebase-system-architecture-styles",
          "label": "Codebase / System Architecture Styles",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-codebase-system-architecture-styles.md",
          "ref": "chapter:/ontology#architecture-category-codebase-system-architecture-styles"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-codebase-system-architecture-styles",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-codebase-system-architecture-styles",
          "label": "Codebase / System Architecture Styles",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-codebase-system-architecture-styles.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-codebase-system-architecture-styles"
        },
        {
          "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-solid-object-oriented-design",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-solid-object-oriented-design",
          "label": "SOLID / Object-Oriented Design",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-solid-object-oriented-design.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-solid-object-oriented-design"
        },
        {
          "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": "The degree to which a component can be swapped for another implementation of its interface without editing its callers.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-interchangeability",
      "json": "https://banes-lab.com/json/records/architecture/interchangeability",
      "label": "Interchangeability",
      "markdown": "https://banes-lab.com/records/architecture/interchangeability.md",
      "ref": "architecture:interchangeability"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-reusability",
      "json": "https://banes-lab.com/json/records/architecture/reusability",
      "label": "Reusability",
      "markdown": "https://banes-lab.com/records/architecture/reusability.md",
      "ref": "architecture:reusability"
    }
  },
  "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": "class FooService {\n  constructor(private readonly store: FooStore) {}\n  save(foo: Foo) { return this.store.save(foo); }\n}\ntest(\"saves without a database\", async () => {\n  const store = new MemoryFooStore();\n  await new FooService(store).save(foo);\n  expect(store.find(foo.id)).toEqual(foo);\n});",
    "before": "class FooService {\n  private readonly store = new SqlFooStore();\n  save(foo: Foo) { return this.store.save(foo); }\n}",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "component",
    "service",
    "infrastructure"
  ],
  "severity": "recommended"
}