Enable dual-device login and mobile APK update checks
This commit is contained in:
yoyuzh
45
docs/superpowers/plans/2026-04-03-overview-apk-download.md
Normal file
45
docs/superpowers/plans/2026-04-03-overview-apk-download.md
Normal file
@@ -0,0 +1,45 @@
|
||||
# Overview APK Download Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** 在总览界面增加 Android APK 下载入口，并让前端 OSS 发布流程稳定上传最新调试 APK。
|
||||
|
||||
**Architecture:** 总览页使用固定的前端静态下载路径展示 APK 下载按钮，避免引入额外后端接口。OSS 发布仍沿用现有 `scripts/deploy-front-oss.mjs`，只额外把 `front/android/app/build/outputs/apk/debug/app-debug.apk` 上传到稳定对象 key，避免把 APK 混入 `front/dist` 进而被 Capacitor 再次打包进 Android 壳。
|
||||
|
||||
**Tech Stack:** React 19, TypeScript, Vite 6, Node.js ESM scripts
|
||||
|
||||
---
|
||||
|
||||
### Task 1: 总览页下载入口状态与链接
|
||||
|
||||
**Files:**
|
||||
- Modify: `front/src/lib/app-shell.ts`
|
||||
- Modify: `front/src/lib/app-shell.test.ts`
|
||||
- Modify: `front/src/pages/overview-state.ts`
|
||||
- Modify: `front/src/pages/overview-state.test.ts`
|
||||
|
||||
- [ ] **Step 1: Write the failing test**
|
||||
- [ ] **Step 2: Run `cd front && npm run test` to verify the new state tests fail for the missing helpers**
|
||||
- [ ] **Step 3: Add native-shell detection and APK download path helpers**
|
||||
- [ ] **Step 4: Run `cd front && npm run test` to verify the helper tests pass**
|
||||
|
||||
### Task 2: 桌面端与移动端总览入口
|
||||
|
||||
**Files:**
|
||||
- Modify: `front/src/pages/Overview.tsx`
|
||||
- Modify: `front/src/mobile-pages/MobileOverview.tsx`
|
||||
|
||||
- [ ] **Step 1: Render the APK download entry only in web contexts where it is useful**
|
||||
- [ ] **Step 2: Keep the current overview information architecture intact and reuse the shared helper**
|
||||
- [ ] **Step 3: Run `cd front && npm run lint` to verify the React/TypeScript changes type-check**
|
||||
|
||||
### Task 3: OSS 发布时上传 APK
|
||||
|
||||
**Files:**
|
||||
- Modify: `scripts/deploy-front-oss.mjs`
|
||||
- Modify: `memory.md`
|
||||
- Modify: `docs/architecture.md`
|
||||
|
||||
- [ ] **Step 1: Extend the existing OSS deploy script to upload the built APK to a stable key**
|
||||
- [ ] **Step 2: Verify with `node scripts/deploy-front-oss.mjs --dry-run` if credentials are available, otherwise document the gap**
|
||||
- [ ] **Step 3: Update project memory and architecture notes for the new APK distribution path**
|
||||
59
docs/superpowers/plans/2026-04-03-recycle-bin.md
Normal file
59
docs/superpowers/plans/2026-04-03-recycle-bin.md
Normal file
@@ -0,0 +1,59 @@
|
||||
# Recycle Bin Implementation Plan
|
||||
|
||||
> **For agentic workers:** REQUIRED: Use superpowers:subagent-driven-development (if subagents available) or superpowers:executing-plans to implement this plan. Steps use checkbox (`- [ ]`) syntax for tracking.
|
||||
|
||||
**Goal:** 为网盘增加回收站，删除后的文件或目录自动进入回收站，保留 10 天，可在保留期内恢复，并在网盘左侧目录侧栏底部提供入口。
|
||||
|
||||
**Architecture:** 后端把删除操作从“物理删除”改成“回收站软删除”，为 `StoredFile` 增加删除时间、原始路径/名称、回收站分组信息，并提供“列出回收站”“恢复”“清空过期项”能力。前端在 `Files` 页目录树侧栏底部增加回收站入口，并新增回收站页面/状态，复用现有文件卡片风格展示删除时间、原始位置和恢复操作。
|
||||
|
||||
**Tech Stack:** Spring Boot 3.3, JPA/Hibernate update schema, React 19, TypeScript, Vite
|
||||
|
||||
---
|
||||
|
||||
### Task 1: 后端回收站模型与服务
|
||||
|
||||
**Files:**
|
||||
- Modify: `backend/src/main/java/com/yoyuzh/files/StoredFile.java`
|
||||
- Modify: `backend/src/main/java/com/yoyuzh/files/StoredFileRepository.java`
|
||||
- Modify: `backend/src/main/java/com/yoyuzh/files/FileService.java`
|
||||
- Modify: `backend/src/main/java/com/yoyuzh/files/FileController.java`
|
||||
- Create: `backend/src/main/java/com/yoyuzh/files/RecycleBinItemResponse.java`
|
||||
- Create: `backend/src/main/java/com/yoyuzh/files/RestoreRecycleBinItemRequest.java`
|
||||
|
||||
- [ ] **Step 1: 写后端失败测试，覆盖删除进入回收站、回收站列表、恢复、10 天过期清理**
|
||||
- [ ] **Step 2: 运行 `cd backend && mvn test` 确认新增测试先失败**
|
||||
- [ ] **Step 3: 给 `StoredFile` 增加回收站字段，并让普通文件列表/最近文件默认排除已删除项**
|
||||
- [ ] **Step 4: 把删除改成软删除，目录删除时按组放入回收站，恢复时按组恢复**
|
||||
- [ ] **Step 5: 增加回收站列表、恢复接口和定时清理过期项**
|
||||
- [ ] **Step 6: 运行 `cd backend && mvn test` 确认后端通过**
|
||||
|
||||
### Task 2: 前端回收站入口与页面
|
||||
|
||||
**Files:**
|
||||
- Modify: `front/src/components/layout/Layout.tsx`
|
||||
- Modify: `front/src/components/layout/Layout.test.ts`
|
||||
- Modify: `front/src/App.tsx`
|
||||
- Modify: `front/src/pages/Files.tsx`
|
||||
- Create: `front/src/pages/RecycleBin.tsx`
|
||||
- Create: `front/src/pages/recycle-bin-state.ts`
|
||||
- Create: `front/src/pages/recycle-bin-state.test.ts`
|
||||
- Modify: `front/src/lib/types.ts`
|
||||
- Modify: `front/src/MobileApp.tsx`
|
||||
- Modify: `front/src/mobile-pages/MobileFiles.tsx`
|
||||
|
||||
- [ ] **Step 1: 写前端失败测试，锁住侧栏底部入口和回收站状态变换**
|
||||
- [ ] **Step 2: 运行 `cd front && npm run test` 确认前端新增测试先失败**
|
||||
- [ ] **Step 3: 新增回收站页面和状态，接后端列表/恢复接口**
|
||||
- [ ] **Step 4: 在桌面网盘左侧侧栏最下方加回收站入口，并把删除确认文案改为“移入回收站”**
|
||||
- [ ] **Step 5: 给移动端补可访问的回收站入口和路由**
|
||||
- [ ] **Step 6: 运行 `cd front && npm run test`、`cd front && npm run lint`、`cd front && npm run build`**
|
||||
|
||||
### Task 3: 文档与项目记忆
|
||||
|
||||
**Files:**
|
||||
- Modify: `memory.md`
|
||||
- Modify: `docs/architecture.md`
|
||||
- Modify: `docs/api-reference.md`
|
||||
|
||||
- [ ] **Step 1: 记录回收站行为、保留周期、入口位置和恢复约束**
|
||||
- [ ] **Step 2: 在交付前确认验证命令和已知限制写入文档**
|
||||
Reference in New Issue
Block a user