Lineage and impact

How to Build a Lineage-Based Migration Readiness Score Without Hiding Risk

By Dzmitryi Kharlanau · Published · 21 min read

A migration dashboard shows:

Contents

Reviewed: 14 July 2026

A migration dashboard shows:

Overall readiness: 92%

The programme reports green status.

Most fields are mapped.

Most records load successfully.

Most validation checks pass.

Then the details emerge:

The score is mathematically correct according to its formula.

It is operationally misleading.

The main problem is not that readiness was calculated.

The problem is that weak and strong evidence, critical and optional fields, direct and fallback paths, and blockers and warnings were averaged into one reassuring number.

A migration-readiness score should summarise evidence without allowing aggregation to hide a critical break in lineage.

Lineage provides a better foundation than simple field-completion metrics because it evaluates the whole path:

source
→ dataset
→ Mapping
→ business Attribute
→ SAP endpoint
→ Rule
→ evidence
→ downstream use

A target field can be populated while this path remains incomplete.

A Mapping can exist while its source is unavailable.

A Rule can be documented while its implementation has not been tested.

A fallback can improve completeness while increasing business risk.

A serious readiness score must reflect those differences.

Martenweave already positions deterministic validation, dataset-gap detection, lineage, impact analysis and human-approved PatchProposals as parts of one backend-first governance pipeline. It also exposes health and scorecard commands alongside dataset-readiness, trace and impact operations.

The correct next step is not to create a more decorative dashboard.

It is to define a score whose components remain explainable and whose blockers cannot be averaged away.

---

Readiness is not completeness

Completeness asks:

Is a value present?

Readiness asks:

Is the value available, correctly interpreted, properly transformed, valid for the target context, supported by evidence and safe to use?

Consider Product Plant MRP Type.

A load file contains a nonblank value for every Product Plant record.

Completeness is 100 percent.

But suppose:

The target field is complete.

The migration path is not fully ready.

A readiness score should therefore separate:

technical completeness
from
governed conformance

The first is useful.

The second determines whether the result can be trusted.

---

A score is a summary, not a verdict

One number can help compare:

It should not replace the underlying findings.

A score of 84 may result from:

These situations require different decisions.

Every score should therefore be accompanied by:

The number helps navigation.

The findings govern release decisions.

---

Start with a readiness verdict

Before calculating a percentage, define the possible verdicts.

A practical set is:

Ready

No blocking condition exists. Critical paths are sufficiently evidenced for the declared scope.

Ready with warnings

No blocker exists, but bounded risks or incomplete low-criticality evidence remain.

Conditionally ready

Release is possible only under explicit conditions, temporary controls or accepted residual risk.

Blocked

At least one release-gate condition is unresolved.

Not assessed

Evidence is too incomplete to provide a defensible verdict.

Martenweave’s current dataset-readiness workflow already produces ready, ready_with_warnings or blocked outcomes while combining validation, indexing, profiling and gap detection.

A broader lineage-based model can extend this pattern without reducing everything to a percentage.

---

Blockers must override averages

Suppose a Supplier migration receives these scores:

DimensionScore
Source availability98
Mapping coverage96
Target persistence99
Evidence coverage90
Downstream verification88

The weighted result may be 95.

Now add one condition:

Supplier bank-account ownership is not verified
for 3,400 active suppliers.

The migration should not become ready because unrelated dimensions score well.

The correct result may be:

Score: 95
Verdict: Blocked
Reason: Critical bank-data ownership control unresolved

This is not contradictory.

The score measures aggregate preparation.

The verdict applies release policy.

---

Define critical-path assertions first

A readiness model should begin with deterministic assertions, not weights.

Examples:

Every mandatory SAP target Attribute
must have at least one approved source or creation path.
Every critical Mapping
must have current evidence for its required context.
No active fallback may be used outside its approved scope.
Every Supplier bank account
must have a traceable ownership and validation path.
Every Product Plant record
must contain the organisational keys required by its Mapping.
Every production interface consuming a changed value list
must have compatibility evidence.

If a critical assertion fails, the verdict may be blocked regardless of the numerical score.

---

Readiness dimensions

A lineage-based score can use several dimensions.

The precise weights can vary by programme, but the dimensions should remain stable and interpretable.

1. Model integrity

Does the canonical model validate?

Checks include:

This is the foundation.

A model with broken references should not receive a reliable readiness score.

2. Source readiness

Are the required source fields, keys and contexts available?

Checks include:

3. Mapping readiness

Can approved Mappings produce the target values for the intended population?

Checks include:

4. Rule readiness

Are required controls defined, implemented and tested?

Checks include:

5. Target readiness

