feat(work): stage authenticated remote approvals with scoped execution fencing

This commit is contained in:
ex_tianzy
2026-11-17 11:43:33 +08:00
parent d2881b82b0
commit c80c6a0d27
19 changed files with 1586 additions and 25 deletions
@@ -0,0 +1,60 @@
# 审批闭环与异常恢复:本地联调记录
日期:2026-11-17。范围:客户端feat/phase-A-local-20261116与ECS feat/approval-foundation-local-20261117,均为本地未提交改动。不代表master或已安装产品具备此能力。
## 结果
最终针对性测试:162项通过,1项跳过。ECS/两仓联合100项通过、1项跳过;客户端62项通过。联合测试自身25项通过,其余是认证、任务交接、卡片及客户端既有行为回归。
跳过项:test_postgres_authorization_and_binding_generation,原因是没有提供真实测试PostgreSQL地址。本轮审批账本使用临时SQLite;不声称PostgreSQL审批并发已通过。
## 已核对行为
| 场景 | 实测结果 |
| --- | --- |
| 手机决定的合成回调允许 | 业务MockTransport收到一次请求,审批消费为consumed |
| 拒绝 | 未发送业务请求,同操作再次提交不生成第二次执行 |
| 重复按钮、重复操作、并发消费 | 仅一次许可可消费,业务请求无重复 |
| 消费响应丢失、轮询断线 | 客户端未发送业务请求;重建客户端仍读原操作记录,不重新执行 |
| 业务响应丢失 | 原请求计数为1,返回unknown;重建客户端不重放 |
| 本机停止、绑定变化、服务端执行终态、过期 | 不发送业务请求 |
| 假操作者/应用/租户/Verification Token/时效/会话/卡片/nonce/自报身份 | 未形成批准,原审批保持pending |
| 缺设备签名、签名重放、错任务 | 请求被拒绝,不发送业务请求 |
| 卡片创建响应不明 | 不重发第二张确认卡 |
| 过期卡片更新响应不明 | 只重试更新已知原卡片,删除按钮后不再更新;不新发卡 |
| 审批worker及数据库连接重建 | 查询原审批/卡片继续处理,不重新发卡或替换操作ID |
| 已核定只读 | 不生成审批卡片,沿正常读取流程 |
| 默认关闭 | 没有审批/内部回调路由,不创建审批表,协议不宣称启用 |
| 原生run状态投影 | 仅当前任务运行态投影waiting_for_approval;completed不回退 |
## 方法与边界
使用真实客户端BrokerWorkClient、设备Ed25519签名、ECS ASGI路由、临时数据库与专用审批worker。Redis使用fakeredis,平台卡片及业务API使用合成服务,不连接正式Work,不创建真实日程、不发邮件。
客户端新增可注入的http_transport仅供构造测试;网络和模型不能覆盖传输目标。测试中的原生请求补齐loopback来源/Host,模拟Agent补停止回调,没有放宽正式安全检查。
测试曾因固定轮数的轮询窗口过早读取发送中间态失败,改为单调时钟的实际期限后完整重跑通过。正式“回执不明不重发”规则未修改。
未覆盖:正式长连接SDK传递真人点击、平台三秒响应上限的现场表现、手机卡片呈现、完整ECS进程/主机重启、正式PostgreSQL和所有工具统一审批。这里的worker重建测试不等于服务器重启验收。
## 复现与证据
ECS deployable目录使用现有测试Python执行:
```powershell
python -m pytest tests/test_approval_integration.py tests/test_task_delivery.py tests/test_credential_api.py tests/test_task_cards.py -q --junitxml=build-support/approval-integration-20261117.xml
```
客户端仓库根目录:
```powershell
python -m pytest integrations/work-relay/tests/test_broker_client.py integrations/work-relay/tests/test_task_journal.py integrations/work-relay/tests/test_task_executor_context.py integrations/work-relay/tests/test_broker_task_context.py -q --junitxml=build-support/approval-client-regression-20261117.xml
```
若成对客户端源码不在同级默认目录,通过HAINUO_APPROVAL_PC_SOURCE指定其仓库根目录。缺源码时联合模块明确skip,不能用跳过代替通过。
两端XML保留具体测试名、结果与耗时;git diff --check通过。本轮没有提交、推送、部署、出包或修改已安装客户端。两端审批开关仍默认关闭。
## 下一步
准备独立测试ECS和客户端版本,复用唯一机器人长连接,核对应用回调订阅后做真人允许/拒绝和断线测试。部署需覆盖原longconn及connector,不能照旧只升级connector/router,也不能增加第二个机器人连接。此步骤需要测试环境和平台配置配合;本轮未擅自执行部署。