Просмотр исходного кода

report(dev-lead5): 第4轮续报 07:25 — B-2/B-4 交付+部署派发、B-3/B-5 新派发、B-6/B-7 台账失真、派发链路排障(MSYS_NO_PATHCONV)

Agnes Agent 2 недель назад
Родитель
Сommit
fa0cc2ed32
1 измененных файлов с 140 добавлено и 0 удалено
  1. 140 0
      docs/tdd/orchestration/report-dev-2026-11-04-0725.md

+ 140 - 0
docs/tdd/orchestration/report-dev-2026-11-04-0725.md

@@ -0,0 +1,140 @@
+# 研发负责人工作汇报(TDD 闭环 · 2026-11-04 07:25)
+
+> 汇报人:研发负责人5(自动化 `298dcf47-5a57-4005-ad8d-e4948e8534af`,本会话续轮)
+> 汇报周期:2026-11-04 07:00 ~ 07:25(第 `4` 轮续)
+> 承接上轮:`report-dev-2026-11-04-0700.md`
+> 角色纪律:研发侧只做调度与核验,不代写业务代码、不代写 RED;派发纪律段由 hub 统一注入
+
+---
+
+## 一、本轮结论速览
+
+| 项 | 结论 |
+|---|---|
+| B-2 | **开发完成并已推送** `14f14b580`;testing 部署**已派发**(`ses_e5c543e16ffe`),部署中 |
+| B-4 | **开发完成并已推送** `eb4b79b4`;testing 部署**已派发**(`ses_e5c525bd6ffe`),部署中 |
+| B-3 | **新派发** lan-248 `ses_e5c464ae5ffe`(上传 MIME/扩展名/魔数三层校验) |
+| B-5 | **新派发** lan-248 `ses_e5c458d87ffe`(Result 4xx 工厂方法 + 调用点迁移) |
+| B-6 / B-7 | **台账失真,本轮不派单**(详见第四节)——测试早已入库且实跑全绿,实为「登记脱节」而非「开发待办」 |
+| B-1 | 仍归研发负责人1(全量单测基线复跑),本轮继续避让 |
+
+---
+
+## 二、开发任务交付核验(B-2 / B-4)
+
+### B-2 · admin-auth login 错误语义(`14f14b5804d2960ed0c7fbf10ac553da33ae62cb`)
+
+- 分支:`feature/b2-admin-auth-login-status`(远端已确认),基线 `origin/cfclub@8f02a8b36`,单提交
+- 改动:`AdminAuthController.java`(27 行)+ 新增 `AdminAuthControllerLoginStatusTest.java`(250 行 / 10 case)
+- 修复实质:`@RequestBody(required = false)` + `dto == null` 先判空(消除 NPE);缺参/手机号格式非法由 `Result.error(String)`(恒 500)改为 `Result.error(400, …)`;`login-by-password` / `send-code` 同面公开端点一并治理
+- 开发自报:`mvn clean compile` 通过、`mvn test -Dtest=AdminAuthController*Test` **10/10 通过**、`cfc-web npm run build` 通过
+- ⚠ **过程中发生提交落错分支**(共享工作区被 B-4 会话切分支干扰,提交一度落到 b4 分支上),B-2 会话已用 `git branch -f` 归位并重新 push;**远端已复核确认 b2 分支 tip = 14f14b580、commit 内容与提交信息一致**
+
+### B-4 · butler envelope + commission 400(`eb4b79b47593ba0b599983689083839c5953b388`)
+
+- 分支:`feature/b4-butler-envelope-commission`(远端已确认),基线同为 `8f02a8b36`
+- 改动 6 文件:后端 4(`AdminButlerController` 8 行 / `AdminCommissionConfigController` 10 行 + 两个契约测试类 139+128 行)+ 前端 `cfc-web/src/views/admin/review/ButlerAudit.vue` 2 行 + e2e `tests/e2e/admin-commission-config.spec.js` 4 行
+- F1:butler `user-list` / `list` / `service-records` / `settlements` 四个列表 `data.put("list")` → `data.put("records")`,与活动列表等管理端契约对齐;前端消费点同步
+- F2:commission config 400 根因查明为 **E2E payload 与实体字段不匹配**(`percent/ratio/label/status` vs `name/rate/rateType/remark`),`name` 缺失触发表 NOT NULL 异常;修复为参数校验前置(空 body / 缺 name → 400 + 明确 message),并修正 e2e payload
+- 开发自报:`mvn compile` 通过、两个新测试类 **9/9 通过**、本地实跑 5 个 butler 列表均返 `records`、cfc-web build 通过
+- ⚠ B-4 会话同样遭遇共享工作区分支被切(B-2 归位操作影响),已自行重建状态并复核「改动完好、base 正确」
+
+### 远端一致性抽查
+
+- `git ls-remote` 确认 b2/b4 两分支 tip 与本地核验一致;b4 分支前端改动**确已在提交内**(初次 `--stat` 截断造成的疑虑已用 `git diff base..tip --stat` 复核排除)
+
+---
+
+## 三、部署分派(职责要求:开发完成 → 派发 testing 部署)
+
+| 任务 | commit | 部署会话(pub-iwintrue) | 状态 |
+|---|---|---|---|
+| B-2 | `14f14b580` | `ses_e5c543e16ffefgsb9LlJHdgw5U` | 已受理,构建产物已备(`/home/iwt/cfc-backend-1.0.0.jar` 已替换);正等待 cron 部署释放锁 |
+| B-4 | `eb4b79b4` | `ses_e5c525bd6ffeuPPVZGOpqZutgX` | 已受理,独立 worktree(`/tmp/opencode/cfc-build`)检出目标 commit,后端 package 完成,前端构建中 |
+
+两会话均已按 `cfc-deploy-251.sh` 部署链规范执行。B-2 部署会话额外取得一处实证验证点:线上 `GlobalExceptionHandler` 对空 body JSON 解析错误返 400,但 `{}` 空对象返 **500**——正是 B-2 修复要改变的语义(修复后应 400)。
+
+**收口条件**:部署真实成功后,分别执行
+`tdd_orchestrate.py --deploy-done testing --commit <sha>` 写入 `last_deployed`,再由测试侧 `--mark-green` 放行。
+
+---
+
+## 四、B-6 / B-7 台账失真(本轮新发现,不派单)
+
+台账称二者为「TDD 状态机 RED 键停滞超 25h,测试侧 RED 已写,需开发实现使绿」。**逐项核查后与事实不符**:
+
+| 键 | 台账描述 | 实际核查结果 |
+|---|---|---|
+| `health.report.createReport` | RED 停滞、待开发实现 | 测试类 `HealthReportControllerCreateReportTest.java`(5 case)**已于 11-03 22:08 入库远端**(`81d8883f7`,提交信息明写「入库两个**已全绿**契约测试类(12 例)… Tests run: 12, Failures: 0」);实现 `HealthReportController.createReport` 早已存在 |
+| `dan.assessment.getActiveMaterial` | RED 停滞、待开发实现 | 测试类 `DanAssessmentControllerGetActiveMaterialTest.java` **已于 11-02 23:45 入库远端**(`faf3ca174`,修复 `setName`→`setTitle` 编译阻断,3 例全绿);实现 `DanAssessmentController.getActiveMaterial` 早已存在 |
+
+**真相**:两者不是「开发待办」,而是**状态机登记脱节**——`state.json` 仅 4 键(addMember/getPlanList DONE、listMembers YELLOW、getPlanDetail RED),这两个键从未 `--mark-red` 入账,故「停滞」是账面现象。
+**处置**:不派开发单(派了也是空转);建议由**测试侧**补做 RED→GREEN 登记闭环,或由测试负责人清理台账口径。研发侧不代写测试、不手改状态机。
+
+---
+
+## 五、B-5 方案定稿与派单(从「等分型产物」改为「先修根因」)
+
+上轮结论为「需测试侧先交付 `interface_classify_failures.py` 分型产物(49 条端点清单)方可派单」。本轮核查:
+
+- 该脚本**不在本仓**(`find` 全仓无命中);49 条 REAL_ERR 端点清单**亦未入库**(`git grep REAL_ERR` 仅命中 4 个 md,无清单文件)——继续等将无限期阻塞
+- 但测试侧 `automation-run-2026-11-03-1316.md` 的 **P8 段落已给出与研发侧完全一致的根因与最优方案**:
+  - 根因:`common/Result.java:37-39` `error()` 硬编码 `setCode(500)`,参数缺失/无权限/不存在全部伪装成服务器错误;冒烟 `SERVER_ERR` 恒 0 属**假安全信号**
+  - 方案:新增 `badRequest(400)/forbidden(403)/notFound(404)/conflict(409)` 工厂方法;冒烟脚本按 `code+message` 分桶(`ops_interface_smoke.py` 的 `biz==200` 二值判定同步改);连续 2 轮 `REAL_ERR=0` 视为闭环
+- 补充现状:`Result.java` 已有 `error(String)`(恒 500)与 `error(Integer, String)`(透传)双实现,B-2 修复已直接用 `error(400, …)` 走对方向
+
+**据此派单(B-5 第一批 · 结构级)**:`feature/b5-result-4xx-factories`
+1. 新增 4 个 4xx 工厂方法(纯新增,不动既有签名,零破坏)
+2. 新增 `ResultCodeFactoryTest` 覆盖 4 方法 + 两条既有方法的防回归断言
+3. **明确不做**全仓 318 处 `Result.error()` 的大规模迁移(那是分批计划),只迁本单覆盖调用点
+4. 冒烟脚本 `EXPECTED_DENY` 分桶改造由测试侧负责(P8 第 3 步),研发侧只做后端工厂方法
+
+会话:`ses_e5c458d87ffeMCClTi8jo0KiSh`(lan-248 / axonhub/deepseek)。
+
+---
+
+## 六、B-3 派单(安全类,此前未认领)
+
+**缺陷**(`test_blockers.md` R6 / `blockers.md` B-3):报告上传未做 MIME / 扩展名 / 内容校验,非 PDF 内容未被拒(非 4xx),存在恶意文件上传与存储风险。
+
+**定位**(git grep 实证):`DanReportController.upload`(`POST /api/dan-report/upload`,DanReportController.java:29-31)、`ReportParserController.upload`(`POST /api/report-parser/upload`,:94-96),并要求一并扫描 HealthReportController 同类入口。
+
+**修复要求**:三层校验(Content-Type 白名单 → 扩展名仅 `.pdf` → PDF 魔数 `%PDF-` 兜底防伪造);非法一律 4xx(`Result.error(400, …)` 或 415 语义),绝不可 500、不可静默接受;校验逻辑抽公共方法复用;正常 PDF 路径零行为变更;含空文件保护。
+
+**验收**:非 PDF / 空文件 / 合法 PDF 三类契约用例,两条上传端点各自覆盖。
+
+会话:`ses_e5c464ae5ffeepkpIXHU5ir0gm`(lan-248 / axonhub/deepseek)。
+
+---
+
+## 七、派发链路故障与修复(本轮排障记录)
+
+`hub.py dispatch --instance lan-248` 连续两次返回 `[不可达] 实例 lan-248 不可达: HTTP 500 (无正文)`,而 `hub.py instances` 探测 6/6 全可达、`peek_session` 正常。
+
+排障结论与过程:
+1. 直接 `curl POST /session` → **405**(漏了 `/api` 前缀)→ 修正路径后 → **401**(未带认证)
+2. `resolve_password` 链路确认:密码不在 `XAF_HUB_PW_LAN_248` 环境变量(Windows User/Machine/Process 三处作用域均无),而在 `config.local.json` 的实例级覆盖 `{"lan-248": {"password": "..."}}`;curl 带该密码 → **200 创建成功**(证明服务端与认证均正常)
+3. `--debug --dry-run` 暴露真凶:hub 把 `--dir /sc-data/cfc` 经 Git Bash 转成了 **Windows 路径** `E:\develop\WorkBuddy\...\PortableGit\sc-data\cfc`,服务端据此创建会话失败(500)
+4. 修复:派发前 `export MSYS_NO_PATHCONV=1` → 目录正确传为 `/sc-data/cfc` → **派发成功**
+
+> 注:此为 Git Bash 路径转换的老坑,远程 Linux 实例(lan-248 / pub-iwintrue)派发时必须加 `MSYS_NO_PATHCONV=1`;`--dry-run` 打印的「目录」字段是快速自检点。
+> 本轮教训:凡「实例可达但 dispatch 500」,先用 `--debug --dry-run` 看目录字段是否被转成 Windows 路径。
+
+---
+
+## 八、待办与下一步
+
+| 事项 | 责任 | 状态 |
+|---|---|---|
+| B-2 部署完成 → `--deploy-done testing --commit 14f14b580` | 研发侧(编排) | 部署中,待收口 |
+| B-4 部署完成 → `--deploy-done testing --commit eb4b79b4` | 研发侧(编排) | 部署中,待收口 |
+| B-3 / B-5 开发完成 → 派发 testing 部署 → `--deploy-done` | 研发侧(编排) | 开发中 |
+| B-6 / B-7 登记脱节 | **测试侧**(补 RED→GREEN 登记或清理台账口径) | 已上报,不派开发单 |
+| B-5 后续批次(49 条 REAL_ERR 端点逐条认领) | 待测试侧补分型清单入库 | 根因单已先行,清单到货后分批 |
+| S-cfc-6(getPlanDetail)RED | 测试侧 | TR-1 已送达,待测试角色写 RED 并 push |
+| B-1 全量单测基线复跑 | 研发负责人1 | 避让中,仅跟踪 |
+
+---
+
+> 提交铁律:本报告经 `git commit` + `git push` 至 `origin/cfclub`(data_ref)后方为送达。
+> 本轮零改动主工作树(`E:/cfc` 有 43 处其他会话遗留改动,未 add、未 checkout、未 stash)。