# Traceability

> The degree to which a request, workflow or change can be followed end to end through correlated records.

Record: `architecture:traceability`
Kind: quality-attribute
Layer: [Observability](https://banes-lab.com/records/layer/observability.md)
Severity: mandatory
Scope: request, workflow, change
Canonical: https://banes-lab.com/ontology#architecture-traceability

Listed in [Architecture principles](https://banes-lab.com/api/records/architecture.md), after [Audit Logging](https://banes-lab.com/records/architecture/audit-logging.md) and before [Correlation ID](https://banes-lab.com/records/architecture/correlation-id.md).

## Repair

- Refactored by: Add Correlation ID, Propagate Context
- Detected by: missing correlation propagation
- Violated by: uncorrelated logs/events
- Measured by: trace completeness
- Enforced by: middleware, tracing policy

## Requires

- [Correlation ID](https://banes-lab.com/records/architecture/correlation-id.md)
- [Logs/Traces](https://banes-lab.com/records/lexicon/logs-traces.md)

## Reinforces

- [Debuggability](https://banes-lab.com/records/lexicon/debuggability.md)
- [Auditability](https://banes-lab.com/records/architecture/auditability.md)

## Enables

- [End-to-End Causality](https://banes-lab.com/records/lexicon/end-to-end-causality.md)

## Conflicts with

- [Anonymous Flow](https://banes-lab.com/records/lexicon/anonymous-flow.md)

## In tension with

- [Metadata Propagation Overhead](https://banes-lab.com/records/lexicon/metadata-propagation-overhead.md)
- [Dynamic Dispatch](https://banes-lab.com/records/architecture/dynamic-dispatch.md)
- [Choreography](https://banes-lab.com/records/architecture/choreography.md)
- [Polymorphism](https://banes-lab.com/records/architecture/polymorphism.md)
- [Chain of Responsibility Pattern](https://banes-lab.com/records/architecture/chain-of-responsibility-pattern.md)
- [Inversion of Control](https://banes-lab.com/records/architecture/inversion-of-control.md)
- [Dynamic Dispatch / Traceability](https://banes-lab.com/records/tension/dynamic-dispatch-traceability.md)
- [Choreography / Traceability](https://banes-lab.com/records/tension/choreography-traceability.md)
- [Polymorphism / Traceability](https://banes-lab.com/records/tension/polymorphism-traceability.md)
- [Chain of Responsibility Pattern / Traceability](https://banes-lab.com/records/tension/chain-of-responsibility-pattern-traceability.md)
- [Inversion of Control (IoC) / Traceability](https://banes-lab.com/records/tension/inversion-of-control-ioc-traceability.md)

## Tensions

- [Traceability / Metadata Propagation Overhead](https://banes-lab.com/records/tension/metadata-propagation-overhead-traceability.md)

## Severity

- [mandatory](https://banes-lab.com/records/vocabulary/severity-mandatory.md)

## Category

- [Observability / Auditability / Traceability](https://banes-lab.com/records/architecture-category/observability-auditability-traceability.md)

## Enforced by

- [codemods/entrypoints/specifier.target.entrypoint.ts](https://banes-lab.com/source/governance/codemods/entrypoints/specifier.target.entrypoint.ts.md)
- [codemods/validators/reference.validator.ts](https://banes-lab.com/source/governance/codemods/validators/reference.validator.ts.md)
- [runtime/entrypoints/template.entrypoint.ts](https://banes-lab.com/source/build/runtime/entrypoints/template.entrypoint.ts.md)

## Reinforced by

- [Causality](https://banes-lab.com/records/architecture/causality.md)
- [Causal Dependency](https://banes-lab.com/records/architecture/causal-dependency.md)
- [Architecture Decision Records](https://banes-lab.com/records/architecture/architecture-decision-records.md)
- [Logging](https://banes-lab.com/records/architecture/logging.md)
- [Audit Logging](https://banes-lab.com/records/architecture/audit-logging.md)
- [Dashboards](https://banes-lab.com/records/architecture/dashboards.md)

## Required by

- [Explainability](https://banes-lab.com/records/architecture/explainability.md)

## Linked from

- [Documentation is code](https://banes-lab.com/disciplined-methodology/verify/documentation-is-code.md)
- [A system is a graph](https://banes-lab.com/software-architecture/model/a-system-is-a-graph.md)
- [Runtime Discovery / Dynamic Binding](https://banes-lab.com/ontology/principles/architecture-category-runtime-discovery-dynamic-binding.md)
- [Causality / Ordering / Distributed Time](https://banes-lab.com/ontology/principles/architecture-category-causality-ordering-distributed-time.md)
- [Control / Coordination / Centralization](https://banes-lab.com/ontology/principles/architecture-category-control-coordination-centralization.md)
- [SOLID / Object-Oriented Design](https://banes-lab.com/ontology/principles/architecture-category-solid-object-oriented-design.md)
- [Architecture Review / Evolution / Governance Artifacts](https://banes-lab.com/ontology/principles/architecture-category-architecture-review-evolution-governance-artifacts.md)
- [Model Architecture](https://banes-lab.com/ontology/principles/architecture-category-model-architecture.md)
- [Observability / Auditability / Traceability](https://banes-lab.com/ontology/principles/architecture-category-observability-auditability-traceability.md)
- [Behavioral Patterns](https://banes-lab.com/ontology/principles/architecture-category-behavioral-patterns.md)
- [Plugin / Extensibility / IoC](https://banes-lab.com/ontology/principles/architecture-category-plugin-extensibility-ioc.md)
- [Observability / Auditability / Traceability](https://banes-lab.com/ontology/lexicon/lexicon-category-observability-auditability-traceability.md)
- [Quality Attributes](https://banes-lab.com/ontology/lexicon/lexicon-category-quality-attributes.md)
- [Severity levels](https://banes-lab.com/ontology/schema/the-vocabulary-severity.md)
- [The resolutions](https://banes-lab.com/ontology/schema/the-resolutions.md)