Files
tsumugu/docs/product/TSUMUGU_CONNECTOR_NACHARBEIT_REVIEW_2026-10-20.md
LarsandCursor c29bd29f34
Deploy Development / deploy (push) Successful in 39s
Test Suite / pytest-backend (push) Successful in 2m29s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 20s
Korrigiere IMAP-Ordner, MIME-Ansicht und die gemeinsamen Leser, damit große Postfächer, Notizen und verspätete Quellenantworten zuverlässig bleiben.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-20 08:47:24 +02:00

8.1 KiB

Prüfung der Connector-Nacharbeit

Stand: 20.10.2026. Geprüfter Arbeitsstand: C:/Dev/tsumugu. Keine Änderung an Anwendung, Repositorydokumenten oder Datenbanken; kein Push oder Deployment.

Ergebnis

Die Nacharbeit ist im Code vorhanden und ein deutlicher Fortschritt. Eine vollständige Abnahme des Auftrags ist noch nicht belegt. Die folgenden vier Restpunkte sind konkret eingegrenzt. Ein erneuter Architekturentwurf oder zusätzliche Produktfunktionen sind dafür nicht erforderlich.

Was tatsächlich hinzugekommen ist

  • Gemeinsame Quellenfreigabe über sourceaccess.py; der allgemeine E-Mail-Endpunkt verwendet das registrierte Modul statt eines fest eingebauten IMAP-Abrufs.
  • Paperless-Filter werden weitergereicht und auf Query, Titel, Korrespondent, Dokumenttyp, Tags, Dokumentdatum und Sortierung abgebildet. Ergebnisseiten und Stammdatenauswahl sind vorhanden.
  • IMAP verwendet begrenzte UID-Fenster, unterscheidet Suchfehler von leeren Ergebnissen und führt UIDVALIDITY sowie unvollständige Suchzustände mit.
  • Uploads und Versandfassungen verwenden adapter_for; die Lösch-/Bereinigungsobjekte können den zuständigen Adapter aufrufen.
  • MDXEditor ist lokal eingebunden. Notizen öffnen gerendert, lassen sich mit Formatierungsleiste bearbeiten und wechseln nach dem Speichern zurück zur Leseansicht.

1. Externe Abrufe laufen weiterhin teilweise innerhalb einer Fachtransaktion

Beleg: backend/app/sourceaccess.py:125 beendet zunächst die Transaktion. Der IMAP-Callback in backend/app/sources.py:387 ruft anschließend aber load_imap_original auf. Diese Funktion liest in backend/app/sources.py:1123 über _owned erneut aus der Datenbank und startet damit vor pull_rfc822 wieder eine Transaktion.

Auch backend/app/sources.py:1251 und :1272, die Paperless-/IMAP-Originale für Export und Versandfassungen laden, lösen die Transaktion vor ihrem Netzwerkabruf nicht. Die Freigabeprüfung nach dem Abruf aus der gemeinsamen Lesestrecke wird dort ebenfalls nicht verwendet. Dateiveröffentlichungen in ops.py und correspondence.py erfolgen weiterhin zwischen Fachschreiboperationen.

Eigener Nachweis: Zwei isolierte Python-Prüfungen ohne DB und Netzwerk haben die tatsächlichen Funktionen mit kleinen Verbindungs-/Transportattrappen aufgerufen. Beim Einstieg in den externen Transport war der Status sowohl im IMAP-Lesepfad als auch im Paperless-Exportpfad INTRANS.

Gezielte Nacharbeit: Die freigegebenen Verbindungsdaten vor dem externen Teil vollständig auflösen. Im externen Teil keine DB-Nachfrage einbauen, die die Transaktion erneut eröffnet. Für Export und Versandfassung ebenfalls vorbereiten, extern lesen und danach erforderliche Rechte/Versionen erneut prüfen. Schreibabläufe ausdrücklich in vorbereitende und abschließende Phasen teilen; kein pauschales Zwischen-Commit als Ersatz für einen sicheren Ablauf. Die abschließende Korrektheit bei Fehler und Entzug testen.

2. Markdown-Editor und gespeicherte Leseansicht unterstützen unterschiedliche Formatierung

Beleg: frontend/src/notes.jsx:154 aktiviert Überschriften ohne Einschränkung. Das installierte Plugin bietet Ebenen 1 bis 6 an. frontend/src/markdown.jsx:61 rendert dagegen nur Ebenen 1 bis 3. Der Renderer behandelt eingerückte Listenelemente als gleichrangig und beginnt geordnete Listen stets bei 1.

Eigener Nachweis: Den tatsächlichen MarkdownView mit dem vorhandenen JSX-Werkzeug im Speicher übersetzt und mit React serverseitig gerendert. Kein Build und keine Dateischreiboperation im Repository nötig:

  • #### Unterpunkt ergibt einen Absatz mit sichtbaren vier Rauten statt einer Überschrift.
  • - Ebene 1 mit eingerücktem - Ebene 2 ergibt zwei gleichrangige Listenelemente.
  • Eine mit 5. beginnende geordnete Liste enthält kein start-Attribut und wird damit ab 1 angezeigt.

