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: Meterthickness: Millimeterarea_weight: Gramm pro Quadratmetercore_diameter: Millimetercore_type: separater Wert, nicht mit Durchmesser vermischen
Merge-Prioritaeten
- ERP-Stammdaten
- bestehende RollCalc-Berechnungsdaten
- 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.mddocs/erp-enrichment.mddocs/importers.mddocs/merge-rules.mdtests/fixtures/src/article_data_manager/