Can the SAP target represent and persist the governed result?

Checks include:

6. Evidence readiness

Is the path verified for the current baseline and scope?

Checks include:

7. Downstream readiness

Will consuming systems and processes interpret the result correctly?

Checks include:

8. Operational readiness

Can cutover and hypercare manage remaining exceptions?

Checks include:

A score that measures only source fields and target loads misses most of these dimensions.

---

Do not assign equal weight to every field

One missing optional Product description is not equivalent to:

Objects need criticality.

A simple criticality model might include:

Critical

Failure blocks migration or creates unacceptable legal, financial, operational or integrity risk.

High

Failure materially affects core processes or large populations.

Medium

Failure creates controlled operational degradation or manual work.

Low

Failure affects convenience, description or nonessential reporting.

This criticality should influence both:

A critical failure may block.

A low-criticality failure may reduce the score without blocking.

---

Criticality belongs to a business path

Avoid rating only the physical SAP field.

For example:

Supplier Bank Account

may be critical for active payable suppliers but irrelevant for prospects not yet approved for payment.

MRP Type

may be critical for manufacturing plants but low priority for nonstock products.

Tax Identifier

may be mandatory in one country and conditional in another.

Criticality should therefore be scoped by:

---

Example 1: Supplier bank-data readiness

A Supplier Bank Account readiness assessment might include:

Model integrity

Source readiness

Mapping readiness

Rule readiness

Evidence readiness

Operational readiness

Possible outcome:

Aggregate score: 93

Verdict: Blocked

Critical finding:
Bank ownership not verified for 680 payment-active suppliers.

The score shows substantial progress.

The verdict prevents false confidence.

---

Example 2: Product units of measure

For Product units of measure, the critical path may include:

source unit
→ canonical unit meaning
→ conversion ratio
→ SAP base and alternative units
→ sales or warehouse interface

Readiness dimensions include:

A Product might load successfully with:

Base unit: PC
Alternative unit: BOX

while the conversion ratio is missing.

Field completeness appears high.

Operational readiness is low.

A useful score penalises the missing transformation relationship more heavily than an absent marketing description.

---

Example 3: Cost Centre validity

Cost Centre readiness requires more than object creation.

The path includes:

source Cost Centre
+
controlling area
+
valid-from date
+
valid-to date
+
responsible organisational context
→ SAP Cost Centre

A mock load may create all records.

Readiness should still assess:

Possible result:

Object creation: 100%
Validity at go-live: 94%
Posting verification: 82%
Hierarchy assignment: 97%

Verdict: Blocked

Why blocked?

Because 6 percent of active Cost Centres cannot receive postings on the planned go-live date.

The overall percentage should not conceal that.

---

Example 4: Customer partner functions

A readiness model for partner functions should not count only partner records.

It should evaluate:

A load may reconcile 100 percent of source rows.

But if Bill-to and Payer were reversed for one sales organisation, the migration is not ready.

Suggested dimension scores:

DimensionScore
Source field availability100
Key Mapping96
Role conversion89
Target persistence99
Mandatory-role conformance84
Business sample approval72

Verdict:

Conditionally ready

Condition:

Resolve Payer/Bill-to conversion for Sales Organisation 2200.

---

Example 5: Supplier tax identifiers

Tax-Identifier readiness should distinguish:

Possible results:

Presence: 98%
Format: 97%
Country/category match: 88%
Legal evidence: 76%
Target persistence: 99%

A naive average gives 92.

That may still be blocked if the programme cannot determine which tax category applies to a critical country population.

The category problem is semantic.

Target completeness does not compensate for it.

---

Example 6: Product profit centre

Profit centre derivation may depend on:

plant
+
product family
+
company structure
→ profit centre

Readiness should assess:

A default regional Profit Centre may improve completeness from 91 to 100 percent.

The readiness score should not reward it without qualification.

Instead:

Target completeness: 100%
Approved derivation: 91%
Temporary fallback: 9%
Verdict: Ready with conditions

Condition:

Fallback population must be remediated before first month-end close.

---

Score lineage paths, not only objects

A FieldEndpoint may be valid.

A Mapping may be valid.

A Rule may be valid.

Yet the complete path may still fail.

Example:

source Product Status
→ Mapping
→ Product Lifecycle Status
→ SAP endpoint

All objects exist.

But the source population covers only active products, while the target scope includes discontinued products.

The path has a coverage gap.

Readiness should therefore evaluate path assertions such as:

A path receives readiness only when these conditions align.

---

Path-level readiness states

A useful path classification can include:

Complete

All required components and current evidence are present.

Complete with controlled fallback

