# VOC002 – Administrative Status Vocabulary

**Status:** v0.1 – Ist-Dokumentation  
**Projekt:** Reconcilix  
**Stand:** 2026-08-30  
**Charakter:** administratives Kontrollvokabular / Bestandsaufnahme

## 1. Zweck

VOC002 dokumentiert die in Reconcilix verwendeten administrativen Status-Notationen und ihren aktuellen Einsatzbereich.

Das Dokument ist zunächst **deskriptiv**. Es legt den beobachteten bzw. im Quellcode vorgesehenen Ist-Stand fest, ohne bereits eine endgültige fachliche Harmonisierung der Status-Lifecycles vorzunehmen.

Die Statuswerte werden als kontrollierte **Notationen** gespeichert. Für administrative Struktur- und Lifecycle-Werte werden keine eigenen Status-URIs vorausgesetzt.

## 2. Governance v0.1

1. Statuswerte werden in Großbuchstaben als kontrollierte Notationen geführt, z. B. `COMPLETED`.
2. Gleiche Notationen dürfen in unterschiedlichen Entity-Scopes vorkommen.
3. Gleiche Notation bedeutet nicht automatisch identische Lifecycle-Semantik über alle Scopes hinweg.
4. Neue Statuswerte sollen in VOC002 dokumentiert werden, sobald sie in Domainmodell oder Persistenz eingeführt werden.
5. Eine semantische Bereinigung erfolgt bewusst noch nicht.
6. Nach ca. 2–3 Monaten produktiver Nutzung soll eine Häufigkeitsanalyse je Entity-Scope durchgeführt werden.
7. Danach werden nicht benötigte Werte bereinigt und die verbleibenden Werte mit Scope Notes präzisiert.

## 3. Ist-Bestand

| Entity-Scope | Notation | Stand v0.1 |
|---|---|---|
| `SourceDelivery` | `RECEIVED` | im Domainmodell vorgesehen |
| `SourceDelivery` | `PROCESSING` | im Domainmodell vorgesehen |
| `SourceDelivery` | `COMPLETED` | im Domainmodell vorgesehen |
| `SourceDelivery` | `FAILED` | im Domainmodell vorgesehen |
| `InterpretationGraph` | `CREATED` | administrativer Initialstatus |
| `InterpretationNode` | `INITIAL` | administrativer Initialstatus |
| `ReconciliationRun` | `CREATED` | im Domainmodell vorgesehen |
| `ReconciliationRun` | `RUNNING` | im Domainmodell vorgesehen |
| `ReconciliationRun` | `COMPLETED` | im Domainmodell vorgesehen |
| `ReconciliationRun` | `FAILED` | im Domainmodell vorgesehen |
| `ReconciliationRunItem` | `PENDING` | im Domainmodell vorgesehen |
| `ReconciliationRunItem` | `COMPLETED` | im Domainmodell vorgesehen |
| `ReconciliationRunItem` | `FAILED` | im Domainmodell vorgesehen |

## 4. Scope-Übersicht

```text
SourceDelivery
  RECEIVED
  PROCESSING
  COMPLETED
  FAILED

InterpretationGraph
  CREATED

InterpretationNode
  INITIAL

ReconciliationRun
  CREATED
  RUNNING
  COMPLETED
  FAILED

ReconciliationRunItem
  PENDING
  COMPLETED
  FAILED
```

## 5. Bereinigung InterpretationGraph / InterpretationNode

Mit VOC002 v0.1 werden die bisher verwendeten temporären Status-URIs für `InterpretationGraph` und `InterpretationNode` aufgegeben.

### InterpretationGraph

Bisher:

```text
status_uri = https://reconcilix.example/status/created
```

Neu:

```text
status = CREATED
```

### InterpretationNode

Bisher:

```text
status_uri = https://reconcilix.example/status/initial
```

Neu:

```text
status = INITIAL
```

Damit folgen InterpretationGraph und InterpretationNode demselben Repräsentationsprinzip wie SourceDelivery, ReconciliationRun und ReconciliationRunItem: administrative Status werden als kontrollierte Notationen gespeichert.

## 6. Bewusst offene Semantik

VOC002 v0.1 definiert noch keine abschließenden Scope Notes für die einzelnen Notationen.

Insbesondere wird **nicht** unterstellt, dass beispielsweise `COMPLETED` in den Scopes `SourceDelivery`, `ReconciliationRun` und `ReconciliationRunItem` exakt dieselbe Zustandssemantik besitzt.

Die präzise Bedeutung soll aus dem stabilisierten Runtime-Verhalten abgeleitet und anschließend je Scope dokumentiert werden.

## 7. Geplante Häufigkeitsanalyse

Nach ca. 2–3 Monaten soll mindestens je Entity-Scope ermittelt werden:

- Anzahl der Datensätze je Statusnotation,
- Anteil der Statuswerte innerhalb des Scopes,
- Statuswerte ohne reale Verwendung,
- nur sehr kurzlebige technische Übergangszustände,
- mögliche redundante oder missverständlich benannte Werte.

Beispielhafte Auswertungsstruktur:

```text
Notation     SourceDelivery   Graph   Node   Run   RunItem
----------------------------------------------------------
CREATED             ...        ...      0    ...         0
INITIAL             0            0    ...      0         0
PENDING             0            0      0      0       ...
RUNNING             0            0      0    ...         0
COMPLETED          ...           0      0    ...       ...
FAILED             ...           0      0    ...       ...
```

## 8. Abgrenzung

VOC002 behandelt ausschließlich administrative Statuswerte.

Nicht Gegenstand von VOC002 sind insbesondere:

- fachliche Match Decisions,
- Discovery Methods,
- Matching Strategies,
- Interpretation Techniques,
- Entity Types,
- Context Types.

Diese Konzepte besitzen eine andere Semantik und sollen nicht allein aufgrund einer ähnlichen technischen Repräsentation in VOC002 aufgenommen werden.

## 9. Nächster Review

**Review-Ziel:** Häufigkeitsanalyse und Scope Notes  
**Zeitraum:** ca. November 2026

Bis zu diesem Review soll das Statusmodell nach Möglichkeit stabil gehalten und nur bei konkretem Runtime-Bedarf erweitert werden.