diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 2e874e6..3eaf6bd 100644 --- a/docs/product/TSUMUGU_PRODUCT_SPEC.md +++ b/docs/product/TSUMUGU_PRODUCT_SPEC.md @@ -1,6 +1,6 @@ # Tsumugu – Fachliche Produktspezifikation -**Stand:** 16.10.2026 · **Arbeitsstand:** 0.19, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.20, 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. @@ -45,6 +45,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - 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. - Manuelle Zuordnung von Rechnungen, Erstattungen und Zahlungen im MVP; Sammelabrechnungen und Bankeingänge ohne eindeutige Rechnungsreferenz müssen berücksichtigt werden. +- Im Erstattungsfall soll der Regelfall mit der Erstattung erledigt sein. Rückfragen oder nachzureichende Belege können ihn offenhalten; dann muss er in der Aufgabenliste berücksichtigt werden. Teil-/Nacherstattungen sind selten, müssen aber möglich bleiben. Das universelle Finanzmodell muss außerdem anteilige Zahlungen auf Rechnungen berücksichtigen (F-03c). Nicht erstattbare Restbeträge und genaue Abschlussregeln sind noch zu klären. - Spätere KI-Nutzung eigener, geschützter Vorgangsinformationen vorbereiten. Keine belegte Pflicht zu einem autonomen Agenten im MVP. ## 3. Ergebnisse des Originalabgleichs @@ -72,7 +73,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 | „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. | +| 3 / F-03 | Bestehende Erstattungsdaten geklärt (F-03a/b). Mehrfach-/Teilerstattungen als seltene Fälle, offene Rückfragen/Nachweise mit Aufgabenbezug und anteilige Rechnungszahlungen als allgemeiner Bedarf bestätigt (F-03c). | Nächste Frage F-03d: fachlicher Abschluss bei endgültig nicht erstattbarem Restbetrag. Konkrete Betragszuordnungen, Zahlungszuordnung 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. | @@ -276,13 +277,23 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G **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 +### F-03c – Teilbeträge und offene Erstattungsfälle: Bedarf präzisiert am 16.10.2026 -Soll eine Rechnung mehrere Erstattungszuordnungen mit jeweils eigenem Betrag und Bezug zum Erstattungsbeleg erhalten können, deren Summe als zugeordneter Erstattungsbetrag angezeigt wird? +**Bestätigter Bedarf und Gewichtung:** Der Nutzer erklärt, dass eine Erstattung den Vorgang im Regelfall erledigen soll. Mehrere Teil-/Nacherstattungen derselben Rechnung sind in diesem Anwendungsfall eher untypisch, können aber in seltenen Fällen vorkommen. Nicht erstattete Teilbeträge können durch Grenzen entstehen; eine Erstattung kann außerdem wegen Rückfragen oder fehlender Belege noch ausstehen. Solange hierzu Klärungs-/Nachreichungsbedarf besteht, bleibt der Vorgang offen und muss in der Aufgabenliste berücksichtigt werden. In anderen Anwendungsfällen sind anteilige Zahlungen auf eine Rechnung ausdrücklich relevant. -**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. +**Auswirkungen auf Fachmodell und MVP:** Ein Modell, das pro Rechnung zwingend nur eine Erstattung oder eine Zahlung zulässt, deckt den beschriebenen Bedarf nicht ab. Der häufige einfache Fall soll einfach bedienbar bleiben; weitere Teilbeträge kommen bei Bedarf hinzu. Eine unvollständige Erstattung, ein endgültig nicht erstattbarer Anteil, eine noch offene fachliche Klärung und eine tatsächliche Teilzahlung sind unterschiedliche Sachverhalte. Das Modell darf nicht auf Krankenkassenerstattungen begrenzt werden. -**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. +**Weiterführender Modellvorschlag:** Beträge je Beziehung zwischen Rechnung und Erstattungsbeleg nachvollziehbar erfassen und an der Rechnung summieren; Zahlungen separat betragsbezogen zuordnen. Die Nutzerantwort bestätigt den Bedarf an Teil-/Mehrfachfällen und deren geringe Häufigkeit im Erstattungsfall, noch keine vollständige Feld-/Summen-/Korrekturregel. Fachliches Prüfszenario für die spätere Ausarbeitung: Eine ausstehende Erstattung mit nachzureichendem Beleg bleibt offen und erscheint mit dem nötigen Handlungsbedarf in der Aufgabenliste; eine anteilig bezahlte Rechnung verliert die Information über den noch offenen Zahlungsbetrag nicht. + +**Weiterhin offen:** Umgang mit endgültig nicht erstattbaren Anteilen (F-03d), Bedeutung von „Vorgang“ im konkreten Erstattungsablauf gegenüber einzelner Rechnung/Sammelabrechnung, Abschluss im Verhältnis zu Zahlungseingängen, Aufgabenanlage/-zuordnung/-fristen, Korrekturen/Storno, unklare Zuordnungen und Synchronisation von Summenwerten. „In der Aufgabenliste“ bedeutet noch keine beschlossene automatische Erzeugung separater Aufgaben für jede offene Rechnung. + +### F-03d – Abschluss bei endgültig nicht erstattbarem Anteil: nächste Frage, offen + +Soll ein Erstattungsvorgang fachlich abgeschlossen werden können, wenn der nicht erstattete Restbetrag endgültig geklärt und als nicht erstattbar akzeptiert ist? + +**Vorschlag:** Ja. Beispiel: Von 200 Euro Rechnungsbetrag werden 170 Euro erstattet; 30 Euro sind wegen einer bestätigten Grenze endgültig nicht erstattbar und es wird keine weitere Klärung verfolgt. Der Vorgang kann dann fachlich abgeschlossen werden, obwohl keine vollständige Erstattung vorliegt. Besteht dagegen noch eine Rückfrage oder wird ein weiterer Betrag erwartet, bleibt die Bearbeitung offen und der Handlungsbedarf sichtbar. Vorteil: bekannte nicht erstattbare Anteile erzeugen keine dauerhaften falschen offenen Erstattungsfälle; Nachteil: der Unterschied zwischen akzeptiertem Abschluss und weiter zu verfolgendem Rest muss ausdrücklich erkennbar sein. + +**Abgrenzung des Vorschlags:** Ein fachlicher Abschluss ist kein Nachweis eines tatsächlichen Geldeingangs oder der vollständigen Zahlung der Rechnung. Die genaue Abschlussregel im Verhältnis zu separaten Zahlungsvorgängen bleibt offen. Ein Restbetrag wird nicht allein wegen seiner Höhe oder einer vermuteten Grenze automatisch als endgültig nicht erstattbar behandelt. Noch keine Entscheidung hierzu getroffen. ## 6. Fortschreibung @@ -324,4 +335,6 @@ Soll eine Rechnung mehrere Erstattungszuordnungen mit jeweils eigenem Betrag und 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. +16.10.2026, Arbeitsstand 0.20: Nutzer präzisiert F-03c: einfache vollständige Erledigung als Erstattungsregelfall, seltene Teil-/Nacherstattungen, offene Rückfragen/Nachweise mit Aufgabenbezug; anteilige Rechnungszahlungen in anderen Anwendungsfällen relevant. Bedarf gesichert, keine pauschale Freigabe aller vorgeschlagenen Betrags-/Statusregeln angenommen. Nächste Frage F-03d betrifft Abschluss bei endgültig nicht erstattbarem Rest. 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.