3.5 KiB
3.5 KiB
原型核对与实施映射
核对时间: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 |
阶段与验收
- 工程及真实纵向闭环:Java 21 / Spring Boot 3,按 auth、notes、assets、dashboard 分包的模块化单体;PostgreSQL + Flyway;Vue 3 / TS / Vite / Element Plus。验证认证、CSRF、CRUD、版本冲突、文件刷新可读、工作台聚合和构建。空库无示例业务记录。会话 Cookie,密码 BCrypt;初始化凭据来自环境。文件私有,下载必须登录。
- 博客和书签;补充发布/撤回与链接校验测试。(2026-11-10:博客管理、公开博客页与导航书签已实现;公网域名/HTTPS 入口需单独部署。)
- RSS、待办日历、代码片段;实现调度、抓取防护、幂等及日期时区测试。
- AI 与知识图谱;明确模型配置、费用边界、引用来源及真实双链关系。
- 系统设置、备份恢复、存储适配;完成灾难恢复演练和部署加固。
视觉与交互取舍
保留 224px 侧栏、73px 顶栏、绿色花园欢迎区、卡片、四栏统计、笔记双栏编辑/预览、拖放上传、手机布局和深色主题。未开发的模块显示“尚未实现”,工作台不显示模拟待办、RSS、博客或书签数字。主题仅为当前浏览器偏好,不冒充后端设置。第一阶段为手动保存(离开提示),自动保存、编辑格式工具、双链导航留作后续增强。搜索范围明确限定笔记及资产。