Initialize Article Data Manager project

docs/adr/0001-separate-repository.md

@@ -0,0 +1,20 @@
+# ADR 0001 - Eigenstaendiges Repository
+
+## Status
+
+Akzeptiert
+
+## Entscheidung
+
+Der Article Data Manager wird als eigenstaendiges Projekt gefuehrt und nicht in das RollCalc-Repository integriert.
+
+## Begruendung
+
+- getrennte Verantwortlichkeiten
+- unabhaengige Entwicklung
+- Schutz des RollCalc vor Import- und Datenpflegekomplexitaet
+- spaetere Wiederverwendung durch weitere Systeme
+
+## Konsequenzen
+
+RollCalc konsumiert nur ein definiertes Exportartefakt. Schnittstellen und Formatkompatibilitaet muessen dokumentiert und getestet werden.

docs/adr/0002-source-data-separation.md

@@ -0,0 +1,17 @@
+# ADR 0002 - Trennung der Datenquellen
+
+## Status
+
+Akzeptiert
+
+## Entscheidung
+
+ERP-Daten, bestehende RollCalc-Daten, manuelle Daten und generierte Daten werden physisch und logisch getrennt.
+
+## Begruendung
+
+Die Trennung macht Herkunft, Verantwortlichkeit und Konflikte nachvollziehbar. Sie reduziert das Risiko, produktive Quelldaten versehentlich zu veraendern oder generierte Ergebnisse als Primaerdaten zu behandeln.
+
+## Konsequenzen
+
+Importer und Merge-Logik muessen Quelle und Prioritaet explizit beruecksichtigen. Produktive Datenverzeichnisse werden nicht standardmaessig versioniert.

docs/adr/0003-article-number-as-string.md

@@ -0,0 +1,19 @@
+# ADR 0003 - Artikelnummer als Zeichenkette
+
+## Status
+
+Akzeptiert
+
+## Entscheidung
+
+Artikelnummern werden durchgaengig als Strings behandelt.
+
+## Begruendung
+
+- fuehrende Nullen
+- keine mathematische Bedeutung
+- moegliche zukuenftige alphanumerische Werte
+
+## Konsequenzen
+
+Importer duerfen Artikelnummern nicht in numerische Typen konvertieren. Normalisierung darf fuehrende Nullen nicht entfernen.

docs/adr/0004-generated-output-not-primary-data.md

@@ -0,0 +1,17 @@
+# ADR 0004 - Generierte Datei ist kein Primaerdatenbestand
+
+## Status
+
+Akzeptiert
+
+## Entscheidung
+
+Die erzeugte `article-data.json` ist ein Build-Artefakt. Aenderungen duerfen nicht direkt ausschliesslich in dieser Datei vorgenommen werden.
+
+## Begruendung
+
+Primaere Aenderungen gehoeren in ERP, bestehende RollCalc-Quelldaten oder manuelle Zusatzdaten. Nur so bleiben Herkunft, Validierung und Konflikte nachvollziehbar.
+
+## Konsequenzen
+
+`data/generated/article-data.json` wird nicht standardmaessig versioniert. Relevante Aenderungen muessen reproduzierbar aus den Quellen erzeugt werden.

docs/adr/README.md

@@ -0,0 +1,3 @@
+# Architecture Decision Records
+
+ADRs dokumentieren zentrale Architekturentscheidungen. Neue ADRs werden fortlaufend nummeriert und sollen Entscheidung, Kontext und Konsequenzen enthalten.