Files
tsumugu/docs/product/TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md
LarsandCursor d6b70d8f92
Deploy Development / deploy (push) Successful in 28s
Test Suite / pytest-backend (push) Failing after 2m18s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 10s
Schließe die Connector-Kapselung ab, damit Paperless, IMAP und weitere Quellen über dieselbe Anbindung laufen.
Co-authored-by: Cursor <cursoragent@cursor.com>
2026-10-19 15:00:50 +02:00

7.2 KiB
Raw Permalink Blame History

Tsumugu – Ergebnis der Connector-/Storage-Grundlage

Stand: 19.10.2026. Dies ist der Zwischenstand vor den Abschlusskriterien. Maßgeblich für den Abschluss ist TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md. Die Kriterien stehen in TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md und haben Vorrang vor Formulierungen, die eine teilweise Integration als Abschluss zulassen.

Lokale Umsetzung von Abschnitt A aus TSUMUGU_CONNECTOR_UMBAU_AUFTRAG_2026-10-19.md nach TSUMUGU_CONNECTOR_STORAGE_VERTRAG_v0.1_2026-10-19.md.

Das ist ein Implementierungsnachweis, keine neue Fachversion. F-02b und F-02c bleiben. Abschnitt B, also der vervollständigte Quellenbrowser, die erweiterte Paperless-Suche und ein Editor für Markdown-Dateien, ist nicht begonnen.

Es gab keinen Push und kein Deployment.

Übernommene Dokumente

Aus dem Paket TSUMUGU_CONNECTOR_PLANUNG_2026-10-19.zip liegen unverändert im Repository:

  • docs/architecture/TSUMUGU_CONNECTOR_STORAGE_VERTRAG_v0.1_2026-10-19.md
  • docs/architecture/Tsumugu_Connector_Suite_Architektur_v0.2.md
  • docs/architecture/TSUMUGU_STORAGE_SCHLUESSEL_PRUEFAUFTRAG_2026-10-19.md
  • docs/product/TSUMUGU_CONNECTOR_UMBAU_AUFTRAG_2026-10-19.md

Die Begleitdatei README.md im Paket ist ein Deckblatt und wurde nicht über die Projekt-README gelegt. Der Prüfauftrag an die Architektur-Session wurde nur abgelegt, nicht versandt.

Was die Grundlage jetzt tut

  • Paperless und IMAP sind registrierte Adapter über den bestehenden Protokollcode. Ein POST legt eine weitere Instanz an. Ein PATCH ändert Zugangsdaten derselben Id.
  • Eine externe Referenz trägt connector_id ohne Fremdschlüssel und resolution (bound, ambiguous, unresolved, none). Dieselbe externe Nummer in zwei Instanzen bleibt getrennt. Ein gelöschter Zugang wird nicht auf eine andere Instanz umgehängt. Mehrdeutiger Bestand bleibt mehrdeutig, bis der Owner zuordnet. Ein eindeutiger Bestand wird beim Anlegen und einmalig im Backfill gebunden.
  • Eine Suche ohne connector_id ruft bei mehreren eigenen Paperless-Instanzen die Quelle nicht auf. Nicht erklärte Filter antworten 422 mit Code unsupported. IMAP behält Fach, Stichwort und Fortsetzung über before.
  • Ein Empfänger mit use_owner_sources liest das ausdrücklich freigegebene Original über den gebundenen Zugang des Owners. Zugangsdaten und die übrigen Treffer werden nicht ausgeliefert. Ohne diese Freigabe bleibt das Original unerreichbar.
  • Eigene Dateien und Versandfassungen laufen über den lokalen Storage-Port. Die Referenz trägt Instanz, Generation, Objektkennung und Inhaltsrevision. Schutzprofil und Schlüsselzuständigkeit liegen daneben. Der Bestand ist legacy-plaintext mit Schlüsselzuständigkeit none. Ein anderer MEDIA_ROOT erzeugt eine neue Schreibgeneration und liest die alte Generation weiter an der gebundenen Wurzel.
  • Profile managed-encrypted und client-encrypted liefern Metadaten und verweigern Klartext. Es gibt keine neue Verschlüsselung. Ein gespeicherter Dummy-Geheimtext, der unverändert zurückgelesen wird, ist kein Kryptographienachweis.
  • Die Oberfläche hängt die vorhandenen Paperless- und E-Mail-Auswahlen an eine gemeinsame Registrierung. Der Notizeditor bleibt der bestehende PATCH. markdown_file ist erklärt und nicht angeboten.

Tests

