8.1 KiB
第一阶段验收记录
日期:2026-11-09,Mac 本地执行。Java 21.0.10、Maven 3.9.12、Node 24.14.0、独立 PostgreSQL 16、Chromium。
自动验证
- 后端
mvn verify:3 组真实 PostgreSQL 集成测试通过(认证/CSRF、笔记与冲突、私有文件生命周期)。 - 前端
npm test:2 项 Markdown 安全预览测试通过。 - 前端
npm run build:TypeScript 校验和 Vite 构建通过;JavaScript 约 299 KB(gzip 约 110 KB)。 npm audit:0 已知漏洞。此结果只针对此次锁定的前端依赖及当时的公告数据库。- Flyway 从空库成功创建 app_user / notes / assets;开发业务库无内置示例记录。
浏览器验证
output/playwright/check-live.js 为 Playwright CLI 的 run-code 验收脚本,针对本机临时验收账号。可通过技能的 CLI 在运行中的本机站点执行;它会创建并删除特定测试记录,勿直接用于含同名记录的业务库。
通过:真实登录,新增笔记、Markdown 预览、脚本清理、保存、刷新持久化、未保存离开保护、收藏、删除;文本文件上传、页面刷新后再次打开、原件下载和删除;手机导航、主题切换。过程无 JavaScript pageerror。匿名首次访问 /auth/me 的 401 是预期的登录状态探测。
已人工查看截图:
output/playwright/prototype-desktop.png原始原型工作台。output/playwright/app-desktop.png实现后的 1440px 工作台。output/playwright/app-editor.png双栏笔记编辑器。output/playwright/app-mobile-editor.png390px 手机编辑器。output/playwright/app-mobile.png手机工作台。output/playwright/app-dark.png手机深色工作台。
390px 编辑器和工作台检查页面宽度均未溢出。原型与实现复用了布局、色彩、CSS、侧栏图标及花园插画;真实空状态替代原型演示数据。
原型 SHA256 在开始与结束均为 2c6dc9c6e8a4f287f78e84f70ff508f1bc1c472577fa9c09be4a4dfc1cbc5e24,未改动原文件。
尚未验证/尚未实现
- Docker 构建与 Compose 启动已于 2026-11-10 补充实测通过,见下方新增记录。
- 未测试所有浏览器、并发压力、大规模数据、备份恢复、公网部署。
- 博客、书签、RSS、效率中心、AI、图谱和系统设置均未实现,导航和工作台相关区块明确标注。
- 第一阶段仅手动保存笔记;自动保存、格式快捷工具条和双链导航尚未迁移。
2026-11-10 容器补充验收
Docker Desktop 4.99.0,Docker Engine 29.9.3,Compose v5.7.0,Linux ARM64。前后端均从源码在容器内构建成功。独立项目 myspace-container-test 使用单独数据库及资产数据卷,未改动本机开发数据。
- PostgreSQL 16.15 健康检查通过;Flyway V1 成功应用。
- 后端以 UID 10001 运行;上传目录可写,文件删除后物理文件数为 0。
- 创建阶段 18 项检查通过,包含认证、CSRF、笔记搜索/收藏/分类/版本冲突、文本和 PNG 文件、15 MB 上限、空文件拒绝、工作台聚合及文件访问权限。
- 三个容器全部强制重建(已确认三个容器 ID 均变化),保留命名卷。验证阶段 10 项检查通过;笔记内容及版本不变,两个文件的 SHA256 不变。
- 清理仅删除验收脚本创建的记录;最后账户 1 个,笔记 0 条,资产 0 条,磁盘资产文件 0 个。
- Chromium 通过真实 Nginx 入口验证登录、工作台、知识库、文件页面和退出;无 JavaScript pageerror。截图:
output/playwright/container-desktop.png。 - 既有本机开发前端 5173 端口仍返回 200。
首次构建遇到镜像加速地址无响应和一次 Maven 依赖超时;通过项目级官方仓库选项及 Maven 缓存后重试成功,未改动 Docker 全局配置。复现命令及维护步骤见 容器验收。
2026-11-10 博客管理(第二阶段部分)
按原型 /Users/xzh/Documents/MySpace/prototype/index.html(SHA256 仍为 2c6dc9c6e8a4f287f78e84f70ff508f1bc1c472577fa9c09be4a4dfc1cbc5e24,只读)的 blog()、blogForm()、preview-blog、blog-form 分支实现。
- 后端
mvn verify:4 组集成测试通过,新增blogLifecycleStatusAndConflict(默认草稿、发布切换后筛选、搜索、版本冲突 409、非法 status 400、未登录 403、删除与 404)。 - 前端
npm test:4 项通过(新增原始 HTML 媒体/容器标签移除、http(s) 图片保留)。 - 前端
npm run build:TypeScript 校验 + Vite 构建通过。 - Flyway:测试库与开发库均从 V1 升到 V2;用新 JAR 在独立
myspace_test库启动一次验证迁移幂等。 - 浏览器验收(Chrome headless,真实登录,1440px 与 390px):39 项全部通过,覆盖新建默认草稿、编辑改标题并发布、刷新后保留、全部/草稿/已发布筛选与徽标一致、页内搜索(标题/正文/空态)、阅读预览 Markdown 渲染与 XSS 清理、全局搜索命中文章并打开预览、删除后刷新仍不存在、390px 无横向溢出、无 JavaScript 运行时错误。验收数据已清理。
- 截图:
output/playwright/blog-list.png、blog-form.png、blog-preview.png、blog-mobile.png。
与原型的有意差异(均在任务要求范围内):新增「删除文章」与摘要必填校验(原型没有删除,摘要为 required);编辑弹窗区分「写一篇新文章 / 编辑文章」标题,而原型复用同一标题;正文 Markdown 使用知识库同一渲染器,因此标题、列表、引用、代码与笔记一致,并移除原始 HTML 中的 img/script/iframe 等标签(原型把原始 HTML 当文本);状态徽标文案为「草稿 · 不公开 / 已发布 · 公开」(公开博客页加入后更新);卡片按 9 篇分页,避免超过 9 篇时失去封面配色循环。原型中的页内搜索框在博客页启用;状态筛选在前端本地完成(与原型一致),列表一次最多拉取 100 篇。
2026-11-10 公开博客页
需求:发布后需要一个公开的博客页面展示已发布的文章。
- 后端
mvn verify:5 组集成测试通过。新增publicBlogOnlyExposesPublishedAndIgnoresSession:slug 生成与同名去重、中文/纯数字标题回退article、匿名可读、只含已发布、草稿 slug 与不存在 slug 同为 404、响应不含 id/version、管理接口仍要求登录、ETag 条件请求返回 304。 - 前端:
vue-tsc通过,vitest5 项通过(新增外部链接target=_blank+rel=noopener noreferrer),npm run build通过(JS 316 KB / gzip 115 KB)。 - Flyway:开发库与测试库从 V2 升到 V3(
V3__public_blogs.sql回填历史文章 slug,唯一索引 + 已发布部分索引)。 - 浏览器验收(Chrome headless):
.local/public-blog-acceptance.py24/24:管理端发布 → 卡片出现公开入口与「复制 / 打开」→ 复制写入剪贴板 → 新标签页打开公开页;全新无 Cookie 的浏览器上下文打开/blog,列表含已发布、不含草稿、无登录框;进入文章后 URL 为/blog/<slug>、Markdown 渲染、<script>被清理、外部链接新标签页打开;页面标题、浏览器后退、390px 无横向溢出、全程无 JavaScript 错误;直接调用 API 时草稿 slug 返回 404,公开详情无内部字段。.local/blog-acceptance.py39/39:管理端原有流程(新建默认草稿、发布、刷新保留、筛选、页内搜索与正文匹配、预览、全局搜索、删除、手机宽度、无运行时错误)在公开页加入后仍全部通过。
- 截图:
output/playwright/public-blog-list.png、public-blog-article.png、public-blog-mobile.png。验收数据已清理(删除本次验收*文章)。
边界说明:公开页目前可被同一台电脑上的浏览器访问(本机开发地址 http://127.0.0.1:5173/blog,容器地址 http://localhost:8088/blog)。要从互联网访问需要把它部署到公网入口(域名 + HTTPS),这不在本次实现范围;/blog 不要求登录,但仍沿用部署的访问控制。页面带 noindex,不进入搜索引擎。