The path relies on an approved fallback within declared scope.

Partially covered

Only part of the intended population has a valid path.

Unverified

The design path exists but current evidence is missing.

Nonconformant

Observed behaviour differs from approved lineage.

Broken

A required source, Mapping, context or target is unavailable.

These path states can feed the aggregate score.

They should also remain visible individually.

---

Evidence confidence must affect the score

A path supported by:

is stronger than one supported by:

Possible confidence levels:

High

Current, reproducible and reviewed evidence.

Medium

Current but partial evidence, or reviewed evidence with limited scope.

Low

Indirect, stale, incomplete or unreviewed evidence.

None

No supporting evidence.

A score can include an evidence-confidence factor.

However, low confidence for a critical path should often change the verdict to not assessed or blocked, rather than merely reducing the percentage slightly.

---

Evidence age should not be treated uniformly

A six-month-old source profile may still be useful for a stable reference table.

A one-week-old interface test may be stale if:

Evidence freshness should depend on model changes, not only calendar age.

An Evidence object becomes stale when its tested assumptions no longer match the current baseline.

---

Scoring fallbacks

Fallbacks need separate treatment.

A readiness formula that treats:

value successfully produced

as full credit will reward defaults and manual workarounds.

Instead, classify fallback quality.

Approved equivalent fallback

Nearly full readiness credit.

Example:

Approved transformable fallback

Reduced credit until transformation and reconciliation are verified.

Manual governed fallback

Partial credit, limited by capacity and evidence.

Approximate fallback

Low credit and likely conditional readiness.

Undocumented fallback

No readiness credit and possible blocker.

Expired fallback

Blocker for affected critical scope.

This keeps technical completeness from disguising weak provenance.

---

Example 7: Business Partner time zone

A migration derives Time Zone from country.

For countries with one time zone, this may be reliable.

For countries with several time zones, it is approximate.

A readiness report might show:

Direct source value: 61%
Deterministic country derivation: 24%
Regional derivation: 10%
Approximate country default: 5%

The field is 100 percent populated.

Path readiness is lower.

The five-percent approximate population should remain visible by country and risk.

---

Example 8: Product serial-number profile

Serial-number profile affects operational processing.

Readiness may require:

A wrong profile may not prevent product creation.

It can break warehouse or delivery execution after go-live.

Therefore, the downstream-process dimension may carry more weight than simple target persistence.

This is a good example of a field whose migration risk appears only after examining the process lineage.

---

Example 9: Supplier purchasing block

A Supplier may have several block types:

A readiness score that groups them as “Supplier Block” can be misleading.

The score should assess:

A complete target field with the wrong block type is worse than a missing optional field.

---

Example 10: Customer shipping condition

Shipping Condition may be sourced from:

Readiness should verify:

A score based only on nonblank target values will miss incorrect logistics behaviour.

---

Avoid one universal formula

Different migration domains have different risk structures.

Supplier bank data should emphasise:

Product planning data should emphasise:

Tax data should emphasise:

Partner functions should emphasise:

The score framework should remain consistent.

Dimension weights and blockers should be domain-specific.

---

A two-layer scoring model

A practical approach uses two layers.

Layer 1: release gates

Boolean or categorical conditions.

Examples:

These determine the verdict.

Layer 2: weighted readiness dimensions

Used to measure progress and compare areas.

Example:

Model integrity: 15%
Source readiness: 15%
Mapping readiness: 20%
Rule readiness: 10%
Target readiness: 10%
Evidence readiness: 15%
Downstream readiness: 10%
Operational readiness: 5%

The exact numbers should be configurable.

The two-layer model prevents a high aggregate score from overriding a failed gate.

---

Example formula

For each path, a score might be based on:

Path readiness =
model integrity
× source factor
× Mapping factor
× target factor
× evidence factor

A multiplicative approach reflects an important principle:

A missing essential component can make the path unusable.

If source readiness is zero, the path should not receive a high score because its target and documentation are excellent.

At a higher level, dimension scores can be aggregated using weights.

The calculation should remain transparent.

---

Why multiplication can be useful

Consider:

Source readiness: 0.2
Mapping readiness: 1.0
Target readiness: 1.0
Evidence readiness: 0.8

A simple average gives:

0.75

That suggests moderate readiness.

A multiplicative result gives:

0.16

This better reflects that the path lacks usable source coverage.

However, multiplication can also become too punitive for partial evidence.

The correct approach may combine:

The formula should reflect programme policy, not mathematical elegance.

---

Use floors for essential dimensions

Another approach is to limit the final score by the weakest essential dimension.

Example:

Aggregate weighted score: 91
Lowest essential dimension: 54
Final displayed score: 54

