Files
MySpace/docs/implementation-plan.md

3.5 KiB
Raw Permalink Blame History

原型核对与实施映射

核对时间: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、博客或书签数字。主题仅为当前浏览器偏好,不冒充后端设置。第一阶段为手动保存(离开提示),自动保存、编辑格式工具、双链导航留作后续增强。搜索范围明确限定笔记及资产。