Files

33 lines
3.7 KiB
Markdown
Raw Permalink 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.
# 第一阶段交付
工程:`/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` 中拒绝示例值。