Add module ownership docs

2026-06-15 10:06:42 +02:00
parent c6b5a0572c
commit 63a1e79147
12 changed files with 386 additions and 0 deletions
@@ -0,0 +1,15 @@
+# Module Ownership Docs
+Stand: 2026-06-15
+
+Diese Ordnerstruktur dokumentiert die fachliche und technische Ownership der Module.
+
+Regeln:
+- Ein Ordner pro Hauptmodul oder technischem Bereich.
+- Jedes Modul bekommt eine kurze README mit Zweck, Ownership, Reads, Writes und Grenzen.
+- Submodule werden im README des owning Moduls kurz benannt, wenn sie nicht eigenes Ownership tragen.
+- Code, Doku und Datenmodell sollen dieser Struktur folgen.
+
+Referenz:
+- [Technische Architektur](../architektur/technical_architecture.md)
+- [Modulkarte](../architektur/modulkarte.md)
+
@@ -0,0 +1,34 @@
+# Buchhaltung
+Stand: 2026-06-15
+
+## Zweck
+
+Finanzbuchhaltung mit Kontierung, Verbuchung, Offene-Posten und Abschluss.
+
+## Owns
+
+- Buchungssaetze
+- Konten
+- OP-Positionen
+- Steuerdaten
+
+## Writes
+
+- Verbuchung
+- OP-Pflege
+- Zahlungslauf
+- Mahnwesen
+- Abschlusslaeufe
+
+## Reads
+
+- Freigegebene ERP-Belege
+- Zahlungsdaten
+- Kontenplan
+
+## Grenzen
+
+- Keine operative Lagerlogik.
+- Keine Beratungslogik.
+- Keine UI-Sonderlogik fuer ERP-Prozesse.
+
@@ -0,0 +1,36 @@
+# ERP
+Stand: 2026-06-15
+
+## Zweck
+
+ERP ist der operative Container fuer die Kerndomane des Tagesgeschaefts.
+
+## Enthaltene Module
+
+- Kontakte
+- Bestellungen
+- Lager
+- Artikel-Mapping
+- Import-Integration
+- Direktverkauf
+
+## Ownership
+
+- Owns keine fachlichen Daten als Container.
+- Owns nur die Strukturierung der operativen ERP-Module.
+- Fachliche Verantwortung liegt immer in den Untermodulen.
+
+## Grenzen
+
+- Keine Buchhaltung.
+- Keine Kundenberatung.
+- Keine technischen `shared`-Hilfen.
+- Keine Runtime-Logik.
+
+## Relevante Entry-Points
+
+- `public/order-import.php`
+- `order-import.php`
+- `public/api/otc-order.php`
+- `public/otc/index.php`
+
@@ -0,0 +1,31 @@
+# Artikel-Mapping
+Stand: 2026-06-15
+
+## Zweck
+
+Aufloesung externer Shopdaten auf interne verkaufbare Artikel und Produkte.
+
+## Owns
+
+- `sellable_item`
+- `external_item_alias`
+- `sellable_item_component`
+
+## Writes
+
+- Aliaspflege
+- Zuordnung externer Artikel
+- Komponentenpflege
+
+## Reads
+
+- Bestellungen
+- Import-Integration
+- Lager
+
+## Grenzen
+
+- Keine Bestellverarbeitung.
+- Keine Lagerbewegungen.
+- Keine Buchhaltung.
+
@@ -0,0 +1,37 @@
+# Bestellungen
+Stand: 2026-06-15
+
+## Zweck
+
+Operative Verarbeitung von Bestellungen, Positionen und Status.
+
+## Owns
+
+- `sales_order`
+- `sales_order_line`
+- Bestellstatus
+
+## Writes
+
+- Bestellung anlegen und aktualisieren
+- Positionen pflegen
+- Status fortschreiben
+
+## Reads
+
+- Kontakte
+- Artikel-Mapping
+- Lager
+
+## Submodule
+
+- Bestellkopf
+- Positionen
+- Status
+
+## Grenzen
+
+- Keine Buchhaltung.
+- Keine Lagerbestandswahrheit.
+- Kein Direktverkaufs-UI.
+
@@ -0,0 +1,35 @@
+# Direktverkauf
+Stand: 2026-06-15
+
+## Zweck
+
+Manuelle Erfassung von Direktverkaeufen und deren operative Ausloesung.
+
+## Owns
+
+- Direktverkaufsbelege
+- Erfassungsdaten
+- OTC-UI und OTC-API
+
+## Writes
+
+- Direktverkauf erfassen
+- Folgeschritte im ERP ausloesen
+
+## Reads
+
+- Kontakte optional
+- Lager
+- Bestellungen
+
+## Relevante Entry-Points
+
+- `public/otc/index.php`
+- `public/api/otc-order.php`
+
+## Grenzen
+
+- Keine Buchhaltung.
+- Keine allgemeine Bestellverwaltung.
+- Keine technische Runtime-Logik.
+
@@ -0,0 +1,35 @@
+# Import-Integration
+Stand: 2026-06-15
+
+## Zweck
+
+Technische Annahme externer Eingangsdaten und Weiterleitung an die owning Module.
+
+## Owns
+
+- Import- und Webhook-Einstiege
+- technische Importzustandsdaten
+- technische Events oder Ausfuehrungsmarker
+
+## Writes
+
+- Importausloesung
+- technische Verarbeitungsereignisse
+- kontrollierte Weitergabe an Fachmodule
+
+## Reads
+
+- Externe Payloads
+- Konfiguration
+- Zielmodul-Schnittstellen
+
+## Relevante Entry-Points
+
+- `public/order-import.php`
+- `order-import.php`
+
+## Grenzen
+
+- Keine Fachlogik fuer Bestellungen, Lager oder Buchhaltung.
+- Keine Dateninterpretation, die einem Fachmodul gehoert.
+
@@ -0,0 +1,37 @@
+# Kontakte
+Stand: 2026-06-15
+
+## Zweck
+
+Zentraler Kontaktstamm fuer Kunden, Lieferanten und sonstige Parteien.
+
+## Owns
+
+- `party`
+- `address`
+- `contact`
+
+## Writes
+
+- Kontaktstamm
+- Adressen
+- Kommunikationsdaten
+
+## Reads
+
+- Bestellungen
+- Buchhaltung
+- Kundenberatung
+
+## Grenzen
+
+- Keine Bestelllogik.
+- Keine Lagerlogik.
+- Keine Buchungslogik.
+
+## Relevante Schnittstellen
+
+- Kontaktanlage
+- Kontaktabfrage
+- Lookup fuer andere Module
+
@@ -0,0 +1,39 @@
+# Lager
+Stand: 2026-06-15
+
+## Zweck
+
+Bestand, Charge, MHD und Bewegungen.
+
+## Owns
+
+- `product`
+- `stock_lot`
+- `stock_move`
+- `v_stock_lot_balance`
+
+## Writes
+
+- Warenzugang
+- Warenabgang
+- Umlagerung
+- Chargenpflege
+
+## Reads
+
+- Bestellungen
+- Import-Integration
+- Direktverkauf
+
+## Submodule
+
+- Chargen
+- Bewegungen
+- Bestandsfuehrung
+
+## Grenzen
+
+- Keine Buchhaltung.
+- Keine Beratungslogik.
+- Keine fachfremden Artikelzuordnungen.
+
@@ -0,0 +1,33 @@
+# Kundenberatung
+Stand: 2026-06-15
+
+## Zweck
+
+Fall- und gespraechsbezogene Kundenberatung mit Rueckmeldung und Follow-up.
+
+## Owns
+
+- Beratungsgespraeche
+- Empfehlungen
+- Rueckmeldungen
+- Follow-ups
+
+## Writes
+
+- Gespraech erfassen
+- Bedarf dokumentieren
+- Empfehlungen pflegen
+- Rueckmeldungen nachhalten
+
+## Reads
+
+- Kontakte
+- Produkte
+- Bestellungen
+
+## Grenzen
+
+- Keine Buchhaltung.
+- Keine Lagerbestandswahrheit.
+- Keine technische Importlogik.
+
@@ -0,0 +1,29 @@
+# Shared
+Stand: 2026-06-15
+
+## Zweck
+
+Fachlich neutrale, wiederverwendbare technische Bausteine.
+
+## Enthalten
+
+- UI-Komponenten
+- Layout-Bausteine
+- Tabellen, Formulare, Statusdarstellung
+- Validierung ohne Fachentscheidung
+- Datums-, Geld- und Formatierungshelfer
+- technische API-Clients
+- Logging- und Session-nahe Hilfen
+
+## Ownership
+
+- Keine fachliche Primärverantwortung.
+- Keine Business-Logik.
+
+## Grenzen
+
+- Keine Lagerlogik.
+- Keine Buchhaltungslogik.
+- Keine Beratungslogik.
+- Keine Bestellfachlogik.
+
@@ -0,0 +1,25 @@
+# System
+Stand: 2026-06-15
+
+## Zweck
+
+Technische Laufzeit-, Start-, Trigger- und Supervisor-Logik.
+
+## Enthalten
+
+- Webhook-/Trigger-Logik
+- Start- und Deploy-Hooks
+- technische Jobsteuerung
+- Laufzeit- und Betriebslogik
+
+## Ownership
+
+- Keine fachliche Primärverantwortung.
+- Nur technische Infrastruktur- und Runtime-Funktionen.
+
+## Grenzen
+
+- Keine operativen Fachprozesse.
+- Keine Modul-Domain-Logik.
+- Keine Geschäftsregeln.
+