docs: start milestone v0.3 Reimagining Cloud Storage integration
This commit is contained in:
+23
-3
@@ -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*
|
||||
|
||||
+17
-16
@@ -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 |
|
||||
|
||||
Reference in New Issue
Block a user