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>
This commit is contained in:
1 parent
34c4084a7c
commit
c29bd29f34
29 files changed
+2562
-410
No files matched your search
@@ -31,6 +31,9 @@
|
||||
| [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_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md](product/TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md) | Korrektur K1–K7: IMAP-Ordner, MIME, Transaktion, Markdown, Leser, Paperless-Antworten | 20.10.2026 |
|
||||
| [TSUMUGU_IMAP_SENT_ITEMS_MIME_BEFUND_UND_FIXAUFTRAG_2026-10-20.md](product/TSUMUGU_IMAP_SENT_ITEMS_MIME_BEFUND_UND_FIXAUFTRAG_2026-10-20.md) | Befund zu Sent Items und MIME, unverändert übernommen | 20.10.2026 |
|
||||
| [TSUMUGU_CONNECTOR_NACHARBEIT_REVIEW_2026-10-20.md](product/TSUMUGU_CONNECTOR_NACHARBEIT_REVIEW_2026-10-20.md) | Review der Nacharbeit, unverändert übernommen | 20.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 |
|
||||
|
||||
@@ -75,3 +75,19 @@ Ein Quellenmodul registriert sich mit `register_source` und liefert nur Fähigke
|
||||
## 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.
|
||||
|
||||
## Korrektur am 20.10.2026
|
||||
|
||||
Auftrag: [TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md](TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md). Die Befunde vom selben Tag bleiben unverändert. Die historische Suite oben bleibt unverändert. `tests/test_correction_k1_k7.py` lief danach mit 7 bestandenen Tests. Export, Connector-Nacharbeit und Connector-Basis liefen in derselben lokalen Testdatenbank mit 26 bestandenen Tests. Die Versandtests liefen mit 3 bestandenen Tests. Der Frontend-Build ist durchgelaufen. Kein Push und kein Deployment.
|
||||
|
||||
Die Bedienprüfung lief gegen eine lokale API mit nachgebildetem IMAP und einem verzögerten Paperless-Stellvertreter. Das ist keine Prüfung des bestehenden Postfachs und keine Dokumentabfrage der bestehenden Paperless-Instanz.
|
||||
|
||||
| Korrektur | Geändertes Verhalten | Nachweis | Ergebnis | Grenze |
|
||||
|---|---|---|---|---|
|
||||
| K1 Ordnernamen | Fachnamen, die kein IMAP-Atom sind, werden gequotet. `INBOX` bleibt ungequotet. Ein Fach mit gemeldetem Bestand und leerer abgeschlossener Liste gilt nicht als leer. | Synthetisch: `test_mailbox_names_are_quoted_protocol_strings`, `test_a_filled_folder_with_spaces_is_not_reported_empty`. Bedienung: der Stellvertreter erhielt `INBOX` und `"Sent Items"`; Sent Items zeigte Nachrichten und die Richtung Ausgang. | Synthetisch und in der Bedienung bestanden. | Das bestehende Postfach mit mehr als 4.000 Nachrichten wurde nicht gelesen. |
|
||||
| K2 MIME | Eine Auswertung für Vorschau, Leser und Export. Anzeigename und Archivname sind getrennt. HTML wird bereinigt; die Textfassung ist gekennzeichnet. Eine angehängte Nachricht bleibt eine Anlage. | Synthetisch: `test_parse_mail_keeps_names_html_and_attached_messages`, `test_preview_below_and_above_the_limit_uses_the_same_parts`. Bedienung: Tabelle, `A & B`, Dateiname `Buero Uebergabe.pdf`, keine Skripte, keine fremde Bildadresse, Textfassung sichtbar. | Synthetisch und am Stellvertreter bestanden. | Keine Nutzermail. Bytezahl und SHA-256 zwischen Download, ZIP und Originalanlage einer betroffenen Mail sind nicht verglichen. |
|
||||
| K3 Transaktion | IMAP-Lesen, Export und Dateiveröffentlichung laufen ohne offene Fachtransaktion. Der Fachabschluss folgt danach. Ein fehlgeschlagener Abschluss lässt weder den Eintrag noch die veröffentlichten Bytes stehen. | Synthetisch: `test_upload_and_mail_fetch_leave_the_domain_transaction` sah `IDLE` am Upload und am Mailabruf. `test_failed_conclusion_keeps_no_partial_file` ließ keinen Eintrag und keine Prüfbytes zurück. Die bestehenden Versandtests blieben grün. | Für diese beiden Grenzen bestanden. | Entzug während der Veröffentlichung und ein gleichzeitiger Versionskonflikt sind nicht eigens geprüft. |
|
||||
| K4 Markdown | Der Leser nutzt einen Markdown-Renderer für die Ebenen 1–6, verschachtelte Listen und den Listenstart. HTML, `javascript:`-Links und externe Bilder werden nicht ausgeführt. | Markup-Prüfung der Leserhülle. Bedienung: gespeicherte Notiz mit den genannten Strukturen, Vorschau aus dem Quelltext, Abbrechen stellt die Ansicht wieder her. Bei 360 und 390 px kein Überlauf, Schaltfläche 44 px. | Lesen und Quelltextvorschau bestanden. | Die formatierte Leiste öffnete diese Notiz nicht, weil sie den gespeicherten Text verändert hätte. Der Quelltext blieb maßgeblich. |
|
||||
| K5 Registrierung | Die Leserhülle ruft die registrierte Darstellung auf. Die Beispielquelle bringt Formular und Registrierung in ihrem eigenen Modul mit und erscheint in der Produktauslieferung nicht. | Die Leserhülle rendert die Testdarstellung und speichert über den registrierten Testeditor. Bedienung mit `?probe=1`: Beispielquelle verbinden, nach „Proben“ suchen, übernehmen, öffnen, erneut öffnen, Übergabepaket prüfen und herunterladen. Der Download antwortete mit 200; der Prüfstand nannte `Probenbrief/Probenbrief.txt`. | Bestanden in der Testoberfläche. | Die Beispielquelle ist kein Produktzugang. |
|
||||
| K6 Paperless-Antworten | Eine verspätete Suche oder Facette schreibt nicht in die inzwischen gewählte Instanz. Der Instanzwechsel leert Filter und Trefferliste. | Bedienung am Stellvertreter: Suche auf „Alt“ starten, zu „Neu“ wechseln, die späte Antwort abwarten. Zugang, leere Suche und Facette blieben bei Neu. Die anschließende Suche zeigte „Treffer Neu“. Schließen während einer laufenden Suche ließ die Vorgangsliste unverändert. | In der Bedienung bestanden. | Keine echte Paperless-Instanz. |
|
||||
| K7 Filter und reale Quellen | Der synthetische Paperless-Abruf filtert den Katalog nach Inhalt, Titel, Metadaten, Datum und Seite. | `test_paperless_filters_change_the_hits`: nur der Inhaltstreffer, nur Titel „Vertrag“, die kombinierte Teilmenge und die zweite Seite unterscheiden sich. | Synthetisch bestanden. | Weder die bestehende Paperless-Dokumentabfrage noch das bestehende Postfach wurden ausgeführt. Schema-Lesen vom 19.10. ersetzt das nicht. |
|
||||
@@ -0,0 +1,69 @@
|
||||
# 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.
|
||||
@@ -0,0 +1,84 @@
|
||||
# Sent Items und MIME-Aufbereitung: Befund und gezielter Cursor-Auftrag
|
||||
|
||||
**Stand:** 20.10.2026. Geprüft: `C:/Dev/tsumugu`. Keine Änderung an Anwendung oder Repository; keine echte Quelle und keine Datenbank angesprochen.
|
||||
|
||||
## Nutzerbeobachtung und Grenzen
|
||||
|
||||
Der Ordner „Sent Items“ enthält laut Outlook mehr als 4.000 Nachrichten, erscheint in Tsumugu aber leer. Einige E-Mails mit großen Anlagen wirken in Anzeige und Export verändert; die EML-Datei wird in Outlook korrekt dargestellt.
|
||||
|
||||
**Nutzerpräzisierung:** Betroffen sind Dateiname beziehungsweise Anzeige. Eine Veränderung heruntergeladener Dateiinhalte oder fehlende Anlagen wurde vom Nutzer nicht berichtet. Entsprechend liegt der Schwerpunkt auf korrekten Namen und Darstellung; die Byteprüfung ist eine zusätzliche Integritätskontrolle. Der unten separat reproduzierte Verlust angehängter EML-Dateien ist ein zusätzlicher Parserbefund, keine nachträgliche Umdeutung der Nutzerbeobachtung.
|
||||
|
||||
Diese beiden Beobachtungen sind ernst zu nehmen. Sie beweisen noch nicht, dass Outlook und Tsumugu denselben serverseitigen Ordner sehen oder dass extrahierte Binäranlagen verändert wurden. Die konkrete Nutzerquelle wurde hier nicht geprüft. Es wurden aber die folgenden Codefehler unabhängig reproduziert.
|
||||
|
||||
## Belegte Befunde
|
||||
|
||||
### 1. IMAP-Ordnernamen mit Leerzeichen sind nicht korrekt geschützt
|
||||
|
||||
`backend/app/sources.py:730` und `:798` übergeben den entquoteten Ordnernamen direkt an `client.select`. Die tatsächlich installierte Python-Bibliothek setzt diesen Parameter in den Befehl ein, ohne ihn automatisch zu quotieren.
|
||||
|
||||
Eine Prüfung ohne Socket mit dem tatsächlichen IMAP-Befehlsencoder ergab für `Sent Items`:
|
||||
|
||||
```text
|
||||
T1 EXAMINE Sent Items
|
||||
```
|
||||
|
||||
Für diesen Namen ist eine korrekte IMAP-Stringdarstellung erforderlich, beispielsweise `"Sent Items"`, einschließlich richtigem Escaping. Das ist ein belegter Protokollfehler, aber noch kein Nachweis, dass genau diese Serverantwort beim Nutzer zum Leerzustand führt. Ein strikt ablehnender Server sollte einen Fehler erzeugen; warum der Nutzer „leer“ sieht, muss zusätzlich entlang Serverantwort und UI verfolgt werden.
|
||||
|
||||
### 2. Der Sonderweg für große Mailvorschauen verliert den MIME-Kontext
|
||||
|
||||
`_fetch_message` wechselt bei mehr als 8.000.000 Rohbytes in `_oversized_message`. `_partial_text` holt einen Ausschnitt von `BODY.PEEK[TEXT]` und parst ihn mit einem künstlichen Subject-Header, aber ohne die ursprünglichen MIME-Header und Multipart-Grenzinformationen.
|
||||
|
||||
Ein synthetischer Multipart-Test an der echten `_partial_text`-Funktion zeigte MIME-Header und Base64-Anlageninhalt als Nachrichtentext. Dieser Befund erklärt eine größenabhängig kaputte Vorschau sehr konkret. Er beweist keine Veränderung der Originalanlage im Export; dessen vollständiger Abruf läuft anders.
|
||||
|
||||
### 3. Anzeige und Export verwenden eine verlustbehaftete Textfassung
|
||||
|
||||
`backend/app/mailpack.py::_html_text` entfernt HTML-Tags mit regulären Ausdrücken. Tabellenstruktur, Layout und Inline-Bilder bleiben dabei nicht erhalten; HTML-Entities werden nicht zuverlässig als Zeichen ausgegeben. Ein Test mit einer HTML-Mail lieferte `A & B` statt `A & B` und eine flache Zeichenfolge statt der Tabelle.
|
||||
|
||||
Der Export schreibt `mail.raw` als EML, die Lesefassung aber aus `mail.parsed.text`. Deshalb können EML und Lesefassung unterschiedlich aussehen. Das erklärt die Beobachtung einer Umformatierung, ohne daraus bereits einen Defekt der extrahierten PDF-/Bilddateien abzuleiten.
|
||||
|
||||
### 4. Angefügte EML-Nachrichten können unbemerkt fehlen
|
||||
|
||||
`parse_mail` überspringt alle Parts mit `is_multipart()`. Das trifft auch auf `message/rfc822` zu. Der anschließende Baumdurchlauf kann dafür den inneren Text einer angehängten E-Mail dem äußeren Nachrichtentext zuschlagen.
|
||||
|
||||
Eigener Test: Eine Nachricht mit `weitergeleitet.eml` als Anlage wurde mit **null Anlagen**, **keinem Fehlhinweis** und einer Mischung aus äußerem und innerem Text aufbereitet. Das betrifft auch den Export und seine Vollständigkeitsbehauptung.
|
||||
|
||||
### 5. Große Anlagen sind nicht grundsätzlich beschädigt
|
||||
|
||||
Eine synthetische gewöhnliche Base64-Anlage mit 9.000.000 Bytes wurde von `parse_mail` mit gleicher Länge und identischem SHA-256 extrahiert. Die konkrete Anlage des Nutzers muss deshalb anhand ihrer tatsächlichen MIME-Struktur und der heruntergeladenen Bytes geprüft werden; „groß“ allein ist noch keine Ursache.
|
||||
|
||||
### 6. MIME-kodierte Dateinamen werden je nach Zugriff verschieden angezeigt
|
||||
|
||||
Die Vorschau nutzt `_decode`, der vollständige Parser dagegen `_header_text`, das solche Header nicht dekodiert. Mit derselben synthetischen E-Mail wurde reproduziert:
|
||||
|
||||
- Vorschau: `Buero Uebergabe.pdf`.
|
||||
- Reader/Export: `=?utf-8?q?Buero_Uebergabe=2Epdf?=`.
|
||||
|
||||
Das passt unmittelbar zur Nutzerpräzisierung. MIME-/Headerdekodierung für Anzeigename und Exportnamen vereinheitlichen, einschließlich RFC-2231-Parametern. Einen sicheren Archiv-Dateinamen vom angezeigten Originalnamen trennen; notwendige Pfadbereinigung und Kollisionsbehandlung erhalten.
|
||||
|
||||
## Umsetzungsauftrag an Cursor
|
||||
|
||||
Erhalte die bestehende Connector-Architektur und die übrige Nacharbeit. Schließe gezielt diese Fehler, ohne neue Grundlagenanalyse oder zusätzliche Produktfunktionen.
|
||||
|
||||
1. Ordnernamen an allen IMAP-Auswahl-/Abrufstellen korrekt als Protokollstrings behandeln. Leerzeichen, Anführungszeichen, Backslash und erforderliche Zeichenkodierung testen. CR/LF weiter ablehnen. Rohname für die Protokolladresse und lesbares Label getrennt halten.
|
||||
2. Den echten betroffenen Ordner ausschließlich lesend diagnostizieren, soweit eine bestehende autorisierte Verbindung zugänglich ist: Konto/Host und vollständigen Ordnerpfad vergleichen, LIST-Zuordnung, EXAMINE-Status und EXISTS, UIDNEXT/UIDVALIDITY und begrenzte Suchantwort erfassen. Keine Credentials oder privaten Inhalte protokollieren. Outlook-Cache beziehungsweise ein anderer Ordner ist eine zu prüfende Möglichkeit, keine feststehende Erklärung.
|
||||
3. Wenn EXAMINE einen befüllten Ordner meldet, aber die Aufbereitung keine Einträge ergibt, Leerzustand nicht ungeprüft behaupten. Fehler, nicht abgeschlossene Suche, widersprüchliche Antworten und wirklich leer unterscheiden. Das große-Folder-Paging erhalten; nicht unbegrenzt alle Nachrichten laden.
|
||||
4. Die große Vorschau über korrekt ausgewählte Text-/HTML-MIME-Parts und deren Transfer-Encoding/Charset aufbauen. Keine beliebig abgeschnittene Multipart-Rohstruktur als fertigen Mailtext ausgeben. Falls eine vollständige Vorschau nicht möglich ist, klar als begrenzt kennzeichnen; MIME-Fragmente und Base64-Blöcke nicht als Nutztext ausgeben.
|
||||
5. Einen gemeinsamen MIME-Baum für Vorschau, Lesen, Anlagenabruf und Export auswerten. Alternative Körperdarstellungen, related/Inline-Ressourcen und echte Anlagen trennen. Angehängte E-Mails als eigene vollständige Anlage erhalten; deren Inhalt nicht in die äußere Nachricht einmischen. Doppelte Namen bleiben getrennt.
|
||||
6. EML-Originalbytes unverändert erhalten. Originalanlagen als korrekt transferdekodierte Nutzbytes liefern; keine Bild-/PDF-Neuerzeugung und keine Textdekodierung binärer Nutzdaten. Unbekannte oder nicht sicher dekodierbare MIME-Parts ausdrücklich als Grenze melden, statt unbemerkt Vollständigkeit zu behaupten.
|
||||
MIME-kodierte Dateinamen in Vorschau, Reader, Download und Export konsistent dekodieren. Anzeigename und sicherer Archiv-Dateiname bleiben unterscheidbar; technische Sicherheitsbereinigung darf keinen unverständlichen MIME-Header als Namen hinterlassen.
|
||||
7. Für HTML-Mails eine sichere formatierte Ansicht mit vorhandenen lokalen Inline-Ressourcen vorsehen. Skripte, aktive Inhalte und automatische externe Nachladezugriffe sperren. Eine vereinfachte Textfassung darf zusätzlich bestehen, muss als solche erkennbar sein. Keine Zusage pixelgleicher Outlook-Darstellung. Im Export Original-EML und Originalanlagen erhalten; eine formatierte Lesefassung sicher bereitstellen oder verbleibende Darstellungsgrenzen klar benennen. Nicht das unveränderte EML durch eine neu serialisierte Mail ersetzen.
|
||||
|
||||
## Konkrete Abnahme
|
||||
|
||||
- Sent Items mit Leerzeichen und mehr als 4.000 Nachrichten: derselbe serverseitige Ordner liefert erste Seite und spätere Treffer; Suche findet einen bekannten Treffer. Serverantwort und Anzeige passen zusammen. Zusätzlich Ordnernamen mit Quote/Backslash und ein echter leerer Ordner.
|
||||
- Dieselbe synthetische MIME-Struktur unterhalb und oberhalb der Vorschaugrenze: gleicher lesbarer Körper und gleiche Anlagenliste, abgesehen von einer ausdrücklich angegebenen Textkürzung. Kein sichtbarer MIME-/Base64-Rest.
|
||||
- HTML-Tabelle, Entities, Unicode-/kodierte Header und Dateinamen, quoted-printable und Base64, Inline-CID-Bild und angehängte EML prüfen. Innere EML bleibt als Anlage vollständig und getrennt. Nicht unterstützte Sonderformate als solche behandeln.
|
||||
- Für eine betroffene Nutzer-Mail EML lokal vergleichen. Danach jede extrahierte Anlage zwischen Tsumugu-Download, ZIP-Export und der aus derselben EML korrekt gespeicherten Anlage vergleichen: Bytezahl und SHA-256. Bericht trennt Dateiname, Darstellung und tatsächliche Byteabweichung.
|
||||
- Export meldet eine ausgelassene oder fehlerhafte Anlage; kein stiller Verlust. Die bestehende Regel „vollständige E-Mail einschließlich aller Anlagen trotz separat abgewähltem Vorkommen“ erhalten.
|
||||
- Tests synthetisch und an echten Quellen getrennt berichten. Nicht verfügbare Nutzerfälle bleiben offen. Keine produktive DB für Regressionstests, kein Push und kein Deployment.
|
||||
|
||||
## Primärquellen
|
||||
|
||||
- [RFC 9051 – IMAP4rev2](https://www.rfc-editor.org/rfc/rfc9051.html): Mailboxnamen, Protokollstrings, Auswahl und Identität. Weiterhin bestehende IMAP4rev1-Server unterstützen.
|
||||
- [Python – email.message](https://docs.python.org/3/library/email.message.html): MIME-Baum und `is_multipart()`, insbesondere `message/rfc822`. Details mit der eingesetzten Python-Version abgleichen.
|
||||
- [RFC 2045 – MIME](https://www.rfc-editor.org/rfc/rfc2045.html): Content-Type und Transfer-Encoding.
|
||||
@@ -0,0 +1,129 @@
|
||||
# Korrekturauftrag an Cursor: Connectoren, IMAP, Mailaufbereitung und Markdown
|
||||
|
||||
**Stand:** 20.10.2026
|
||||
**Repository:** `C:/Dev/tsumugu`
|
||||
**Zielort:** `docs/product/TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md`
|
||||
**Umfang:** Die nachstehend gebündelten Korrekturen und ihre lokale Abnahme sind beauftragt. Kein Push und kein Deployment.
|
||||
|
||||
## 1. Führender Auftrag und Befundquellen
|
||||
|
||||
Dieser Auftrag bündelt beide Prüfberichte vom 20.10.2026. Er ist der gemeinsame Umsetzungseinstieg; die Einzelberichte bleiben die Quellen für Reproduktion, Fundstellen und Nachweisgrenzen. Doppelte Aufgaben nur einmal lösen. Frühere bereits korrekt umgesetzte Funktionen erhalten.
|
||||
|
||||
**R – vorherige Prüfung:** [Connector-Nacharbeit: Review vom 20.10.2026](TSUMUGU_CONNECTOR_NACHARBEIT_REVIEW_2026-10-20.md)
|
||||
|
||||
- R1 = Abschnitt 1: externe Abrufe und Fachtransaktionen.
|
||||
- R2 = Abschnitt 2: unterschiedlicher Markdown-Umfang in Editor und Leser.
|
||||
- R3 = Abschnitt 3: nur nominelle Leser-/Editor-Registrierung.
|
||||
- R4 = Abschnitt 4: verspätete Paperless-Antworten.
|
||||
- R-N = Abschnitt „Nachweisgrenzen“: echte Filterwirkung und Bediennachweis des dritten Connectors.
|
||||
|
||||
**M – ergänzende Mailprüfung:** [Sent Items und MIME: Befund und Fixauftrag](TSUMUGU_IMAP_SENT_ITEMS_MIME_BEFUND_UND_FIXAUFTRAG_2026-10-20.md)
|
||||
|
||||
- M1 = Befund 1: ungeschützte IMAP-Ordnernamen mit Leerzeichen.
|
||||
- M2 = Befund 2: verlorener MIME-Kontext in großen Vorschauen.
|
||||
- M3 = Befund 3: verlustbehaftete HTML-Textfassung.
|
||||
- M4 = Befund 4: ausgelassene angehängte EML und vermischte Nachrichtentexte.
|
||||
- M5 = Befund 5: synthetischer Integritätsnachweis für eine normale große Anlage.
|
||||
- M6 = Befund 6: unterschiedliche Dekodierung von Dateinamen.
|
||||
|
||||
Die Berichte liegen bei Übergabe gemeinsam mit diesem Auftrag unter:
|
||||
|
||||
`C:/Users/lars/Documents/Codex/2026-10-17/lies-zuerst-c-dev-tsumugu-docs/outputs/`
|
||||
|
||||
Übernimm die drei Dokumente nach `docs/product`, damit die relativen Verweise dort funktionieren. Verlinke den gemeinsamen Auftrag in `docs/README.md` und der Planungsübergabe. Keine Änderungen an den historischen Befundbehauptungen, um inzwischen erfolgte Korrekturen zu verdecken; neue Ergebnisse ergänzen.
|
||||
|
||||
Lies außerdem `AGENTS.md`, die betroffenen bestätigten Entscheidungen in `docs/product/TSUMUGU_PRODUCT_SPEC.md`, die bisherigen Connector-Abschlusskriterien und den Source-/Storage-Vertrag. Die Architekturvorlagen liegen unter **`docs/reference/`**. Bestehende Gestaltung, Fachmodell und Fremdänderungen erhalten. Kein Neustart der Grundlagenarbeit.
|
||||
|
||||
## 2. Beobachtung, Befund und offene Ursache
|
||||
|
||||
- „Sent Items“ ist laut Nutzer in Outlook mit mehr als 4.000 Nachrichten befüllt, erscheint in Tsumugu aber leer. Die ungeschützte Übermittlung des Namens ist reproduziert; die tatsächliche Ursache des Leerzustands an dieser Nutzerquelle ist noch nicht abschließend nachgewiesen.
|
||||
- Der Nutzer hat die Anlagenbeobachtung präzisiert: **Dateiname beziehungsweise Anzeige verändert**. Er hat keine beschädigten heruntergeladenen Dateiinhalte und keine fehlenden Anlagen berichtet.
|
||||
- Die Auslassung angehängter EML ist ein zusätzlicher synthetisch reproduzierter Parserfehler. Sie ist keine Umdeutung der Nutzerbeobachtung.
|
||||
- Eine gewöhnliche Base64-Anlage mit 9.000.000 Bytes wurde synthetisch bytegleich extrahiert. Das beweist weder einen generellen Defekt großer Anlagen noch die Korrektheit aller MIME-Sonderfälle.
|
||||
- Die bisherigen 82 Tests und der Build sind gemeldete historische Ergebnisse. Sie ersetzen die gezielte Abnahme der folgenden Korrekturen nicht.
|
||||
|
||||
## 3. Gebündelte Korrekturen und Abnahme
|
||||
|
||||
### K1 – Sent Items und andere IMAP-Ordner korrekt öffnen
|
||||
|
||||
**Quellen:** M1, Nutzerbeobachtung im Mailbericht.
|
||||
|
||||
- Ordnernamen in allen Auswahl-/Abrufpfaden als korrekte IMAP-Protokollstrings behandeln: Leerzeichen, Quotes, Backslash und notwendige Zeichenkodierung. Rohname und sichtbares Label getrennt halten. CR/LF weiter ablehnen.
|
||||
- Den betroffenen Ordner über eine vorhandene autorisierte Verbindung lesend diagnostizieren, soweit erreichbar: Konto/Host und vollständigen Ordnerpfad, LIST-Zuordnung, EXAMINE-Status/EXISTS, UIDNEXT/UIDVALIDITY sowie begrenzte Suchantwort vergleichen. Keine privaten Inhalte oder Credentials protokollieren. Gleichen Ordner in Outlook und IMAP prüfen; nicht ungeprüft Outlook-Cache oder Ordnergröße zur Ursache erklären.
|
||||
- Bei widersprüchlichen Antworten, fehlgeschlagenem Abruf oder nicht abgeschlossener Suche keinen endgültigen Leerzustand melden. Begrenztes Paging erhalten.
|
||||
|
||||
**Abnahme:** Ordner mit Leerzeichen und mehr als 4.000 Nachrichten liefert die erste Seite und einen bekannten späteren Suchtreffer. Zusätzlich echte Leere, Suchfehler, UID-Lücken und Namen mit Quote/Backslash prüfen. Ist die echte Quelle nicht verfügbar, synthetischen Nachweis liefern und die reale Nutzerabnahme ausdrücklich offen lassen.
|
||||
|
||||
### K2 – MIME-Aufbereitung, Namen und Maildarstellung vereinheitlichen
|
||||
|
||||
**Quellen:** M2, M3, M4, M5, M6.
|
||||
|
||||
- Vorschau, vollständiges Lesen, Anlagenabruf und Export verwenden dieselbe fachlich korrekte MIME-Auswertung. Unterschiedliche Größenlimits dürfen keinen Wechsel zu einer falsch interpretierten Rohstruktur erzeugen.
|
||||
- Große Vorschauen gezielt aus passenden Text-/HTML-Parts und deren Transfer-Encoding/Charset gewinnen. Abgeschnittene Multipart-Fragmente nicht mit künstlichen Headern als fertige Mail parsen. Bei Begrenzung einen klaren Zustand liefern; keine MIME-Header oder Base64-Anlagen als Nachrichtentext anzeigen.
|
||||
- MIME-kodierte Header und Dateinamen in allen Ansichten konsistent dekodieren, einschließlich RFC-2231-Parametern. Angezeigten Originalnamen von sicherem Archiv-Dateinamen trennen; Pfadbereinigung und Kollisionsbehandlung erhalten.
|
||||
- Echte Anlagen, HTML-/Textalternativen und lokale Inline-Ressourcen unterscheiden. Angehängte `message/rfc822`-Nachrichten vollständig als eigene Anlage erhalten. Deren Text nicht in die äußere Nachricht mischen. Doppelte Dateinamen bleiben getrennt.
|
||||
- Eine sichere formatierte HTML-Mailansicht mit lokalen Inline-Ressourcen bereitstellen. Keine Skripte, aktiven Inhalte oder automatischen externen Nachladezugriffe. Eine zusätzliche vereinfachte Textfassung bleibt als solche erkennbar. Keine Zusage pixelgleicher Outlook-Darstellung.
|
||||
- Original-EML unverändert erhalten. Anlagen als korrekt transferdekodierte Original-Nutzbytes ausgeben, keine PDF-/Bild-Neuerzeugung. Export enthält weiterhin die vollständige EML und alle Anlagen; eine formatierte Lesefassung sicher bereitstellen oder verbleibende Darstellungsgrenzen klar benennen. Fehlerhafte oder ausgelassene Teile nicht still als vollständig melden.
|
||||
|
||||
**Abnahme:** Dieselbe MIME-Struktur unter und über der bisherigen 8-MB-Vorschaugrenze; konsistente Körperdarstellung und Anlagenliste. Zusätzlich kodierte Dateinamen, HTML-Tabelle/Entities, Unicode, Base64/quoted-printable, Inline-CID-Bild, doppelte Namen und angehängte EML. Für eine betroffene Nutzer-Mail die Namen und Darstellung direkt vergleichen. Bytezahl und SHA-256 der extrahierten Anlagen zwischen Download, ZIP und korrekt aus derselben EML gespeicherter Anlage als Integritätskontrolle vergleichen. Separat abgewählte Anlage-Vorkommen dürfen weiterhin nicht die Anlagen der exportierten E-Mail entfernen.
|
||||
|
||||
### K3 – Externe Arbeit und Fachtransaktion wirklich trennen
|
||||
|
||||
**Quelle:** R1.
|
||||
|
||||
- Verbindungsdaten vor dem externen Abruf vollständig auflösen. Im externen Abschnitt keine DB-Nachfrage einbauen, die unmittelbar wieder eine Transaktion eröffnet.
|
||||
- IMAP-Lesen, Quellenexport und Abruf für Versandfassungen über dieselben belastbaren Zugriffsgrenzen führen. Nach externer Arbeit erforderliche aktuelle Rechte, Instanz und Version erneut prüfen.
|
||||
- Upload-/Snapshot-Veröffentlichung mit sicheren vorbereitenden und abschließenden DB-Phasen sowie nachvollziehbarer Bereinigung ausführen. Ein pauschales Zwischen-Commit ersetzt keinen korrekten Schreibablauf. Bestandsreferenzen, Generationen und gesicherte Versandbytes erhalten.
|
||||
|
||||
**Abnahme:** An den tatsächlichen Transport-/Speichergrenzen nachweisen, dass keine Fachtransaktion offen ist; nicht nur prüfen, ob eine Hilfsfunktion vorher `commit` aufruft. Entzug, konkurrierende Änderung, externer Fehler und abschließender DB-Fehler führen zu keiner unberechtigten Ausgabe oder scheinbar vollständig gespeicherten Teilfassung. Keine neue Kryptografie.
|
||||
|
||||
### K4 – Gespeicherte Markdown-Ansicht entspricht dem Editor
|
||||
|
||||
**Quelle:** R2.
|
||||
|
||||
- Einen sicheren, zum Editor passenden Markdown-Renderer einsetzen. Keine weiteren Regex-Sonderfälle als Ersatz für korrekte Markdown-Struktur.
|
||||
- Vom Editor angebotene Überschriften, verschachtelte Listen und Anfangswerte geordneter Listen im Leser korrekt darstellen. Quelltext außerhalb des unterstützten visuellen Umfangs verlustfrei erhalten.
|
||||
- Notiz öffnet gerendert; Bearbeiten, Speichern, Abbrechen und Konflikterhalt funktionieren weiterhin. Gemeinsamer Notizinhalt bleibt gemeinsam, lokale Anmerkungen lokal.
|
||||
|
||||
**Abnahme:** Überschriften 1–6, verschachtelte Listen, Liste ab 5, Zitate, Links und Code im Editor, nach Speichern, nach Wiederöffnung und nach Quelltextwechsel vergleichen. Quelltext/Export ohne Inhaltsverlust, schädliches HTML/Links und externe Medien weiterhin geschützt.
|
||||
|
||||
### K5 – Ausführbare Leser und Editoren registrieren
|
||||
|
||||
**Quelle:** R3; ergänzend R-N.
|
||||
|
||||
- Tatsächliche Anzeige-/Editorkomponenten mit gemeinsamen Lade-, Speicher-, Abbruch- und Konfliktverträgen registrieren. Die allgemeine Leserhülle ruft die registrierte Komponente auf.
|
||||
- Eine Zuordnung neuer Mediennamen auf weiterhin fest eingebaute Leserzweige genügt nicht. Neue Leser-/Editorbausteine dürfen keine Änderung an Akten-/Vorgangsseiten oder am allgemeinen Reader verlangen.
|
||||
- Interne Notizen behalten ihren bisherigen Speicherweg und ihre Identität. Kein künstlicher externer Notiz-Connector und keine neue MD-Dateischreibfunktion.
|
||||
|
||||
**Abnahme:** Eine zusätzliche Testdarstellung und einen Testeditor nur durch ihre Module und Registrierung integrieren und tatsächlich über die Leserhülle bedienen. Vorhandenen dritten Test-Connector in der Testoberfläche einrichten, suchen, öffnen, einbinden, erneut öffnen und exportieren. Keine weiteren produktiven Dienste erforderlich; ein reiner Registry-Test in Node genügt nicht.
|
||||
|
||||
### K6 – Paperless-Antworten an die aktuelle Anfrage binden
|
||||
|
||||
**Quelle:** R4.
|
||||
|
||||
- Überholte Such-, Vorschau- und Stammdatenantworten beim Instanz-/Suchwechsel ignorieren oder abbrechen. Sie dürfen weder Ergebnisse noch Instanzauswahl zurücksetzen.
|
||||
- Fremde Filter-IDs beim Instanzwechsel zurücksetzen oder ausdrücklich neu validieren. Bewusste Auswahl weiterhin unter gespeicherter Instanz und Ressourcen-ID erhalten.
|
||||
|
||||
**Abnahme:** Antwort A verzögern, zu Instanz beziehungsweise Suche B wechseln, danach A zustellen. Ergebnisse, Vorschau, Filter und Zugang bleiben bei B. Dasselbe für mehrfache schnelle Wechsel und Schließen der Ansicht prüfen.
|
||||
|
||||
### K7 – Noch fehlende Nachweise sauber schließen
|
||||
|
||||
**Quelle:** R-N; reale Abnahme im Mailbericht.
|
||||
|
||||
- Paperless-Tests müssen Filterwirkung auf unterscheidbaren Testdaten belegen, zusätzlich zur Parameterübertragung: Suchwort nur im Inhalt, getrennte Titeleingrenzung, kombinierte Metadaten-/Datumsfilter und mehrere Seiten. Ein Fake, der unabhängig von den Parametern dieselben Treffer liefert, belegt keine Suchsemantik.
|
||||
- Reale Paperless-Abnahme an der vorhandenen autorisierten Instanz lesend ausführen, soweit verfügbar. Schemaauslesen und tatsächliche Dokumentabfrage sind verschiedene Nachweise.
|
||||
- Reale IMAP-Abnahme aus K1 und konkrete problematische Mail aus K2 prüfen, soweit verfügbar. Nicht verfügbare Anschlüsse oder fehlende konkrete Beispieldaten als offen benennen; keine Credentials beschaffen oder Inhalte extern veröffentlichen.
|
||||
|
||||
**Abnahme:** Der Abschlussbericht trennt je Punkt Umsetzung, synthetischen Funktionsnachweis, Bediennachweis und tatsächlichen Quellencheck. Ein nicht ausgeführter Realtest erhält keinen Status „bestanden“.
|
||||
|
||||
## 4. Durchführung und Abschluss
|
||||
|
||||
1. Aktuellen Code gezielt gegen K1–K7 prüfen. Bereits behobene Punkte mit ihrem konkreten Nachweis übernehmen; keine Änderungen nur zum Nachbauen alter Fundstellen. Zeilenangaben in den Berichten beziehen sich auf den damaligen Stand.
|
||||
2. Mit den unmittelbar störenden Mailproblemen K1/K2 beginnen und die nötigen gemeinsamen Änderungen aus K3/K5 einbeziehen. Bestehende Funktionen weiterverwenden. Die übrigen Korrekturen gehören zum selben Auftrag und werden nicht still zurückgestellt.
|
||||
3. Passende Regressionstests gezielt ergänzen, dann relevante Gesamttests und Frontend-Build ausführen. Bestandene breite Läufe ohne neue Änderung oder offene Sorge nicht ständig wiederholen. Keine produktive DB für automatisierte Tests.
|
||||
4. Betroffene UI auf Desktop und bei 390/360 px prüfen: Fokus, Tastatur, Fehler, Laden, Leerzustand und Abbruch. Gewählte Gestaltung und kompakte Inhaltslisten erhalten.
|
||||
5. Bestehende Abschlussmatrix und betroffene API-/Architekturdokumentation gezielt nachführen. Keine neue vollständige Grundlagen-Spezifikation.
|
||||
|
||||
Liefere abschließend eine kurze Matrix mit **K1–K7, geändertem Verhalten, konkretem Nachweis, Ergebnis und verbleibender Grenze**. Bei Blockern deren Auswirkung benennen, während unabhängige Korrekturen weiterlaufen. Ein funktionierender Zwischenstand darf als solcher übergeben werden; den gesamten Auftrag erst bei erfüllten Kriterien als abgeschlossen melden.
|
||||
|
||||
Weiterhin außerhalb dieses Auftrags: Finanzfunktionen, KI, bidirektionale Paperless-Synchronisation, neue SaaS-/Runtime-/Kryptografieplattform und produktive weitere Speicheranbieter. Kein Push, Deployment, externer Versand oder Eingriff in andere Produkte.
|
||||
@@ -21,6 +21,8 @@ Diese Datei sichert bestätigte Anforderungen, den Quellenabgleich und das näch
|
||||
|
||||
**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).
|
||||
|
||||
**Implementierungsnachweis 20.10.2026, ohne neue Fachversion:** Die Korrektur K1–K7 ist lokal umgesetzt: [TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md](TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md). IMAP-Fachnamen mit Leerzeichen, Anführungszeichen oder Backslash gehen als gequotete Protokollargumente an den Server. Die gemeinsame MIME-Auswertung trennt Anzeigenamen und Archivnamen und liefert eine bereinigte HTML-Ansicht neben einer gekennzeichneten Textfassung. Externe Abrufe und die Veröffentlichung von Dateibytes laufen außerhalb der offenen Fachtransaktion; der fachliche Abschluss folgt danach. Der Markdown-Leser stellt die Ebenen 1–6, verschachtelte Listen und den Listenstart dar. Neue Leser hängen an der Registrierung. Verspätete Paperless-Antworten ändern nicht die inzwischen gewählte Instanz. F-02b und F-02c bleiben offen. Eine echte Postfach- und Dokumentprüfung an den bestehenden Zugängen ist nicht erfolgt.
|
||||
|
||||
## 2. Gesicherter fachlicher Kern
|
||||
|
||||
**Bestätigt durch aktuellen Auftrag und/oder ursprüngliche Nutzeraussagen:**
|
||||
|
||||
@@ -1,5 +1,7 @@
|
||||
# Tsumugu – Übergabe zur fachlichen Weiterplanung
|
||||
|
||||
**Nachtrag 20.10.2026:** Der Korrekturauftrag K1–K7 ist lokal umgesetzt und nicht deployed. Auftrag, Mailbefund und Review stehen in [TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md](TSUMUGU_KORREKTURAUFTRAG_CONNECTOREN_MAIL_MARKDOWN_2026-10-20.md). Die Nachweise und die offenen echten Quellenprüfungen stehen am Ende der [Abschlussmatrix](TSUMUGU_CONNECTOR_ABSCHLUSSMATRIX_2026-10-19.md). Ein lebendes Postfach und eine echte Paperless-Dokumentabfrage bleiben offen.
|
||||
|
||||
**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.
|
||||
|
||||
Reference in new issue
Block a user