WIP: XZH-21 后端改动 + 测试验收附加用例
This commit is contained in:
commit
1bd637528d
168 files changed
+13874
No files matched your search
+77
@@ -0,0 +1,77 @@
|
||||
# API(第一阶段 + 博客管理 + 导航书签 + 公开博客)
|
||||
|
||||
所有路径以 `/api/v1` 开头,业务 API 需登录 Cookie;不使用浏览器持久化 token。除 GET 外需 `X-CSRF-TOKEN` 请求头,值从 `/auth/csrf` 的 `token` 字段取得(响应也给出 `headerName`)。登录和退出后重新请求 token。
|
||||
|
||||
| 方法 | 路径 | 请求/结果 |
|
||||
|---|---|---|
|
||||
| GET | /auth/csrf | `{token,headerName}`,匿名可访问 |
|
||||
| POST | /auth/login | form-urlencoded `username,password`;成功 200,失败 401 |
|
||||
| GET | /auth/me | `{username}` |
|
||||
| POST | /auth/logout | 成功 204,失效会话 |
|
||||
| GET | /dashboard | `{notes,starred,assets,bookmarks,storageBytes,recentNotes}` |
|
||||
| GET | /notes | `q, category, starred, offset`;数组,每页最多 100 |
|
||||
| POST | /notes | `{title,body,category,tag,star,version:0}`;201 + 完整记录 |
|
||||
| GET | /notes/categories | 返回已保存的笔记分类名称数组 |
|
||||
| POST | /notes/categories | `{name}`;创建分类并返回 `{name}`,重名返回 409 |
|
||||
| GET | /notes/categories/usage | 返回分类名称和笔记数 `{name,noteCount}` |
|
||||
| DELETE | /notes/categories | `name` 指定分类,`replacement` 指定迁移目标。空分类可直接删除。有笔记时需提供另一个分类。至少保留一个分类,成功返回 204 |
|
||||
| GET | /notes/{uuid} | 完整记录 |
|
||||
| PUT | /notes/{uuid} | 同创建字段,version 必须是读取时版本;更新返回 version+1;冲突 409 |
|
||||
| DELETE | /notes/{uuid} | 204,移入回收站;不存在返回 404 |
|
||||
| GET | /assets | `q,type=all/image/file,offset`;数组,每页最多 100 |
|
||||
| POST | /assets | multipart 字段 `file`,单文件 1 字节至 15 MB;201 |
|
||||
| GET | /assets/{uuid}/content | PNG/JPEG/GIF 内联,其他附件;`download=true` 强制下载 |
|
||||
| DELETE | /assets/{uuid} | 删除磁盘文件与元数据,204 |
|
||||
| GET | /bookmarks | `q,category,offset`;数组,每页最多 100,按更新时间倒序 |
|
||||
| POST | /bookmarks | `{title,url,description,category,icon_asset_id,is_public}`;默认私有,图标可选,必须是图床图片;仅接受有效的 http(s) URL;201 + 完整记录 |
|
||||
| GET | /bookmarks/{uuid} | 完整记录 |
|
||||
| PUT | /bookmarks/{uuid} | 请求字段与新增一致;更新原记录及公开状态;不存在返回 404 |
|
||||
| DELETE | /bookmarks/{uuid} | 204,移入回收站;不存在返回 404 |
|
||||
| GET | /public/bookmarks | 匿名只读;`offset,limit(1–100,默认 50)`;仅展示已同步至公开快照的记录,返回 `{title,url,description,category,icon_asset_id,updated_at}` |
|
||||
| GET | /public/bookmarks/images/{uuid} | 匿名读取被公开书签选为图标的 PNG/JPEG/GIF;其他图片或未引用图片返回 404 |
|
||||
| GET | /blogs | `q, status=all/draft/published, offset`;数组,每页最多 100,按更新时间倒序 |
|
||||
| POST | /blogs | `{title,summary,body,status,version:0,cover_asset_id,category}`;status 为 draft/published;201 + 完整记录 |
|
||||
| GET | /blogs/{uuid} | 完整记录 |
|
||||
| PUT | /blogs/{uuid} | 同创建字段,version 必须是读取时版本;更新返回 version+1;冲突 409 |
|
||||
| DELETE | /blogs/{uuid} | 204,移入回收站;不存在返回 404 |
|
||||
| GET | /public/blogs | 匿名只读;`offset, limit(1–50,默认 20), q, category`;仅已同步的已发布文章,`{title,summary,slug,updated_at,cover_asset_id,category}`,按更新时间倒序 |
|
||||
| GET | /public/blogs/rss.xml | 匿名订阅最近 30 篇已同步的文章,返回 RSS 2.0 |
|
||||
| GET | /public/blogs/categories | 匿名只读;返回已发布文章的分类列表 |
|
||||
| GET | /public/blogs/{slug} | 匿名只读;仅已同步的已发布文章,额外返回 `body`;草稿或不存在的 slug 均为 404 |
|
||||
| GET | /public/blogs/{slug}/images/{uuid} | 匿名读取该已发布文章引用的封面或 Markdown 图片;其余情况返回 404 |
|
||||
|
||||
笔记字段:id(UUID)、title(1–120 非空)、body(最多 1,000,000 字符)、category(1–60 非空)、tag(0–60)、star、version、created_at、updated_at。
|
||||
资产字段:id、name、media_type、size(字节)、created_at。时间由数据库产生,使用 timestamptz。
|
||||
书签字段:id(UUID)、title(1–60 非空)、url(有效 http/https 地址,最多 4096 字符)、description(0–160)、category(1–60 非空)、created_at、updated_at。书签为私有数据;管理页面使用 `target="_blank"` 与 `rel="noopener noreferrer"` 打开网址。
|
||||
博客字段:id(UUID)、title(1–120 非空)、summary(0–200)、body(最多 1,000,000 字符)、status(draft/published,数据库 CHECK 约束)、slug(唯一)、version、created_at、updated_at。列表不返回数量汇总;前端在本地按状态和关键词筛选(页内搜索与全局搜索都按正文匹配)。
|
||||
`cover_asset_id` 是可选的图床图片 UUID。提交 `null` 可移除封面。Flyway V4 为已有文章新增该字段,删除对应图床原图时自动清空。
|
||||
`slug` 由服务端在创建时按标题生成:小写 ASCII 字母数字保留,其余转连字符,最多 80 字符;不含字母(如纯中文或纯数字标题)时用 `article`,再追加 id 前 6 位保证唯一。编辑标题不会改变 slug,已分享的链接保持有效。
|
||||
|
||||
公开与私有边界:
|
||||
- `/public/**` 可匿名访问,是前端 `/blog`、`/blog/<slug>` 页面的唯一数据来源;响应不含 id、version 等内部字段,公开页面请求时使用 `credentials: "omit"`,页面被嵌入或分享时不会带上登录 Cookie。
|
||||
- 公开接口响应携带 ETag(根据文章版本、封面及当前页文章集合生成),带 `If-None-Match` 的条件请求内容未变时返回 304;公开页面每 30 秒、以及窗口重新获得焦点时做条件请求,文章更新后自动刷新。
|
||||
- 所有 `/blogs` 管理接口仍需登录和 CSRF。单账户平台,不提供按作者或空间的隔离;公开页面目前可被同一台电脑上的浏览器访问,是否可被互联网访问取决于部署与网络环境。
|
||||
|
||||
响应头:所有响应带 `X-Content-Type-Options: nosniff`、`Referrer-Policy: strict-origin-when-cross-origin`、`X-Frame-Options: SAMEORIGIN`。
|
||||
|
||||
错误:401 未登录/凭据错误;403 CSRF 不合法;400 输入校验失败(含非法 status 筛选值);404 不存在;409 版本冲突;413 超过上传限制;500 服务失败。控制器业务错误为 `{message}`;安全过滤器错误可能采用 Spring 标准错误格式。前端保留未保存内容并提示错误,不将失败当成功。
|
||||
|
||||
|
||||
## V4 工作区
|
||||
|
||||
| 方法 | 路径 | 用途 |
|
||||
|---|---|---|
|
||||
| GET、POST | /library/{kind}/folders | 知识库及图床的文件夹列表与新增 |
|
||||
| GET | /library/{kind}/facets | 知识库及图床的文件夹计数、标签和图床存储统计 |
|
||||
| GET、POST、PUT | /library/{kind}/categories | 分类列表、新增、改名或迁移后删除 |
|
||||
| POST | /library/{kind}/batch | 对指定 ID 批量移动、加标签、移入回收站或调整书签顺序 |
|
||||
| GET | /library/{kind}/trash | 按模块查看已删除记录 |
|
||||
| POST、DELETE | /library/{kind}/trash/{id} | 恢复或永久删除 |
|
||||
| GET | /notes/{id}/history | 按笔记分页读取版本列表 |
|
||||
| GET、POST | /notes/{id}/history/{version} | 预览历史版本或使用当前版本号恢复 |
|
||||
| GET | /notes/{id}/backlinks | 查找引用当前笔记的双链 |
|
||||
| GET、PUT | /assets/{id} | 读取和编辑文件名、分类、文件夹、标签、描述 |
|
||||
| PUT | /bookmarks/{id}/favorite | 修改常用收藏状态 |
|
||||
| POST | /bookmarks/import | 批量导入并按网址去重,导入项默认私有 |
|
||||
| GET、POST | /publication | 查看待同步清单或按当前发布版本提交同步 |
|
||||
| GET | /publication/export | 导出已发布的博客与书签快照 |
|
||||
@@ -0,0 +1,86 @@
|
||||
# Docker Compose 容器验收
|
||||
|
||||
2026-11-10 实测通过:前后端容器构建、数据库迁移、18 项创建阶段检查、10 项重建后检查,以及 Chromium 登录/工作台/笔记/文件/退出流程。三个容器 ID 均已变化,笔记版本和文件 SHA256 保持一致。测试记录已清理,服务保留运行在 http://localhost:8088 ,登录信息见本机 `.local/container-access.md`。
|
||||
|
||||
不连接本机开发数据库(127.0.0.1:55432),不使用本机资产目录。测试配置在 Git 忽略的 `.local/container-test.env`,权限为 600。
|
||||
|
||||
2026-11-10 晚 `compose.yml` 统一为单一栈:固定项目名 `name: myspace`,数据卷 `myspace_postgres-data` / `myspace_asset-data`;后端健康检查通过后才启动前端。此前按目录名运行的 `myspace_hifox` 栈已停止(容器移除,数据卷保留,未被新栈使用),旧的 `-p myspace-container-test` 命令不再适用。
|
||||
|
||||
## 可重复执行
|
||||
|
||||
从工程根目录运行。先填写测试环境文件(参考 `.env.example`),并确保 8088 和 5432 端口空闲。项目名由 `compose.yml` 的 `name:` 决定,不要传 `-p`,否则会另建一套数据卷:
|
||||
|
||||
```sh
|
||||
docker compose --env-file .local/container-test.env up --build -d
|
||||
python3 scripts/container-smoke.py --phase create
|
||||
# 重建全部容器,保留命名数据卷;不要加 down -v
|
||||
docker compose --env-file .local/container-test.env up -d --force-recreate
|
||||
python3 scripts/container-smoke.py --phase verify
|
||||
```
|
||||
|
||||
`/blog` 公开页验收(登录 → 草稿不出现在匿名接口 → 发布后公开 → 删除测试文章):`python3 .local/stack-smoke.py`。2026-11-10 在 `myspace_hifox` 栈实测 6/6 通过;同次确认匿名接口带 `nosniff`、`X-Frame-Options: DENY` 等响应头。
|
||||
|
||||
2026-11-10 重启时实测:容器已移除但镜像保留时,`docker compose up` 直接运行**旧镜像**,不读源码;改了代码后必须 `docker compose --env-file .local/container-test.env build` 或加 `--build`,再用 `docker compose ... ps` 确认容器镜像 ID 与新镜像一致。.local/compose-e2e.py 依赖公开接口中的 slug(V3),在 V2 镜像上会报 `KeyError: 'slug'`。
|
||||
|
||||
`create` 验证静态页面、匿名拒绝、登录、CSRF、笔记 CRUD 与冲突、搜索筛选、文本/PNG 上传和下载、实际统计、退出及文件私有性。它将新建记录的 UUID 保存到 `.local/container-test-state.json`。
|
||||
|
||||
`verify` 重新登录,检查重建前的笔记版本和内容,按 SHA256 检查两个文件内容,随后只删除脚本创建的记录并检查统计回到基线。若中途失败,保留状态文件,排查后再次执行 `verify`;不要直接删除状态文件造成测试数据失去追踪。
|
||||
|
||||
## 首次启动值与已有数据卷
|
||||
|
||||
`DB_PASSWORD`(数据库角色)和 `ADMIN_PASSWORD`(唯一账户)只在**首次创建**时生效;已有数据卷时重建容器、修改 env 都不会改变它们。
|
||||
|
||||
2026-11-10 晚,`myspace_postgres-data` 卷是由先前一次以 `.env.example` 示例值启动的运行创建的:角色密码为 `replace-with-a-long-database-password`,账户 `admin` 的哈希对应示例密码 `replace-with-a-unique-password`。为与 `.local/container-test.env` 一致,角色密码已在单用户模式用 `ALTER ROLE` 重置,账户哈希已改写为 `ADMIN_PASSWORD` 的 BCrypt 值。未删除任何数据。
|
||||
|
||||
但工程根目录没有 `compose.yml` 的 `name:` 时,项目名取自目录名,当前由 `compose.yml` 使用的是 `myspace_hifox` 栈,其数据卷 `myspace_hifox_postgres-data` / `myspace_hifox_asset-data`。该卷同样由示例值创建,2026-11-10 重启时已把角色密码重置为 `DB_PASSWORD`、`admin` 哈希改写为 `ADMIN_PASSWORD`。目前线上数据只有 1 篇已发布文章。`myspace_postgres-data` / `myspace_asset-data` 中的示例值数据**未**重置,暂未被任何栈使用。
|
||||
|
||||
## 重置角色密码
|
||||
|
||||
在工程根目录执行;密码经环境变量传入,包含引号也安全(已实测):
|
||||
|
||||
```sh
|
||||
set -a; . ./.env; set +a # 读取 DB_PASSWORD;也可换成任意密码
|
||||
docker compose stop db
|
||||
docker run --rm --user postgres -e NEWPW="$DB_PASSWORD" \
|
||||
-v myspace_postgres-data:/var/lib/postgresql/data \
|
||||
registry-1.docker.io/library/postgres:16-alpine \
|
||||
sh -c 'printf "ALTER ROLE myspace PASSWORD %s;\n" "$(printf "%s" "$NEWPW" | sed "s/'"'"'/'"'"''"'"'/g; s/^/'"'"'/; s/$/'"'"'/")" | postgres --single -D /var/lib/postgresql/data postgres'
|
||||
docker compose up -d
|
||||
```
|
||||
|
||||
## 重置账户密码
|
||||
|
||||
`ADMIN_PASSWORD` 只在数据库中没有任何账户时生效。需要生成 BCrypt 哈希(`$2a$`,60 字符)后写入 `app_user`:
|
||||
|
||||
```sh
|
||||
set -a; . ./.env; set +a
|
||||
docker run --rm -e PW="$ADMIN_PASSWORD" registry-1.docker.io/library/maven:3.9-eclipse-temurin-21 sh -c 'mvn -q dependency:get -Dartifact=org.springframework.security:spring-security-crypto:6.5.6 >/dev/null 2>&1; cat > /tmp/G.java <<EOF
|
||||
public class G { public static void main(String[] a){ System.out.print(org.springframework.security.crypto.bcrypt.BCrypt.hashpw(a[0], org.springframework.security.crypto.bcrypt.BCrypt.gensalt(10))); } }
|
||||
EOF
|
||||
CP=$(find ~/.m2 -name "spring-security-crypto-6.5.6.jar" | head -1); javac -cp "$CP" -d /tmp/c /tmp/G.java && java -cp "/tmp/c:$CP" G "$PW"' | tail -1 > /tmp/hash
|
||||
[ "${#$(cat /tmp/hash)}" -eq 60 ] || { echo '哈希生成失败,未写入'; exit 1; }
|
||||
printf "update app_user set password_hash = '%s' where id=1;\n" "$(cat /tmp/hash)" | docker exec -i myspace_hifox-db-1 psql -U myspace -d myspace
|
||||
rm -f /tmp/hash
|
||||
```
|
||||
|
||||
写完无需重启,下一次登录即生效。
|
||||
|
||||
## 本机镜像拉取问题
|
||||
|
||||
2026-11-10 首次测试时,Docker Desktop 全局配置中的镜像加速服务长时间未返回。测试通过 `IMAGE_REGISTRY=registry-1.docker.io` 直接从 Docker Hub 官方仓库拉取成功。项目增加了可选 `IMAGE_REGISTRY` 构建参数和数据库镜像前缀,默认仍为 `docker.io`;未修改 Docker Desktop 全局配置,也未关闭 TLS 校验。
|
||||
|
||||
首次构建需下载 Maven/JDK、JRE、Node、Nginx 和 PostgreSQL 基础镜像。后续构建复用 Docker 缓存。第一次后端构建下载 logback-classic 时遭遇 Maven Central 读取超时;后端 Dockerfile 已加入 BuildKit Maven 缓存挂载,失败后重试可复用已下载依赖。
|
||||
|
||||
## 服务维护
|
||||
|
||||
```sh
|
||||
# 状态和日志
|
||||
docker compose --env-file .local/container-test.env ps
|
||||
docker compose --env-file .local/container-test.env logs --tail=100
|
||||
# 后端健康状态
|
||||
docker inspect myspace_hifox-backend-1 --format '{{.State.Health.Status}}'
|
||||
# 停止并移除容器,保留数据卷
|
||||
docker compose --env-file .local/container-test.env down
|
||||
# 再次启动
|
||||
docker compose --env-file .local/container-test.env up -d
|
||||
```
|
||||
@@ -0,0 +1,32 @@
|
||||
# 第一阶段交付
|
||||
|
||||
工程:`/Users/xzh/Documents/project/MySpace`。原型:`/Users/xzh/Documents/MySpace/prototype`(未修改)。
|
||||
|
||||
2026-11-10 继续工作时已确认本机前端 `http://localhost:5173` 和后端 `http://localhost:8080/api/v1/auth/csrf` 均返回 HTTP 200。
|
||||
|
||||
本机开发账户见 `.local/access.md`,此文件权限为 600,整个 `.local` 目录均已被 Git 忽略。业务数据位于 `.local/pgdata`,文件位于 `.local/assets`。请避免将它们删除或作为源码提交。
|
||||
|
||||
## 阅读入口
|
||||
- `README.md`:环境、部署、开发和测试命令,以及已知限制。
|
||||
- `docs/implementation-plan.md`:实际原型页面、API、数据表与阶段映射。
|
||||
- `docs/api.md`:第一阶段接口与字段。
|
||||
- `docs/verification.md`:构建、测试及浏览器验收记录。
|
||||
- `output/playwright/`:界面截图及可重复执行的浏览器验收脚本。
|
||||
|
||||
## 下一阶段
|
||||
博客管理已于 2026-11-10 实现(`V2__blogs.sql` + `com.myspace.blogs.BlogsController` + `frontend/src/App.vue` 中的博客页、`BlogArt.vue`),验收见 `docs/verification.md`。书签仍是第二阶段剩余部分,尚未开始。开始前应再次读取原型的 blog、blogForm、bookmarks、bookmark-form 处理逻辑;沿用现有认证和错误处理;使用新增 Flyway V2 迁移,不能更改已应用的 V1。
|
||||
|
||||
博客需要标题、摘要、Markdown、草稿/发布状态、预览与更新日期;“发布”必须定义可访问的公开阅读入口,不能仅改状态冒充完成。公开入口已实现:`V3__public_blogs.sql`(slug)、`PublicBlogsController`(`/api/v1/public/blogs`)、前端 `PublicBlog.vue`(`/blog`、`/blog/<slug>`,由 `main.ts` 按路径选择应用);验收脚本 `.local/public-blog-acceptance.py`。公网访问仍需把该地址部署到域名与 HTTPS 之后。书签需要网址协议校验、名称、描述、分类、搜索、删除和新窗口打开。完成后补充 API 测试、前端交互验收,并更新导航的待开发标记。
|
||||
|
||||
## Docker 验收补充(2026-11-10)
|
||||
|
||||
容器环境已构建并完成启动、CRUD、上传和重建持久化测试,浏览器验证通过。访问 http://localhost:8088 ,登录信息见 `.local/container-access.md`。它与原有 5173 开发环境数据完全独立。运行步骤和结果见 `docs/container-testing.md`。
|
||||
|
||||
当日晚间:`compose.yml` 固定项目名 `name: myspace`,后端健康检查通过后才启动前端;已重建镜像并重启为单一栈(`myspace-db-1` / `myspace-backend-1` / `myspace-frontend-1`),V3 迁移已应用,`/blog` 公开页验收 6/6 通过。登录 `admin`,密码为 `.local/container-test.env` 中的 `ADMIN_PASSWORD`(原示例密码已作废)。
|
||||
|
||||
遗留 / 待确认:
|
||||
- **当前实际运行的是 `myspace_hifox` 栈**(`myspace_hifox-db-1` / `myspace_hifox-backend-1` / `myspace_hifox-frontend-1`,http://localhost:8088)。工程根目录没有 `compose.yml` 的 `name:` 时,项目名取自目录名,文档里的 `name: myspace` 说明尚未生效,需要时再加。
|
||||
- 2026-11-10 重启:从源码重新构建镜像并重建容器,6/6 冒烟通过。`admin` 与 DB 角色密码已与 `.local/container-test.env` 对齐(此前仍是示例值)。
|
||||
- 以下卷均未使用、可确认后删除:`myspace_postgres-data`、`myspace_asset-data`(文档假设的栈,从未运行)、`myspace-container-test_postgres-data`、`myspace-container-test_asset-data`(旧测试卷)。`docker volume rm` 会永久删除数据,不要删 `myspace_hifox_*`。
|
||||
- db 固定发布到宿主机 5432;与其他 PostgreSQL 冲突时修改 `compose.yml` 的端口映射。
|
||||
- 首次启动若直接使用 `.env.example` 示例密码,示例密码同样能登录;建议后续在 `AccountInitializer` 中拒绝示例值。
|
||||
@@ -0,0 +1,29 @@
|
||||
# 原型核对与实施映射
|
||||
|
||||
核对时间: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、博客或书签数字。主题仅为当前浏览器偏好,不冒充后端设置。第一阶段为手动保存(离开提示),自动保存、编辑格式工具、双链导航留作后续增强。搜索范围明确限定笔记及资产。
|
||||
@@ -0,0 +1,90 @@
|
||||
# MySpace V4 开发交接
|
||||
|
||||
更新:2026-11-11。本文是新版 UI、交互和后续任务的入口。现有接口以代码为准,[API 文档](api.md)记录现有契约,[历史交接](handoff.md)和[原计划](implementation-plan.md)供追溯。下文保留 V4 全量目标。当前工程已实现后台导航及工具子路由、工作台、四个内容模块、统一回收站、笔记版本、RSS 手动刷新、效率中心、收集箱、备份和 AI Studio。模型能力由部署配置启用。访客生成和定时工作流仍待开放。
|
||||
|
||||
## 1. 参考与取舍
|
||||
|
||||
原型目录:`/Users/xzh/Documents/MySpace/MySpace_修复版_V4`。保持四个 HTML 与两个 JS 在同一目录;从 `MySpace-管理后台.html` 打开,在右上角「公开发布」同步,再从后台分别打开三张公开页。对照时建议以同一个本地静态站点提供四页,避免不同浏览器对直接打开文件时的存储行为影响判断。
|
||||
|
||||
| 原型文件 | 开发参考 |
|
||||
|---|---|
|
||||
| `MySpace-管理后台.html` | 后台页面、工具中心、发布中心、各模块联动;以最后加载的 V4 修复层及实际事件为准 |
|
||||
| `MySpace_Public_Blog.html` | 公开博客列表、分类、搜索、阅读详情、订阅入口 |
|
||||
| `MySpace_Public_Nav.html` | 公开导航分组、链接卡片与主题 |
|
||||
| `MySpace_Public_AI.html` | 对话/生图入口、模型选择、提示词书架、访客会话和公开图片 |
|
||||
| `myspace-client.js`、`admin_router.js` | 浏览器快照、主题、错误提示和原型路由参考 |
|
||||
| `README_修复说明_V4.md` | 变更和历史验收线索;末尾「公开页面导航调整」覆盖正文的旧互跳描述 |
|
||||
|
||||
**公开页独立。** 后台可进入博客、导航和 AI,三张公开页均不放其他公开页或后台的入口(包括移动菜单和浮动入口)。保留各自业务导航、主题切换和发布状态。
|
||||
|
||||
**复刻交互,重写数据层。** 原型用 localStorage 在同浏览器同步,且包含模拟 AI、RSS 示例和叠加事件处理。正式版沿用 Vue/TypeScript、Spring Boot、PostgreSQL、Flyway、登录 Cookie 与 CSRF。业务记录和发布结果以服务器为准;本地只保存主题、视图偏好、可清除的访客会话等。生产空状态与加载失败独立呈现,不混入示例文章、模型或订阅。
|
||||
|
||||
## 2. 页面范围及实现差距
|
||||
|
||||
| 页面 | V4 目标及开发切入点 |
|
||||
|---|---|
|
||||
| 工作台 | 沿用已有统计和最近笔记;补快捷收集、待办摘要、通知和发布状态。计数来自实际记录。 |
|
||||
| 知识库 | 现有笔记 CRUD、分类、收藏、Markdown 编辑与预览继续使用。新增文件夹、多标签、网格/列表、筛选排序、批量操作、模板、双链/反链及图谱;编辑器补 AI 助手、配图、版本与导出。分类与文件夹是两个维度。 |
|
||||
| 博客 | 复用现有草稿/已发布、Markdown、摘要、封面和 slug;补分类、图床/生成封面、从笔记建草稿、转笔记、公开预览。公开 URL 沿用 `/blog`、`/blog/:slug`。 |
|
||||
| 图床 | 复用真实上传、预览、下载。新增图片/文件视图、文件夹、标签、批量移动/删除、详情与复制链接/Markdown。私有素材使用认证地址;公开素材使用受发布范围约束的稳定地址。 |
|
||||
| 书签 | 已有新增、删除、分类和图床图标;补编辑、收藏、多标签、手动顺序、列表/卡片、批量操作、浏览器 HTML/JSON 导入导出、公开勾选。沿用 `/bookmarks`;仅接受 HTTP(S) 网址,导入先预览去重并显示跳过原因。 |
|
||||
| RSS | 新增订阅源、分类、抓取状态、阅读器、已读/收藏、搜索和批量标记;文章可存笔记、待办、收集箱或发给 AI 摘要。删除订阅保留已抓取内容。 |
|
||||
| 效率中心 | 新增待办、日历、代码片段。待办支持完成和状态筛选;日程可创建、编辑、删除;代码片段可编辑、复制。 |
|
||||
| AI Studio | 新增对话、生图、供应商、模型、历史、素材库、提示词、用量、日志、偏好。历史区分对话/图片,素材库区分全部/收藏;模型失效时清理失效筛选和默认项,区分未生成与未收藏。 |
|
||||
| 工具中心 | 七个入口:标签管理、版本历史、回收站、批量管理、自动化工作流、浏览器工具、联动说明。以真实计数和状态展示,另提供收集箱、全局搜索、公开发布入口。自动化和浏览器工具的服务端能力分期,未接通时说明限制。 |
|
||||
| 收集箱 | 新增手动快速收集及浏览器捕捉入口,记录标题、内容/网址、来源和处理状态;整理成笔记、书签或待办。 |
|
||||
| 设置 | 新增资料、主题与编辑偏好、备份导入导出。导入先校验版本和预览影响;缺失模块不注入样例。凭据不随备份导出,附件备份是否包含文件须在界面说明。 |
|
||||
| 公开博客 | 复用 `PublicBlog.vue`,补 V4 分类、更多分类、搜索和发布状态;搜索与分类可叠加,详情支持直接打开和返回。RSS 入口只在真实订阅地址就绪后启用。 |
|
||||
| 公开导航 | 复用 `PublicBookmarks.vue`,按公开分类和顺序展示,空分组不渲染;统一绿色系与深浅色,保留网址访问和图标失败回退。 |
|
||||
| 公开 AI | 新增建议路径 `/ai`。欢迎页、模型选择、提示词填入、对话/生图、访客历史搜索与回看、公开图集;真实能力未就绪时明确禁用。 |
|
||||
|
||||
后台主导航按 V4 顺序:工作台 → 知识库 → 博客 → 图床 → 书签 → RSS → 效率中心 → AI Studio → 工具中心 → 收集箱 → 设置。工具中心子页用独立路由状态;父入口、子页名称、面包屑、页面标题和浏览器返回一致。现有后台入口继续可达,管理深链可采用 `/admin/...`,确认前端回退配置并保留原入口。搜索弹窗支持 Cmd/Ctrl+K,结果按类型携带稳定 ID,进入对应详情而非仅切换模块;覆盖笔记、博客、素材、书签、RSS、待办、日程、代码片段、提示词、AI 会话和图片,未交付的模块随其上线纳入。
|
||||
|
||||
## 3. 关键流程和数据规则
|
||||
|
||||
### 公开发布
|
||||
|
||||
- **现状**:公开博客直接读已发布文章;公开书签接口及图标接口目前没有可见性过滤,所有现有书签可被匿名列出。V4 原型首次发布可能默认全选书签,发布函数传入全量提示词开关,空模型白名单也可能回退到全部。正式版不继承这些默认行为。
|
||||
- **目标**:发布面板列出符合条件的文章,允许明确勾选书签、提示词、模型及图片,并设置访客生图。新建书签/提示词/图片默认私有,空白名单代表关闭全部模型,生图默认关闭。发布前预览数量,显示最近成功时间及「有改动待同步」,支持导出同一份公开数据 JSON。
|
||||
- **建议契约**:`GET /api/v1/publication` 返回待发布预览、当前发布版本、时间和差异;`POST /api/v1/publication` 按预览版本原子提交,只生成允许公开的字段与资源引用,返回新版本和各模块数量。公开接口保留原路径和可兼容字段,以服务器发布版本作为 ETag 的一部分。发布失败保留旧版本并显示原因。草稿化、取消公开、移入回收站、禁用模型或关闭生图立即在服务端撤销可见性/执行权;恢复只回私有区或草稿,重新公开需显式操作。
|
||||
- **迁移**:升级前列出现有公开博客、书签及图片引用。已有已发布博客可作为首版基线保留原 slug;现有书签在管理员明确勾选前不进入新发布清单。切换时同时替换匿名列表、详情和图片的权限条件;验证清空选择、缓存更新、直接访问旧图标地址和无登录的新设备。公开响应不得含供应商凭据、内部日志或未选内容。
|
||||
|
||||
### 回收站与版本
|
||||
|
||||
- 笔记、博客、书签、图床素材、日程、代码片段的单条及批量删除统一进回收站。现有四类 DELETE 需改为软删除;所有常规列表、搜索、计数和公开读取排除已删除。图床保留文件字节直到永久删除;有活跃引用的素材永久删除前显示影响并拒绝操作,待引用解除后重试。
|
||||
- 建议保留源记录及 ID,增加删除时间并用统一回收站视图查询;`GET /api/v1/trash` 支持按类型分页,`POST /api/v1/trash/{kind}/{id}/restore` 恢复,`DELETE /api/v1/trash/{kind}/{id}` 永久删除。原分类/文件夹还在则回原位置,缺失则提示选择替代位置;恢复失败保留记录,成功写入通知。清空需要明确确认与逐项结果。
|
||||
- 笔记的有效保存(含自动保存)在同一事务中记录保存前的标题、正文、分类、文件夹、标签等,再提交正文与版本号;无变化不生成重复快照。历史使用不可变版本 ID,可按笔记分页查询/预览。恢复前再存当前版本,使用现有乐观锁;冲突返回 409 并保留编辑稿。编辑器两个导出入口生成相同 UTF-8 Markdown,YAML 用序列化器处理标题、标签、换行和特殊字符。保留策略独立配置,不沿用原型数组截断作为生产规则。
|
||||
|
||||
### 模块联动与 AI
|
||||
|
||||
- RSS → 笔记、待办、收集箱;笔记 → 博客草稿,博客 → 可编辑笔记;书签 → 收集箱(含网址和描述),素材 → 收集箱(元数据和内部引用);收集箱 → 笔记/书签/待办。保留来源 ID 或链接,创建成功后才更新收集状态,重试不重复创建。完成后提供打开目标入口。
|
||||
- 笔记 AI 助手、笔记配图、博客封面和 RSS 摘要进入对应 AI 模式并预填提示词;引用卡片按 ID 打开原文,再返回时保留对话和未发送草稿。生成结果经用户选择可存图床并作为封面;生成过程不自动发布或修改正文。
|
||||
- 输入限制统一为 8000 字符;后台按原型在预填/提交前提示并提供截断后的可编辑预览,访客侧超限显示计数、禁用发送;后端按相同计数规则校验并拒绝超限。访客发送时重新校验模型 ID、供应商及能力开关,公开接口只返回可展示字段。凭据仅后端保存;AI 失败保留草稿,日志和用量只记录必要字段,访客调用设置频率、用量限制和超时。访客历史与管理员会话隔离。
|
||||
- RSS 抓取、AI 服务和工作流接入前,UI 只展示可用能力。正式 RSS 刷新显示成功时间与失败状态,按来源和文章标识去重;自动化执行和工具接入后单独定义权限、运行记录与失败恢复。
|
||||
|
||||
## 4. 实施顺序
|
||||
|
||||
| 批次 | 工作包与交付条件 |
|
||||
|---|---|
|
||||
| A:发布边界和 UI 骨架 | 统一后台壳、工具入口、三张公开页入口规则;完成公开书签和图片过滤、发布面板及发布版本;改造已存在的公开博客/导航并保留旧链接。AI 页可先显示能力关闭状态。 |
|
||||
| B:现有模块完整流程 | 笔记、博客、图床、书签扩展字段和编辑交互;同批接入统一回收站、笔记版本与 Markdown 导出。验证现有库升级、分类和原 slug。 |
|
||||
| C:新增本地业务 | 收集箱、效率中心、标签/批量、通知、全局搜索、备份;补齐笔记/博客/素材/书签之间的联动。新增模块随交付接入搜索与回收站。 |
|
||||
| D:外部服务 | RSS 订阅与真实抓取、AI Studio 与公开 AI、用量与日志、自动化和浏览器工具的后端接入。分别验证权限、失败恢复与实际调用;按能力开放。 |
|
||||
|
||||
开发入口:`frontend/src/main.ts` 负责公开页入口,`App.vue` 是现有后台,`api.ts` 是接口层;按模块拆出页面与状态,复用 Markdown 和素材组件。后端沿用现有 controller、认证及集成测试,从下一未使用的 Flyway 版本开始(当前目录最大 V16)。迁移新增字段先回填再约束;保留现有 UUID、slug、分类关系和文件引用。不改已应用 SQL。不自动导入 HTML 原型示例;若后续需要迁移真实原型数据,应走带校验和预览的显式导入,包含旧回收站按类型和源 ID 去重。
|
||||
|
||||
## 5. 验收清单
|
||||
|
||||
| 编号 | 验收场景 |
|
||||
|---|---|
|
||||
| V4-01 | 工具中心七个入口均打开对应页面;面包屑、高亮、浏览器返回和刷新后的路由一致;无重复一级导航。 |
|
||||
| V4-02 | 六种支持对象单条删除、各支持模块批量删除后,从列表、搜索及公开页消失;恢复保持 ID 和分类或明确要求重选;永久删除后不可恢复。 |
|
||||
| V4-03 | 自动和手动保存分别产生有效历史,无变化不重复;可预览、恢复且恢复前留档;并发冲突不覆盖另一稿。两个导出入口能下载并解析含特殊字符的 YAML。 |
|
||||
| V4-04 | 在无登录的新浏览器验证已发布文章、选中书签/提示词/图片和白名单模型;草稿、未选内容、直链图片及空模型名单不泄露。失败保留原发布版本,撤回后重新请求拿不到旧内容。 |
|
||||
| V4-05 | 公开博客分类与搜索组合可用,详情直链和返回正常;公开导航分组正常;三张公开页均无互跳或后台入口,后台仍可打开三页。 |
|
||||
| V4-06 | AI 历史/素材筛选可切换;禁用模型后默认项修正;无生成/无收藏状态不同;8000 和 8001 字符边界前后端一致;关闭生图后访客既不能从 UI 发送也不能直接调用。 |
|
||||
| V4-07 | 笔记引用回原文后返回 AI 草稿仍在;配图/封面预填正确;搜索同名结果打开各自 ID;RSS/收集箱转存失败后仍可重试且不重复创建。 |
|
||||
| V4-08 | 按 1150、900、680、430px 断点两侧及 360px 检查工具中心、编辑器、设置、AI 和三张公开页;深浅色、键盘焦点、弹窗关闭后焦点恢复、错误提示可见、页面无横向溢出。 |
|
||||
| V4-09 | 用空库和已有数据各跑一次迁移;已有公开文章 slug、登录、笔记、上传下载继续工作。备份导入预览及错误分支不改原有数据。 |
|
||||
|
||||
每批在后端集成测试覆盖访问权限、迁移和状态变化,在浏览器验收端到端关键流程。原型 README 中的 24 项后台和 7 项公开页通过记录仅作为原型历史,不能替代工程验收;当前实现范围见工程 README。
|
||||
@@ -0,0 +1,77 @@
|
||||
# 第一阶段验收记录
|
||||
|
||||
日期: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`,不进入搜索引擎。
|
||||
Reference in new issue
Block a user