Backend-Suite am 19.10.2026 gegen die lokale Datenbank tsumugu_local_test: 69 Tests, Exitcode 0. Eine DeprecationWarning aus Starlette/anyio, kein Fehlschlag. Die sieben neuen Fälle in backend/tests/test_connector_basis.py prüfen Adapter-Rundlauf und Pfadabwehr, einen Wurzelwechsel ohne Umhängen, stabile Datei-Id und Bytes, die Ablehnung einer Notizbearbeitung an einer Datei, zwei Paperless-Instanzen mit derselben Nummer 15, eine Suche ohne Instanz ohne Quellaufruf, einen abgelehnten Korrespondent-Filter ohne Echo des Werts, mehrdeutigen Bestand bis zur Zuordnung, ein gesperrtes Profil ohne Klartext und einen PATCH, der die andere Instanz nicht verändert.

Die bestehende Suite blieb in demselben Lauf grün, darunter Export, Kapitel, Rechte, Postfächer, Owner-Quellen und Versandfassungen. Paperless und IMAP sind in diesen Tests nachgebildet. Es gab keinen Abruf einer lebenden Paperless- oder IMAP-Anlage. Die Mocks belegen den Vertrag im Prozess, nicht die entfernte API-Fassung.

Oberfläche

Der Produktionsbau des Frontends ist nach der Umbenennung der Registrierung nach frontend/src/sources/registry.jsx durchgelaufen.

Zusätzlich lief die Anwendung lokal auf 127.0.0.1:8019 mit Vite auf 127.0.0.1:5173 gegen die weggeworfene Datenbank tsumugu_browser_test. Port 8000 war auf diesem Rechner schon belegt. Geprüft wurde:

  • die Quellenseite zeigt beide registrierten Formulare, „Paperless-Instanz verbinden“ und „Konto hinzufügen“
  • zwei Paperless-Instanzen und ein IMAP-Konto bleiben nebeneinander stehen
  • „Zugang erneuern“ an Archiv Alpha sendet PATCH an dieselbe Id; das Secret der zweiten Instanz bleibt unverändert
  • in der Akte verlangt die Paperless-Auswahl bei zwei Instanzen eine Wahl und nennt die heutige Stichwortgrenze
  • die E-Mail-Auswahl zeigt das angelegte Konto, die IMAP-Grenze und bei einem unerreichbaren Beispielhost „Das Postfach ist nicht erreichbar“, ohne erfundene Fächer
  • eine Notiz lässt sich anlegen und im Leser öffnen; nach einer zwischenzeitlich erhöhten Version antwortet das Speichern mit 409, der Satz „Der Stand hat sich geändert. Der eingegebene Text bleibt stehen. Bitte neu laden.“ erscheint, und der eingegebene Text bleibt im Feld
  • bei 390 Pixel Breite bleiben Quellenseite und Leser ohne seitlichen Überlauf der Seite bedienbar

Die Beispielhosts waren nicht die echten Quellen. Ein Vorgang wurde nicht separat angeklickt; er verwendet dieselbe Registrierung wie die Akte.

Der Testlauf und die lokale Oberfläche benutzten eine temporäre Superuser-Rolle auf dem lokalen PostgreSQL. Diese Rolle und die Wegwerfdatenbank sind danach entfernt. Der bestehende Migrator setzt das Passwort von tsumugu_runtime auf das Passwort des verbindenden Owners. Damit dieses Testpasswort nicht liegen bleibt, wurde das Passwort der Runtime-Rolle lokal rotiert und nicht festgehalten. Der nächste Start mit dem Operatorpasswort setzt es wieder, wie im Datenmodell zu R-09 beschrieben.

Grenzen

  • Die anfragegebundene Datenbanktransaktion umschließt weiterhin den Quellabruf und das lokale Schreiben. Die Datei wird erst nach einem geprüften Rundlauf veröffentlicht, und ein Rollback entfernt die neue Datei. Das ist keine getrennte Transaktion von Datenbank und Dateisystem.
  • Zugangsdaten bleiben Klartext in connectors.secret (Review R-05). Es gibt keinen Schlüssel-Tresor und keinen SaaS-Nachweis.
  • Der Prüfauftrag zur Schlüsselhaltung wurde nicht an die Architektur-Session geschickt.
  • Abschnitt B ist der nächste, getrennt zu startende Funktionsausbau.
  • Der Befund R-10 beschreibt den früheren Zustand, dass der Betrachter seinen eigenen Zugang benutzte. Der Lesepfad folgt jetzt der dort empfohlenen Bindung an den Owner. Der Befundtext selbst wurde nicht umgeschrieben.