# WP3-001-005 – Runtime Integration

- **Status:** Draft
- **Version:** 0.1
- **Scope:** WP3 – Discovery Framework Foundation
- **Owner:** ED
- **Review:** PL, LA

## Referenzen

- WP3-001 – Discovery Framework Foundation
- WP3-001-001 – Discovery Route Model
- WP3-001-002 – Discovery Configuration Registry
- WP3-001-003 – Candidate Discovery Adapter Contract
- WP3-001-004 – Candidate Discovery Router
- PRE_WP3-001 – Architekturübersicht Discovery Framework
- ADR002 – Source Delivery Model
- DM001 – Domain Model
- DM002 – Persistence Model

---

# 1. Ziel

Dieses Work Package integriert das Discovery Framework in den bestehenden Reconcilix-Laufzeitpfad.

Nach Abschluss von WP3-001-005 erfolgt jede Candidate Discovery über den CandidateDiscoveryRouter.

Das fachliche Discovery-Verhalten bleibt unverändert.

---

# 2. Scope

Dieses Work Package umfasst ausschließlich

- Integration des CandidateDiscoveryRouter in den bestehenden Runtime-Pfad
- Anpassung des Composition Root
- Registrierung der DiscoveryConfigurationRegistry
- Registrierung des ersten CandidateDiscoveryAdapter
- Integrationstests
- Regressionstests

Nicht Bestandteil sind

- neue Discovery-Verfahren
- produktive xTree-Integration
- produktive Local-Reconciliation-Store-Neuimplementierung
- Änderungen an Domain Model oder Persistence Model

---

# 3. Architekturbezug

WP3-001-005 verbindet die in WP3-001-001 bis WP3-001-004 eingeführten Komponenten mit der bestehenden Reconcilix-Runtime.

Das Discovery Framework wird damit Bestandteil des produktiven Reconciliation-Flows.

---

# 4. Klassenübersicht

| Klasse | Typ | Status | Verantwortung |
|---------|-----|--------|----------------|
| CandidateDiscoveryRouter | Class | Bestehend | Einstiegspunkt des Discovery Frameworks |
| DiscoveryConfigurationRegistry | Class | Bestehend | Bereitstellung der Discovery Routes |
| CandidateDiscoveryAdapter | Interface | Bestehend | Technischer Adaptervertrag |
| LegacyCandidateDiscoveryAdapter* | Class | Bestehend | Übergangsadapter für bestehende Discovery |
| Composition Root | Infrastruktur | Anpassung | Verdrahtung der Komponenten |

\* Arbeitstitel – Bezeichnung im LA-Review prüfen.

---

# 5. Integrationspunkte

Folgende bestehende Komponenten werden angepasst:

- Composition Root
- Runtime Factory (falls erforderlich)
- RuntimeContext (falls erforderlich)
- CandidateDiscoveryGateway
- ReconciliationApplicationService (nur falls erforderlich)

Die Anpassungen beschränken sich auf die Einbindung des Discovery Frameworks.

Das fachliche Verhalten bleibt unverändert.

---

# 6. Laufzeitfluss

Nach Abschluss dieses Work Packages ergibt sich folgender Aufrufpfad:

```text
ReconciliationApplicationService
        │
        ▼
CandidateDiscoveryGateway
        │
        ▼
CandidateDiscoveryRouter
        │
        ├── DiscoveryConfigurationRegistry
        │
        └── CandidateDiscoveryAdapter
                │
                ▼
     bestehende Candidate Discovery
                │
                ▼
          CandidateItem[]
```

Während WP3-001-005 erfolgt die Candidate Discovery weiterhin über die bestehende Implementierung.

Lediglich der Einstiegspunkt wird ersetzt.

---

# 7. Verantwortlichkeiten

WP3-001-005

führt keine neue Discovery ein.

WP3-001-005

ändert keine Discovery Methods.

WP3-001-005

ändert keine Candidate Items.

WP3-001-005

integriert ausschließlich das Discovery Framework in die Runtime.

---

# 8. Implementierungsreihenfolge

1. CandidateDiscoveryRouter registrieren.
2. DiscoveryConfigurationRegistry registrieren.
3. CandidateDiscoveryAdapter registrieren.
4. Composition Root anpassen.
5. Runtime verdrahten.
6. Regressionstests durchführen.
7. Integrationstests durchführen.

---

# 9. Deliverables

## Neue Konfiguration

- Registrierung des Discovery Frameworks

## Angepasste Komponenten

- Composition Root
- Runtime-Konfiguration

## Tests

- Integrationstests
- Regressionstests

---

# 10. Akzeptanzkriterien

Das Work Package ist abgeschlossen, wenn

1. sämtliche Discovery-Anfragen über den CandidateDiscoveryRouter laufen,
2. das Discovery Framework vollständig in die Runtime eingebunden ist,
3. die bestehende Discovery weiterhin dieselben Candidate Items liefert,
4. keine Änderungen am fachlichen Discovery-Verhalten auftreten,
5. alle bestehenden Tests erfolgreich sind,
6. alle neuen Integrationstests erfolgreich sind.

---

# 11. Out of Scope

Nicht Bestandteil sind

- Local Reconciliation Store Adapter
- xTree Candidate Discovery Adapter
- HTTP-Kommunikation
- REST
- SPARQL
- mehrere Discovery Routes
- Priorisierung
- Hybrid Discovery
- Ranking
- Result Fusion
- neue Discovery Methods

---

# 12. Auswirkungen auf Folgepakete

Nach erfolgreichem Abschluss von WP3-001 ist das Discovery Framework vollständig in Reconcilix integriert.

Die folgenden Work Packages implementieren anschließend die ersten produktiven Adapter:

- ED-04-007 – source_value.source_delivery_id
- ED-04-008 – delivery_id aus OpenRefine übernehmen
- WP3-002 – Local Reconciliation Store Adapter
- WP3-003 – xTree Candidate Discovery Adapter
- WP3-004 – Discovery Configuration Integration
- WP3-005 – End-to-End Candidate Discovery