From 0e56c85349dc4cffa1a6c8ae88c1d0a0f030e5a0 Mon Sep 17 00:00:00 2001 From: curo1305 Date: Wed, 17 Jun 2026 23:16:21 +0200 Subject: [PATCH] docs: start milestone v0.3 Reimagining Cloud Storage integration --- .planning/PROJECT.md | 26 +++++++++++++++++++++++--- .planning/STATE.md | 33 +++++++++++++++++---------------- 2 files changed, 40 insertions(+), 19 deletions(-) diff --git a/.planning/PROJECT.md b/.planning/PROJECT.md index 68bda0a..db32e77 100644 --- a/.planning/PROJECT.md +++ b/.planning/PROJECT.md @@ -14,6 +14,18 @@ Every user's documents — and the credentials they use to store them — are in See `.planning/MILESTONES.md` and `.planning/milestones/v0.2-ROADMAP.md` for full archive. +## Current Milestone: v0.3 Reimagining Cloud Storage integration + +**Goal:** Make connected cloud storage behave like first-class DocuVault storage: users can browse and manage cloud files as if they were local, analyze all or selected cloud documents, and search them by keywords, sentences, or ideas while minimizing DocuVault-owned local storage. + +**Target features:** +- Native-feeling cloud file navigation and actions: open, preview, upload, move, delete, rename, and organize files from connected providers. +- Provider setup, health, reconnect, credential lifecycle, and error handling that make cloud connections feel reliable and understandable. +- Analyze all cloud documents or a selected subset without requiring manual local upload. +- Classify and index cloud documents so they become smart-searchable like locally uploaded documents. +- Cache and offload cloud file bytes on demand, similar to a desktop sync client, preserving local-like navigation while minimizing local storage use. +- Rework storage architecture where needed: provider capabilities, background jobs, sync/import/index state, conflict handling, and test coverage. + ## Requirements ### Validated (v0.1 — shipped 2026-06-06) @@ -65,7 +77,14 @@ See `.planning/MILESTONES.md` and `.planning/milestones/v0.2-ROADMAP.md` for ful - ✓ Dead code deleted (FolderRow.vue, AccountView.vue, stale test files) — v0.2 - ✓ WHY-only comment policy enforced (CODE-09) — v0.2 -### Active (next milestone — not yet defined) +### Active (v0.3 — Reimagining Cloud Storage integration) + +- [ ] Cloud files can be browsed and managed with the same core actions as local files: open, preview, upload, move, delete, and rename. +- [ ] Cloud provider setup and maintenance includes health status, reconnect flows, credential lifecycle handling, and useful error states. +- [ ] Users can analyze all cloud documents or a selected subset from connected storage. +- [ ] Analyzed cloud documents are classified and indexed for smart search by keywords, sentences, and semantic ideas. +- [ ] DocuVault minimizes local storage by caching cloud file bytes only when needed and offloading them when safe. +- [ ] Storage architecture models provider capabilities, sync/index state, background jobs, and conflict/error handling explicitly. ### Out of Scope @@ -79,7 +98,7 @@ See `.planning/MILESTONES.md` and `.planning/milestones/v0.2-ROADMAP.md` for ful ## Context -- **Current state**: v0.2 shipped 2026-06-17. All 4 v0.2 phases complete: stack upgrade + decomposition (Phase 8), admin panel rearchitecture (Phase 9), UX interaction layer (Phase 10), visual design + responsive layout (Phase 11). 277 tests pass. Bundle −81 kB from baseline. App is mobile-responsive, keyboard-navigable, and fully polished. Ready for next milestone definition. +- **Current state**: v0.3 started 2026-06-17 after v0.2 shipped. The next focus is reimagining cloud storage as virtual-local document storage: connected cloud files should feel local to navigate and manage, while DocuVault adds classification and smart search without unnecessarily storing full cloud file contents. - **Tech stack**: FastAPI 0.136+ (Python 3.12), SQLAlchemy 2.0 async, Alembic, MinIO SDK; Vue 3 (Options API), Pinia, Vue Router 4, Vite, Tailwind CSS. - **Code quality**: v0.1 was built feature-first under time pressure. Both backend and frontend contain duplication, inconsistent patterns, and components that grew beyond their original scope. v0.2 addresses this systematically. - **Admin panel**: Standalone /admin/* route subtree with AdminLayout as the route component, AdminSidebar with 5 nav links, and 5 dedicated view components. AdminView.vue and legacy tab components deleted. Admin users redirect to /admin on login; non-admin blocked by to.matched.some() guard. @@ -120,6 +139,7 @@ See `.planning/MILESTONES.md` and `.planning/milestones/v0.2-ROADMAP.md` for ful | Teleport + getBoundingClientRect for dropdowns | Viewport-edge clipping eliminated without complex position logic; prerequisite for virtual scrolling | ✓ Shipped Phase 10 (UX-13) | | Admin routes lazy-loaded | All 5 admin views excluded from initial bundle; −81 kB (−30.6%) improvement | ✓ Shipped Phase 11 (PERF-03) | | Vite 8 upgrade for npm audit | Closed high-severity esbuild CVE present in Vite 5/6; npm audit now clean | ✓ Shipped Phase 11 (11-07) | +| Virtual-local cloud storage model | Users already organize documents in their cloud provider; DocuVault should add local-like actions, analysis, and smart search without forcing full import | — Pending v0.3 | ## Evolution @@ -141,4 +161,4 @@ Last updated: 2026-06-16 4. Update Context with current state --- -*Last updated: 2026-06-17 — after v0.2 milestone* +*Last updated: 2026-06-17 — after starting v0.3 milestone* diff --git a/.planning/STATE.md b/.planning/STATE.md index b54e14c..371356a 100644 --- a/.planning/STATE.md +++ b/.planning/STATE.md @@ -1,29 +1,30 @@ --- gsd_state_version: 1.0 -milestone: v0.2 -milestone_name: UI Overhaul and Optimization -current_phase: 11 -status: complete -last_updated: "2026-06-17" -last_activity: 2026-06-17 -- v0.2 milestone archived +milestone: v0.3 +milestone_name: Reimagining Cloud Storage integration +status: planning +last_updated: "2026-06-17T21:15:24.719Z" +last_activity: 2026-06-17 progress: - total_phases: 4 - completed_phases: 4 - total_plans: 33 - completed_plans: 33 - percent: 100 + total_phases: 0 + completed_phases: 0 + total_plans: 0 + completed_plans: 0 + percent: 0 --- # Project State **Project:** DocuVault -**Status:** v0.2 milestone complete — ready for next milestone +**Status:** v0.3 milestone planning — defining requirements **Last Updated:** 2026-06-17 ## Current Position -Milestone v0.2 shipped 2026-06-17. All 4 phases complete, 40/40 requirements satisfied. -Next action: `/gsd:new-milestone` to define v0.3 +Phase: Not started (defining requirements) +Plan: — +Status: Defining requirements +Last activity: 2026-06-17 — Milestone v0.3 started ## Phase Status @@ -81,7 +82,7 @@ _Updated at each phase transition._ | Field | Value | |---|---| -| Last session | 2026-06-17 — v0.2 milestone archived | -| Next action | /gsd:new-milestone to define v0.3 | +| Last session | 2026-06-17 — v0.3 milestone started | +| Next action | Define v0.3 requirements and roadmap | | Pending decisions | None | | Resume file | None |