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