diff --git a/.planning/phases/10-ux-interaction/10-UAT.md b/.planning/phases/10-ux-interaction/10-UAT.md new file mode 100644 index 0000000..510db1c --- /dev/null +++ b/.planning/phases/10-ux-interaction/10-UAT.md @@ -0,0 +1,203 @@ +--- +status: complete +phase: 10-ux-interaction +source: 10-01-SUMMARY.md, 10-02-SUMMARY.md, 10-03-SUMMARY.md, 10-04-SUMMARY.md, 10-06-SUMMARY.md, 10-07-SUMMARY.md, 10-08-SUMMARY.md, 10-09-SUMMARY.md, 10-10-SUMMARY.md, 10-11-SUMMARY.md, 10-12-SUMMARY.md +started: 2026-06-16T00:00:00Z +updated: 2026-06-16T15:30:00Z +--- + +## Current Test + +[testing complete] + +## Tests + +### 1. File Manager Loading Skeleton +expected: Open the file manager. While documents are loading, the content area shows 5 animated shimmer/pulse rows instead of any "Loading…" text. Once loaded, the shimmer rows disappear and real content (or an empty state) renders. +result: issue +reported: "Cloud folder view: no skeleton visible on load (loading=false on first render). Cloud files unclickable with no feedback." +severity: major +fix_applied: "loading=ref(true) in CloudFolderView; onFileOpen shows info toast. Commit ce67b9f. Local storage loads too fast to verify manually — skeleton confirmed present in template." + +### 2. Empty State — No Documents +expected: In a folder with no documents, the content area shows a styled empty state with an icon (folder or document), a headline like "No documents yet" or similar, and descriptive subtext. Not just a blank white area. +result: pass + +### 3. Empty State — No Search Results +expected: Type a search query that returns no matches. The content area shows an empty state with a search icon, a "No results" headline, and a "Clear search" link/button that resets the query. +result: pass +note: Search bar only visible inside a folder (breadcrumb.length > 0) — by design, root shows folders only. Empty state confirmed working inside folder. + +### 4. Sidebar Loading Skeletons +expected: On first load, the sidebar's Folders, Cloud, and Topics sections show animated shimmer placeholder rows while their data loads. No plain spinner or "Loading" text. +result: issue +reported: "Local storage too fast to see any loading. Nextcloud sidebar section does nothing until folder loads — no skeleton or feedback visible during load." +severity: major + +### 5. Sidebar Empty States +expected: With no folders created, no cloud connections, and no topics, each sidebar section shows a small (compact) empty state: a tiny icon with a brief message like "Create a folder in the file manager", "Connect in Settings", or "No topics yet". +result: issue +reported: "Empty states confirmed. But search bar and sorting controls are not visible at the root of the cloud and local file browser." +severity: major +note: Search-at-root absence was previously noted in test 3 as \"by design\", but user is explicitly flagging it as missing expected functionality. + +### 6. Sidebar — No Inline "New Folder" Button +expected: The sidebar's Folders section header does NOT have a "New" or "New folder" button next to it. Folder creation happens only via the file manager toolbar. +result: pass + +### 7. Breadcrumb Bar in File Manager +expected: The file manager shows a breadcrumb bar above the content. At the root it shows "Home". After navigating into a folder it shows "Home > FolderName". Clicking "Home" navigates back to root. +result: pass + +### 8. Breadcrumb Bar in Admin Views +expected: Admin views (Users, Quotas, AI Config, Audit Log) and Settings show a breadcrumb bar with static segments like "Users", "Settings > Account", etc. No "Home" root button in these views. +result: issue +reported: "Admin views still show the normal user sidebar." +severity: major + +### 9. Toast on Document Delete +expected: Delete a document. A toast notification appears in the bottom-right corner with a success message (e.g., "Document deleted"). It auto-dismisses after a few seconds. +result: pass + +### 10. Toast on File Upload +expected: Upload one or more files. After upload completes, a toast appears summarising the result (e.g., "2 files uploaded" or a per-file message). It appears without a page refresh. +result: pass +note: User also reported drag-and-drop didn't work — covered in tests 15–17. + +### 11. Keyboard Shortcut — / Focuses Search +expected: While viewing the file manager with focus NOT in a text field, press "/". The search bar receives focus (cursor appears inside it). Pressing "/" while already in a text input does NOT trigger this. +result: issue +reported: "Search bar not visible at directory root (see gap #2). When inside a folder where search IS visible, pressing '/' does nothing." +severity: major + +### 12. Keyboard Shortcut — U Opens Upload +expected: While viewing the file manager with focus not in a text field, press "U". The file-picker dialog opens (browser native file chooser), same as clicking the upload button. +result: issue +reported: "Pressing U does not open the file picker." +severity: major + +### 13. Keyboard Shortcut — N Starts New Folder +expected: While viewing the file manager with focus not in a text field, press "N". The new-folder inline input appears in the content area, same as clicking the "New folder" toolbar button. +result: issue +reported: "Pressing N does not trigger new folder input." +severity: major + +### 14. Keyboard Shortcut — Escape Clears Search +expected: With a search query active in the file manager, press "Escape". The search field clears and the full document list returns. +result: issue +reported: "Field clears on Escape, but search no longer works afterwards — cannot type a new query." +severity: major + +### 15. OS Drag Overlay +expected: From the OS (Finder/Explorer), drag a file and hover it over the browser window. A full-screen semi-transparent overlay appears saying something like "Drop files to upload". Releasing the file starts the upload. +result: issue +reported: "Overlay appears correctly, but dropping the file does not start the upload." +severity: major + +### 16. Drag Document to Folder +expected: In the file manager, drag a document row onto a folder row. The folder row highlights while the document hovers over it. Releasing drops the document into the folder (it moves; the folder item count updates). +result: pass + +### 17. Click-After-Drag Guard +expected: After dragging a document (without dropping it onto a folder — just drag and release), the document does NOT open or navigate. The drag gesture does not accidentally trigger a "file open" action. +result: pass + +### 18. Admin View Skeletons +expected: Open the Admin > Audit Log or Admin > Users page while data loads. The table body shows skeleton rows (animated shimmer cells) instead of a spinner or "Loading…" text. +result: pass +note: Skeleton visible but very briefly — data loads fast locally. Skeleton confirmed present. + +### 19. Admin Audit Log Empty State +expected: With no audit log entries (or with filters that match nothing), the audit log table shows an empty state with a "Clear filters" button. Not just an empty table with no rows. +result: pass + +## Summary + +total: 19 +passed: 10 +issues: 9 +pending: 0 +skipped: 0 +blocked: 0 + +## Gaps + +- truth: "Sidebar Cloud section shows animated shimmer rows while Nextcloud data loads" + status: failed + reason: "User reported: Local storage too fast to see any loading. Nextcloud sidebar section does nothing until folder loads — no skeleton or feedback visible during load." + severity: major + test: 4 + root_cause: "" + artifacts: [] + missing: [] + debug_session: "" + +- truth: "Admin views show admin-specific layout (no user sidebar) with breadcrumb bar" + status: failed + reason: "User reported: Admin views still show the normal user sidebar." + severity: major + test: 8 + root_cause: "" + artifacts: [] + missing: [] + debug_session: "" + +- truth: "Pressing '/' while in the file manager (with search bar visible) focuses the search input" + status: failed + reason: "User reported: pressing '/' does nothing when search bar is visible inside a folder." + severity: major + test: 11 + root_cause: "" + artifacts: [] + missing: [] + debug_session: "" + +- truth: "Pressing 'U' while in the file manager opens the file-picker dialog" + status: failed + reason: "User reported: pressing U does not open the file picker." + severity: major + test: 12 + root_cause: "" + artifacts: [] + missing: [] + debug_session: "" + +- truth: "Pressing 'N' while in the file manager triggers the new-folder inline input" + status: failed + reason: "User reported: pressing N does not trigger new folder input." + severity: major + test: 13 + root_cause: "" + artifacts: [] + missing: [] + debug_session: "" + +- truth: "After pressing Escape to clear search, the search field remains functional for new queries" + status: failed + reason: "User reported: field clears on Escape but search no longer works afterwards — cannot type a new query." + severity: major + test: 14 + root_cause: "" + artifacts: [] + missing: [] + debug_session: "" + +- truth: "Dropping a file from OS onto the drag overlay starts the upload" + status: failed + reason: "User reported: overlay appears but dropping the file does not start the upload." + severity: major + test: 15 + root_cause: "" + artifacts: [] + missing: [] + debug_session: "" + +- truth: "Search bar and sorting controls are visible at the root level of the file manager and cloud file browser (currently hidden behind breadcrumb.length > 0 guard)" + status: failed + reason: "User reported: search bar and sorting controls not visible at the root of the cloud and local file browser." + severity: major + test: 5 + root_cause: "" + artifacts: [] + missing: [] + debug_session: ""