Files
MySpace/docs/verification.md
T

78 lines
8.1 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,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/<slug>`、Markdown 渲染、`<script>` 被清理、外部链接新标签页打开;页面标题、浏览器后退、390px 无横向溢出、全程无 JavaScript 错误;直接调用 API 时草稿 slug 返回 404,公开详情无内部字段。
- `.local/blog-acceptance.py` 39/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`,不进入搜索引擎。