refactor: strengthen client boundaries and quality gates

2026-08-28 14:26:58 +08:00
parent 3af145abe5
commit ad27acad7e
51 changed files with 7703 additions and 697 deletions
@@ -4104,3 +4104,19 @@ git diff --check
 - 采用两阶段密码安全发布并在每次覆盖前重新建恢复资产：`code-quality-before-d85ff859-20260828T035007Z`、`code-quality-compatible-d85ff859-20260828T035426Z`、`code-quality-before-fc4a6a7-20260828T040150Z`。三份均含PostgreSQL custom dump、运行目录、配置、Redis RDB、MinIO数据、状态快照、回退说明和SHA-256；恢复清单、pg_restore、tar和Redis校验通过。
 - 最终收尾为95/95迁移、11项服务active、入口HTTP 200、API/Gateway健康、Redis PONG、`gateway.submit.results pending=0/lag=0`，发布后7项核心服务error级日志均0。浏览器真实登录页完整且控制台error/warning为0；未自动输入账号密码/验证码，登录后深层页面仍保留为人工浏览器验收边界。
 - 本轮没有发送短信、压测、修改余额/应用/通道或写入MinIO业务对象，也没有执行新的CMPP模拟器全链；两个SendChain超大Service未在安全发布中做高风险重构。完整证据和保留项见`docs/code-quality-remediation-result-20260828.md`。只操作测试环境`100.93.204.60`，预生产未访问或修改。
+
+## 2026-08-28 代码质量 V2 复评与测试环境健康探测校正
+
+- 固定`3af145abe5eb8cae567bb18e29116b4940889258`基线重新复评，原两个P0在代码、单测和结构门禁层面均已关闭；API 47套543项、全源覆盖率59.84/51.29/60.15/62.60、前后端构建、bundle budget、Gateway全包测试/go vet、Prisma及队列契约通过。正式报告为`docs/code-quality-reassessment-20260828-v2.md`。
+- 首次外部健康探测时本机开启Clash虚拟网卡/代理，`100.93.204.60:12026/api/health`曾连续返回HTTP 502。关闭Clash后使用`curl --noproxy '*'`明确绕过代理，连续3次均返回HTTP 200、`status=ok`，总响应约19～28ms，TCP 12026可连接；因此撤销“测试环境502”P0判定，确认为本地代理干扰，不是服务端故障。
+- 本轮SSH只读认证未成功，未独立读取部署标记、内部服务、Redis Stream、migration和服务器日志；这些运行态项目继续保留为预生产前复核边界。未部署、未重启服务、未写库、未发送短信、未压测，预生产未访问或修改。
+
+## 2026-08-28 代码质量持续优化执行
+
+- 按`docs/code-quality-continuous-optimization-plan-20260828.md`实施非“暂不建议投入”项：补齐客户端凭据、Webhook、导出、文件、用户等运行时DTO与负向校验；浏览器端不再为客户端请求发送或回退租户ID，服务端继续只从认证会话取得客户端租户。
+- 登录保护扩展为账号、来源IP和账号+IP三维失败计数，并增加IP维度验证码频率限制；Redis键只保存规范化值的SHA-256摘要。账号锁定仍为24小时，IP阈值为15分钟窗口30次，组合阈值为24小时5次；Prometheus新增有界事件/范围指标。
+- 建立Vitest、Testing Library、jsdom、MSW前端测试基座，覆盖登录错误中文化、异步路由异常、客户端租户头禁止、401/403/500、文件/表单请求、用户列表loading/empty/error及删除确认。33项前端测试通过，纳入覆盖范围的核心模块为statements 88.19%、branches 84.51%、functions 84%、lines 87.94%，门禁为80/70/80/80。
+- API增量覆盖门禁覆盖本轮新增DTO、动态JSON校验及登录安全逻辑，28项定向测试通过，覆盖率为86.78/78.29/95.83/89.84。API全量51套563项通过，全源覆盖率为70.44/53.77/71.76/73.61，较V2复评继续形成缓冲。
+- 引入ESLint flat config、Prettier和实际增量文件门禁；`packageManager`固定为npm 11.6.2，正式提交仍只维护根目录/API两份`package-lock.json`。历史受保护的未跟踪`pnpm-lock.yaml`和空文件`=`保持原状且不纳入提交。
+- 重新审计API依赖并将9项公告降至5项：Swagger、`js-yaml`、`fast-uri`和`brace-expansion`安全升级完成；剩余5项属于Prisma CLI同一开发/迁移链，唯一自动方案为破坏性降级Prisma 7至6，未执行`audit fix --force`。逐项路径和运行时判断见`docs/api-dependency-advisory-matrix-20260828.md`。
+- 本地前后端TypeScript、Vite生产构建、bundle budget、Gateway全包测试与`go vet`、95项Prisma schema、代码质量、安全部署及依赖缓解门禁均通过。按方案明确排除全局ValidationPipe一次性切换、强制audit修复、ECharts替换和SendChain高风险重构；发布与真实环境证据在后续条目补齐。