Initialize Article Data Manager project
This commit is contained in:
@@ -0,0 +1,60 @@
|
||||
# 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 und Tests.
|
||||
|
||||
## Offene fachliche Fragen
|
||||
|
||||
Siehe `docs/data-model.md` und `docs/merge-rules.md`.
|
||||
|
||||
## Naechste Schritte
|
||||
|
||||
- Importer fuer RollCalc-JSON, ERP-CSV und manuelle CSV-Datei implementieren.
|
||||
- Validierungs- und Merge-Regeln produktiv ausbauen.
|
||||
- Reports und deterministischen Export ergaenzen.
|
||||
|
||||
## Wichtige Dateien
|
||||
|
||||
- `docs/data-dictionary.md`
|
||||
- `docs/merge-rules.md`
|
||||
- `tests/fixtures/`
|
||||
- `src/article_data_manager/`
|
||||
Reference in New Issue
Block a user