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