This makes bottlenecks visible.

Possible essential dimensions:

A domain can choose which dimensions are essential.

---

Do not hide denominators

A readiness percentage should always expose what was counted.

Example:

Mapping readiness: 92%

should explain:

46 of 50 critical Mapping paths verified

not only the percentage.

Also show:

A score can rise artificially when hard objects are moved to “out of scope.”

Scope changes should be reviewed.

---

Population-weighted and object-weighted scores

These answer different questions.

Object-weighted

Each Attribute or Mapping contributes equally.

Useful for model completeness.

Population-weighted

Contribution depends on affected record count.

Useful for operational exposure.

Example:

Object-weighted scoring may make the second situation look worse.

Population-weighted scoring shows the first has greater exposure.

A mature report should show both.

---

Criticality-weighted score

Criticality weighting focuses on business importance.

Example:

Missing optional Product subtitle:
low weight

Missing Supplier bank country:
critical weight

This helps prioritisation.

It should not replace population weighting.

A critical issue affecting one record may still require a block.

---

Three parallel views

A useful scorecard can show:

Model view

How many objects and paths are structurally ready?

Population view

How many records are covered by ready paths?

Risk view

How much critical business exposure remains?

Example:

ViewScore
Model readiness91
Population coverage97
Critical risk readiness68

This is more informative than one blended figure.

---

Example 11: Product Plant planning data

Suppose:

Possible views:

Field completeness: 95
Model-path readiness: 86
Population readiness: 92
Critical risk readiness: 71
Verdict: Conditionally ready

Condition:

Remove or formally approve the temporary MRP Controller fallback
before the first production planning cycle.

---

Example 12: Finance payment terms

Payment Terms readiness may score highly because the field is widely populated.

But analysis finds:

Possible report:

Technical completeness: 99
Contextual Mapping readiness: 74
Owner acceptance: 63
Population affected: 18%
Verdict: Blocked for acquired-company population

The migration object may remain ready for other populations.

Readiness should support scoped verdicts.

---

Scoped readiness

Avoid declaring an entire domain ready or blocked when only one context is affected.

Possible scopes:

Example:

Supplier domain:
Ready with warnings

Portugal tax scope:
Blocked

Germany bank-data scope:
Ready

Acquired-company payment terms:
Conditionally ready

This allows proportionate decisions without hiding local blockers.

---

Readiness aggregation hierarchy

Scores can roll up through several levels:

Field or Rule
→ lineage path
→ business Attribute
→ Entity
→ migration object
→ domain
→ wave
→ programme

Every roll-up should preserve:

The programme score should never erase a blocked lower-level critical path.

---

Red, amber and green need definitions

Colour alone is not governance.

Define thresholds and gates.

Example:

Green

Amber

Red

A score of 91 can still be red if a critical gate fails.

This should be intentional, not treated as a dashboard defect.

---

Unknown is not green

Many programmes score only what has been assessed.

Unassessed objects disappear from the denominator.

This inflates readiness.

Use an explicit state:

Not assessed

Critical unassessed paths should reduce evidence coverage and may block release.

The organisation should not receive readiness credit for missing information.

---

Evidence confidence and uncertainty

A score should expose uncertainty.

Example:

Readiness score: 82
Evidence confidence: Low

This is materially different from:

Readiness score: 82
Evidence confidence: High

Confidence may depend on:

---

Readiness trends

Trend is useful when interpreted carefully.

Example:

Mock Load 1: 54
Mock Load 2: 68
Mock Load 3: 79
Cutover rehearsal: 83

The trend suggests progress.

But the report should also show:

A score can drop because the model became more honest.

That may be progress.

---

Do not optimise for the score

Once a metric becomes a target, teams may:

Controls should include:

The score is an instrument.

It should not become a game.

---

Score-policy versioning

When weights, thresholds or blockers change, record the policy version.

Example:

Readiness policy:
MW-READINESS-2.1

A score of 82 under one policy may not be comparable to 82 under another.

Store:

---

Score explanations

For every result, produce a concise explanation.

Weak:

Product readiness: 73

Stronger:

Product readiness: 73

Primary constraints:
- MRP Controller fallback used for 12% of Product Plant records
- serial-number profile not tested in warehouse process
- three plant mappings lack current evidence

Blockers:
none

Verdict:
Ready with conditions

The explanation should be generated from structured findings, not manually rewritten each time.

---

Recommended scorecard layout

Overall verdict

Conditionally ready

Overall score

81 / 100

Confidence

Medium

Blocking conditions

None

Release conditions

- Resolve Cost Centre validity for company code 3100
- Reconcile temporary Product profit-centre fallback before month-end

