116 lines
5.9 KiB
Markdown
116 lines
5.9 KiB
Markdown
# Modulkarte ERP Naurua
|
|
Stand: 2026-06-15
|
|
Status: Architektur-Arbeitskarte
|
|
|
|
## 1. Zweck
|
|
|
|
Diese Modulkarte ordnet das System in klar getrennte fachliche Hauptmodule, Submodule und technische Querschnittsbereiche. Sie dient als Zielbild fuer die saubere Trennung von Ownership, Schnittstellen und wiederverwendbaren `shared`-Bausteinen.
|
|
|
|
## 2. Leitlinien
|
|
|
|
- Jedes Hauptmodul besitzt genau eine Primaerverantwortung.
|
|
- Submodule sind nur interne fachliche Zuschnitte innerhalb eines Hauptmoduls.
|
|
- `shared` enthaelt nur fachlich neutrale, wiederverwendbare Bausteine.
|
|
- `system` enthaelt nur technische Runtime-, Start-, Trigger- und Laufzeitlogik.
|
|
- Fachliche Logik bleibt immer im owning Modul.
|
|
- Cross-Modul-Zugriffe erfolgen nur ueber explizite Schnittstellen.
|
|
|
|
## 3. Moduluebersicht
|
|
|
|
| Modul | Typ | Submodule | Primaerverantwortung | Owned Daten / Artefakte | Writes | Reads | Public Interface | `shared`-Bedarf |
|
|
|---|---|---|---|---|---|---|---|---|
|
|
| Kontakte | Hauptmodul | Stammdaten, Adressen, Kommunikationsdaten | Kunden-, Lieferanten- und Kontaktstamm | `party`, `address`, `contact` | Kontaktstamm, Adressen, Kommunikationsdaten | Referenzen aus Bestellungen, Buchhaltung, Beratung | Kontakt-API, Such- und Lookup-Schnittstellen | Validierung, Formatierung, UI-Bausteine |
|
|
| Bestellungen | Hauptmodul | Bestellkopf, Positionen, Status | Operative Bestellverarbeitung | `sales_order`, `sales_order_line`, Statusdaten | Bestellanlage, Status, Zuordnung | Kontakte, Artikel-Mapping, Lager | Bestell-API, Status-API | Geld-/Datumsformat, Tabellen- und Status-Patterns |
|
|
| Lager | Hauptmodul | Chargen, Bewegungen, Bestandsfuehrung | Bestand, Charge, MHD, Bewegungen | `product`, `stock_lot`, `stock_move`, `v_stock_lot_balance` | Warenzugang, -abgang, Umlagerung, Chargenpflege | Bestellungen, Import, Direktverkauf | Lager-API, Bestands- und Chargen-Schnittstellen | Listen-, Detail- und Statusdarstellung |
|
|
| Artikel-Mapping | Hauptmodul | Externe Artikel, interne Artikel, Zuordnung | Aufloesung externer Shopdaten auf interne Artikel | `sellable_item`, `external_item_alias`, `sellable_item_component` | Aliaspflege, Zuordnung, Bundle-/Komponentenpflege | Bestellungen, Import | Mapping-API | Suchlogik, Tabellenmuster, Normalisierung |
|
|
| Import / Integration | Hauptmodul | Webhooks, Import-Routing, externe Adapter | Annahme und Verteilung externer Eingangsdaten | Integrationsdaten, Importzustand, technische Events | Importausloesung, technische Events | Externe Quellen, operative Kernmodule | Webhook- und Import-Schnittstellen | HTTP-nahe Bausteine, Parsing, technische Validierung |
|
|
| Direktverkauf | Hauptmodul | Tageserfassung, Sammelverkauf | Manuelle Erfassung von Direktverkaeufen | Direktverkaufsbelege, Erfassungsdaten | Direktverkauf, Ausloesung operativer Folgeschritte | Kontakte optional, Lager, Bestellungen | Direktverkaufs-UI und API | Erfassungsmuster, Formularbausteine |
|
|
| Buchhaltung | Hauptmodul | Debitoren, Kreditoren, Hauptbuch, Nebenbuecher | Finanzbuchhaltung, Kontierung, Abschluss, Steuerlogik | Buchungssaetze, Konten, OP-Positionen, Steuerdaten | Verbuchung, OP-Pflege, Abschlusslaeufe | Freigegebene ERP-Belege, Zahlungsdaten, Kontenplan | Buchhaltungs-API, Buchungsimport, Zahlungsabgleich | Geld-/Steuerformat, Listen, Prüf- und Statusmuster |
|
|
| Kundenberatung | Hauptmodul | Gespraechserfassung, Empfehlungen, Follow-ups | Beratungsfall, Bedarf, Empfehlung, Rueckmeldung | Beratungsgespräche, Empfehlungen, Rueckmeldungen | Gespraech, Notizen, Follow-ups | Kontakte, Produkte, Bestellungen | Beratungs-API, Fall- und Verlaufsschnittstellen | Formular- und Verlaufsmuster |
|
|
| `shared` | Technischer Bereich | UI, Helpers, technische Services | Fachlich neutrale Wiederverwendung | Wiederverwendbare technische Bausteine | Keine fachlichen Writes | Mehrere Module | Gemeinsame technische APIs und Komponenten | Kernbereich |
|
|
| `system` | Technischer Bereich | Runtime, Trigger, Scheduler, Supervisor | Technische Laufzeit und Ausfuehrungslogik | Jobs, Trigger, technische Laufzeiten | Systemnahe Laufzeitlogik | Technische Zustandsdaten | Systeminterne technische Schnittstellen | Laufzeit-, Job- und Triggerbausteine |
|
|
|
|
## 4. Modulzuschnitt im Zielbild
|
|
|
|
### 4.1 ERP-Kern
|
|
|
|
Der ERP-Kern besteht aus:
|
|
|
|
- Kontakte
|
|
- Bestellungen
|
|
- Lager
|
|
- Artikel-Mapping
|
|
- Import / Integration
|
|
- Direktverkauf
|
|
|
|
Diese Module bilden die operative Kernverarbeitung. Sie duerfen Buchhaltung nur ueber klare Integrationsschnittstellen versorgen.
|
|
|
|
### 4.2 Buchhaltungssystem
|
|
|
|
Die Buchhaltung ist ein eigenes Hauptmodul mit eigener fachlicher Ownership.
|
|
|
|
Es erhaelt aus dem ERP:
|
|
|
|
- freigegebene Rechnungen oder Erlosereignisse
|
|
- Zahlungsinformationen
|
|
- relevante Debitoren-/Kreditoren-Referenzen
|
|
- Buchungsgrundlagen aus operativen Belegen
|
|
|
|
Es fuehrt selbst:
|
|
|
|
- Kontierung
|
|
- Hauptbuch
|
|
- Nebenbuecher
|
|
- OP-Verwaltung
|
|
- Zahlungslauf
|
|
- Mahnwesen
|
|
- Abschluss und Steuerlogik
|
|
|
|
### 4.3 Kundenberatung
|
|
|
|
Kundenberatung ist ein eigenes Hauptmodul fuer fall- und gespraechsbezogene Arbeit.
|
|
|
|
Es erhaelt aus dem ERP:
|
|
|
|
- Kundenstamm
|
|
- Kaufhistorie
|
|
- produktbezogene Referenzen
|
|
|
|
Es fuehrt selbst:
|
|
|
|
- Gespraechserfassung
|
|
- Bedarfserhebung
|
|
- Produktempfehlungen
|
|
- Rueckmeldungen
|
|
- Follow-up-Logik
|
|
|
|
## 5. `shared`-Regeln fuer das Zielbild
|
|
|
|
In `shared` gehoeren nur Bausteine, die fachlich neutral sind und in mehreren Modulen wiederverwendet werden koennen:
|
|
|
|
- UI-Komponenten und Layout-Bausteine
|
|
- Tabellen, Formulare, Statusdarstellung
|
|
- Validierung ohne Fachentscheidungen
|
|
- Datums-, Geld- und Formatierungshelfer
|
|
- technische API-Clients
|
|
- Logging, Auth- und Session-nahe Hilfen
|
|
- generische Fehler- und Ladezustandsmuster
|
|
|
|
Nicht in `shared` gehoeren:
|
|
|
|
- Buchhaltungsregeln
|
|
- Lagerlogik
|
|
- Beratungslogik
|
|
- Bestellfachlogik
|
|
- modulpezifische Dateninterpretation
|
|
|
|
## 6. Naechste Strukturierungsarbeit
|
|
|
|
Aus dieser Modulkarte folgen als naechste Dokumente:
|
|
|
|
1. Modulvertraege je Hauptmodul
|
|
2. Owned-DB-Register je Modul
|
|
3. Prozessvertraege fuer die Hauptprozesse je Modul
|
|
4. Liste der wiederverwendbaren `shared`-Bausteine
|
|
|