10 KiB
Auftrag an Cursor – erste gemeinsame Connector-/Storage-Basis
Stand: 19.10.2026 · Status: Vorbereiteter, begrenzter Umsetzungsauftrag. Durch Erstellung dieses Dokuments wurde keine Anwendung geändert. Übergabe an Cursor erteilt den Umsetzungsauftrag bis zur lokalen Prüfung.
Ziel und Grundlagen
Arbeite in C:/Dev/tsumugu. Lies zuerst AGENTS.md, die aktuelle Fachspec, die Connector Suite v0.2 und C:/Dev/tsumugu/docs/architecture/TSUMUGU_CONNECTOR_STORAGE_VERTRAG_v0.1_2026-10-19.md. Nutze die bestehenden Architekturverträge und Blueprints unter C:/Dev/tsumugu/docs/reference. Das Repository verwendet den Ordnernamen reference im Singular.
Die Vertragsbeschreibung ist ein Umsetzungsvorschlag auf Basis der bestätigten Fachentscheidungen. Prüfe den aktuellen Code erneut. Erhalte bestehende Fremdänderungen, Fachmodell und ausgewählte Gestaltung. Vorhandene Paperless-/IMAP-Protokollarbeit, Medienablage, Reader und Notizeditor wiederverwenden. Keine neue Foundation oder parallele Connector-Anwendung.
Lieferpaket
Primäres Ziel ist die belastbare Grundlage für die fortlaufende private Nutzung. Der Auftrag wird in zwei getrennt prüfbare Lieferabschnitte gegliedert. Zuerst Abschnitt A fertigstellen und lokal übergeben. Abschnitt B ist der vorbereitete nächste Funktionsausbau und wird durch diesen Basisauftrag nicht automatisch mitimplementiert. Es werden weder neue Plattformdienste noch ungenutzte Fachmodule auf Vorrat angelegt.
Abschnitt A – jetzt beauftragt: Grundlagen bei erhaltener Funktion
- Gemeinsamen Source-Vertrag und registrierte Adapter für Paperless und IMAP integrieren. Konkrete Verbindung, Ressource, Operation, Rechte und Fehlerzustand durchgängig erhalten.
- Eigene Dateiablage und gesicherte Versandfassungen an einen kleinen Storage-Port mit lokalem Adapter anbinden. Bestandsdateien ohne Neu-Upload erhalten. Storage-/Inhaltsrevision und Schlüsselzuständigkeit gemäß Vertrag trennen.
- Gemeinsame Frontend-Zugriffsschicht und Registry für Quell-/Darstellungsbausteine einführen. Bestehende Picker/Formulare als registrierte Quellmodule weiterverwenden. Gemeinsame Hüllen und Auswahl-/Zielkontextverträge gezielt herausziehen; eine vollständige Neugestaltung sämtlicher Dialoge ist nicht erforderlich.
- Reader nach Darstellungsart anbinden; vorhandene Notizbearbeitung erhalten und ihre Speichern-/Konfliktzustände hinter der gemeinsamen Editor-Anschlussstelle führen. Die bestehende Notiz-API bleibt der fachliche Speicherweg für Notizen. Noch nicht vorhandene Editorarten werden nicht als nutzbar angeboten.
- Typisierte Such-, Filter-, Sortier- und Paging-Verträge mit ausgewiesenen Fähigkeiten definieren. Die heutige Suche darf durch den Umbau keine Funktion verlieren; zusätzliche Filter werden in Abschnitt B geliefert. Ein gemeinsames Interface bedeutet keine vorgetäuschte Verfügbarkeit.
- Vorschau, Originaldownload, Export, Anlagen und Versandnachweise über dieselbe autorisierte Ressourcenauflösung führen. Keine spontane Auswahl eines anderen Quellenzugangs. Bibliotheks-/Frameworkmigrationen sind kein Teil der Grundlagenlieferung.
Abschnitt B – nächster, separat zu startender Funktionsausbau
Gemeinsamen Quellenbrowser einschließlich Preview-vor-Übernahme vervollständigen. Paperless-Suche um Freitext/Titel, Korrespondent, Dokumenttyp, Tags, Dokumentdatumsbereich, Sortierung und weitere Ergebnisseiten erweitern. Konkrete API-Fähigkeiten gegen die eingesetzte Version prüfen. Mehrfachauswahl über Such-/Seitenwechsel erhalten. Dies ist bestätigter Ausbaubedarf, aber keine Abnahmevoraussetzung für Abschnitt A. Ein neuer MD-Dateieditor ist ein weiterer eigener Schnitt.
Beginne mit einer kurzen Bestands- und Aufwandsnotiz für diesen Schnitt; die alte Schätzung von 6–9 Tagen gilt nicht automatisch für diesen erweiterten Auftrag. Geplante und bereits vorhandene Funktionen unterscheiden. Eine erneute vollständige Produktspezifikation ist nicht erforderlich.
Migration und Schutz
Bestehende Elemente, Einbindungen, Kapitel, Inhaltsdaten und Rechte erhalten. Eindeutige Quellinstanzen nachziehen; Mehrdeutigkeiten markieren und bewusst auflösen lassen. Rohdaten nicht kopieren, um Referenzen zu vereinfachen. Keine globale automatische Zusammenführung anhand externer ID oder Hash.
Bestehende Medien- und Snapshotdateien zunächst unter stabiler Legacy-Speichergeneration lesbar machen. Metadatenmigration genügt, wo kein physischer Umzug nötig ist. Neue Repräsentationen werden erst nach geprüftem Speichererfolg veröffentlicht. Fehlgeschlagene oder wiederholte Abläufe dürfen keine falschen Erfolgsmeldungen oder stillen Verluste erzeugen.
Keine Netzwerk-/großen Dateioperationen in offener Fachtransaktion. Aktuelle Rechte und Version vor Abschluss erneut prüfen. Quellcredentials bleiben im zuständigen Adapter. Befunde zu bestehender Credential-Speicherung und Schlüsselverwaltung ausdrücklich in der Aufwands-/Grenzennotiz behandeln; daraus keine behauptete SaaS-Reife ableiten.
Die erste Lieferung aktiviert keine neue Kryptografie. Sie muss den späteren Content-/Crypto-Zugriff über die festgelegte Grenze ermöglichen und unbehandelte Schutzprofile geschlossen ablehnen. Eine verschlüsselte Ablage darf erst nach dem gesonderten Schlüssel-/Recovery-Prüfergebnis und einem dafür konkretisierten Implementierungsauftrag aktiviert werden.
Konkrete Abnahme
Mit synthetischen Daten und getrennten Testdatenbanken prüfen:
- Bestand: PDF/Fotos, Notizen, Unterkapitel, geordnete Anlagen, Versandfassungen und Export bleiben nach Migration nutzbar. Vorhandene IDs und Originalbytes sind erhalten.
- Instanzbindung: Gleiche Dokumentnummer in zwei simulierten Paperless-Instanzen führt zu korrekten, getrennten Auflösungen. Änderung der Verbindungsreihenfolge lenkt Referenzen nicht um. Mehrdeutiger Altbestand bleibt vorhanden und verlangt Zuordnung.
- Suche: In Abschnitt A die heutige Suche und instanzgebundene Anfrage-/Ergebnisverträge prüfen; nicht implementierte Fähigkeiten korrekt ausweisen. Für Abschnitt B: mindestens 45 synthetische Treffer über mehrere Seiten, kombinierte Grundfilter und Sortierung prüfen, Treffer hinter Seite eins vor Einbindung öffnen. Suchwechsel erhält bewusst gewählte Ressourcen; fehlende Rechte verraten keine Titel oder Zähler.
- IMAP: Ordnernavigation, Paging, Nachricht, Anlagen, eindeutige Wiedererkennung bei Verschiebung sowie klare Fehler bei fehlender/mehrdeutiger Nachricht erhalten.
- Owner-Abruf: Berechtigter Empfänger liest ausdrücklich freigegebene Unterlagen über den erlaubten Owner-Zugang. Er bekommt weder Credentials noch Suchzugriff auf dessen übrigen Bestand. Entzug wirkt beim nächsten Abruf.
- UI: Beide vorhandenen Auswahlwege über die neue gemeinsame Zugriffsschicht tatsächlich bedienen. Zielcontainer, Kapitel und Handlungskontext bleiben korrekt. Desktop und 390/360 px, Tastatur, Dialogfokus/-rückkehr, Abbruch sowie Fehler beim Speichern/Einbinden prüfen. Der vollständig vereinheitlichte Quellenbrowser wird zusätzlich in Abschnitt B abgenommen.
- Anzeige/Editor: PDF/Bild und E-Mail korrekt anzeigen; Markdown-Notiz bearbeiten und Versionskonflikt behandeln. Nicht unterstützte Editierfähigkeit wird klar angezeigt und serverseitig verweigert. Keine künstliche MD-Dateibearbeitung durch Umwandlung in eine Notiz.
- Storage-Vertrag: Lokalen Adapter und einen kleinen Testadapter gegen denselben Vertrag prüfen. Opaque Bytes roundtrip, stabile Generation, Fehlerzustände und unveränderte Inhaltsrevisionen belegen. Der Testadapter ist kein zweiter produktiver Speicherdienst.
- Vorbereitung kundenseitiger Schlüssel: Ein gesperrtes/noch nicht unterstütztes Schutzprofil erlaubt Metadatenanzeige nach Recht, aber keinen stillen serverseitigen Klartextabruf. Dummy-Ciphertext unverändert speichern/lesen. Aus diesem Test keinen Verschlüsselungsnachweis ableiten.
- Fehlerfälle: Speicherfehler, DB-Abschlussfehler, Wiederholung, Quellausfall, Fremd-IDs, Pfadmanipulation und veraltete Bearbeitung abdecken. Veröffentlichung erst nach verifiziertem Erfolg; verwaiste Zwischenstände nachvollziehbar bereinigen.
- Export: Hierarchische Auswahl und vollständige EML samt Anlagen erhalten, auch bei separat abgewähltem Anlage-Vorkommen. Gesicherte Versandstände dürfen durch aktuelle Quellstände nicht ersetzt werden.
Passende vorhandene Backend-Tests weiterverwenden und gezielt ergänzen. Frontend-Build und erforderliche UI-Prüfungen ausführen. Reale Quellenrechte/API-Version in einer abschließenden, ausdrücklich autorisierten Anschlussprüfung bestätigen; Mocks und tatsächliche Quellenprüfungen im Bericht unterscheiden. Keine privaten Daten in Screenshots oder Logs übernehmen.
Dokumentation und Abschluss
Nach tatsächlicher Änderung die Fachspec gezielt fortschreiben; bestätigte Nutzerentscheidungen, Vorschläge und Implementierungsnachweise unterscheiden. F-02b/c bleibt erhalten: Die erste Source-Lieferung ist lesend und hebt die frühere Feldsynchronisationsanforderung nicht auf. API_REFERENZ.md, DATENMODELL_IST.md, RECHTEMODELL_IST.md und betroffene technische Beschreibung im selben Schnitt aktualisieren. Neue Dokumente in docs/README.md und der Planungsübergabe verlinken.
Liefere Abschnitt A lokal integriert mit tatsächlichen Testergebnissen, wesentlichen Abweichungen und verbleibenden Grenzen. Benenne Abschnitt B ausdrücklich als nächsten Funktionsausbau. Alte Quellenwege nur während der Migration als delegierende Kompatibilität behalten; keine dauerhafte doppelte Fachlogik. Quellenspezifische registrierte UI-Komponenten sind zulässig, solange die Fachseiten die gemeinsamen Verträge verwenden.
Nicht enthalten: produktiver Hybridkanal, Browser-Schlüsseltresor, neue Verschlüsselungsimplementierung, automatische EML-Archivierung, Dateisystem-/NAS-Source, neue MD-Dateischreibfunktion, dynamische Sammlungen, neue Paperless-Metadaten-Schreib-/Synchronisationsfunktion, Banking oder KI. Diese Anforderungen bleiben im Zielbild erhalten. Kein Push, Deployment, Versand oder Änderung anderer Jinkendo-Produkte.