# 第一阶段验收记录 日期: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.png` 390px 手机编辑器。 - `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 全局配置。复现命令及维护步骤见 [容器验收](container-testing.md)。 ## 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` 通过,`vitest` 5 项通过(新增外部链接 `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.py` 24/24:管理端发布 → 卡片出现公开入口与「复制 / 打开」→ 复制写入剪贴板 → 新标签页打开公开页;**全新无 Cookie 的浏览器上下文**打开 `/blog`,列表含已发布、不含草稿、无登录框;进入文章后 URL 为 `/blog/`、Markdown 渲染、`