diff --git a/docs/product/TSUMUGU_PRODUCT_SPEC.md b/docs/product/TSUMUGU_PRODUCT_SPEC.md index 3cfe425..ef453ee 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.16, Product Recovery und fachliches Interview. +**Stand:** 16.10.2026 · **Arbeitsstand:** 0.17, 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. @@ -38,6 +38,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch - Private Inhalte bleiben privat, bis sie bewusst freigegeben werden. Die Freigabe eines Elements in Vorgang B eröffnet weder Zugriff auf Vorgang A, in dem dasselbe Element eingebunden ist, noch auf weitere Inhalte von A. Eine Einschränkung im Kontext A ist nicht automatisch eine globale Sperre für eine ausdrücklich erlaubte Einbindung in B; globale Schutzregeln sind noch zu klären. - 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. - 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. @@ -68,8 +69,8 @@ Die Reihenfolge ist zugleich der vorgeschlagene Interviewablauf. Die fünf Punkt | Prio / ID | Entscheidungsgegenstand und Status | Einfluss, bestätigter Teil und verbleibende Vorschläge | |---|---|---| | 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 | Jetzt im Interview: eigene Datei-/Anhangsspeicherung (F-02a), feldweise Zuständigkeit bei bidirektionaler Metadatensynchronisation (F-02b) und bewusste Auflösung echter Änderungskonflikte (F-02c) bestätigt. | Nächster Schritt F-02d: tatsächlich genutzte zusätzliche Paperless-Felder erfassen. Konkrete Feldzuordnung, Quellenlebenszyklus und Rechtekontext bleiben offen. | -| 3 / F-03 | Bedeutung der Finanzbeziehungen und Status: beantragt, bewilligt, eingegangen, bezahlt; Teil-/Mehrfachzuordnungen, Restbeträge und Korrekturen. | Verhindert falsche Offensummen und Vermischung von Zusage und Zahlung. Vorschlag: Beträge manuell und nachvollziehbar zuordnen, unklare Beträge unzugeordnet lassen; keine erzwungene Eindeutigkeit oder automatische Buchhaltung. Umfang der Korrekturregeln gemeinsam festlegen. | +| 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. | | 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. | @@ -241,13 +242,27 @@ Beziehungen zu Beteiligten, Statuswerte und konkrete Bedienabläufe werden bei d **Auswirkungen auf Fachmodell und MVP:** Der Abgleich muss den letzten gemeinsam abgeglichenen Stand gegenüber den aktuellen Werten beider Seiten unterscheiden können. Fachliche Prüfszenarien: Einseitige Änderung wird übernommen; unterschiedliche beidseitige Änderung wird zur Entscheidung angezeigt und nicht still überschrieben; gleiche beidseitige Änderung wird ohne Konflikt behandelt. Darstellung, Wiederholungsversuche, besondere Feldtypen und technische Erkennung bleiben für die Ausarbeitung offen. -### F-02d – Bestehende zusätzliche Paperless-Felder: nächste Bestandsfrage, offen +### F-02d – Bestehende zusätzliche Paperless-Felder: Nutzerbestand erfasst am 16.10.2026 -Welche selbst angelegten Felder nutzt der Nutzer aktuell in Paperless, insbesondere für Rechnungen und Erstattungen? +Der Nutzer nennt folgende tatsächlich genutzte Felder. Schreibweisen sind als Gesprächsangaben gesichert; exakte API-Feldnamen, IDs und Datentypen sind nicht geprüft. -**Bereits belegt:** Betrag, Zahlungsziel, Statusfelder und Verknüpfungen von Erstattungsbelegen zu Rechnungen werden im ursprünglichen Anwendungsfall erwähnt. Exakte Feldnamen, Datentypen, Statuswerte und die Umsetzung der Verknüpfungen sind nicht bekannt. Daraus wird noch keine vollständige oder verbindliche Synchronisationsfeldliste abgeleitet. +| 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. | +| 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). | +| 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. | -**Empfehlung zum Vorgehen:** Zunächst die tatsächlich genutzte Struktur anhand einer groben Nutzerliste erfassen und danach die benötigten gemeinsamen Felder auswählen. Das Finanzmodell darf nicht ungeprüft durch die bisherige Paperless-Abbildung begrenzt werden; konkrete Zuordnung und Migrationsbedarf erst anhand der Fachanforderungen festlegen. Keine praktische Paperless-Verbindung oder Änderung an bestehenden Daten in diesem Schritt. +**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 + +Bezeichnet „erstattet_am“ den tatsächlichen Geldeingang auf dem Konto oder das Datum der Erstattungsmitteilung? + +**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. ## 6. Fortschreibung @@ -283,4 +298,6 @@ Welche selbst angelegten Felder nutzt der Nutzer aktuell in Paperless, insbesond 16.10.2026, Arbeitsstand 0.16: F-02c bestätigt: eindeutige zulässige Änderungen automatisch abgleichen, echte konkurrierende Widersprüche ohne stilles Überschreiben zur bewussten Entscheidung erhalten. Nächster Schritt F-02d erfasst die tatsächlich genutzten zusätzlichen Paperless-Felder, bevor konkrete Synchronisationsfelder zugeordnet werden. Keine Änderung an Anwendungscode, Datenbanken oder Deployments. +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. + 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.