chengma/cmroubao
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Page: T-234
Pages
00-ai-start-here 01-vision 02-requirements 03-tech-stack 04-architecture 05-coding-rules 06-tasks 07-user-stories 08-interaction-checklist Design Home Integrations-shunyunbao-contract PPT T-001 T-002 T-003 T-004 T-101 T-102 T-103 T-104 T-201 T-202 T-203 T-204 T-205 T-206 T-207 T-208 T-209 T-210 T-211 T-212 T-213 T-214 T-215 T-216 T-217 T-218 T-219 T-220 T-221 T-222 T-223 T-224 T-225 T-226 T-227 T-228 T-229 T-230 T-231 T-232 T-233 T-234 T-235 T-236 T-237 T-238 T-239 T-240 T-241 T-242 T-243 T-244 T-245 T-246 T-247 T-248 T-249 T-250 T-251 T-252 T-253 T-254 T-255 T-256 T-257 T-258 T-259 T-260 T-261 T-262 T-263 T-264 T-265 T-266 T-267 T-268 T-269 T-270 T-271 T-272 T-273 T-274 T-275 T-276 T-277 T-278 T-279 T-280 T-281 Task-Template Tasks agent-context api clean-state-checklist current-state routes
Clone
1
T-234
ila edited this page 2026-08-07 16:36:48 +08:00
Table of Contents

同步来源：docs/tasks/T-234.md · commit afc651f75a3a

id: T-234 title: 在受控 ERP 诊断模式输出 OCR 验证码文本 phase: 2 deps:

  • T-233 status: DONE created: 2026-07-29 context_ref: 1e703ef work_branch: null write_paths:
  • docs/tasks/T-234.md
  • docs/api.md
  • docs/current-state.md
  • backend-api/internal/platform/shunyunbao/**

问题 / 背景

现场受控 ERP 日志显示登录 JSON 为 status=false 且 msg=图片验证码不正确。这表明 ERP endpoint 可达且已处理登录请求，当前无法确认本机 OCR 为该次验证码返回了什么文本。T-233 有意不记录验证码/OCR 文本，导致无法区分 OCR 识别错误、大小写/字符集规则差异或 ERP 验证码 协议变化。

方案

  1. 仅在已有 CMROUBAO_ERP_DEBUG_LOG=true 或 start-backend.bat --erp-debug 的受控模式中， 在 OCR 成功返回后、登录前记录本次实际提交的有效验证码文本和长度。
  2. 无效、空白、过长或含控制字符的 OCR 输出只记录 ocr_result class=invalid，绝不记录原文； OCR client error 只记录 class=failed，不输出响应 body。
  3. 保持验证码图片、ticket、Cookie、登录 payload、账号密码及常规生产日志不可见；调试开关默认 关闭，诊断结束后关闭。
  4. 固定 session 测试，断言有效 OCR 文本仅在 diagnostics 开启时输出，非法文本、图片和凭证 均不泄露。

验收要点

  • 当前验证码错误场景可在 ERP 登录请求前看到 erp_ocr_result value=... length=...。
  • diagnostics 关闭时不记录 OCR 文本；无效/OCR 失败不记录其原始输出或错误正文。
  • 验证码图片、ticket、Cookie、账号密码和登录 payload 不进入日志。
  • 标准 Go 验证和入口构建通过。

边界

  • 不修改 OCR endpoint、验证码请求、ERP 登录协议、重试或同步 schema。
  • OCR 文本仅为短时人工诊断用途，不持久化、不发给浏览器/API；不得用于绕过验证码或自动重试。

执行记录

  • 2026-07-29：创建任务。现场 ERP 返回“图片验证码不正确”，因此进入受控 OCR 文本观测； 当前证据不足以断言是 OCR 准确率、验证码规则还是外部 ERP 协议变化。
  • 2026-07-29：在有效 OCR 识别后、ERP 登录前增加仅 diagnostics 可见的转义文本/长度日志； OCR failed/invalid 只记录 class。固定测试覆盖图片、凭证、无效文本和 OCR error 不泄露； 标准 Go 测试、race、vet 及 api/migrate/authctl 构建均通过。