Mache große IMAP-Fächer, die Paperless-Suche und die interne Markdown-Notiz über die gemeinsamen Schnittstellen benutzbar.
Deploy Development / deploy (push) Successful in 41s
Test Suite / pytest-backend (push) Failing after 2m55s
Test Suite / smoke-dev (push) Successful in 0s
Test Suite / frontend-build (push) Successful in 23s

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
LarsandCursor committed 2026-10-20 07:34:14 +02:00
1 parent c3a07cee64
commit 7e39fbb2bd
29 files changed
+6053 -320

No files matched your search

+1
View File
@@ -30,6 +30,7 @@
| [TSUMUGU_CONNECTOR_UMBAU_AUFTRAG_2026-10-19.md](product/TSUMUGU_CONNECTOR_UMBAU_AUFTRAG_2026-10-19.md) | begrenzter Umsetzungsauftrag, Abschnitt A beauftragt, Abschnitt B der nächste Ausbau | 19.10.2026 |
| [TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md](product/TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md) | Abschlusskriterien der Kapselung; Vorrang vor einem teilweise integrierten Zwischenstand | 19.10.2026 |
| [TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md](product/TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md) | Kriterium, Nachweis und Ergebnis der Kapselung | 19.10.2026 |
| [TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md](product/TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md) | Nacharbeit: IMAP-Seiten, Paperless-Suche, Markdown-Notiz | 19.10.2026 |
| [TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md](product/TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md) | früherer Zwischenstand von Abschnitt A vor den Abschlusskriterien | 19.10.2026 |
| [TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md](product/TSUMUGU_WEITERPLANUNG_UEBERGABE_2026-10-17.md) | Einstieg für die fachliche Weiterplanung | 17.10.2026 |
| [TECHNICAL_SPEC_HANDOFF.md](product/TECHNICAL_SPEC_HANDOFF.md) | historischer Auftrag zur technischen Spezifikation | 16.10.2026 |
@@ -43,6 +43,35 @@ Ein produktiver Connector folgt demselben Schnitt:
- Historische Migrationen, Testdoubles und die Dokumentation.
- Der Paperless-Dateizugriff auf ein lokales Archiv bleibt im Connector-Modul. Eigene Uploads und Versandfassungen schreiben über den Storage-Port. Die Anfrage räumt danach nur Pfade ab, die der Adapter selbst veröffentlicht hat. Die Fixture-Bereinigung löscht Bestandsdateien an derselben Objektkennung.
## Grenzen
## Grenzen vor der Nacharbeit
Die Anfrage-Transaktion umfasst weiterhin den Quellabruf und das lokale Schreiben. Zugangsdaten liegen als Klartext in `connectors.secret`. Es gibt keine neue Verschlüsselung, keine erweiterte Paperless-Suche, keinen Markdown-Dateieditor und keinen Remote-Speicher. Der Testadapter ist kein produktiver Dienst. Lebende Paperless- und IMAP-Anlagen wurden nicht geprüft.
Dieser Absatz beschreibt den Stand vor der Nacharbeit am selben Tag. Die Anfrage-Transaktion umfasste damals noch den Quellabruf. Zugangsdaten liegen als Klartext in `connectors.secret`. Es gibt keine neue Verschlüsselung und keinen Remote-Speicher. Der Testadapter ist kein produktiver Dienst.
## Nacharbeit am 19.10.2026
Auftrag: [TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md](TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md). Die historische Suite oben bleibt unverändert. Die neue Suite `tests` lief danach mit **82 Tests, Exitcode 0**. Der Paperless-Filtertest wurde nach der Relevanzzuordnung einzeln erneut ausgeführt und ist grün. Der Frontend-Build ist durchgelaufen. Kein Push und kein Deployment.
IMAP, Paperless-Treffer und der Speicheradapter in `test_connector_followup.py` sind nachgebildet. Das ist kein lebender Postfach- oder Dokumentabruf. Die laufende Paperless-Instanz `paperless-webserver-1` wurde nur am Schema gelesen: Paperless-ngx **2.20.6**. `query` ist die Volltextsuche, `title__icontains` das eigene Titelfeld, `tags__id__all` die Und-Verknüpfung, `created` das Dokumentdatum neben `added` und `modified`. `score` ist kein Sortierfeld. Eine Suche ohne `ordering` ist dort die Relevanzreihenfolge. Dokumentinhalte wurden nicht gelesen.
| Paket | Nachweis | Ergebnis |
|---|---|---|
| A Gemeinsamer Zugriff, Darstellung, Speicher | `sourceaccess.py`, Briefkasten-Test ohne IMAP, Speicherstest über `adapter_for` | Bestanden in der nachgebildeten Suite. Upload, erneutes Lesen, Versandfassung, Export und Löschen laufen über die aufgelöste Instanz. Fehlende Instanzzeile bleibt der bisherige lokale Pfad. |
| B IMAP-Seiten | `test_large_folder_is_bounded_and_a_late_hit_is_not_empty`, Fehler- und UIDVALIDITY-Tests | Bestanden gegen den nachgebildeten Server. Ein Fach mit Lücken bleibt seitenweise begrenzt. Ein Treffer hinter der ersten Seite ist kein leeres Fach. NO, abgebrochene Köpfe und ein UIDVALIDITY-Wechsel sind eigene Zustände. Ein lebendes Postfach wurde nicht geprüft. |
| C Paperless-Suche | Filtertest und Schema 2.20.6 | Bestanden gegen den nachgebildeten Abruf und das gelesene Schema. Inhalt, Titel, Korrespondent, Typ, mehrere Tags, Dokumentdatum, Seite 3 und zwei Instanzen derselben Dokumentnummer sind getrennt. Eine Suche in den echten Dokumenten steht aus. |
| D Markdown-Notiz | Notiztest und Browser am lokalen Testkonto | Bestanden für gemeinsamen Text, Export, Leserecht und Konflikt. Die formatierte Bearbeitung mit `@mdxeditor/editor` 3.52.4, MIT, ist im Browser geöffnet worden: Leiste, Quelltextumschaltung, gespeicherte Ansicht, Abbrechen. Ein Listenstrich und ein Stern gelten beim Öffnen als dieselbe Liste. Jede andere Abweichung bleibt im Quelltext. `markdown_file` bleibt aus. |
## Anleitung für ein weiteres Modul
Ein Quellenmodul registriert sich mit `register_source` und liefert nur Fähigkeiten, die es ausführt. Die Oberfläche ruft `registerSourceModule` auf und ersetzt die Registrierung nicht. Eine bekannte Darstellung wird mit `registerRepresentation` gebunden; die Notiz nutzt `markdown` → `note` und erscheint nicht unter Quellen. Ein Speicheradapter kommt in die Fabrik von `adapter_for` und wird über die gespeicherte Instanz aufgelöst. Ein Editor hängt an derselben Ressourcenansicht. Fachseiten, Rechte und das Schema zählen die Art nicht auf.
## Weiterhin zulässige Quellkenntnis
- Protokoll, Konfiguration, Suche und Auswahl von Paperless und IMAP in `backend/app/sources.py` und `frontend/src/pages/Sources.jsx`.
- Die Kompatibilitätsrouten delegieren an dieselben Dienste.
- Die Darstellung `email` öffnet das registrierte Modul und danach den gemeinsamen Mail-Leser.
- Stammdaten, Seitenzahl und Vorschau bleiben an Instanz und Recht gebunden.
- Historische Migrationen, Testdoubles und diese Dokumentation.
## Laufzeit und Erweiterbarkeit
Der Netzwerkabruf wird vor dem externen Aufruf aus der offenen Fachtransaktion gelöst und danach auf Recht und Instanz geprüft. Große IMAP-Fächer lesen begrenzte UID-Fenster, nicht die gesamte Liste je Seite. Paperless-Seiten sind die eigene Seitennummer, keine weitergereichte Fortsetzungsadresse. Die Erweiterung um eine Quelle, eine Darstellung oder einen Editor braucht kein neues Rechtsschema. Eine neue Speicherart braucht eine Fabrik und bleibt an die gespeicherte Instanz gebunden. Es gibt keine zusätzliche Verschlüsselung und keinen weiteren Produkt-Speicher.
@@ -0,0 +1,141 @@
# Cursor-Auftrag: Connector-Kapselung abschließen, IMAP und Paperless verbessern, Markdown-Notizen bearbeiten
**Stand:** 19.10.2026
**Zielort:** `C:/Dev/tsumugu/docs/product/TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md`
**Status:** Umsetzungsauftrag nach Übergabe an Cursor, bis zur lokalen Prüfung. Dieses Dokument selbst ändert keine Anwendung. Kein Push und kein Deployment.
## 1. Ziel und Verbindlichkeit
Arbeite im vorhandenen Repository `C:/Dev/tsumugu`. Erhalte laufende Änderungen, Bestandsdaten, bestätigte Fachentscheidungen und die ausgewählte Gestaltung. Liefere ein funktionierendes System mit standardisiert erweiterbaren Connectoren und den drei konkret benötigten Verbesserungen. Eine Registrierung neben weiter bestehenden Sonderwegen genügt nicht.
Lies gezielt:
1. `AGENTS.md` und die einschlägigen Abschnitte der aktuellen `docs/product/TSUMUGU_PRODUCT_SPEC.md`, insbesondere gemeinsamer Notizinhalt, kontextbezogene Rechte, Quellen und Export.
2. `docs/product/TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md` und die aktuelle Abschlussmatrix. Die Matrix ist eine zu prüfende Ergebnisbehauptung, keine Ausnahme von den Anforderungen.
3. `docs/architecture/TSUMUGU_CONNECTOR_STORAGE_VERTRAG_v0.1_2026-10-19.md` und die Connector Suite v0.2 im selben Verzeichnis; ergänzend den bisherigen Umbauauftrag für bestehende Schnittstellen und Abnahme.
4. Die betroffenen Architekturregeln und Blueprints unter **`docs/reference/`**, insbesondere Auth/Session/Scope, Medien/Dateien/sicheres Rendering und die Regeln zu kurzen Transaktionen in der Referenzarchitektur. Der Verzeichnisname ist `reference`, nicht `references`. Lokale Kopien verwenden; alte absolute Pfade in diesen Dokumenten sind kein Auftrag zur Änderung anderer Produkte.
Dieser Auftrag startet die hier beschriebene erweiterte Paperless-Suche ausdrücklich. Er erweitert die bisher zurückgestellte Notizbedienung. Er startet keine bidirektionale Paperless-Synchronisation und keine allgemeine MD-Dateischreibfunktion. Frühere gegenteilige Umfangsgrenzen sind nur für diese ausdrücklich genannten Funktionen überholt. Keine erneute vollständige Produktspezifikation oder Repositoryinventur.
## 2. Befund und gewünschtes Verhalten unterscheiden
**Nutzerbeobachtungen:** Große IMAP-Ordner erscheinen leer; auch einschränkende Suche liefert dort nichts. Die Paperless-Suche wirkt wie reine Titelsuche und bietet keine weiteren Eingrenzungen. Notizen sollen nach dem Speichern formatiert lesbar sein; gewünscht ist ein echter Markdown-Editor, bevorzugt auch direkte Bearbeitung in der formatierten Ansicht mit Schaltern.
**Gezielte Codebefunde vor Übergabe, erneut am tatsächlichen Arbeitsstand prüfen:**
- `backend/app/sources.py::_imap_page` ruft eine ordnerweite UID-Suche auf, wertet nur `data[0]` aus und liefert auch bei `status != OK` eine leere Trefferliste. `_fetch_header` verwirft einzelne Abruffehler still. Das belegt problematische Fehlerbehandlung; die konkrete Ursache im betroffenen Ordner ist noch nicht nachgewiesen.
- `paperless_documents` sendet bereits `query` an `/api/documents/`, begrenzt auf 20 Ergebnisse und reicht keine Fortsetzung weiter. Daraus folgt **kein** Beweis einer technisch ausschließlich auf Titel beschränkten Suche. `_paperless_find` verwirft zusätzliche Optionen; der allgemeine Suchaufruf reicht Filter nicht vollständig weiter.
- `MarkdownEditor` ist derzeit ein Textfeld mit einfacher Vorschau. Der Reader bleibt auch nach dem Speichern im Bearbeitungsformular. `frontend/src/markdown.jsx` enthält einen begrenzten selbstgebauten Renderer.
- Der dritte Source-Test belegt Backend-Aufrufe und eine Frontend-Registrierung, aber keinen vollständigen Bedienablauf. Der zweite Storage-Adapter wird isoliert geprüft; die Anwendung erzeugt an mehreren Stellen weiterhin direkt `LocalAdapter`.
Reproduziere Fehler vor der Behebung und kennzeichne Vermutungen als solche. Kein Bericht darf aus synthetischen Tests einen erfolgreichen Abruf der echten Nutzerquelle ableiten.
## 3. A – Kapselung tatsächlich abschließen
### Quellen, Rechte und Inhaltszugriff
- Protokoll, Konfiguration, Suchoptionen, Navigation, Ressourcenauflösung, Mapping und Fehlerübersetzung gehören zum registrierten Connector-Modul. Quellspezifische Formulare und Filter gehören zu dessen UI-Modul. Gemeinsame Seiten setzen diese Module zusammen.
- Ein gemeinsamer Zugriffsdienst verantwortet Tsumugu-Identität, Datenraum, Kontextrechte, konkrete Quellinstanz und erlaubte Owner-Vermittlung. Ein neuer Adapter darf diese Freigabe- und Auditabläufe nicht kopieren müssen. Quellseitige zusätzliche Einschränkungen bleiben beim Adapter. Bestehende Rechte werden nicht erweitert.
- Quelle und Darstellung trennen: Eine Quelle, die E-Mail-Originale bereitstellt, muss den vorhandenen Mail-Leser einschließlich Anlagen nutzen können. `_complete_mail` darf nicht direkt auf einen ausschließlich IMAP-fähigen Zugriff festgelegt bleiben. Analog PDF, Bild und Text über autorisierten Ressourcenabruf führen.
- Leser und Editoren als registrierte Komponenten mit gemeinsamem Lebenszyklus anbinden. Neue Darstellungen dürfen eigene registrierte Bausteine benötigen, ohne Änderungen in Akten-/Vorgangsseiten oder Exportsteuerung. Eine Funktion, die nur feste Darstellungsnamen umbenennt, ist noch keine solche Registrierung.
- Typisierte, vom jeweiligen Modul validierte Optionen und Ressourcenkennungen vollständig durchreichen. Keine dauerhafte zentrale Liste aller providerspezifischen Suchfelder. Bestehende Standardfelder können gemeinsame Verträge bleiben. Kompatibilitätsrouten delegieren an dieselben Dienste; keine zweite aktive Fachlogik.
- Neue Module werden an einem ausdrücklichen Einstieg registriert. Eine Fachseite darf nicht beim Import die bereits gefüllte Registry löschen und neu mit zwei festen Quellen belegen.
### Storage und Transaktionen
- Den tatsächlichen Adapter anhand der gespeicherten Storage-Instanz über eine gemeinsame Auflösung beziehen. Uploads, Lesen, Löschen, Rollback-Bereinigung und Versandfassungen verwenden diesen Zugang. Direkte Konstruktion von `LocalAdapter` in Fachoperationen beseitigen; lokale Pfade gehören zum lokalen Adapter.
- Den vorhandenen Testadapter durch diese echte Zugriffsstrecke prüfen, nicht nur seine Methoden nebeneinander aufrufen. Kein zusätzlicher produktiver Cloud-/NAS-Dienst erforderlich. Bestandsreferenzen, Generationen und Inhaltsrevisionen erhalten.
- Externe Abrufe und größere Dateioperationen aus offenen Fachtransaktionen lösen. Autorisierten Abruf vorbereiten, externe Arbeit ausführen, vor Veröffentlichung beziehungsweise endgültiger Ausgabe erforderliche Rechte und Versionen erneut prüfen. DB und Ablage nicht als gemeinsame atomare Transaktion behandeln; Fehler und Bereinigung nach dem bestehenden Vertrag abwickeln.
- Nicht unterstützte Schutzprofile bleiben gesperrt. Keine neue Verschlüsselung in diesem Auftrag.
## 4. B – IMAP: große Ordner korrekt anzeigen und durchsuchen
**Ergebnis:** Ein großer, befüllter Ordner ist durchblätterbar. Eine Suche erfasst den gesamten gewählten Ordner, auch Treffer außerhalb der ersten Seite. Leer, keine Treffer, unvollständiger Abruf und Fehler sind unterschiedliche Zustände.
1. Ursache mit aussagekräftigen, inhaltsarmen Diagnosen eingrenzen: Ordnerauswahl, Anzahl/UID-Bereich soweit verfügbar, Suchstatus, Antwortumfang und -form, Timeout/Protokollfehler und Headerabruf. Keine Zugangsdaten, Nachrichtentexte oder vollständigen privaten Header protokollieren.
2. Erfolgreiche leere Suche von `NO`, `BAD`, Verbindungsabbruch, Timeout und ungültiger Antwort unterscheiden. Bei Fehlern keine Meldung „Ordner leer“ oder „keine Treffer“ ausgeben. Stille Fehler beim Headerabruf dürfen einen befüllten Ordner nicht scheinbar leeren.
3. Ordnernavigation und Suche für große UID-Bestände begrenzen und seitenweise verarbeiten. Nicht bei jedem Blättern beliebig große vollständige UID-Listen übertragen und sortieren. Geeignete Serverfähigkeiten nutzen; eine kompatible, begrenzte Strategie für Server ohne zusätzliche Sucherweiterungen erhalten. Nicht pauschal globale Bibliothekslimits erhöhen oder Timeouts unbegrenzt verlängern.
4. Suchkriterien serverseitig auf den ganzen Ordner anwenden beziehungsweise bei begrenzter Bereichssuche nachweisbar vollständig fortsetzen. Ein nicht untersuchter Rest darf nicht als endgültig trefferlos gelten. Eine Antwort enthält eine Fortsetzung oder einen erkennbaren unvollständigen Zustand, wenn die Suche noch nicht abgeschlossen ist.
5. Cursor an Zugang, Ordner, Suchanfrage und nötigen Identitätsstand binden; UID-Lücken, entfernte Nachrichten und UIDVALIDITY-Wechsel sicher behandeln. Bei wechselndem Bestand keine unbemerkte Verwechslung mit einer anderen Nachricht.
6. Antwortzeiten und Zahl externer Aufrufe für den Regressionstest dokumentieren. Nur Metadaten für die aktuelle Seite laden; vollständige Nachrichten und Anlagen erst auf Anforderung. Nur lesender Zugriff, keine Veränderung des Gelesen-Status.
7. Bei schnellem Ordner-/Suchwechsel dürfen verspätete Antworten nicht die neue Ansicht überschreiben. Auswahl und Zielkontext bleiben korrekt. Fremde oder entzogene Zugänge bleiben geschützt.
## 5. C – Paperless: brauchbare Suche mit Eingrenzungen
**Ergebnis:** Dokumente lassen sich über ihren Inhalt finden und über sichtbare fachliche Filter eingrenzen. Die Suche funktioniert auch jenseits der ersten Ergebnisseite.
Liefern:
- Freitextsuche mit klarer Beschriftung für Titel und Dokumentinhalt sowie ein getrenntes Titelfeld zur zusätzlichen Eingrenzung. Inhaltsbegriffe, die nicht im Titel stehen, müssen im passenden Testbestand Treffer liefern.
- Korrespondent und Dokumenttyp als Auswahl anhand der am konkreten Zugang sichtbaren Stammdaten; Tags als Mehrfachauswahl. Für mehrere Tags eine klar erkennbare Verknüpfung anbieten, mindestens „alle ausgewählten Tags“. Keine still wechselnde UND-/ODER-Semantik.
- Dokumentdatum von/bis, mit sichtbarer Bedeutung; nicht ungefragt Upload-/Änderungsdatum verwenden. Leere Grenzen zulassen, ungültige Bereiche verständlich ablehnen.
- Sortierung mindestens nach Dokumentdatum und Titel, auf-/absteigend; Relevanz anbieten, soweit die eingesetzte API dies für die gewählte Suche unterstützt. Stabile Fortsetzung berücksichtigen.
- Weitere Ergebnisseiten, aktiven Filterzustand, Zurücksetzen und Vorschau vor Übernahme. Bereits bewusst gewählte Dokumente bei Seiten-/Suchwechsel erhalten und sichtbar machen; Auswahl nach Instanz und Ressourcen-ID führen.
Suchtext und verschiedene Filter werden gemeinsam angewendet. Filterdaten bleiben im zuständigen Connector. Der gemeinsame Dienst darf validierte Filter nicht nach der Prüfung verwerfen. Fähigkeiten erst aktiv ausweisen, wenn die Operation ausführbar ist. Nicht unterstützte Parameter dürfen nicht still ignoriert werden.
Die konkret eingesetzte Paperless-Version und deren API-Schema prüfen. Moderne Dokumentation ist keine Zusage über eine ältere Nutzerinstanz. Kein eigener Volltextindex und keine lokale Nachfilterung lediglich der ersten 20 Treffer. Von der API gelieferte Fortsetzungsadressen nur innerhalb der vertrauenswürdigen Instanz verwenden; keine Credential-Weitergabe an fremde Hosts. Instanz- und Rechtebindung gilt auch für Stammdaten, Zähler und Vorschau.
Die generelle Sucherweiterung ist beauftragt. Individuelle Finanzfelder, benutzerdefinierte Feldabfragen und Metadatenänderungen sind hier kein zusätzlicher Pflichtumfang.
## 6. D – Notizen: Markdown bearbeiten, anschließend formatiert lesen
### Fachliche Einordnung und Pflichtverhalten
Eine interne Notiz muss nicht als externe Quelle unter „Quellen“ erscheinen. Benötigt werden ein registrierter interner Notiz-Zugriff und ein wiederverwendbarer Markdown-Leser/Editor über die gemeinsame Ressourcen-/Editor-Schnittstelle. Notizen behalten ihre vorhandene Identität und Speicherung; sie werden nicht automatisch zu Dateien oder pro Einbindung kopiert. Eine spätere MD-Datei kann denselben Editor mit einem anderen Speicheradapter nutzen; das Schreiben externer MD-Dateien ist jetzt nicht beauftragt.
- **Öffnen:** Gespeicherte Notizen zunächst gerendert anzeigen. Bei Bearbeitungsrecht gibt es „Bearbeiten“; bei reinem Leserecht keinen aktiven Editor. Das gilt auch beim erneuten Öffnen und für bestehende Notizen.
- **Bearbeiten:** Eine klar erkennbare Bearbeitungsansicht mit Formatierungsleiste und Markdown-Quelltextmodus. Entwurf, Auswahl und Inhalt beim Moduswechsel erhalten.
- **Speichern:** Nach erfolgreichem Speichern in die gerenderte Leseansicht wechseln und den tatsächlich gespeicherten Stand zeigen. Bei Fehlern im Editor bleiben. „Abbrechen“ stellt den gespeicherten Stand wieder her. Navigation mit ungesicherten Änderungen bewusst behandeln.
- **Inhalt:** Markdown bleibt die maßgebliche Darstellung. Kein HTML als unbemerkter Ersatz. Vorhandene Dokumenthüllen kompatibel adaptieren; eine neue DB-Struktur nur bei belegter Notwendigkeit und ohne Inhaltsverlust. Export gibt vollständiges Markdown aus.
- **Umfang:** Überschriften, fett, kursiv, Listen, Links, Zitate, Inline-Code und Codeblöcke konsistent lesen und bearbeiten. Formatierungsschalter haben zugängliche Namen und sichtbaren Zustand. Bestehende Inhalte außerhalb des visuell unterstützten Umfangs unverändert erhalten und nötigenfalls im Quelltextmodus bearbeiten; keine verlustbehaftete Konvertierung.
- **Rechte und Konflikte:** Gemeinsamer Notizinhalt bleibt in allen Einbindungen derselbe, lokale Anmerkungen bleiben lokal. Kontextbezogene Rechte und optimistische Versionsprüfung erhalten. Bei `409` bleibt der Entwurf erhalten; kein stilles Überschreiben und kein bloßes Neuladen mit Textverlust.
- **Rendering:** Sicheren Markdown-Parser/Renderer verwenden oder den vorhandenen Mechanismus belastbar ersetzen. Rohes HTML, Skripte und gefährliche Linkprotokolle nicht ausführen. Externe Medien nicht automatisch nachladen. Keine Notizinhalte an einen externen Editordienst senden.
### Bevorzugtes Ziel: direkt formatiert bearbeiten
Der Nutzer wünscht idealerweise Bearbeitung direkt in der formatierten Ansicht mit Formatierungsschaltern. Setze das bevorzugt mit einer geeigneten, lokal eingebundenen und gepflegten Editor-Komponente um; Quelltext bleibt umschaltbar. Kein eigener Rich-Text-Editor auf Basis unkontrollierter DOM-/HTML-Konvertierung und keine breite Bibliotheksstudie. Eine kurze begründete Komponentenwahl genügt; aktuelle Version, Markdown-Roundtrip und Lizenz prüfen.
Das ist die bevorzugte Bedienung dieser Lieferung, keine Erlaubnis zu stillen Inhaltsverlusten. Falls sie sich im Bestand nicht zuverlässig umsetzen lässt, die konkrete Grenze und eine funktionsfähige Alternative aus Markdown-Bearbeitung, Formatierungsleiste und gerenderter Leseansicht benennen. Dann den Wunsch nach direkter formatierter Bearbeitung ausdrücklich als offen ausweisen; eine einfache Textarea mit Vorschau nicht als vollständig erfülltes Ideal melden. Die übrigen Pakete deshalb nicht anhalten.
## 7. Vorgehen und konkrete Abnahme
Erst eine kurze Liste: welche Punkte im aktuellen Stand bereits belegt sind, welche Lücken tatsächlich bestehen und in welcher Reihenfolge sie geschlossen werden. Dann implementieren. Keine wochenlange Rahmenwerksarbeit. Sinnvolle Reihenfolge: notwendige gemeinsame Anschlussstellen korrigieren, IMAP-Fehler beheben, Paperless-Suche ausbauen, Markdown-Bedienung integrieren. Technisch unabhängige Aufgaben müssen nicht auf eine vollständige Umstellung aller Details warten; am Ende die gemeinsame Integration prüfen.
| Nr. | Szenario und beobachtbares Ergebnis |
|---|---|
| A1 | Dritten Test-Connector nur durch Modul und ausdrückliche Registrierung anbinden. In der Testoberfläche einrichten, suchen/navigieren, vor Übernahme öffnen, einbinden, erneut öffnen und exportieren. Für sein Formular ist ein eigenes registriertes Modul zulässig; eine nicht vorhandene Standardform nicht behaupten. Keine Source-Sonderzweige in Fachseiten, generischem Reader oder Export ergänzen. |
| A2 | Eine Testquelle mit E-Mail-Darstellung über den vorhandenen Leser einschließlich Anlagen öffnen. Der Zugriff läuft über ihre registrierte Ressourcenoperation, ohne IMAP-Zwang. Keine zusätzliche produktive Quelle erforderlich. |
| A3 | Vorhandenen Test-Storage über die echte Speicherauflösung für Upload, erneutes Lesen, Export, Versandfassung und Löschen/Bereinigung verwenden. Einheitenprüfungen an zwei unverbundenen Adapterobjekten genügen nicht. IDs, Generationen und Originalbytes erhalten. |
| A4 | Fehlende und entzogene Kontext-/Quellfreigabe sowie manipulierte Instanz und Ressource prüfen. Suche, Vorschau, Original, Anlagen und Export bleiben geschützt. Adapter wiederholen keine Tsumugu-Freigabelogik. Externen Abruf und Rechteentzug zwischen Vorbereitung und Abschluss prüfen. |
| B1 | Großen Ordner mit mindestens 50.000 synthetischen UID-Einträgen, Lücken und mehr als einer Seite reproduzieren. Erste und weitere Seiten liefern Nachrichten, Suche findet einen gezielt außerhalb der ersten Seite liegenden Treffer. Große Antwort bzw. begrenzte Antwortstrategie prüfen; eine lange UID-Liste allein in einem Fake beweist keine reale Protokollverträglichkeit. Aufruf-/Datenumfang bleibt begrenzt. |
| B2 | Erfolgreich leerer Ordner und erfolgreiche Suche ohne Treffer zeigen einen Leerzustand. `NO`, `BAD`, Timeout, Abbruch und fehlgeschlagene Headerabrufe zeigen passende Fehler/Teilzustände. Der vollständige Ausfall einer Ergebnisseite wird nicht „leer“. |
| B3 | UIDVALIDITY-Wechsel, neue/gelöschte Nachrichten, Unicode-Suchtext und schneller Ordnerwechsel führen zu korrekter Fortsetzung oder verständlichem Neustart. Keine falsche Nachricht, kein veränderter Gelesen-Status. |
| C1 | Mindestens 45 synthetische Paperless-Dokumente über mehrere Seiten: Ein Suchwort nur im Inhalt wird gefunden; ein getrenntes Titelfeld grenzt zusätzlich ein. Filter für Korrespondent, Typ, mehrere Tags und Datum werden einzeln und kombiniert bis zur API nachweisbar übergeben und korrekt angewandt. |
| C2 | Sortierung und Seitenwechsel erhalten Filter und bewusste Mehrfachauswahl. Treffer hinter Seite eins vor Übernahme öffnen, einbinden, erneut öffnen und exportieren. Zwei Instanzen mit gleicher Dokument-ID bleiben getrennt. Fremde/entzogene Stammdaten und Treffer bleiben verborgen. |
| D1 | Bestehende Notiz öffnen: gerenderte Ansicht. Bearbeiten mit Formatierungsleiste, Moduswechsel, Speichern: gerenderter neuer Stand; erneutes Öffnen identisch. Abbrechen und Navigation verlieren keinen Entwurf unbeabsichtigt. Formatierte Direktbearbeitung entweder vorführen oder als offen begründen. |
| D2 | Dieselbe Notiz in zwei Vorgängen: berechtigte Änderung erscheint in beiden, lokale Anmerkung nur in ihrem Kontext. Leserecht erlaubt keine Änderung. Versionskonflikt bewahrt den Entwurf und überschreibt keinen anderen Stand. |
| D3 | Markdown mit Links, Listen, Überschriften, Zitaten, Code und bisher nicht visuell unterstützter Syntax über Öffnen/Speichern/Moduswechsel erhalten. Kein Inhaltsverlust; schädliches HTML/Links werden nicht ausgeführt, externe Bilder nicht automatisch abgerufen. |
| E1 | Bestehende Exportauswahl, Unterkapitel, eigene Dateien und gesicherte Versandstände funktionieren. E-Mail enthält weiterhin alle Anlagen, auch wenn ein separates Anlage-Vorkommen abgewählt ist. Gesicherte Versandbytes nicht durch aktuelle Quelldaten ersetzen. |
| E2 | Betroffene Bedienabläufe auf Desktop und bei 390/360 px prüfen: Tastatur, Fokus und Rückkehr, Laden/Fehler/leer, Speichern/Abbrechen. Vorhandene Designrichtung und kompakte Listen erhalten. |
Vorhandene Tests gezielt erweitern. Nach den Änderungen relevante Regressionstests und Frontend-Build ausführen. Bestandene Prüfungen ohne neue Änderung oder ungelöste Sorge nicht wiederholt breit laufen lassen. Keine produktiven Datenbanken für automatisierte Tests verwenden.
Für tatsächliche Quellenchecks nur vorhandene autorisierte lokale Verbindungen lesend verwenden; keine neuen Credentials beschaffen und keine Inhalte veröffentlichen. Wenn ein echter Anschluss nicht verfügbar ist, synthetischen Nachweis und verbleibende reale Abnahme getrennt ausweisen. Keine Erfolgsmeldung für eine nicht durchgeführte Prüfung. Der Nutzer hat bereits grundsätzlich funktionierende Alltagsabläufe beobachtet; diese Beobachtung ersetzt keinen gezielten Großordner- oder Filtertest.
## 8. Dokumentation, Grenzen und Übergabe
- Dieses Dokument im vorgesehenen Produktverzeichnis ablegen und in `docs/README.md` sowie der Planungsübergabe verlinken. Die Fachspec gezielt um die aktuellen Nutzeranforderungen und spätere Implementierungsnachweise ergänzen; bevorzugte Bedienung und noch offene Punkte klar kennzeichnen.
- Betroffene API-/Datenmodell-/Rechte-Dokumentation nur im nötigen Umfang nachführen. Die bestehende Abschlussmatrix korrigieren: alte Testergebnisse historisch erhalten, behobene Lücken mit neuen konkreten Nachweisen ergänzen. Nicht pauschal alles auf „bestanden“ setzen.
- Abschlussbericht kurz halten: vier Arbeitspakete A–D mit Ergebnis, konkret ausgeführten Tests, realer oder nachgebildeter Quelle und verbleibender Grenze. Dazu Anleitung für neue Source-/Storage-/Darstellungs-/Editor-Module und Liste der weiterhin zulässigen Quellkenntnis. Laufzeitverhalten und Erweiterbarkeit getrennt bewerten.
- Kein Push, Deployment, externer Versand oder Änderung anderer Produkte. Keine neue SaaS-/Runtime-/Kryptografieplattform, keine KI, Finanzfunktionen oder bidirektionalen Paperless-Schreiboperationen. Bestehende Schlüssel-/Storage-Zielanforderungen erhalten.
## 9. Technische Quellen für die Umsetzung
Die folgenden Primärquellen sind Orientierung, keine Zusage über die installierte Version. Vor konkretem Mapping die eingesetzte Version/API prüfen:
- [Paperless-ngx: REST API](https://docs.paperless-ngx.com/api/) – Suchmöglichkeiten, Filter und API-Versionierung. Die offizielle Dokumentation beschreibt Inhalts-/Titelsuche; der aktuelle lokale `query`-Aufruf belegt daher nicht die Ursache der beobachteten Titelsuche.
- [Python: imaplib](https://docs.python.org/3/library/imaplib.html) – Rückgabestatus, Fehler und UID-Zugriff. Technische Details gegen die im Projekt eingesetzte Python-Version prüfen.
- [RFC 9051: IMAP4rev2](https://www.rfc-editor.org/rfc/rfc9051.html) – Protokoll- und Identitätsregeln. Bestehende IMAP4rev1-Server weiterhin unterstützen; rev2 ist keine neue Mindestanforderung.
Die Notiz-Editorbibliothek wird mit kurzer Begründung im Repository festgelegt; dieser Auftrag schreibt keine unüberprüfte Bibliothek oder Version vor.
+1 -1
View File
@@ -19,7 +19,7 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch
**Kennzeichnung in dieser Datei:** Bestätigt = aktueller Nutzerauftrag oder direkt lesbare ursprüngliche Nutzeraussage; Rekonstruktion = nur durch Recovery belegt; Vorschlag = neue Empfehlung ohne Freigabe; Offen = noch zu entscheiden. Technische Discovery-Vorschläge werden nicht zu Fachanforderungen erhoben.
**Implementierungsnachweis 19.10.2026, ohne neue Fachversion:** Die lesende Connector-/Storage-Grundlage ist lokal umgesetzt. Das ist ein Implementierungsnachweis zum Vertrag v0.1, keine neue bestätigte Produktentscheidung und keine Aufhebung von F-02b oder F-02c. Die erste Source-Lieferung bleibt lesend. Bidirektionale Feldsynchronisation, erweiterte Paperless-Suche und der vervollständigte Quellenbrowser sind der nächste, separat zu startende Funktionsausbau. Die Abschlusskriterien in [TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md](TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md) haben Vorrang vor einem nur teilweise integrierten Zwischenstand. Nachweis, Grenzen und die Matrix stehen in [TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md](TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md). Der frühere Zwischenstand bleibt in [TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md](TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md).
**Implementierungsnachweis 19.10.2026, ohne neue Fachversion:** Die lesende Connector-/Storage-Grundlage ist lokal umgesetzt. Das ist ein Implementierungsnachweis zum Vertrag v0.1, keine neue bestätigte Produktentscheidung und keine Aufhebung von F-02b oder F-02c. Die erste Source-Lieferung bleibt lesend. Bidirektionale Feldsynchronisation bleibt der spätere Ausbau. Die Nacharbeit an großen IMAP-Fächern, der Paperless-Suche und der internen Markdown-Notiz ist beauftragt und lokal umgesetzt: [TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md](TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md). Eine Notiz bleibt ein interner Gegenstand. Beim Öffnen erscheint zuerst die gesetzte Markdown-Fassung. Mit Bearbeitungsrecht folgt eine formatierte Bearbeitung mit Formatierungsleiste und umschaltbarem Markdown-Quelltext. Weicht die formatierte Ansicht vom gespeicherten Markdown ab, bleibt der Quelltext maßgeblich. Die Abschlusskriterien in [TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md](TSUMUGU_CONNECTOR_ABSCHLUSSKRITERIEN_2026-10-19.md) haben Vorrang vor einem nur teilweise integrierten Zwischenstand. Nachweis, Grenzen und die Matrix stehen in [TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md](TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md). Der frühere Zwischenstand bleibt in [TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md](TSUMUGU_CONNECTOR_BASIS_ERGEBNIS_2026-10-19.md).
## 2. Gesicherter fachlicher Kern
@@ -1,6 +1,6 @@
# Tsumugu – Übergabe zur fachlichen Weiterplanung
**Nachtrag 19.10.2026:** Die Connector-/Storage-Grundlage ist gegen die Abschlusskriterien geschlossen. Die Matrix steht in [TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md](TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md). Abschnitt B, der vervollständigte Quellenbrowser und die erweiterte Paperless-Suche, bleibt der nächste separate Funktionsausbau. F-02b und F-02c bleiben erhalten. Der übrige Text dieser Übergabe beschreibt den Stand vom 17. und 18.10.2026.
**Nachtrag 19.10.2026:** Die Connector-/Storage-Grundlage ist gegen die Abschlusskriterien geschlossen. Die Matrix steht in [TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md](TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md). Die Nacharbeit an großen IMAP-Fächern, der Paperless-Suche und der internen Markdown-Notiz ist lokal umgesetzt; Auftrag und Grenzen stehen in [TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md](TSUMUGU_CONNECTOR_NACHARBEIT_IMAP_PAPERLESS_MARKDOWN_AUFTRAG_2026-10-19.md). F-02b und F-02c bleiben erhalten; eine bidirektionale Paperless-Schreibsynchronisation startet dieser Auftrag nicht. Der übrige Text dieser Übergabe beschreibt den Stand vom 17. und 18.10.2026.
**Stand:** 17.10.2026 · **Zweck:** Einstieg in einen neuen fachlichen Planungschat nach Auswahl des Designkonzepts. Keine neue Produktentscheidung und kein zusätzlicher Implementierungsauftrag.