Files
article-data-manager/PROJECT_KNOWLEDGE.md
2026-07-29 14:32:15 +02:00

1.8 KiB

Project Knowledge

Zweck

Article Data Manager erzeugt, validiert und pflegt langfristig die Artikeldaten fuer den bestehenden Roll Calculator.

Abgrenzung

Das Projekt ist ein eigenstaendiges Repository. RollCalc konsumiert spaeter nur die generierte article-data.json.

Zentrale Datenquellen

  • ERP-CSV-Export als primaere Quelle fuer fachlich eindeutige Stammdaten.
  • Bestehende RollCalc-JSON als Quelle fuer vorhandene Berechnungsparameter.
  • Manuelle CSV-Daten fuer Zusatzdaten und explizite Korrekturen.

Artikelnummer

nr und ERP-Artikelnummern werden immer als Strings behandelt. Fuehrende Nullen muessen erhalten bleiben.

Einheiten

  • width: Meter
  • thickness: Millimeter
  • area_weight: Gramm pro Quadratmeter
  • core_diameter: Millimeter
  • core_type: separater Wert, nicht mit Durchmesser vermischen

Merge-Prioritaeten

  1. ERP-Stammdaten
  2. bestehende RollCalc-Berechnungsdaten
  3. manuelle Ergaenzungen und ausdruecklich erlaubte Overrides

Konflikte duerfen nicht stillschweigend ueberschrieben werden.

Sicherheitsregeln

Produktive ERP-Daten, lokale Quelldaten, generierte Dateien und Reports sind per .gitignore ausgeschlossen. Nur reduzierte oder anonymisierte Beispiele werden versioniert.

Aktueller Stand

Phase 0: Struktur, Dokumentation, Fixtures, minimale Python-Bausteine, Tests, RollCalc-JSON-Importer, ERP Explorer und ERP Enrichment Dry Run.

Offene fachliche Fragen

Siehe docs/data-model.md und docs/merge-rules.md.

Naechste Schritte

  • ERP-CSV-Importer und Import manueller CSV-Datei implementieren.
  • Validierungs- und Merge-Regeln produktiv ausbauen.
  • Reports und deterministischen Export ergaenzen.

Wichtige Dateien

  • docs/data-dictionary.md
  • docs/erp-enrichment.md
  • docs/importers.md
  • docs/merge-rules.md
  • tests/fixtures/
  • src/article_data_manager/