# ADR-A001 – Match Baseline

- Status: Accepted
- Datum erstellt: 2026-06-28
- Betrifft: Evaluation
- Implemented in:
    - evaluation/matcult-the_vocnet_org_00000019/2026-06-29_E001_match_baseline/E001.md
- Referenziert in
    - docs/current/ROADMAP_MATCHING.md

---

# Kontext

Reconcilix entwickelt sich iterativ anhand realer Datensätze.

Für die Objektfacette des MCT-Vokabulars stehen zwei
repräsentative Testkorpora aus dem Rheinland zur Verfügung:

- Bauwerke
- Ausstattungsobjekte

Die Evaluation erfolgt über OpenRefine gegen den ReconciliationStore.

Während der ersten Testläufe wurde deutlich, dass sowohl erfolgreiche
Matches als auch Fehlmatches wichtige Hinweise für die Weiterentwicklung
des QueryTokenizer liefern.

Damit Verbesserungen objektiv bewertet werden können, wird eine
reproduzierbare Baseline benötigt.

---

# Entscheidung

Für jede größere Weiterentwicklungsphase wird eine reproduzierbare
Evaluationsrunde (Evaluation, kurz E) angelegt.

Eine Evaluationsrunde besteht mindestens aus

- den verwendeten OpenRefine-Projekten,
- einer Iterationsbeschreibung,
- den daraus gewonnenen Erkenntnissen.

Die erste Evaluationsrunde erhält die Kennung

E001 – Match Baseline

und dient als Referenz für alle weiteren Verbesserungen des
QueryTokenizer und der Matching-Strategien.

Alle nachfolgenden Änderungen werden gegen diese Baseline evaluiert.

---

# Begründung

Die Qualität eines Reconciliation-Systems lässt sich nicht allein anhand
des Quellcodes beurteilen.

Verbesserungen müssen anhand identischer Datensätze nachvollziehbar
gemessen werden.

Durch die Einführung einer Baseline

- bleiben Evaluationen reproduzierbar,
- werden Regressionen früh erkannt,
- können verschiedene Matching-Strategien objektiv verglichen werden,
- entsteht eine nachvollziehbare Entwicklungshistorie.

Die Baseline bildet den Ausgangspunkt für die schrittweise Umsetzung der
Matching-Roadmap.

---

# Auswirkungen

## Positiv

- reproduzierbare Evaluationen
- objektiver Vergleich verschiedener Versionen
- Grundlage für Regressionstests
- transparente Dokumentation fachlicher Entscheidungen
- Vorbereitung einer Bewertung durch Domain-Expert*innen

## Negativ

- zusätzlicher Dokumentationsaufwand
- Evaluationsdaten müssen dauerhaft archiviert werden

---

# Konsequenzen

Jede zukünftige Evaluationsrunde erhält

- eine eindeutige Kennung (E002, E003, ...),
- einen eigenen Ordner unter `evaluation/`,
- mindestens eine Iteration `IXX.md`.

Technische Änderungen am Matching werden grundsätzlich gegen die
aktuelle Baseline evaluiert, bevor sie als abgeschlossen gelten.

Die Matching-Roadmap wird unabhängig von einzelnen Evaluationen in

`docs/current/ROADMAP_MATCHING.md`

fortgeführt.

---

# Verwandte ADRs