xinyouhe/photo-live
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(plan): record M0 completion (tasks 1-3, port conflict resolution, quay.io deviation)

Browse Source 
Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
浅念
2026-09-17 16:50:43 +08:00
parent 538fdd46dd
commit 9dc530feaf
1 changed files with 4 additions and 7 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/plans/2026-09-17-P1a-后端核心链路.md
+4 -7
View File
@@ -16,7 +16,7 @@
- [ ] D01 首发语言：按建议值 zh-CN、en 开发（不确认则默认执行） - [ ] D01 首发语言：按建议值 zh-CN、en 开发（不确认则默认执行）
- [x] D12 生产 MySQL 版本：已确认 8.0+（2026-09-17）；本地容器用 MySQL 8.4 对齐，迁移仅使用 8.0 兼容特性。**注意**：库级默认校对 `utf8mb4_0900_bin` 需 MySQL ≥ 8.0.30——部署前在验收记录登记两台 ECS 的精确小版本；若低于 8.0.30 则回退 `utf8mb4_bin`（同样大小写敏感）并重跑语义测试。 - [x] D12 生产 MySQL 版本：已确认 8.0+（2026-09-17）；本地容器用 MySQL 8.4 对齐，迁移仅使用 8.0 兼容特性。**注意**：库级默认校对 `utf8mb4_0900_bin` 需 MySQL ≥ 8.0.30——部署前在验收记录登记两台 ECS 的精确小版本；若低于 8.0.30 则回退 `utf8mb4_bin`（同样大小写敏感）并重跑语义测试。
- [ ] 本机环境：`node -v` ≥ 20、`pnpm -v` ≥ 9、`docker -v` 与 `docker compose version` 可用（Windows + Docker Desktop） - [x] 本机环境：已验证（node v24.13.0、pnpm 10.7.1、Docker 29.2.1 + Compose v5.0.2；3306/6379 与其他项目容器的冲突已由用户决策解决——停用 x-server-mysql/redis 并取消自启）
--- ---
@@ -199,15 +199,11 @@ AUTH_SESSION_TTL_SECONDS=2592000
UPLOAD_MAX_BYTES=52428800 UPLOAD_MAX_BYTES=52428800
``` ```
- [ ] **Step 2: 启动并验证** - [x] **Step 2: 启动并验证**（完成：全部 healthy；collation=utf8mb4_0900_bin；photo_cn 库与 photo-dev bucket 就绪；**偏差登记**：minio 镜像改用 quay.io/minio/*（Docker Hub 官方仓库已删除），P2 ov 侧沿用）
```bash
cd infra && docker compose up -d && docker compose ps
```
Expected: mysql-cn / redis-cn / minio / minio-init 均 healthy 或 exited(0)（init 为一次性任务）。 Expected: mysql-cn / redis-cn / minio / minio-init 均 healthy 或 exited(0)（init 为一次性任务）。
- [ ] **Step 3: Commit** `chore(infra): cn-side mysql/redis/minio compose` - [x] **Step 3: Commit** `chore(infra): cn-side mysql/redis/minio compose`（完成：538fdd4，含 packageManager→pnpm@10.7.1 对齐）
--- ---
@@ -647,6 +643,7 @@ export interface StoragePort {
- 每任务 TDD 节奏不可跳步：先失败测试→实现→通过→提交；集成/E2E 测试统一跑在 compose 依赖上（`docker compose up -d` 前置）。 - 每任务 TDD 节奏不可跳步：先失败测试→实现→通过→提交；集成/E2E 测试统一跑在 compose 依赖上（`docker compose up -d` 前置）。
- e2e 隔离：每个 e2e spec `beforeAll` 调 `test/reset.ts`（truncate cn 全表 + 清 MinIO `photo-live/dev` 前缀）；worker/storage 测试沿用同约定（各自包内复制 reset 工具或引用）。 - e2e 隔离：每个 e2e spec `beforeAll` 调 `test/reset.ts`（truncate cn 全表 + 清 MinIO `photo-live/dev` 前缀）；worker/storage 测试沿用同约定（各自包内复制 reset 工具或引用）。
- 基础设施注意：minio 镜像统一用 `quay.io/minio/*`（Docker Hub 官方仓库已删除，P2 ov 侧同样）；跑 prisma/集成测试前先确认宿主端口实际指向 photo-live 容器（`docker port photo-live-mysql-cn-1`），Docker Desktop 重启可能拉起其他项目容器抢占 3306/6379（已对其设 restart=no，但新冲突可能来自其他来源）。
- env：命令一律在仓库根执行；根 `.env` 为唯一 env 文件，脚本经 dotenv-cli 注入、测试经 `test/load-env.ts` 载入（Task 7 约定；`services/worker/test` 与 `packages/storage/test` 复制同约定 load-env.ts——两者到仓库根同为三级向上，路径一致）；新增 env 变量必须同步 `.env.example`；密钥不入库。 - env：命令一律在仓库根执行；根 `.env` 为唯一 env 文件，脚本经 dotenv-cli 注入、测试经 `test/load-env.ts` 载入（Task 7 约定；`services/worker/test` 与 `packages/storage/test` 复制同约定 load-env.ts——两者到仓库根同为三级向上，路径一致）；新增 env 变量必须同步 `.env.example`；密钥不入库。
- 发现契约需变更时：先改 `packages/contracts` 并重新生成类型、在任务提交信息中登记，再改消费端（契约单一事实源）。 - 发现契约需变更时：先改 `packages/contracts` 并重新生成类型、在任务提交信息中登记，再改消费端（契约单一事实源）。
- 与总纲冲突处以总纲为准并回写修订；HEIC、MySQL 行值比较等 D12 复核项结论写入验收记录。 - 与总纲冲突处以总纲为准并回写修订；HEIC、MySQL 行值比较等 D12 复核项结论写入验收记录。