61 lines
1.7 KiB
Markdown
61 lines
1.7 KiB
Markdown
# 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/`
|