Erfasse manuelle Erstattungsbetraege je Rechnung mit Belegreferenz

This commit is contained in:
Lars committed 2026-10-16 14:15:44 +02:00
1 parent 337fcfb544
commit bb1c777558
1 file changed
+18 -7
+18 -7
View File
@@ -1,6 +1,6 @@
# Tsumugu – Fachliche Produktspezifikation
**Stand:** 16.10.2026 · **Arbeitsstand:** 0.18, Product Recovery und fachliches Interview.
**Stand:** 16.10.2026 · **Arbeitsstand:** 0.19, Product Recovery und fachliches Interview.
**Status:** Führende fachliche Arbeitsdatei; noch keine freigegebene Gesamtspezifikation.
Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das nächste Interview. Sie nimmt keine offenen Produktentscheidungen vorweg. Datenmodell, konkrete Workflows, MVP-Abnahmebedingungen und Implementierungsaufträge werden nach den jeweiligen Entscheidungen hier ergänzt. Anwendungscode, Datenbanken und Deployments sind nicht Gegenstand dieser Etappe.
@@ -40,6 +40,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch
- Eindeutige zulässige Metadatenänderungen werden automatisch abgeglichen. Wurde dasselbe Feld seit dem letzten gemeinsamen Stand in beiden Systemen unterschiedlich geändert, bleiben beide Werte bis zur bewussten Auflösung durch einen berechtigten Nutzer erhalten. Identische neue Werte sind kein Konflikt (F-02c bestätigt).
- Bestehende Paperless-Felder laut Nutzer: Rechnungsbetrag, Erstattungsbetrag, Zahlungsziel, bezahlt_am, erstattet_am, eingerecht_am sowie Ablaufdatum für die Aufbewahrungsfrist (F-02d). Dies ist eine Bestandsangabe, noch keine abschließende Synchronisationsfeldliste oder Feldzuordnung.
- „erstattet_am“ bezeichnet in der bestehenden Nutzung das Datum der Erstattungsmitteilung. Tatsächliche Zahlungseingänge werden bisher nicht überwacht (F-03a bestätigt). Historische Werte sind daher kein Nachweis für einen Geldeingang und dürfen beim späteren Abgleich nicht in Zahlungsdaten umgedeutet werden.
- Der bestehende „Erstattungsbetrag“ wird nur an der Rechnung gepflegt. Rechnungen werden mit Erstattungsbelegen verknüpft; der Nutzer versucht aus deren Angaben die jeweils betroffene Rechnung und den zugehörigen Betrag zu erkennen (F-03b). Dies ist eine manuelle fachliche Zuordnung, kein überwachter Zahlungseingang.
- Tsumugu kann eigene Dateien und Anhänge dauerhaft geschützt speichern, die nicht in Paperless liegen, und daneben externe Referenzen verwalten. Paperless-Dokumentdateien bleiben dort archiviert und werden referenziert. Eigene Ablage etwa für gespeicherte E-Mails mit Anhängen, Fotos oder später Sprachaufnahmen und externe Verweise etwa auf IMAP sind grundsätzlich möglich (F-02a bestätigt); genaue Ressourcentypen, Importfunktionen und MVP-Lieferumfang bleiben offen.
- Chronologische Kommunikation, Ereignisse, Aufgaben und Fristen. Dokumentdatum, Versand, Zugang und Erfassung bleiben semantisch getrennt; diese ausdrückliche Trennung ist im aktuellen Auftrag über die übernommene Baseline abgesichert, im direkt lesbaren Original nur teilweise aus dem Anwendungsfall belegbar.
- Aufgaben zunächst in Tsumugu; keine Übernahme der komplexen Kairo-Projektsteuerung. Später sollen Aufgaben auch in Kairo angelegt und verfolgt werden können.
@@ -71,7 +72,7 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt
|---|---|---|
| 1 / F-01 | Grundprinzipien F-01a–f und Strukturentscheidungen S-01a–f bestätigt, einschließlich ausdrücklicher Freigabe nachträglich ergänzter Inhalte. Späterer Zugang für einen Anwalt ausdrücklich gewünscht. | Erster Interviewdurchgang abgeschlossen; kein vollständiges Rechte-/Lebenszyklusmodell. Weitere Strukturbeziehungen, dynamische Sichten, externe Zugangsverfahren, konkrete Rechte-/Ownership-Übergänge, Rollen und Rechteentzug bleiben für die Ausarbeitung offen. |
| 2 / F-02 | Eigene Dateiablage (F-02a), feldweise Zuständigkeit (F-02b) und Konfliktregel (F-02c) bestätigt; sieben bestehende Paperless-Felder vom Nutzer benannt (F-02d). | Vor konkreter Feldzuordnung die finanzielle Bedeutung der Erstattungsangaben klären (F-03a). Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. |
| 3 / F-03 | Jetzt zur Klärung der bestehenden Felder: „erstattet_am“ ist Mitteilungsdatum, bisher keine Überwachung tatsächlicher Zahlungseingänge (F-03a). Manuelle Finanzzuordnung bleibt bestätigter MVP-Rahmen. | Nächste Bestandsfrage F-03b: wird der Erstattungsbetrag je Rechnung, auf dem Sammelbeleg oder auf beiden Ebenen gepflegt? Anschließend Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen konkretisieren. |
| 3 / F-03 | „erstattet_am“ ist Mitteilungsdatum, bisher keine Überwachung tatsächlicher Zahlungseingänge (F-03a). „Erstattungsbetrag“ bisher nur an der Rechnung; Referenz zum Beleg und manuelle Interpretation der Belegangaben (F-03b). | Nächste Frage F-03c: mehrere betragsbezogene Erstattungszuordnungen je Rechnung und deren Summe. Zahlungszuordnung, Differenzen und Korrekturen anschließend konkretisieren. |
| 4 / F-04 | Fachliche Chronologie und Fristen: Ereignistypen, belegte/unsichere Zeitangaben, Bezug zu Aufgaben, Verlängerungen und Erinnerungen. | Bestimmt, ob die beiden Ausgangsfälle praktisch bearbeitbar sind. Vorschlag: Fachereignisse von technischen Änderungen unterscheiden; Fristursprung und Änderungen erfassen. Automatische Rechtsfristberechnung nicht ohne gesonderte Entscheidung annehmen. |
| 5 / F-05 | Erster nutzbarer MVP-Durchstich und anschließende Ausbaureihenfolge innerhalb des bestätigten Rahmens. | Legt Fertigkriterien fest und verhindert eine Überladung. Vorschlag: Zuerst einen vollständigen manuellen Ablauf vom Ressourceneingang über Zuordnung bis zum Abschluss validieren und am zweiten Anwendungsfall gegenprüfen. Bereits bestätigte MVP-Bestandteile nicht stillschweigend streichen; Portalautomatik, KI, Importer und Kairo-Kopplung gesondert zeitlich einordnen. |
@@ -250,7 +251,7 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G
| Vom Nutzer benanntes Feld | Gesicherte Bedeutung / noch offene Semantik |
|---|---|
| Rechnungsbetrag | Genanntes Betragsfeld. Währung, brutto/netto und Korrekturregeln noch nicht spezifiziert. |
| Erstattungsbetrag | Genanntes Betragsfeld; mitgeteilter/bewilligter gegenüber tatsächlich eingegangener Betrag noch zu unterscheiden. |
| Erstattungsbetrag | Wird ausschließlich an der Rechnung gepflegt; Zuordnung aus den Angaben verknüpfter Erstattungsbelege, kein überwachter Zahlungseingang (F-03b). Mehrere Teilzuordnungen noch nicht spezifiziert. |
| Zahlungsziel | Bereits im ursprünglichen Anwendungsfall als Fälligkeit der Rechnung beschrieben; Verlängerungen noch zu modellieren. |
| bezahlt_am | Genanntes Zahlungsdatumsfeld; genaue Zahlungszuordnung und Teilzahlungen noch offen. |
| erstattet_am | Datum der Erstattungsmitteilung, kein Datum eines überwachten tatsächlichen Zahlungseingangs (F-03a bestätigt). |
@@ -267,13 +268,21 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G
**Vorschlag für Tsumugu, noch nicht abschließend beschlossen:** Erstattungsmitteilung, mitgeteilter Betrag und tatsächliche Zahlungseingänge getrennt führen. Die bereits bestätigte manuelle Zahlungszuordnung im MVP bleibt bestehen; konkrete Zahlungsdaten, Teilbeträge und Mehrfachbeziehungen sind als Nächstes zu spezifizieren. Die vorherige Empfehlung, „erstattet_am“ für den Geldeingang zu verwenden, ist durch die Bestandsklärung nicht angenommen und wird nicht auf historische Daten angewandt.
### F-03b – Bestehende Zuordnung des Erstattungsbetrags: nächste Bestandsfrage, offen
### F-03b – Bestehende Zuordnung des Erstattungsbetrags: geklärt am 16.10.2026
Wird das Feld „Erstattungsbetrag“ heute an der einzelnen Rechnung als ihr zugerechneter Betrag, an der Erstattungsmitteilung als Gesamtbetrag oder auf beiden Ebenen gepflegt?
**Bestätigte Bestandsangabe:** Der Nutzer pflegt den Erstattungsbetrag aktuell ausschließlich an der Rechnung. Die Rechnungen werden dem Erstattungsbeleg zugeordnet, sodass eine Referenz entsteht. Aus dem Erstattungsbeleg versucht der Nutzer zu erkennen, auf welche konkrete Rechnung sich die einzelnen Beträge beziehen. Ein eigenes gepflegtes Gesamtbetragsfeld am Erstattungsbeleg ist damit nicht belegt.
**Zweck:** Die aktuelle Abbildung von Sammelerstattungen verstehen, bevor ein Modell für Betragszuordnungen und die Synchronisationsfelder festgelegt wird. Keine Variante der bestehenden Nutzung wird vorausgesetzt.
**Auswirkungen:** Referenz und Betragszuordnung sind fachlich unterscheidbar. Eine bloße Referenz auf einen Sammelbeleg ersetzt noch keine zuverlässige Verteilung seiner Beträge auf Rechnungen. Die Zuordnung kann Interpretation erfordern und darf nicht als automatisch eindeutig oder als Nachweis tatsächlicher Zahlung verstanden werden. Der universelle manuelle Zuordnungsbedarf aus der Recovery wird durch das konkrete Vorgehen bestätigt.
**Empfehlung für das spätere Modell, noch offen:** Gesamtbetrag einer Erstattungsmitteilung und die davon einzelnen Rechnungen zugeordneten Beträge fachlich unterscheiden; tatsächliche Zahlungen zusätzlich getrennt behandeln. Die aktuelle Paperless-Abbildung soll gezielt übernommen/abgebildet werden, ohne die Erweiterbarkeit durch bisherige Feldgrenzen einzuschränken.
**Weiterhin offen:** Umgang mit mehreren Belegen pro Rechnung, Bedeutung/Summierung des einzelnen bisherigen Betragsfeldes in solchen Fällen, Korrekturen und unsichere Zuordnungen. Historische Teilbeträge je Referenz lassen sich aus einem einzelnen Rechnungsfeld nicht ohne gesicherte Grundlage rekonstruieren.
### F-03c – Mehrere betragsbezogene Erstattungszuordnungen je Rechnung: nächste Frage, offen
Soll eine Rechnung mehrere Erstattungszuordnungen mit jeweils eigenem Betrag und Bezug zum Erstattungsbeleg erhalten können, deren Summe als zugeordneter Erstattungsbetrag angezeigt wird?
**Vorschlag:** Ja. Ein Erstattungsbeleg kann wie bereits bestätigt mehrere Rechnungen betreffen; zusätzlich kann eine Rechnung mehrere Teil-/Nacherstattungen aus unterschiedlichen Belegen erhalten. Der Betrag gehört fachlich zur jeweiligen Zuordnung, die Rechnung zeigt die Summe dieser Zuordnungen. Beispiel: Rechnung 200 Euro, Beleg A ordnet 120 Euro zu, Beleg B weitere 50 Euro; die zugeordnete Erstattung beträgt 170 Euro. Daraus folgt noch kein tatsächlicher Geldeingang und keine Entscheidung darüber, ob die verbleibenden 30 Euro erwartet, abgelehnt oder ungeklärt sind.
**Abwägung:** Beträge und Herkunft bleiben nachvollziehbar, ohne frühere Werte bei einer weiteren Erstattung überschreiben zu müssen. Dafür benötigt die Rechnung bei mehreren Belegen eine kurze Liste ihrer Zuordnungen. Alternative: nur ein direkt gepflegter Gesamtwert je Rechnung plus Belegreferenzen ohne eigene Zuordnungsbeträge; weniger Eingaben, aber keine nachvollziehbare Verteilung auf die Belege. Noch keine Variante beschlossen. Korrekturen/Storno, unklare Zuordnungen, Beträge über dem Rechnungsbetrag, Währung und Synchronisation des Summenwerts bleiben offen.
## 6. Fortschreibung
@@ -313,4 +322,6 @@ Wird das Feld „Erstattungsbetrag“ heute an der einzelnen Rechnung als ihr zu
16.10.2026, Arbeitsstand 0.18: F-03a als Bestandsklärung gesichert: „erstattet_am“ ist Datum der Erstattungsmitteilung, tatsächliche Zahlungseingänge werden bisher nicht überwacht. Keine Umdeutung historischer Daten; keine Zustimmung zur vorigen Empfehlung eines Eingangsdatums unter diesem Feldnamen angenommen. Nächste Bestandsfrage F-03b betrifft die Ebene des gepflegten Erstattungsbetrags. Keine Änderung an Anwendungscode, Datenbanken oder Deployments.
16.10.2026, Arbeitsstand 0.19: F-03b geklärt: Erstattungsbetrag bisher nur an der Rechnung, Referenz zum Erstattungsbeleg; konkrete Rechnung/Beträge werden aus dem Beleg manuell erschlossen. Nächste Frage F-03c betrifft mehrere betragsbezogene Erstattungszuordnungen je Rechnung. Keine Änderung an Anwendungscode, Datenbanken oder Deployments.
Nach jeder Entscheidung diese Datei mit kurzer Begründung und Auswirkungen auf Fachmodell/MVP aktualisieren. Die historische Baseline bleibt unverändert. Keine Implementierung ohne ausdrückliche Freigabe; technische Umsetzung später anhand der dann freigegebenen Jinkendo-Blueprints.