diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index ef453ee..e03bd0f 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.17, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.18, 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. @@ -39,6 +39,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Paperless-Dokumente werden referenziert. Ausgewählte Metadaten müssen bidirektional synchronisierbar sein. Je synchronisiertem Feld wird ein fachlich maßgebliches System festgelegt; zulässige Änderungen können weiterhin aus beiden Systemen übernommen werden. Tsumugu hält eigene fachliche Beziehungen und Metadaten. Konkrete Feldliste, Zuordnung und Umfang der Übernahme vorhandener Paperless-Metadaten sind offen (F-02b bestätigt). - 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. - 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. @@ -70,7 +71,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: finanzielle Bedeutung von Erstattung, Geldeingang und Zahlung; danach Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen. | Nächste Frage F-03a: bezeichnet „erstattet_am“ den tatsächlichen Geldeingang oder eine Erstattungsmitteilung? Verhindert Vermischung von Zusage und Zahlung. Manuelle Zuordnung bleibt bestätigt; konkrete Regeln und Umfang 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. | | 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. | @@ -252,17 +253,27 @@ Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als G | Erstattungsbetrag | Genanntes Betragsfeld; mitgeteilter/bewilligter gegenüber tatsächlich eingegangener Betrag noch zu unterscheiden. | | 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 | Genanntes Datumsfeld; Erstattungsmitteilung gegenüber tatsächlichem Geldeingang offen (F-03a). | +| erstattet_am | Datum der Erstattungsmitteilung, kein Datum eines überwachten tatsächlichen Zahlungseingangs (F-03a bestätigt). | | eingerecht_am | Schreibweise aus der Nutzerantwort. Als Einreichungsdatum verstanden; diese Deutung ist eine Arbeitsinterpretation, der genaue Feldname bleibt beim späteren Abgleich zu prüfen. | | Ablaufdatum | Vom Nutzer ausdrücklich auf die Aufbewahrungsfrist bezogen. Daraus folgt keine bereits beschlossene automatische Löschung oder Fristberechnung. | **Abgrenzung:** Die im Originalchat erwähnten Statusfelder und Verknüpfungen zu Erstattungsbelegen bleiben als Ausgangsanforderung erhalten, sind durch diese Liste aber nicht genauer beschrieben. Aus der Bestandsliste folgen weder eine automatische Übernahme sämtlicher Felder noch eine abschließende Synchronisationsfeldliste. Das Finanzmodell darf nicht ungeprüft durch die bisherige Paperless-Abbildung begrenzt werden. Keine praktische Verbindung oder Änderung an bestehenden Daten. -### F-03a – Erstattungsdatum gegenüber Mitteilungsdatum: nächste Frage, offen +### F-03a – Bestehendes Erstattungsdatum ist Mitteilungsdatum: geklärt am 16.10.2026 -Bezeichnet „erstattet_am“ den tatsächlichen Geldeingang auf dem Konto oder das Datum der Erstattungsmitteilung? +**Bestätigte Bestandsangabe:** Der Nutzer erklärt ausdrücklich: „erstattet_am“ bezeichnet aktuell das Datum der Erstattungsmitteilung. Zahlungseingänge überwacht er bisher nicht. -**Empfehlung:** Als Erstattungsdatum den tatsächlichen Geldeingang verstehen und das Datum einer Mitteilung/eines Bescheids bei Bedarf als eigenen Zeitbezug führen. Vorteil: zugesagte Erstattung und verfügbare Zahlung bleiben für die Bearbeitung unterscheidbar; Nachteil: sofern beide Zeitpunkte benötigt werden, reicht ein einzelnes Datumsfeld nicht aus. Das ist noch kein Beschluss über neue Pflichtfelder. Die historische Nutzung des bestehenden Feldes muss erhalten bzw. bei einer späteren Übernahme bewusst abgebildet werden; eine abweichende bestehende Bedeutung wird nicht still umgedeutet. Mehrere Eingänge und Teilzahlungen sind anschließend gesondert zu modellieren. +**Auswirkungen auf Fachmodell und Datenübernahme:** Das bestehende Feld wird fachlich dem Mitteilungsdatum zugeordnet. Seine Werte dürfen weder durch bloße Umbenennung zu Zahlungseingängen werden noch als bestätigte Bankeingänge in Summen/Status einfließen. Dass keine Zahlungseingänge erfasst sind, belegt ebenso wenig, dass tatsächlich kein Geld eingegangen ist. Feldzuordnung und technische Synchronisationsnamen bleiben noch festzulegen. + +**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 + +Wird das Feld „Erstattungsbetrag“ heute an der einzelnen Rechnung als ihr zugerechneter Betrag, an der Erstattungsmitteilung als Gesamtbetrag oder auf beiden Ebenen gepflegt? + +**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. + +**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. ## 6. Fortschreibung @@ -300,4 +311,6 @@ Bezeichnet „erstattet_am“ den tatsächlichen Geldeingang auf dem Konto oder 16.10.2026, Arbeitsstand 0.17: Sieben bestehende Paperless-Felder vom Nutzer erfasst (F-02d), einschließlich Ablaufdatum ausdrücklich für Aufbewahrung. Originalschreibweise „eingerecht_am“ erhalten, Einreichungsdatum als Arbeitsinterpretation gekennzeichnet. Vor Feldzuordnung nächste Frage F-03a zur Bedeutung von „erstattet_am“; weitere Integrationspunkte bleiben offen. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +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. + 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.