diff --git a/logs/phase2_log.md b/logs/phase2_log.md index 5f7dece..1a6509c 100644 --- a/logs/phase2_log.md +++ b/logs/phase2_log.md @@ -315,4 +315,78 @@ CREATE INDEX idx_episodes_broadcast_date ON episodes (date_part('year', broadcas |--------|------| | 442d52f | feat: 完善批量导入逻辑,8步冒烟全绿 | -*本日志由 MiniMax M2.7(Cline Act 模式)于 2026-05-15 持续追加,2026-05-19 追加 Task 2 完工坑与红线澄清。* +*本日志由 MiniMax M2.7(Cline Act 模式)于 2026-05-15 持续追加,2026-05-19 追加 Task 2 完工坑与红线澄清,2026-05-20 追加 Task 2 收尾记录。* + +--- + +## 十一、Task 2 收尾完工记录(2026-05-20) + +### 11.1 Git 安全卫生:token 从 URL 剥离 + +**背景**:`.git/config` 里 origin 远程 URL 含明文 token(`cline-tps-dashboard`), +存在被 Cline 误贴日志、截图泄露、备份带出等风险。 + +**改动**: +- `git remote set-url origin` 改成干净 URL(去掉 `user:token@`) +- token 改由 Windows Git Credential Manager (manager) 加密存储 +- 两次 fetch 静默通过,push 走 GCM 透明工作 +- 旧 token `cline-tps-dashboard` 继续使用,不吊销 + +**纪律备注**:以后任何凭证(密码、API key、token)都不许写进 URL、不许写进 .py 文件、 +不许写进任何会被 commit 的文件。 + +### 11.2 小尾巴 1:补录 2024 真值 + +**操作**:制片人手动 psql 直接 INSERT(绕过 API,因 API 权限收紧待办未做)。 + +**当前 yearly_targets 真值**: +- 2024: base=0.6448 / stretch=0.8290 (issued_date=2024-01-01, 补录说明在 notes) +- 2025: base=0.6448 / stretch=0.8989 +- 2026: base=0.6448 / stretch=0.8989 + +### 11.3 小尾巴 3:backups/ 进 .gitignore + +**commit**:20c0a1d(chore: backups/ 进 .gitignore) +**push**:已成功 + +### 11.4 小尾巴 4:schema 类名自查通过 + +类名与 Task 2 Plan 一致,无漂移。`ImportError` / `ImportResult` 命名正确。 + +发现 2 个隐患,**暂不处理,记为待办**: +- 隐患 A:`ImportError` 与 Python 内置同名,当前未撞,未来若在导入逻辑里 raise 才会冲突 +- 隐患 B:`ExcelService.import_episodes()` 返回 dict 而非 Pydantic 对象, + API 层手动构造 `ImportResult`,缺一次 Pydantic 校验层。8 步冒烟已验证业务正确, + 仅代码洁癖问题 + +### 11.5 小尾巴 2:Python PATH 根治坑 4 + +**改动**:从系统 PATH 删除 `C:\Python314\Scripts\` 和 `C:\Python314\` 两行。 +用户 PATH 中 Python 3.12 自动顶上来。 + +**验证**: +- `where.exe python` 第一行变成 3.12 路径 +- `python --version` = Python 3.12.10 +- `sys.executable` 指向 3.12 + +**遗留**:E:\tps-dashboard\backend\ 下没有 venv,Python 依赖装在系统 3.12 全局 +site-packages 里。**记入待办**,Phase 4 部署前或 Task 3 启动前评估是否补 venv。 + +### 11.6 待办清单(Task 3 启动前或后续 Phase 处理) + +| 待办 | 触发时机 | 优先级 | +|---|---|---| +| `yearly_targets` 写权限收紧到 `zhipianren` + `zebian`,`biandao` 只读 | Task 3 启动前 | 高(业务红线) | +| backend/ 补 venv,把全局依赖搬进去 | Task 3 启动前评估 | 中 | +| 隐患 A:`ImportError` 同名冲突预防 | 真要 raise 时再说 | 低 | +| 隐患 B:`ExcelService` 返回 Pydantic 化 | 代码洁癖,有空时做 | 低 | + +### 11.7 Task 2 完整 commit 链(2026-05-19 → 2026-05-20) + +| commit | 内容 | +|---|---| +| 442d52f | feat: 完善批量导入逻辑,8步冒烟全绿(2026-05-19) | +| 6de8111 | docs: Task 2 完工记录,坑7/8/纪律3/Q1-Q4 写入(2026-05-19) | +| 20c0a1d | chore: backups/ 进 .gitignore(Task 2 收尾)(2026-05-20) | + +**Task 2 完整收尾,Phase 2 Task 2 状态:✅ 完工。**