80 lines
3.9 KiB
Markdown
80 lines
3.9 KiB
Markdown
# ERP EDI Bridge v2.5 – Komplettübersicht & Walkthrough
|
||
|
||
Die **ERP EDI Bridge** ist eine moderne Web-App (basierend auf Electron oder Browser), die den Datenaustausch zwischen ERP-Systemen und Partnern durch Konvertierung von VDA- und EDIFACT-Nachrichten vereinfacht.
|
||
|
||
---
|
||
|
||
## 🛠 Hauptfunktionen
|
||
|
||
### 1. Multi-Format Converter
|
||
Unterstützt bidirektionale Konvertierung mit verschiedenen Business-Logiken:
|
||
- **VDA 4913 → Bosch DESADV**: Erzeugt EDIFACT DESADV Nachrichten inkl. NAD-Anreicherung und Gewichts-Editor.
|
||
- **VDA 4913 → IFM DELVRY03**: Erzeugt IFM-spezifische XML-IDocs.
|
||
- **DELFOR → VDA 4905**: Konvertiert EDIFACT Lieferabrufe in das VDA-Format.
|
||
- **IFM DELFOR → VDA 4905**: Spezieller Flow für IFM D04A Nachrichten.
|
||
- **INVRPT → VDA 4913**: Konvertiert EDIFACT Lagerbestandsberichte in VDA EDL36.
|
||
|
||
### 2. Visueller EDI Editor (Neu!)
|
||
Ein interaktiver Editor zur strukturierten Bearbeitung von EDI-Dateien:
|
||
- **Segment-Ansicht**: Stellt EDIFACT-Segmente (UNH, BGM, NAD, etc.) als Karten mit bearbeitbaren Feldern dar.
|
||
- **VDA-Unterstützung**: Bearbeitung von VDA-Sätzen mit Live-Längenprüfung, um die Festlängen-Struktur beizubehalten.
|
||
- **Integration**: Dateien können direkt hochgeladen oder per "Edit"-Button aus dem Konvertierungsergebnis übernommen werden.
|
||
- **Export**: Generiert korrekte EDI-Dateien (inkl. UNA-Header und Separatoren) mit dem Suffix `_edited`.
|
||
|
||
### 3. Premium EDI-Viewer (Neu!)
|
||
Visualisiert EDI-Daten als moderne, druckfreundliche Dokumente mit erweitertem Datenumfang:
|
||
- **DELFOR**: Lieferplan mit Abrufmengen, Zeitplan (Wochen/Monate) und Lieferhistorie.
|
||
- **DESADV**: Lieferschein mit Anzeige von Kunden- vs. Lieferanten-Materialnummern, Chargennummern (`PIA+NB`) und detaillierter Verpackungsauflistung (`PAC`).
|
||
- **INVRPT**: Lagerbestandsbericht mit Bestandsmengen, Lagerorten und Material-Revisionen.
|
||
- **VDA 4913**: Transport-Hierarchie (Transport -> Lieferschein -> Position) mit VDA-Labelnummern und Packstücken.
|
||
- **Interaktivität**: Nutzung von Lucide-Icons für bessere Scanbarkeit und integrierte Druckfunktion.
|
||
|
||
### 4. Automatisierung (Watcher)
|
||
*Nur in der Electron-Version verfügbar:*
|
||
- **Ordner-Überwachung**: Überwacht einen Eingangsordner auf neue Dateien.
|
||
- **Auto-Konvertierung**: Konvertiert Dateien basierend auf hinterlegten Regeln vollautomatisch.
|
||
- **Status-Dashboard**: Zeigt Live-Logs und den Status des Watchers in den Einstellungen an.
|
||
|
||
---
|
||
|
||
## 🏗 Technische Struktur
|
||
|
||
| Komponent | Beschreibung |
|
||
|-----------|--------------|
|
||
| `index.html` | Zentrales UI mit Glassmorphism-Design und Tab-Navigation. |
|
||
| `js/app.js` | Haupt-Orchestrierung der UI und Converter-Logik. |
|
||
| `js/editor.js` | Logik für den visuellen Segment-Editor. |
|
||
| `js/viewer.js` | Parsing und Rendering der Dokumententypen (XSL-ähnlich). |
|
||
| `js/watcher-bridge.js` | Schnittstelle zum Electron Dateisystem-Watcher. |
|
||
| `styles.css` | Modernes Dark-Mode/Glassmorphism Design-System. |
|
||
|
||
---
|
||
|
||
## 🚀 Installation & Start (Electron)
|
||
|
||
1. **Voraussetzung**: [Node.js](https://nodejs.org/) (v18+) installieren.
|
||
2. **Setup**:
|
||
```bash
|
||
npm install
|
||
```
|
||
3. **Start**:
|
||
```bash
|
||
npm start
|
||
```
|
||
|
||
> [!TIP]
|
||
> Die App kann auch direkt über die `index.html` im Browser genutzt werden (ohne Watcher-Funktionalität).
|
||
|
||
---
|
||
|
||
## ⚙️ Einstellungen & Konfiguration
|
||
In den **Settings** können Netzwerkpfade für den Watcher gewählt und die Kundennummern-Zuordnung (`CUSTOMER_MAPPING`) konfiguriert werden.
|
||
|
||
### Intelligente Formaterkennung (Auto-Detect)
|
||
Die App erkennt beim Hochladen einer Datei automatisch das Format und den Partner:
|
||
- **VDA Dateien**: Identifikation über die Kundennummer im Satz 711/511.
|
||
- **EDIFACT Dateien**: Identifikation über den Absender im `UNB`-Segment (Sender ID) oder `NAD+BY`.
|
||
- **Mapping**: Ist die ID in der `CUSTOMER_MAPPING` (Einstellungen) hinterlegt, wird automatisch der richtige Konverter (z.B. DELFOR → VDA 4905) aktiviert.
|
||
|
||
Die Konfiguration wird lokal im Browser-Storage gespeichert oder kann aus einer `config.txt` geladen werden.
|