Files
MySpace/docs/handoff.md
T

3.7 KiB
Raw Blame History

第一阶段交付

工程:/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 中拒绝示例值。