Dimension scores

DimensionScore
Model integrity98
Source readiness86
Mapping readiness78
Rule readiness84
Target readiness95
Evidence readiness69
Downstream readiness71
Operational readiness80

Critical low points

Trend

+6 since Mock Load 3

Scope

Wave 1, Germany and Portugal

---

Release-gate examples

Supplier bank data

Block when:

Product planning

Block when:

Tax data

Block when:

Cost Centres

Block when:

Partner functions

Block when:

These gates should be domain policy, not ad hoc dashboard interpretation.

---

Readiness findings should produce action

Each low score or failed gate should identify:

Example:

Finding:
Product Plant MRP Controller fallback exceeds approved scope

Affected path:
Legacy Planner Group
→ MRP Controller Mapping
→ Product Plant MRP Controller

Scope:
PL20, PL30

Population:
8,420 records

Owner:
Production Planning Data Lead

Action:
Provide plant-specific conversion or approve bounded fallback

The score points to the problem.

The Finding drives delivery.

---

Patch proposals and readiness

A gap should not automatically rewrite the model.

The flow remains:

readiness finding
→ Evidence
→ PatchProposal
→ validation
→ candidate impact
→ human approval

Martenweave’s current architecture explicitly keeps AI and automation in a proposal-first role rather than permitting silent canonical mutation.

This matters because a low score can result from:

Only some cases require a canonical model change.

---

What AI can contribute

AI can help:

AI should not autonomously:

The scoring policy must remain deterministic and reviewable.

---

A focused Martenweave implementation slice

Martenweave already includes:

The next vertical slice should introduce a lineage-based readiness policy.

Goal

Calculate readiness from complete governed paths while preventing critical failures from being hidden by aggregation.

Initial dimensions

Required capabilities

Acceptance criteria

The scorecard must distinguish:

Supplier bank target populated

from:

Supplier bank path verified for ownership, validity and payment use

It must distinguish:

Product MRP Type nonblank

from:

Product MRP Type produced through the approved plant-specific path

It must allow:

Score: 94
Verdict: Blocked

when a critical release gate fails.

Existing commands

martenweave validate --repo ./model
martenweave health --repo ./model
martenweave scorecard --repo ./model
martenweave run dataset-readiness \
  --repo ./model \
  --dataset ./data/mock-load-3.xlsx \
  --out ./reports/readiness

Future policy-aware operation

martenweave scorecard \
  --repo ./model \
  --policy ./policies/migration-readiness.yaml \
  --scope WAVE-1

The policy-aware arguments describe a recommended product direction rather than the current documented CLI contract.

---

Final perspective

A migration-readiness score is useful only when it makes risk easier to see.

It becomes dangerous when it converts:

into small reductions in an otherwise green percentage.

The right model is:

deterministic release gates
+
transparent readiness dimensions
+
path-level evidence
+
criticality
+
scope
+
explainable aggregation

The practical test is:

Can a reviewer understand why the score has its current value, which critical paths remain unsafe, which populations are affected and what evidence would change the verdict?

When the answer is yes, the score supports migration governance.

When the answer is:

We are 92 percent ready,

without a clear explanation of the remaining eight percent, the score is hiding precisely the part that matters.

About the authors

Martenweave is maintained by Dzmitryi Kharlanau.

Martenweave is a backend-first model-governance and evidence layer for SAP migration, MDM, data governance and AMS teams.

It connects canonical model objects, source datasets, Mappings, Rules, physical endpoints, Evidence, Decisions and proposals so that readiness can be calculated from governed paths rather than isolated field counts.

The objective is not to manufacture a reassuring score.

It is to make incomplete or unsafe migration paths difficult to ignore.

Sources and notes

This article was reviewed on 14 July 2026.

Martenweave Core currently treats canonical files as the source of truth, validates IDs, types, references and domain context before generating disposable indexes and exposes health, scorecard, lineage, impact and dataset-readiness operations through its CLI.

The current dataset-readiness workflow orchestrates validation, indexing, dataset profiling, gap detection and summarisation into a report with an explicit readiness verdict. It can promote detected gaps into reviewable PatchProposals rather than mutating the canonical model automatically.

Martenweave’s product contract remains backend-first and proposal-first: evidence enters the pipeline, validators and impact analysis assess the model, and human review controls accepted changes.

The weighting models, critical-path gates, confidence factors and policy-aware scorecard described in this article are recommended Martenweave directions. They should not be interpreted as guarantees of the exact current scorecard implementation unless separately implemented and published.

Martenweave is independent and is not affiliated with or endorsed by SAP.

Primary sources