curo/kite
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: start milestone v0.3 Reimagining Cloud Storage integration

Browse Source
This commit is contained in:
curo1305
2026-06-17 23:16:21 +02:00
parent 123ae5b29b
commit 0e56c85349
2 changed files with 40 additions and 19 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.planning/PROJECT.md
+23 -3
View File
@@ -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. 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 ## Requirements
### Validated (v0.1 — shipped 2026-06-06) ### 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 - ✓ Dead code deleted (FolderRow.vue, AccountView.vue, stale test files) — v0.2
- ✓ WHY-only comment policy enforced (CODE-09) — 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 ### Out of Scope
@@ -79,7 +98,7 @@ See `.planning/MILESTONES.md` and `.planning/milestones/v0.2-ROADMAP.md` for ful
## Context ## 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. - **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. - **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. - **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) | | 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) | | 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) | | 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 ## Evolution
@@ -141,4 +161,4 @@ Last updated: 2026-06-16
4. Update Context with current state 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*
.planning/STATE.md
+17 -16
View File
@@ -1,29 +1,30 @@
--- ---
gsd_state_version: 1.0 gsd_state_version: 1.0
milestone: v0.2 milestone: v0.3
milestone_name: UI Overhaul and Optimization milestone_name: Reimagining Cloud Storage integration
current_phase: 11 status: planning
status: complete last_updated: "2026-06-17T21:15:24.719Z"
last_updated: "2026-06-17" last_activity: 2026-06-17
last_activity: 2026-06-17 -- v0.2 milestone archived
progress: progress:
total_phases: 4 total_phases: 0
completed_phases: 4 completed_phases: 0
total_plans: 33 total_plans: 0
completed_plans: 33 completed_plans: 0
percent: 100 percent: 0
--- ---
# Project State # Project State
**Project:** DocuVault **Project:** DocuVault
**Status:** v0.2 milestone complete — ready for next milestone **Status:** v0.3 milestone planning — defining requirements
**Last Updated:** 2026-06-17 **Last Updated:** 2026-06-17
## Current Position ## Current Position
Milestone v0.2 shipped 2026-06-17. All 4 phases complete, 40/40 requirements satisfied. Phase: Not started (defining requirements)
Next action: `/gsd:new-milestone` to define v0.3 Plan: —
Status: Defining requirements
Last activity: 2026-06-17 — Milestone v0.3 started
## Phase Status ## Phase Status
@@ -81,7 +82,7 @@ _Updated at each phase transition._
| Field | Value | | Field | Value |
|---|---| |---|---|
| Last session | 2026-06-17 — v0.2 milestone archived | | Last session | 2026-06-17 — v0.3 milestone started |
| Next action | /gsd:new-milestone to define v0.3 | | Next action | Define v0.3 requirements and roadmap |
| Pending decisions | None | | Pending decisions | None |
| Resume file | None | | Resume file | None |