# Reconcilix Methodology

Status: Draft  
Scope: Vocabulary Matching im digiCULT/xTree-Kontext  
Language convention: Fließtext deutsch, normative Fachterminologie englisch.

## Purpose

Dieses Verzeichnis enthält methodische Referenzdokumente für Reconcilix. Die Dokumente beschreiben nicht primär Implementierungsdetails, sondern die fachliche Struktur des Vocabulary Matching.

Reconcilix unterscheidet bewusst zwischen:

1. Beobachtbaren Matching-Ergebnissen und deren Klassifikation (`ME001`)
2. Dem Reconcilix-spezifischen Verarbeitungsmodell (`ME002`)
3. Der später daraus abgeleiteten technischen Roadmap (`ROADMAP_MATCHING`)

## Terminology

Terminologie zu kontrollierten Vokabularen orientiert sich an ISO 25964-1:2011 und ISO 25964-2:2013. SKOS wird ergänzend dort berücksichtigt, wo technische Repräsentation und RDF-nahe Begriffe relevant sind.

Für Reconcilix gilt:

- `Concept` entspricht im deutschsprachigen ISO-25964-Kontext einem **Begriff**, nicht einem "Konzept".
- `Term` bezeichnet eine **Benennung** eines `Concept`.
- `CandidateConcept` bezeichnet einen vorgeschlagenen Zielbegriff in einem kontrollierten Vokabular.
- `SourceValue` bezeichnet den ursprünglichen Feldwert oder Textausschnitt, der reconciliert werden soll.

## Documents

- `ME001_Vocabulary_Matching_Patterns.md`  
  Definiert die `Vocabulary Matching Patterns`, die zur Klassifikation von Reconciliation-Ergebnissen verwendet werden.

- `ME002_Vocabulary_Matching_Pipeline.md`  
  Beschreibt das Reconcilix-Verarbeitungsmodell mit `SourceValue`, `InterpretationGraph`, `InterpretationNode`, `ReconciliationResult`, `CandidateConcept` und `MatchDecision`.

## Relationship to Evaluation

Evaluationen, Findings und Expert:innenfeedback können `Vocabulary Matching Patterns` aus `ME001` verwenden, um nicht nur Trefferqualität, sondern auch die Art des Matching-Falls zu beschreiben.

Beispiel:

```text
SourceValue: "Altrarretabel"
InterpretationNode[0]: "Altrarretabel"
ReconciliationResult: success=false, pattern=ORTHOGRAPHIC_VARIANT
InterpretationNode[1]: "Altarretabel"
ReconciliationResult: success=..., pattern=COMPOSITE_TERM / SEMANTIC_GENERALIZATION
```

Damit wird nachvollziehbar, welche `Matching Strategy` erforderlich war oder in einer späteren Iteration erforderlich wäre.