Files
MySpace/docs/implementation-plan.md
T

30 lines
3.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 原型核对与实施映射
核对时间:2026-11-09。原型 `/Users/xzh/Documents/MySpace/prototype/index.html` 为单文件 HTML(内嵌 CSS、SVG、原生 JS),同级仅原型及验证产物,无工程。目标目录 `/Users/xzh/Documents/project/MySpace` 原为空。
原型 SHA256:`2c6dc9c6e8a4f287f78e84f70ff508f1bc1c472577fa9c09be4a4dfc1cbc5e24`。仅读取,绝不覆盖。样式及花园 SVG 提取到前端,业务重新以 Vue 实现,不使用原型 localStorage 数据。
| 页面/交互 | 第一阶段 API(均 /api/v1)或后续建议 | 数据表 | 阶段 |
|---|---|---|---|
| 初始化、登录、退出 | GET auth/csrf,POST auth/login,GET auth/me,POST auth/logout | app_user | 1 |
| 工作台数量、最近笔记、存储使用 | GET dashboard | notes、assets 聚合 | 1 |
| 知识库新增、搜索、分类、收藏、Markdown 编辑/导出/删除 | GET/POST notes,GET/PUT/DELETE notes/{id} | notes(版本号防覆盖) | 1 |
| 文件拖放、分类、名称搜索、预览、原件下载、删除 | GET/POST assets,GET assets/{id}/content,DELETE assets/{id} | assets + 独立磁盘卷 | 1 |
| 博客草稿、发布、预览 | GET/POST blogs,GET/PUT/DELETE blogs/{id},状态字段 draft/published | blogs(V2) | 2 已实现 |
| 公开博客阅读 | GET /public/blogs,GET /public/blogs/{slug}(匿名只读,仅已发布),前端 `/blog` 与 `/blog/<slug>` | blogs.slug(V3) | 2 已实现 |
| 导航书签 | bookmarks CRUD(名称、描述、分类、搜索、删除、http(s) 校验) | bookmarks(V5) | 2 已实现 |
| RSS 订阅、阅读、收藏笔记 | feeds、articles、refresh(待实现,需抓取地址防 SSRF) | feeds/articles(计划) | 3 |
| 效率中心:待办、日历、片段 | tasks/events/snippets(待实现) | 对应三表(计划) | 3 |
| AI 问答、检索 | conversations/messages(待实现) | conversations/messages(计划) | 4 |
| 知识图谱:双链、分类关系 | graph(待实现) | note_links(计划) | 4 |
| 系统设置、备份恢复、外部存储 | settings/backup(待实现) | settings(计划) | 5 |
## 阶段与验收
1. 工程及真实纵向闭环:Java 21 / Spring Boot 3,按 auth、notes、assets、dashboard 分包的模块化单体;PostgreSQL + Flyway;Vue 3 / TS / Vite / Element Plus。验证认证、CSRF、CRUD、版本冲突、文件刷新可读、工作台聚合和构建。空库无示例业务记录。会话 Cookie,密码 BCrypt;初始化凭据来自环境。文件私有,下载必须登录。
2. 博客和书签;补充发布/撤回与链接校验测试。(2026-11-10:博客管理、公开博客页与导航书签已实现;公网域名/HTTPS 入口需单独部署。)
3. RSS、待办日历、代码片段;实现调度、抓取防护、幂等及日期时区测试。
4. AI 与知识图谱;明确模型配置、费用边界、引用来源及真实双链关系。
5. 系统设置、备份恢复、存储适配;完成灾难恢复演练和部署加固。
## 视觉与交互取舍
保留 224px 侧栏、73px 顶栏、绿色花园欢迎区、卡片、四栏统计、笔记双栏编辑/预览、拖放上传、手机布局和深色主题。未开发的模块显示“尚未实现”,工作台不显示模拟待办、RSS、博客或书签数字。主题仅为当前浏览器偏好,不冒充后端设置。第一阶段为手动保存(离开提示),自动保存、编辑格式工具、双链导航留作后续增强。搜索范围明确限定笔记及资产。