749 lines
40 KiB
Markdown
749 lines
40 KiB
Markdown
<!-- status: done -->
|
|
<!-- started: 2026-05-01 -->
|
|
<!-- completed: 2026-05-03 -->
|
|
<!-- component: ui-nyla, gateway -->
|
|
|
|
# FormGeneratorTree (NEU) + Recovery der persistenten Folder/File-Funktionen
|
|
|
|
## Beschreibung und Kontext
|
|
|
|
In den Commits `c8e9304` (2026-04-29), `e7a79a3` und `7c05cb0` (beide 2026-04-30,
|
|
zusammen -1263 / +897) wurde `FolderTree` aus
|
|
|
|
- `ui-nyla/src/pages/basedata/FilesPage.tsx`
|
|
- `ui-nyla/src/components/UnifiedDataBar/FilesTab.tsx`
|
|
|
|
entfernt und durch `FormGeneratorTable` mit `groupingConfig` ersetzt. Begleitend
|
|
wurden die Folder-Operationen aus `FileContext.tsx` und `useFiles.ts` reduziert,
|
|
`FileInfo.folderId` aus `fileApi.ts` und das Pydantic-Feld `FileItem.folderId`
|
|
aus `platform-core/modules/datamodels/datamodelFiles.py` entfernt. Im Repo liegt das
|
|
Archiviertes Skript `platform-core/modules/migrations/_archive/migrate_folders_to_groups.py`, das die
|
|
`FileFolder`-Tabelle + `FileItem.folderId`-Spalte in einen JSON-Tree
|
|
(`TableGrouping.rootGroups`, Context `files/list`) ueberfuehren *kann* -- per
|
|
Default `--dry-run`, ohne begleitende Alembic-Migration zum DROP-COLUMN /
|
|
DROP-TABLE.
|
|
|
|
**Datenbank-Stand:** `FileFolder` und `FileItem.folderId` sind in der DB
|
|
unveraendert vorhanden. Recovery laeuft als reine Pydantic-/Routen-/FE-Wieder-
|
|
verdrahtung -- **kein** neues Schema fuer diesen Track.
|
|
|
|
### Beobachtete funktionale Luecken (nach dem Wechsel zu Table-only)
|
|
|
|
- Folders koennen nicht mehr neu erstellt werden (UI-Affordance entfernt).
|
|
- Pro-File / pro-Folder Scope-Icons + Neutralize-Toggle fehlen
|
|
(`patchGroupScope` / `patchGroupNeutralize` sind Bulk-Operationen auf Group-
|
|
Items und ersetzen die Per-Item-UI nicht).
|
|
- Multiselect / Multidelete mit Cascade ueber gemischte Folders+Files-Auswahl
|
|
ist nicht abgebildet.
|
|
- DnD-Protokoll inkompatibel: `application/group-id`,
|
|
`application/group-file-ids` und `application/tree-items` mit
|
|
`type: 'file' | 'group'` waren auf Tabellen-Gruppierungen optimiert;
|
|
`WorkspaceInput.TreeItemDrop` musste mitziehen.
|
|
- Mandanten-geteilte Folder-Strukturen lassen sich mit per-User-`TableGrouping`
|
|
nicht abbilden.
|
|
|
|
### Tree-Fragmentierung im Frontend (zusaetzlicher Treiber)
|
|
|
|
Heute existieren mindestens **acht parallele** Tree-Implementierungen:
|
|
|
|
| # | Datei | Inhalt | Lazy | Multiselect | Inline-Actions |
|
|
|---|------|--------|---|---|---|
|
|
| 1 | `components/FolderTree/FolderTree.tsx` | Files+Folders (entkoppelt) | nein | ja | ja |
|
|
| 2 | `components/FolderTree/SharepointBrowseTree.tsx` | SharePoint-Browse | ja | nein | nein |
|
|
| 3 | `components/UnifiedDataBar/SourcesTab.tsx` | Connections + Feature-Daten | ja | partiell | partiell |
|
|
| 4 | `components/UnifiedDataBar/ChatsTab.tsx` | Chat-Historien | nein | nein | partiell |
|
|
| 5 | `components/FlowEditor/nodes/shared/DataPicker.tsx` | Upstream-Outputs | nein | nein | nein |
|
|
| 6 | `components/Navigation/TreeNavigation/*` + `MandateNavigation.tsx` | Sidebar | nein | nein | nein |
|
|
| 7 | `pages/admin/InstanceHierarchyView.tsx` | RBAC-Hierarchie | nein | nein | nein |
|
|
| 8 | `pages/views/redmine/redmineTreeLogic.ts` | Redmine-Issues | nein | nein | partiell |
|
|
| 9 | `components/AccessRules/AccessRulesEditor.tsx` | RBAC-Rules | nein | nein | partiell |
|
|
|
|
### Geschaeftstreiber
|
|
|
|
1. Recovery der Datei-/Ordner-Funktionen, ohne `FormGeneratorTable.groupingConfig`
|
|
fuer andere Use-Cases zurueckzubauen.
|
|
2. Konsolidierung der Tree-Implementierungen auf eine getestete
|
|
Komponente -- ein Bugfix-/Feature-Punkt statt acht.
|
|
3. UDB-Konsistenz: drei feste Tabs (Files/Folders, Sources, Chats), alle als
|
|
hierarchische Sicht auf persistente Entitaeten.
|
|
|
|
---
|
|
|
|
## Architektur
|
|
|
|
### `FormGeneratorTree` als neues Familienmitglied
|
|
|
|
Die FormGenerator-Familie wird um eine Tree-Komponente erweitert (parallel zu
|
|
`FormGeneratorTable`, `FormGeneratorForm`, `FormGeneratorList`,
|
|
`FormGeneratorReport`).
|
|
|
|
| Aspekt | Bestimmung |
|
|
|---|---|
|
|
| Aufgabe | Hierarchische, lazy-ladbare Sicht auf persistente Entitaeten |
|
|
| Datenbindung | Pro Use-Case ein **Provider** (siehe Provider-Interface unten) |
|
|
| Spalten | Backend-Attribut-Resolution analog `resolveColumnTypes`; **keine** hardcoded Cell-Renderer in der Page; Pflicht-Spalte = Tree-Spalte (Indent + Chevron + Icon + Name) |
|
|
| Selektion | Multiselect mit Shift/Ctrl/Cmd, kaskadierend (Folder selektieren -> alle eigenen Children); `BatchAction[]`-API analog Table |
|
|
| DnD | Standard-MIME `application/x-poweron-tree-items`, Payload `{ id, type, name, providerKey }[]` |
|
|
| Nicht zustaendig | Report-Rendering (das ist `FormGeneratorReport`); Forms (`FormGeneratorForm`); eigene Datenpersistenz (haelt der Provider); Replikation der `groupingConfig`-Logik aus `FormGeneratorTable` |
|
|
|
|
**Provider-Interface (vorlaeufig):**
|
|
|
|
```typescript
|
|
type Ownership = 'own' | 'shared';
|
|
|
|
interface TreeNode<T> {
|
|
id: string;
|
|
name: string;
|
|
parentId: string | null;
|
|
ownership: Ownership;
|
|
scope?: 'personal' | 'featureInstance' | 'mandate' | 'global';
|
|
neutralize?: boolean;
|
|
// Parent-Kontext (z.B. Folder) ist fuer den Current-User nicht sichtbar;
|
|
// Knoten wird im Root mit Hint-Icon gerendert.
|
|
contextOrphan?: boolean;
|
|
data?: T;
|
|
}
|
|
|
|
interface TreeNodeProvider<T> {
|
|
rootKey: string;
|
|
loadChildren(parentId: string | null, ownership: Ownership): Promise<TreeNode<T>[]>;
|
|
getAttributes(): Promise<AttributeDefinition[]>;
|
|
// Mutations gelten ausschliesslich fuer ownership='own'.
|
|
canCreate?(parentId: string | null): boolean;
|
|
canRename?(node: TreeNode<T>): boolean;
|
|
canDelete?(node: TreeNode<T>): boolean;
|
|
canMove?(source: TreeNode<T>, target: TreeNode<T> | null): boolean;
|
|
canPatchScope?(node: TreeNode<T>): boolean;
|
|
canPatchNeutralize?(node: TreeNode<T>): boolean;
|
|
createChild?(parentId: string | null, name: string): Promise<TreeNode<T>>;
|
|
renameNode?(id: string, newName: string): Promise<void>;
|
|
deleteNodes?(ids: string[]): Promise<void>;
|
|
moveNodes?(ids: string[], targetParentId: string | null): Promise<void>;
|
|
patchScope?(ids: string[], scope: string, cascadeChildren?: boolean): Promise<void>;
|
|
patchNeutralize?(ids: string[], neutralize: boolean): Promise<void>;
|
|
}
|
|
```
|
|
|
|
### Folder/File vs. `TableGrouping` (zwei orthogonale Konzepte)
|
|
|
|
| Eigenschaft | Folder/File (`FileFolder`, `FileItem`) | Group (`TableGrouping`) |
|
|
|---|---|---|
|
|
| Identitaet | First-class Entity (UUID, audit, RBAC) | JSON-Knoten in einem User-spezifischen Tree |
|
|
| Persistenz | DB-Zeile | JSON-Blob in `TableGrouping.rootGroups` |
|
|
| Sichtbarkeit | Per `scope` (personal/featureInstance/mandate/global) | per-User (`userId` ist Partition-Key) |
|
|
| RBAC | Per-Item Scope, Owner-only-Mutationen | keine; nur enthaltene Items haben Scope |
|
|
| Move / Delete | Beeinflusst alle berechtigten User | Lokal pro User |
|
|
| Use-Case | Files/Folders (mandate-shared) | Persoenliche Sortier-Sicht auf flachen Listen (Workflow-Runs, Trustee-Positionen, ...) |
|
|
|
|
`FormGeneratorTable.groupingConfig` bleibt unveraendert. `FormGeneratorTree`
|
|
und `groupingConfig` sind komplementaer; beide Sichten duerfen
|
|
nebeneinander auf denselben Files leben (siehe `FilesPage` View-Toggle).
|
|
|
|
### Use-Case-Zuordnung
|
|
|
|
| Use-Case | Komponente |
|
|
|---|---|
|
|
| Files in Folders (mandate-shared) | `FormGeneratorTree` + `FolderFileProvider` |
|
|
| External-Source-Browse (kDrive, SharePoint, ...) | `FormGeneratorTree` + `ConnectorBrowseProvider` |
|
|
| Feature-Daten in UDB (Mandate -> FeatureConnection -> Group/Table -> Record) | `FormGeneratorTree` + `FeatureDataProvider` |
|
|
| Chat-Historie nach Feature gruppiert | `FormGeneratorTree` + `ChatProvider` |
|
|
| AccessRules-Editor | `FormGeneratorTree` + `RbacRuleProvider` |
|
|
| FlowEditor DataPicker (Upstream-Output-Pfade) | `FormGeneratorTree` + `DataRefProvider` |
|
|
| InstanceHierarchyView (RBAC-Audit) | `FormGeneratorTree` + `InstanceHierarchyProvider` |
|
|
| Workflow-Runs nach Mandant + Status filtern | `FormGeneratorTable` + `groupingConfig` (flach, per-User) |
|
|
| Sidebar (`MandateNavigation`, `TreeNavigation`) | bleibt eigene Komponente -- Routing-Affordance, kein CRUD-Tree |
|
|
|
|
Faustregel: Hat das Item eine eigene DB-Identitaet jenseits des aktuellen Users?
|
|
Ja -> `FormGeneratorTree`. Nein -> `FormGeneratorTable.groupingConfig`.
|
|
|
|
### RBAC- und Sichtbarkeits-Modell (verbindlich)
|
|
|
|
Die Recovery folgt dem fuer Files **bereits implementierten** RBAC-Modell
|
|
(siehe `interfaceRbac.buildFilesScopeWhereClause`,
|
|
`interfaceDbManagement.updateFile / deleteFile / deleteFilesBatch`). Folders
|
|
bekommen 1:1 dieselbe Mechanik:
|
|
|
|
1. **Default-Sichtbarkeit `personal`.** Jedes neu angelegte Folder/File ist
|
|
nur fuer `sysCreatedBy = currentUser` sichtbar.
|
|
2. **Sharing nur ueber `scope`.** Andere User sehen ein Objekt, sobald der
|
|
Eigentuemer den Scope explizit erhoeht (`featureInstance` /
|
|
`mandate` / `global`; `global` setzt `ALL`-Permission voraus, in der
|
|
Praxis SysAdmin).
|
|
3. **Mutation = Owner-only** (oder `ALL`-Permission). Rename / Move / Delete /
|
|
Scope-Cycle / Neutralize-Toggle sind fuer Nicht-Eigentuemer 403; die UI
|
|
blendet die Affordance aus.
|
|
4. **Zwei getrennte Trees in jeder Files-Sicht:**
|
|
- **„Eigene“** -- `sysCreatedBy = currentUser`. Volles CRUD; das Scope-Icon
|
|
zeigt Sharing-Status an.
|
|
- **„Geteilt mit mir“** -- `sysCreatedBy != currentUser`, ueber `scope`
|
|
sichtbar. Read-only; Scope-/Neutralize nur als Indikator-Icon. DnD aus
|
|
diesem Tree ist rein lesend (z.B. Drop in Chat-Input); Drop in den
|
|
eigenen Tree erzeugt **keinen** Move (kein Ownership-Wechsel).
|
|
5. **Render-Regel.** Files erscheinen unter ihrem Folder, wenn der Folder fuer
|
|
den Current-User sichtbar ist. Fehlt der Folder-Kontext (`FileItem.scope`
|
|
geteilt, `FileFolder.scope` nicht), wird die Datei im Root des passenden
|
|
Trees mit `contextOrphan`-Hint („kein Folder-Kontext geteilt“) gerendert.
|
|
Aendert der Owner spaeter den Folder-Scope, wandert die Datei automatisch
|
|
unter den Folder.
|
|
6. **Cascade-Delete nur Owner.** Multidelete eines (Sub-)Trees laeuft genau
|
|
dann, wenn alle Items dem Current-User gehoeren. Gemischte Selektionen
|
|
(Eigene + Geteilte) blockieren die Bulk-Aktion mit Hinweis.
|
|
7. **Folder-Scope-Cascade auf Files = opt-in.** Beim Setzen eines Folder-
|
|
Scopes wird der Owner per Dialog gefragt, ob die enthaltenen Files den
|
|
Scope erben. Default: nein (Folders und Files behalten unabhaengige Scopes,
|
|
konsistent mit der heutigen Files-Logik).
|
|
8. **Folder-Neutralize-Vererbung beim Drop = nein.** Beim Drop eines Files in
|
|
einen Folder mit `neutralize=true` wird der Datei-Wert nicht automatisch
|
|
geaendert; ein Indikator zeigt den Mismatch.
|
|
|
|
> **Datentabellen-Sicht (`FormGeneratorTable.groupingConfig` auf Files):**
|
|
> Status quo. Die Tabelle zeigt weiterhin alle sichtbaren Files (eigene +
|
|
> geteilte) flach; nur die Tree-Sicht trennt Eigene/Geteilt. Falls spaeter
|
|
> gewuenscht, kann ein `ownerFilter` ergaenzt werden -- nicht in diesem Plan.
|
|
|
|
---
|
|
|
|
## Entscheidungen (konsolidiert)
|
|
|
|
| # | Datum | Bereich | Entscheidung | Begruendung |
|
|
|---|-------|--------|-------------|------------|
|
|
| D1 | 2026-05-01 | Komponenten | UDB hat fix drei Tabs (Files, Sources, Chats); alle drei rendern `FormGeneratorTree` | Konsistente UDB-Struktur |
|
|
| D2 | 2026-05-01 | Komponenten | FormGenerator-Familie um `Tree` erweitern; nicht `FolderTree` v2 | Konsolidiert ~8 parallele Tree-Implementierungen |
|
|
| D3 | 2026-05-01 | Komponenten | `FormGeneratorTable.groupingConfig` bleibt unveraendert | Gilt fuer flache Daten (Workflow-Runs, Trustee-Positionen) |
|
|
| D4 | 2026-05-01 | Komponenten | Berichte = `FormGeneratorReport`; **kein** `FormGeneratorChart` (Namens-Klarstellung) | Bestehende Familienkomponente |
|
|
| D5 | 2026-05-01 | Komponenten | Sidebar (`MandateNavigation` / `TreeNavigation`) bleibt eigene Komponente | Routing-Affordance, kein CRUD-Tree |
|
|
| D6 | 2026-05-01 | Persistenz | Recovery via Modell A: `FileFolder` + `FileItem.folderId` reaktivieren (Pydantic, Routen, FE) | Mandanten-geteilte Ordnerstruktur; DB-Schema unveraendert |
|
|
| D7 | 2026-05-01 | Persistenz | Keine Schema-Aenderung in dev/int/prod; `migrate_folders_to_groups.py` wird archiviert (audit trail) | Nur API/FE-Wiederverdrahtung |
|
|
| D8 | 2026-05-01 | Persistenz | Soft-Delete wird **nicht** eingefuehrt; Audit-Eintrag pro Mutation reicht | Bestehende Pattern-Konsistenz |
|
|
| D9 | 2026-05-01 | Persistenz | Owner-Wechsel von Folders/Files ist nicht im Scope (`sysCreatedBy` immutable) | Bestehender Kontrakt |
|
|
| D10 | 2026-05-01 | RBAC | Default-Scope `personal` fuer neue Folders/Files; Sharing nur via Owner-Scope-Patch | Konsistent zu Files-RBAC heute |
|
|
| D11 | 2026-05-01 | RBAC | Geteilte Folders/Files sind fuer Nicht-Owner read-only (Backend 403, UI keine Affordance) | Owner-only-Kontrakt analog `updateFile` / `deleteFile` |
|
|
| D12 | 2026-05-01 | RBAC | Scope-Auflader: `featureInstance`-Sichtbarkeit gilt nur, wenn der User Zugriff auf die Feature-Instanz hat (bestehende `buildFilesScopeWhereClause`-Logik unveraendert) | Konsistenz zu heutigem Files-Pfad |
|
|
| D13 | 2026-05-01 | RBAC | `scope=global` ist im Eigenen-Tree des Owners (i.d.R. SysAdmin) sichtbar mit eigenem Indikator; bei allen anderen Usern im „Geteilt mit mir“-Tree | Symmetrische Owner-Sicht |
|
|
| D14 | 2026-05-01 | UI-Modell | Zwei getrennte Trees pro Files-Sicht: „Eigene“ (CRUD) + „Geteilt mit mir“ (read-only) | Saubere Datenstruktur, keine Vermischung |
|
|
| D15 | 2026-05-01 | UI-Modell | Render-Regel: File unter Folder, falls Folder sichtbar; sonst Root mit `contextOrphan`-Hint | Vermeidet Phantom-Hierarchien |
|
|
| D16 | 2026-05-01 | UI-Modell | „Geteilt mit mir“-Tree sortiert primaer nach Owner-Name, dann Folder-Hierarchie | Quelle des Sharings ist die wichtigste Information |
|
|
| D17 | 2026-05-01 | UI-Modell | „Geteilt mit mir“-Sektion kollabiert sich, wenn leer | UI-Hygiene |
|
|
| D18 | 2026-05-01 | UI-Modell | `FormGeneratorTable.groupingConfig`-Sicht auf Files bleibt flach (Eigene + Geteilte gemischt); kein zusaetzlicher Owner-Filter in diesem Plan | Status quo der Tabelle |
|
|
| D19 | 2026-05-01 | Sharing | Folder-Scope-Cascade auf enthaltene Files = opt-in (Dialog beim Patch) | Vermeidet versehentliche Massen-Sharings |
|
|
| D20 | 2026-05-01 | Sharing | Folder-Neutralize-Vererbung beim File-Drop = nein (analog Scope; Indikator zeigt Mismatch) | Owner-Entscheidung pro Item |
|
|
| D21 | 2026-05-01 | Sharing | Drag aus „Geteilt mit mir“ in eigenen Tree = gesperrt (kein Move, keine implizite Kopie) | Ownership-Wechsel ausserhalb Scope; Kopier-Workflow ggf. spaeterer Plan |
|
|
| D22 | 2026-05-01 | Stage 3 | `SourcesTab` und `ChatsTab` bekommen je **einen** Tree (kein Eigene/Geteilt-Split) | Connections und Chats sind heute personal-aequivalent; kein Sharing-Modell |
|
|
|
|
---
|
|
|
|
## Ziel und Nicht-Ziele
|
|
|
|
- **Ziel 1.** `FormGeneratorTree` als Komponente in
|
|
`ui-nyla/src/components/FormGenerator/FormGeneratorTree/` mit
|
|
Provider-Interface, Built-in-Features (Multiselect, Cascade, DnD,
|
|
Inline-Edit, Scope-/Neutralize-Indikatoren) und Backend-Attribut-Resolution.
|
|
- **Ziel 2.** `FolderFileProvider` als erste Implementierung; recovered die
|
|
in `7c05cb0` entfallenen Funktionen auf Basis Modell A.
|
|
- **Ziel 3.** UDB-Tabs `FilesTab`, `SourcesTab`, `ChatsTab` rendern
|
|
`FormGeneratorTree`. `FilesTab` zeigt zwei Tree-Sektionen (Eigene + Geteilt).
|
|
- **Ziel 4.** `FilesPage.tsx` Split-View: links zwei `FormGeneratorTree`-
|
|
Sektionen, rechts `FormGeneratorTable` mit View-Toggle „Tree-Sicht |
|
|
Liste-mit-Gruppen-Sicht“.
|
|
- **Nicht-Ziel.** `FormGeneratorTable.groupingConfig` rebauen oder entfernen.
|
|
- **Nicht-Ziel.** `FormGeneratorReport` anfassen.
|
|
- **Nicht-Ziel.** Sidebar (`MandateNavigation` / `TreeNavigation`) migrieren.
|
|
- **Nicht-Ziel.** Owner-Wechsel oder Soft-Delete fuer Folders/Files einfuehren.
|
|
|
|
---
|
|
|
|
## Betroffene Module
|
|
|
|
### Frontend Nyla
|
|
|
|
- **Neu:** `components/FormGenerator/FormGeneratorTree/`
|
|
(`FormGeneratorTree.tsx`, `FormGeneratorTree.module.css`, `types.ts`,
|
|
`__tests__/`)
|
|
- **Neu:** `providers/FolderFileProvider.tsx`
|
|
- **Recovery:** `components/UnifiedDataBar/FilesTab.tsx`
|
|
(Tree statt Table-mit-Grouping; Eigene + Geteilt)
|
|
- **Recovery:** `pages/basedata/FilesPage.tsx` (Split-View Tree+Table)
|
|
- **Recovery:** `contexts/FileContext.tsx`, `hooks/useFiles.ts`
|
|
(Folder-Operationen zurueck)
|
|
- **Recovery:** `api/fileApi.ts` (`folderId`, Folder-API-Wrapper)
|
|
- **Anpassen:** `pages/views/workspace/WorkspaceInput.tsx` --
|
|
`TreeItemDrop.type` auf `'file' | 'folder'` zuruecksetzen, neuer
|
|
Standard-MIME `application/x-poweron-tree-items`
|
|
- **Stage 3:** `components/UnifiedDataBar/SourcesTab.tsx` und `ChatsTab.tsx`
|
|
auf `FormGeneratorTree` (je ein Tree, kein Sharing-Split)
|
|
- **Stage 4 (optional):** `SharepointBrowseTree`, `DataPicker`,
|
|
`InstanceHierarchyView`, `AccessRulesEditor`
|
|
|
|
### Gateway
|
|
|
|
- **Recovery:** `datamodels/datamodelFiles.py` -- neues `FileFolder` Pydantic-
|
|
Modell + `FileItem.folderId: Optional[str]` mit `fk_target` auf
|
|
`FileFolder.id`
|
|
- **Recovery:** `interfaces/interfaceDbApp.py` /
|
|
`interfaces/interfaceDbManagement.py` -- `getOwnFolderTree()`,
|
|
`getSharedFolderTree()`, `createFolder` (Default-Scope `personal`),
|
|
`renameFolder`, `moveFolder`, `deleteFolderCascade`, `patchFolderScope`,
|
|
`patchFolderNeutralize`. Mutationen strikt owner-only (oder `ALL`).
|
|
- **Recovery:** `routes/routeDataFiles.py` -- Folder-CRUD-Routen
|
|
(`POST /folders`, `GET /folders/tree?owner=me|shared`,
|
|
`PATCH /folders/{id}`, `POST /folders/{id}/move`,
|
|
`DELETE /folders/{id}?cascade=bool`, `PATCH /folders/{id}/scope`,
|
|
`PATCH /folders/{id}/neutralize`)
|
|
- **Behalten:** `routeDataFiles.py` Group-Endpunkte
|
|
(`/groups/{groupId}/scope`, `/neutralize`, `/download`, `delete_group`)
|
|
fuer `FormGeneratorTable.groupingConfig`-Use-Cases
|
|
- **Archivieren:** `migrations/migrate_folders_to_groups.py` ->
|
|
`migrations/_archive/` mit kurzem README (audit trail)
|
|
- **Unangetastet:** `serviceCenter/.../coreTools/_workspaceTools.py`
|
|
und `mainServiceChat.py` (TableGrouping-Pfad bleibt). Bei Bedarf spaeter
|
|
`_listFolders` / `_listFilesInFolder` als zusaetzliche Agent-Tools.
|
|
|
|
### DB
|
|
|
|
Keine Schema-Aenderung. Optionaler Schema-Sanity-Check in Stage 0.
|
|
|
|
---
|
|
|
|
## Umsetzungs-Checkliste (Packets pro Modell)
|
|
|
|
Jedes Packet ist ein abgeschlossener Auftrag fuer **eine** LLM-Session.
|
|
Header pro Packet: **Modell** | **Eingang** (Voraussetzung) | **Lieferumfang**
|
|
| **Checkliste** | **Abnahme**.
|
|
|
|
Modelle:
|
|
- **Composer 2 Fast** -- mechanische Wiederherstellung, Pattern-Wiederholung,
|
|
Boilerplate, Doku gegen vorhandenen Code.
|
|
- **Opus 4.6** -- Architektur, RBAC-Korrektheit, Greenfield-API,
|
|
nicht-triviale Refactors. Bei Unsicherheit hochstufen.
|
|
|
|
### Reihenfolge / Block-Strategie
|
|
|
|
```
|
|
Stage 0 (optional)
|
|
|
|
|
v
|
|
Stage 1.A (BE Boilerplate) ─┐
|
|
Stage 1.B (BE RBAC-Kern) ├─ Block 1 (Backend in beliebiger Reihenfolge,
|
|
Stage 1.C (FE Greenfield) ─┘ FE kann parallel zu BE)
|
|
|
|
|
v
|
|
Stage 2.A (FE Recovery-Boilerplate)
|
|
|
|
|
v
|
|
Stage 2.B (FE UI-Komposition)
|
|
|
|
|
v
|
|
Stage 2.C (manuelle Verifikation, User) <-- DONE (2026-05-03)
|
|
|
|
|
v
|
|
Stage 3.A (Provider-Refactors) <-- DEFERRED
|
|
Stage 3.B (Tab-Umbau + Cleanup) <-- DEFERRED
|
|
|
|
|
v
|
|
Stage 4 (Tree-Assessment + Dead-Code-Cleanup) <-- DONE (2026-05-03)
|
|
|
|
|
v
|
|
Stage 5 (Doku & Cleanup) <-- DONE (2026-05-03)
|
|
```
|
|
|
|
Empfehlung Merge-Bloecke: **Stage 0+1+2 = PR 1** (Recovery -- abgeschlossen).
|
|
Stage 3 deferred. **Stage 4+5 = PR 2** (Cleanup + Doku -- abgeschlossen).
|
|
|
|
---
|
|
|
|
### Stage 0 -- Schema-Sanity-Check (optional, < 1 h) -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | Composer 2 Fast |
|
|
| **Eingang** | DB-Zugriff dev/int/prod |
|
|
| **Lieferumfang** | Bestaetigte Schema-Praesenz, kein Code-Output |
|
|
| **Abnahme** | Schriftliche Bestaetigung: `FileFolder` + `FileItem.folderId` in allen drei Umgebungen vorhanden; ggf. Zeilenanzahl |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] `information_schema`-Query: `FileFolder`-Tabelle vorhanden in
|
|
**dev** (`poweron_management`; int/prod separat durch Team)
|
|
- [x] `information_schema`-Query: `FileItem.folderId`-Spalte vorhanden
|
|
(**dev**; FK-Verifikation: Spalte + Ziel `FileFolder` lt. Schema)
|
|
- [ ] Optional: `SELECT COUNT(*) FROM "FileFolder"` und Stichprobe pro Mandant
|
|
auf Datenkonsistenz
|
|
|
|
**Hinweis (dev):** `python -m scripts.stage0_filefolder_schema_check` im Ordner `platform-core`.
|
|
|
|
> Falls eine Umgebung abweicht: Plan zurueckziehen, Restore-/Migration-
|
|
> Subtask einplanen, **bevor** Stage 1 startet.
|
|
|
|
---
|
|
|
|
### Stage 1.A -- Backend Boilerplate (Modell A reaktivieren) -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | Composer 2 Fast |
|
|
| **Eingang** | Stage 0 OK; pre-`7c05cb0`-Stand von `datamodelFiles.py` und `routeDataFiles.py` per Git als Referenz |
|
|
| **Lieferumfang** | Pydantic-Modelle, Routen-Skelett, Migrations-Skript archiviert |
|
|
| **Abnahme** | App startet; `GET /folders/tree?owner=me` liefert leere Liste fuer leeren Mandanten ohne Fehler |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] `datamodels/datamodelFiles.py`: `FileFolder` Pydantic-Modell
|
|
(id, name, parentId, mandateId, featureInstanceId, scope, neutralize, sysCreatedAt/By)
|
|
mit `frontend_options` analog `FileItem.scope`; `i18nModel("Ordner")`
|
|
- [x] `datamodels/datamodelFiles.py`: `FileItem.folderId: Optional[str]`
|
|
mit `fk_target` auf `FileFolder.id`
|
|
- [x] `routes/routeDataFiles.py`: Routen-Skelett
|
|
(`POST /folders`, `GET /folders/tree?owner=me|shared`,
|
|
`PATCH /folders/{id}`, `POST /folders/{id}/move`,
|
|
`DELETE /folders/{id}`, `PATCH /folders/{id}/scope`,
|
|
`PATCH /folders/{id}/neutralize`) — GET stub leere Liste; Mutations 501 bis Stage 1.B
|
|
- [x] `migrations/migrate_folders_to_groups.py` ->
|
|
`migrations/_archive/migrate_folders_to_groups.py` + README mit Verweis
|
|
auf diesen Plan
|
|
|
|
---
|
|
|
|
### Stage 1.B -- Backend RBAC-Kern + Audit-Tests -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | **Opus 4.6** |
|
|
| **Eingang** | Stage 1.A OK; `interfaceRbac.buildFilesScopeWhereClause` und `interfaceDbManagement.updateFile` als RBAC-Vorlage |
|
|
| **Lieferumfang** | `interfaceDbManagement`/`interfaceDbApp` Folder-Methoden mit Owner-only-Guards; vollstaendige RBAC-Tests; Verifikation des bestehenden Files-Pfads |
|
|
| **Abnahme** | `test_folderRbac.py` und `test_folder_crud.py` gruen; manuelle Stichprobe Zwei-User: Owner B kann auf Folder von User A keine Mutationsroute aufrufen (alle 403); `contextOrphan`-Render in der Tree-API korrekt |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] `interfaces/interfaceDbApp.py` / `interfaceDbManagement.py`:
|
|
`getOwnFolderTree()`, `getSharedFolderTree()` mit Scope-Where-Klausel
|
|
analog `buildFilesScopeWhereClause`
|
|
- [x] `createFolder` (Default-Scope `personal`)
|
|
- [x] `renameFolder`, `moveFolder`, `deleteFolderCascade`,
|
|
`patchFolderScope`, `patchFolderNeutralize` -- jede Methode mit
|
|
explizitem `sysCreatedBy == currentUser`-Guard (oder `ALL`); sonst
|
|
`PermissionError` -> 403
|
|
- [x] `patchFolderScope`: Cascade-auf-Files als optionaler Parameter
|
|
(D19); ohne expliziten Opt-in keine File-Aenderung
|
|
- [x] **Verifikation bestehender Files-RBAC** (kein Code-Aenderung, nur
|
|
Tests): `updateFile` / `deleteFile` / `deleteFilesBatch` werfen
|
|
fuer Nicht-Owner mit Scope-Sichtbarkeit weiterhin
|
|
`PermissionError`
|
|
- [x] `tests/unit/routes/test_folder_crud.py`: Create / Move /
|
|
Cascade-Delete / Scope-Patch / Neutralize-Patch (Happy Paths +
|
|
Cross-Tenant)
|
|
- [x] `tests/unit/interfaces/test_folderRbac.py`: Zwei-User-Matrix,
|
|
jede Mutationsroute fuer Nicht-Owner = 403; `getSharedFolderTree`
|
|
respektiert Scope; `contextOrphan`-Fall (File geteilt, Folder nicht)
|
|
|
|
---
|
|
|
|
### Stage 1.C -- Frontend `FormGeneratorTree` Greenfield -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | **Opus 4.6** |
|
|
| **Eingang** | Architektur-Abschnitt (Provider-Interface) + RBAC-Modell aus diesem Plan; bestehende `FolderTree.tsx` als UX-Referenz; `FormGeneratorTable` als Bulk-Action-Pattern-Referenz |
|
|
| **Lieferumfang** | Generische `FormGeneratorTree`-Komponente + `FolderFileProvider` + Vitest+RTL-Tests; **kann parallel zu Stage 1.A/1.B laufen**, da Provider gegen Mocks getestet wird |
|
|
| **Abnahme** | Vitest gruen inkl. Edge-Cases (mixed selection, partial-selected, cascade, contextOrphan); Storybook-Story (oder Smoke-Page) zeigt beide Modi `own`/`shared` mit Mock-Provider |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] Ordner `components/FormGenerator/FormGeneratorTree/` mit
|
|
`FormGeneratorTree.tsx`, `FormGeneratorTree.module.css`, `types.ts`,
|
|
`providers/FolderFileProvider.tsx`, `__tests__/`
|
|
- [x] `TreeNodeProvider`-Interface (siehe Architektur-Abschnitt) in
|
|
`types.ts`
|
|
- [x] Built-in Features:
|
|
- Expand/Collapse mit Tastatur-Navigation
|
|
- Multiselect mit Shift/Ctrl/Cmd; getrennt zwischen
|
|
`ownership='own'` und `'shared'`; gemischte Selektion blockiert
|
|
Bulk-Mutationen
|
|
- Cascading-Selection (Folder selektieren -> alle eigenen Children),
|
|
Partial-Selected-Indikator
|
|
- DnD `application/x-poweron-tree-items`; aus `shared` nur lesende
|
|
Drops, kein Move
|
|
- Inline-Rename (Doppelklick / F2) -- nur fuer `ownership='own'`
|
|
- Scope/Neutralize interaktiv nur fuer Eigene; im geteilten Tree
|
|
Indikator-Icons
|
|
- `contextOrphan`-Render-Regel (Knoten am Tree-Root mit Hint-Icon)
|
|
- Bulk-Action-Toolbar analog `FormGeneratorTable.batchActions`; im
|
|
geteilten Tree maximal Lesen/Download
|
|
- [x] `FolderFileProvider.tsx`: Referenzimplementierung gegen die in
|
|
Stage 1.B definierten Folder-API-Routen (kann initial gegen
|
|
Mock-Server laufen)
|
|
- [x] Vitest+RTL-Tests: Lazy-Load, Multiselect-Cascade, Mixed-Selection-
|
|
Block, DnD-Payload, Inline-Rename, Bulk-Delete, `contextOrphan`-
|
|
Render -- alle gegen Provider-Mock
|
|
|
|
---
|
|
|
|
### Stage 2.A -- FE Recovery-Boilerplate -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | Composer 2 Fast |
|
|
| **Eingang** | Stage 1.B + 1.C OK; pre-`7c05cb0`-Stand von `FileContext.tsx`, `useFiles.ts`, `fileApi.ts` per Git |
|
|
| **Lieferumfang** | Folder-Operationen reaktiviert in Context/Hook/API-Wrapper |
|
|
| **Abnahme** | TypeScript clean; bestehende Files-Tests gruen; FilesPage rendert weiterhin (alter Code-Pfad noch aktiv) |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] `contexts/FileContext.tsx`: `FolderInfo`-Typ + `handleCreateFolder`,
|
|
`handleRenameFolder`, `handleDeleteFolderCascade`, `handleMoveFolder`,
|
|
`handleMoveFiles`, `handleDownloadFolder`, `refreshFolders`,
|
|
`treeFileNodes`, `expandedFolderIds` -- gegen die neuen Routen
|
|
- [x] `hooks/useFiles.ts`: Folder-Operationen wieder einbauen
|
|
- [x] `api/fileApi.ts`: `FileInfo.folderId`, `getFolderTree`, `createFolder`,
|
|
`renameFolder`, `moveFolder`, `deleteFolderCascade`, `moveFiles` als
|
|
API-Wrapper
|
|
- [x] `pages/views/workspace/WorkspaceInput.tsx`: `TreeItemDrop.type` auf
|
|
`'file' | 'folder'` zuruecksetzen
|
|
|
|
---
|
|
|
|
### Stage 2.B -- FE UI-Komposition (FilesTab + FilesPage) -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | **Opus 4.6** |
|
|
| **Eingang** | Stage 2.A OK |
|
|
| **Lieferumfang** | `FilesTab` mit zwei Tree-Sektionen; `FilesPage` Split-View mit Toggle Tree/Liste-mit-Gruppen-Sicht |
|
|
| **Abnahme** | Storybook/Smoke der UDB zeigt beide Sektionen, leerer Geteilt-Tree kollabiert; FilesPage-Toggle wechselt korrekt |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] `components/UnifiedDataBar/FilesTab.tsx`: zwei `FormGeneratorTree`-
|
|
Sektionen via `FolderFileProvider`
|
|
- **Eigene** mit Toolbar („Neuer Ordner“, „Multidelete“,
|
|
„Multimove“, „Download als ZIP“)
|
|
- **Geteilt mit mir** read-only, kollabiert wenn leer, Owner-Name
|
|
als oberste Sortier-Achse (D16/D17)
|
|
- `compact={true}`; `onSendToChat` auf `'file' | 'folder'`
|
|
- [x] `pages/basedata/FilesPage.tsx`: Split-View
|
|
- links zwei `FormGeneratorTree`-Sektionen (Eigene / Geteilt) mit
|
|
klar getrennten Headern
|
|
- rechts `FormGeneratorTable` mit Toggle „Tree-Sicht |
|
|
Liste-mit-Gruppen-Sicht“; `groupingConfig` bleibt als alternative
|
|
Sicht
|
|
- Selektion im geteilten Tree -> Tabellenzeilen read-only
|
|
|
|
---
|
|
|
|
### Stage 2.C -- Manuelle Verifikation (User) -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | -- (User) |
|
|
| **Eingang** | Stage 2.B deployed in dev; Test-Mandant mit zwei Usern verfuegbar |
|
|
| **Lieferumfang** | Bestaetigung der Akzeptanzkriterien 1-8b + 10 |
|
|
| **Abnahme** | Alle Punkte unten haken; sonst Defekt-Issue oeffnen, zustaendige Stage erneut |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] Neuer Folder anlegen -> Default `personal`, nur eigener Tree zeigt ihn
|
|
- [x] Scope/Neutralize: Eigene interaktiv, Geteilt nur Indikator
|
|
*(Fix 2026-05-02: FolderFileProvider typeMap fuer Folder- vs File-Endpoints)*
|
|
- [x] Multiselect Folder + Files (eigen) cascadiert; gemischt Eigene/Geteilt
|
|
blockiert Bulk-Mutationen mit Hinweis
|
|
- [x] Multidelete cascadiert nur bei reinem Owner-Set; Confirmation
|
|
*(Fix 2026-05-02: TreeBatchAction.typeFilter, separate Ordner/Dateien-Buttons, window.confirm)*
|
|
- [x] DnD: File von Folder A nach Folder B (eigen) funktioniert; Drag aus
|
|
„Geteilt mit mir“ in eigenen Folder = kein Move
|
|
- [x] DnD: File aus FilesTab in Workspace-Chat-Input dropped korrekt
|
|
(Standard-MIME erkannt) -- aus beiden Trees lesend zulaessig
|
|
- [ ] Cross-User-Sharing: User A setzt Folder-Scope auf `mandate` ->
|
|
User B sieht den Folder im „Geteilt mit mir“ (read-only, 403 auf
|
|
Mutationen via DevTools-Probe)
|
|
*(nicht getestet -- erfordert zwei User im selben Mandant)*
|
|
- [x] FilesPage-Toggle: umgebaut zu „Ordner-Sicht“ (Tabelle gefiltert nach
|
|
selektiertem Ordner) und „Alle Dateien“ (ohne Folder-Filterung).
|
|
Gruppierung entfernt.
|
|
|
|
**Zusaetzliche Fixes aus Stage 2.C Verifikation (2026-05-02/03):**
|
|
|
|
- FolderFileProvider: 405-Fix (falscher API-Endpoint `/api/files` -> `/api/files/list`)
|
|
- FolderFileProvider: typeMap eingefuehrt -- alle Operationen (rename, delete,
|
|
move, patchScope, patchNeutralize) verwenden korrekte Endpoints fuer Folder vs File
|
|
- FormGeneratorTree: Refresh-Icon im Section-Header (`FaSyncAlt`)
|
|
- FormGeneratorTree: Tree-Reload nach Batch-Actions und inline Delete
|
|
- FormGeneratorTree: `window.confirm()` vor Delete (inline + batch)
|
|
- FilesPage: Tree-Table-Sync (selectedFolderId filtert Tabelle, File-Klick
|
|
highlighted Tabellenzeile)
|
|
|
|
---
|
|
|
|
### Stage 3.A -- Provider-Refactors (Sources + Feature-Daten) -- DEFERRED
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Status** | **DEFERRED (2026-05-03)** |
|
|
| **Modell** | **Opus 4.6** |
|
|
| **Eingang** | Stage 1.C OK (FormGeneratorTree stabil) |
|
|
| **Lieferumfang** | `ConnectorBrowseProvider` und `FeatureDataProvider` mit Aequivalenz-Garantie zur bisherigen Logik |
|
|
| **Abnahme** | Vitest+RTL-Tests pro Provider gruen; Smoke-Test: alle bisherigen Knoten-Ebenen sind reproduzierbar |
|
|
|
|
**Grund fuer Deferral:** `SourcesTab` und `ChatsTab` enthalten hochgradig
|
|
domaen-spezifische Tree-Logik (Multi-Level lazy-load ueber Connections,
|
|
Services, Feature-Daten, Mandate-Gruppierungen, Chat-Filterung), die sich
|
|
nicht sinnvoll auf die generische `TreeNodeProvider`-Abstraktion abbilden
|
|
laesst, ohne die Provider-Interfaces erheblich zu erweitern. Der Aufwand
|
|
uebersteigt den Nutzen gegenueber dem bestehenden, funktionierenden Code.
|
|
Kann bei Bedarf spaeter als eigenes Projekt aufgegriffen werden.
|
|
|
|
~~**Checkliste**~~
|
|
|
|
- ~~`providers/ConnectorBrowseProvider.tsx`~~
|
|
- ~~`providers/FeatureDataProvider.tsx`~~
|
|
- ~~Pro Provider Vitest+RTL-Tests~~
|
|
|
|
---
|
|
|
|
### Stage 3.B -- Tab-Umbau + Cleanup (Feature-Flag) -- DEFERRED
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Status** | **DEFERRED (2026-05-03)** |
|
|
| **Modell** | Composer 2 Fast |
|
|
| **Eingang** | Stage 3.A OK |
|
|
| **Lieferumfang** | `SourcesTab.tsx` und `ChatsTab.tsx` auf `FormGeneratorTree`; alter Custom-Tree-Code entfernt; Feature-Flag fuer Rollback |
|
|
| **Abnahme** | Mit Flag aus = Status quo; Flag ein = neue Tree-UI; manuelle Verifikation der UDB-Tabs OK |
|
|
|
|
**Grund fuer Deferral:** Abhaengig von Stage 3.A (s.o.).
|
|
|
|
~~**Checkliste**~~
|
|
|
|
- ~~`providers/ChatProvider.tsx`~~
|
|
- ~~`SourcesTab.tsx` Umbau~~
|
|
- ~~`ChatsTab.tsx` Umbau~~
|
|
- ~~Feature-Flag~~
|
|
- ~~Manuelle Verifikation~~
|
|
|
|
---
|
|
|
|
### Stage 4 -- Restliche Tree-Migrationen (Assessment + Cleanup) -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Status** | **DONE (2026-05-03)** |
|
|
| **Modell** | Composer 2 Fast |
|
|
| **Ergebnis** | Assessment aller Kandidaten; Dead-Code geloescht; keine weiteren Migrationen sinnvoll |
|
|
|
|
**Assessment-Ergebnis**
|
|
|
|
- [x] `FolderTree.tsx` + `SharepointBrowseTree.tsx` + gesamter `components/FolderTree/`-Ordner:
|
|
**GELOESCHT** (Dead Code, keine externen Imports). ESLint-Deprecation-Regel entfernt.
|
|
- [x] `DataPicker.tsx`: **SKIP** -- Schema-basierter Automation2-Picker (read-only,
|
|
in-memory, kein Entity-Tree; TreeNodeProvider-Abstraktion passt nicht)
|
|
- [x] `InstanceHierarchyView.tsx`: **SKIP** -- Read-only Admin-Visualisierung
|
|
(synchrone Props, kein CRUD/DnD/Multiselect; 300 Zeilen, stabil)
|
|
- [x] `AccessRulesEditor.tsx`: **SKIP** -- Kein Tree, sondern tabellarischer
|
|
RBAC-Rule-Editor mit Checkbox-Matrix (774 Zeilen; komplett anderes Paradigma)
|
|
- [x] `TreeNavigation.tsx`: **SKIP** -- Sidebar-Navigation mit React Router
|
|
(NavLink, aktiver Pfad); UI-Navigation, nicht Daten-Tree
|
|
- [x] `redmineTreeLogic.ts`: **SKIP** -- Reiner BFS-Algorithmus fuer
|
|
Redmine-Tickets; kein UI-Komponente
|
|
|
|
---
|
|
|
|
### Stage 5 -- Doku & Cleanup -- DONE
|
|
|
|
| | |
|
|
|---|---|
|
|
| **Modell** | Composer 2 Fast |
|
|
| **Eingang** | Stage 2 mindestens gemerged; spaetestens nach Stage 4 |
|
|
| **Lieferumfang** | Wiki-Update der kanonischen Stellen + neuer Tree-Topic |
|
|
| **Abnahme** | `lastReviewed` aktualisiert; `wiki/c-work/_CHANGELOG.md` pro Stage eine Zeile |
|
|
|
|
**Checkliste**
|
|
|
|
- [x] `wiki/b-reference/ui-nyla/architecture.md`: Komponenten-Tabelle
|
|
um `FormGeneratorTree` ergaenzt, `FolderTree`-Eintrag ersetzt,
|
|
`components/`-Ordner-Beschreibung aktualisiert
|
|
- [x] `wiki/b-reference/ui-nyla/formgenerator.md`: Abschnitt
|
|
`FormGeneratorTree` (Provider-Interface, Built-in Features,
|
|
Vergleichstabelle Tree vs. Table-with-grouping, Props, Verwendung)
|
|
- [x] `wiki/TOPICS.md`: Neuer Eintrag FormGenerator (Table, Form, Tree, Report)
|
|
- [x] `wiki/c-work/_CHANGELOG.md`: Stage 4+5 Eintrag
|
|
- [x] Plan-Dokument verschoben nach `4-done/`
|
|
|
|
---
|
|
|
|
### Eskalations-Regel zwischen Modellen
|
|
|
|
- Composer-Packet stoesst auf Entscheidung, die nicht in **D1-D22** steht
|
|
-> stoppen, Plan ergaenzen (Opus), dann zurueck.
|
|
- Composer-Test schlaegt fehl und Fix ist nicht mechanisch
|
|
-> Diagnose-Loop in Opus, Fix-Patch zurueck zu Composer.
|
|
- Pre-Commit-Hook-Modifikationen (lint/format) bleiben in Composer.
|
|
|
|
---
|
|
|
|
## Akzeptanzkriterien
|
|
|
|
| # | Kriterium (Given-When-Then) | Prio |
|
|
|---|---------------------------|------|
|
|
| 1 | **Given** ein Mandant mit eigenen Folders + Files, **When** der User die Files-Page oeffnet, **Then** die linke Spalte zeigt zwei Sektionen („Eigene“, „Geteilt mit mir“) mit rekursiven Folder-Trees | must |
|
|
| 2 | **Given** der User klickt im Eigenen-Tree auf „Neuer Ordner“, **When** er einen Namen bestaetigt, **Then** der Folder erscheint sofort, ist persistiert mit Default-Scope `personal` und nur fuer den Ersteller sichtbar | must |
|
|
| 3 | **Given** ein eigener Folder mit 5 Files, **When** der User per Multiselect den Folder + 2 weitere Files anwaehlt und „Loeschen“ klickt, **Then** Confirmation `Wirklich 1 Folder (mit 5 Files) und 2 weitere Files loeschen?`; nach OK sind alle 8 Items weg | must |
|
|
| 4 | **Given** ein eigenes File mit `scope=personal`, **When** der User auf das Scope-Icon klickt, **Then** das Icon cyclet `personal -> featureInstance -> mandate -> global -> personal`; jeder Click persistiert via PATCH | must |
|
|
| 5 | **Given** ein eigener Folder, **When** der Owner den Scope auf `mandate` patcht, **Then** Dialog fragt „Files mit teilen?“ (Default: nein); bei Ja erben enthaltene Files den Scope, sonst bleibt deren Scope unveraendert | must |
|
|
| 6 | **Given** der User draggt ein File aus dem FilesTab, **When** im Workspace-Chat-Input gedropped, **Then** Standard-MIME `application/x-poweron-tree-items` wird empfangen; aus beiden Trees lesend zulaessig | must |
|
|
| 7 | **Given** UDB ist offen, **When** der User durch Files / Sources / Chats blaettert, **Then** alle drei Tabs zeigen `FormGeneratorTree` mit konsistentem Look-and-Feel | should |
|
|
| 8 | **Given** zwei Mandanten-Mitglieder (User A, User B), **When** User A einen Folder anlegt (Default `personal`), **Then** User B sieht den Folder **nicht**. Erst nach `mandate`-Scope-Patch erscheint er bei User B im „Geteilt mit mir“ (read-only, Indikator-Icons, keine Mutations-Affordance) | must |
|
|
| 8a | **Given** User A teilt eine Datei (`scope=mandate`), aber den enthaltenden Folder nicht, **When** User B die Files-Page oeffnet, **Then** die Datei erscheint im Root des „Geteilt mit mir“-Trees mit `contextOrphan`-Hint; aendert User A den Folder-Scope, wandert die Datei automatisch unter den Folder | should |
|
|
| 8b | **Given** User B steht im „Geteilt mit mir“ auf einem Folder von User A, **When** er Mutationsroute (rename / move / delete / scope-cycle / neutralize-toggle) aufruft, **Then** Backend antwortet 403 und UI hat keine Affordance | must |
|
|
| 9 | **Given** `FormGeneratorTable.groupingConfig` aktiv auf `AutomationsDashboardPage`, **When** der User die Page laedt, **Then** Workflow-Runs sind weiterhin nach Mandant + Status gruppiert | must |
|
|
| 10 | **Given** `FilesPage` View-Toggle steht auf „Liste-mit-Gruppen-Sicht“, **When** der User auf „Tree-Sicht“ und zurueck wechselt, **Then** beide Sichten zeigen dieselben Files; `TableGrouping` und `FileFolder` sind orthogonal sichtbar | should |
|
|
| 11 | **Given** Drag-Source aus `SourcesTab`, **When** auf eine Workflow-Node gedropped, **Then** Empfaenger sieht denselben `application/x-poweron-tree-items`-MIME wie aus FilesTab | should |
|
|
|
|
---
|
|
|
|
## Testplan
|
|
|
|
| ID | AC | Art | Automatisiert | Repo-Pfad | Status |
|
|
|----|----|-----|--------------|-----------|--------|
|
|
| T1 | 1, 2 | api | ja | `platform-core/tests/unit/routes/test_folder_crud.py` | pending |
|
|
| T2 | 3 | api | ja | `platform-core/tests/unit/routes/test_folder_cascade_delete.py` | pending |
|
|
| T3 | 4, 5 | api | ja | `platform-core/tests/unit/routes/test_folder_scope_neutralize.py` (inkl. Cascade-Opt-in) | pending |
|
|
| T4 | 8, 8a, 8b | api | ja | `platform-core/tests/unit/interfaces/test_folderRbac.py` (zwei User; alle Mutationsrouten 403; Render-Regel inkl. `contextOrphan`) | pending |
|
|
| T5 | 1-6 | ui | ja | `ui-nyla/src/components/FormGenerator/FormGeneratorTree/__tests__/FormGeneratorTree.test.tsx` | pending |
|
|
| T6 | 6, 11 | ui | ja | `ui-nyla/src/components/FormGenerator/FormGeneratorTree/__tests__/dnd.test.tsx` | pending |
|
|
| T7 | 1-7, 10 | manuell | nein | -- | pending |
|
|
| T8 | 9 | manuell | nein | -- | pending |
|
|
| T9 | 7 | manuell | nein | -- | pending |
|
|
|
|
---
|
|
|
|
## Risiken
|
|
|
|
| Risiko | Wahrscheinlichkeit | Impact | Mitigation |
|
|
|--------|-------------------|--------|------------|
|
|
| `FileFolder` / `folderId` in einer Umgebung doch entfernt (Abweichung vom Repo-Stand) | sehr niedrig | hoch | Stage 0 Spot-Check; ggf. Restore aus Backup oder Ableitung aus `TableGrouping.meta.migratedFromFolderId` (One-Shot) |
|
|
| Read-only-Kontrakt fuer Folders nicht durchgaengig (UI versteckt, Backend offen) | mittel | hoch | Pro Mutationsroute expliziter `sysCreatedBy == currentUser`-Guard; Zwei-User-Tests pro Route in Stage 1 |
|
|
| `contextOrphan`-Render leakt Pfad-/Owner-Information mehr als beabsichtigt | niedrig | mittel | Im geteilten Tree nur Owner-Name + File-Name; keine Folder-Pfade aus dem fremden Tree |
|
|
| `_workspaceTools.py` (writeFile -> Group-Auto-Add) bricht nach Recovery | mittel | mittel | Code unangetastet; TableGrouping-Pfad bleibt; User kann Files spaeter manuell in Folder verschieben |
|
|
| TableGrouping-Eintrag und FileFolder-Eintrag widersprechen sich (selber File in Group X UND Folder Y) | hoch | niedrig | By design orthogonal; UI zeigt beide Sichten ueber Toggle; keine Konsistenz-Erzwingung |
|
|
| Stage 3 enthuellt subtile Abhaengigkeiten in SourcesTab/ChatsTab | hoch | mittel | **Eingetreten:** Stage 3 deferred -- domaen-spezifische Logik passt nicht auf generische TreeNodeProvider-Abstraktion |
|
|
| Cascade-Selection-Logik im FormGeneratorTree subtil falsch (z.B. partial-selected) | mittel | niedrig | Umfangreiche Vitest+RTL-Tests in Stage 1 mit Provider-Mock |
|
|
|
|
---
|
|
|
|
## Links
|
|
|
|
- PR: tba (Stage 0+1+2 -- bereit), Stage 3 deferred, Stage 4+5 abgeschlossen
|
|
- Issue: --
|
|
- Vorgaenger-Commits: `c8e9304`, `e7a79a3`, `7c05cb0`
|
|
- Migrations-Skript (archiviert): `platform-core/modules/migrations/_archive/migrate_folders_to_groups.py`
|
|
- Heutige `FolderTree`-Komponente (vollstaendig, nicht mehr eingebunden):
|
|
`ui-nyla/src/components/FolderTree/FolderTree.tsx`
|
|
|
|
---
|
|
|
|
## Abschluss
|
|
|
|
- [x] `b-reference/ui-nyla/architecture.md` aktualisiert
|
|
(Komponenten-Tabelle, UDB-Beschreibung)
|
|
- [x] `b-reference/ui-nyla/formgenerator.md` aktualisiert
|
|
(Abschnitt FormGeneratorTree)
|
|
- [x] `TOPICS.md` aktualisiert
|
|
- [x] Dokument verschoben nach `4-done/`
|