Der gespeicherte Quelltext wird durch diesen Befund nicht nachweislich verändert. Die Leseansicht stellt seine Bedeutung aber falsch dar.

Gezielte Nacharbeit: Einen zum Editor passenden sicheren Markdown-Renderer verwenden und den gemeinsamen unterstützten Umfang testen. Keine weitere Sammlung einzelner Regex-Sonderfälle. Überschriften, verschachtelte Listen und Listenstartwerte nach Bearbeiten, Speichern, erneutem Öffnen und Quelltextwechsel prüfen. Bisherige Schutzregeln zu HTML, gefährlichen Links und externen Medien erhalten.

3. Die Darstellungs-/Editor-Registrierung ist noch keine Registrierung ausführbarer Komponenten

Beleg: frontend/src/sources/registry.jsx:29 registriert eine Zuordnung von Mediennamen auf Leserkennungen. ReadingPane.jsx entscheidet weiterhin anhand fest eingebauter Kennungen, welche Anzeige ausgeführt wird. Es importiert NoteEditor direkt und bindet ihn bei element.kind === "note" ein. Die editors-Struktur in registry.jsx:160 ist eine feste Objektliste; ein neuer registrierter Editor wird daraus nicht dynamisch ausgeführt.

Dadurch lassen sich Quellen mit vorhandenen Standardformaten besser ergänzen. Ein neuer Leser oder Editor kann aber weiterhin Änderungen im allgemeinen Reader benötigen. Die Abschlussmatrix beschreibt diesen Teil weitergehend als der Code.

Gezielte Nacharbeit: Tatsächliche Komponenten und ihre gemeinsamen Lade-/Speicher-/Konfliktverträge registrieren. Die allgemeine Hülle muss die registrierte Komponente aufrufen. Die interne Notiz bleibt eine Notiz mit ihrem bisherigen Speicherweg; ihre fachliche Identität muss dafür nicht geändert werden.

Abnahme: Eine kleine zusätzliche Testdarstellung und einen Testeditor allein durch Module und Registrierung einhängen und über die echte Leserhülle ausführen. Kein neuer produktiver Connector erforderlich. Eine bloße Stringzuordnung genügt nicht.

4. Verspätete Paperless-Suchantworten können einen neueren Zustand überschreiben

Beleg: frontend/src/pages/Sources.jsx:256 übernimmt nach jedem Suchaufruf ungeprüft items, next_page und connector_id. Währenddessen kann über das Auswahlfeld bei :369 die Instanz gewechselt oder eine weitere Suche gestartet werden. Es fehlt eine Anfragenkennung beziehungsweise eine andere Sicherung gegen verspätete Antworten. Der IMAP-Picker hat eine solche Sicherung bereits.

Auswirkung aus dem Codeablauf: Eine langsame Suche A kann nach dem Wechsel auf B oder nach einer neueren Suche noch eintreffen und die aktuelle Trefferliste und Instanzauswahl zurücksetzen. Das ist ein belegter möglicher Ablauf; eine Browser-Reproduktion mit künstlicher Verzögerung wurde hier nicht ausgeführt.

Gezielte Nacharbeit: Such-, Vorschau- und Stammdatenantworten an Instanz und konkrete Anfrage binden. Überholte Antworten ignorieren beziehungsweise abbrechen. Nach Instanzwechsel fremde Filter-IDs zurücksetzen oder ausdrücklich neu validieren. Bewusst gewählte Treffer weiter anhand ihrer gespeicherten Instanz erhalten.

Abnahme: Antwort A künstlich verzögern, zu Instanz B beziehungsweise Suche B wechseln, A erst danach freigeben. Treffer, Vorschau, Filterzustand und Auswahl dürfen nicht auf A zurückspringen.

Nachweisgrenzen

Die Abschlussmatrix nennt 82 bestandene Backend-Tests und einen erfolgreichen Frontend-Build. Diese vollständigen Läufe wurden bei dieser Prüfung nicht wiederholt. Die zusätzliche Prüfung war gezielt und lesend; sie hat keine echte Quelle und keine Datenbank angesprochen.

Der neue Paperless-Test belegt Parameterübertragung und Paging, sein Fake berechnet jedoch keine echte Filterwirkung: Er liefert dieselben Seitendaten unabhängig vom Suchinhalt. Die tatsächliche Filtersemantik an der Nutzerinstanz ist damit weiterhin offen. Laut Matrix wurde nur deren Schema gelesen.

Der bestehende dritte Source-Test prüft weiterhin die Frontend-Registrierung in Node und die Backend-Strecke. Er belegt keinen vollständigen Bedienablauf des dritten Connectors in der Oberfläche. Für den neuen Editor nennt die Matrix Browserprüfungen; eine zusätzliche eigene Browserprüfung wurde hier nicht vorgenommen.

Die reale Großordner-Abnahme bei IMAP und die Inhalts-/Filterabnahme bei Paperless bleiben nach dem vorliegenden Bericht offen. Bei Abschluss klar zwischen Codeänderung, synthetischem Nachweis und erfolgreichem Test an der echten Quelle unterscheiden.