3.7 KiB
第一阶段交付
工程:/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中拒绝示例值。