2026-10-13-mobile-protocol-transfer-finance-parity.md 2.5 KB

移动端协议单转账 / 财务确认对齐 Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 协议编辑页内嵌转账登记/提交财务确认/撤回,与 Web SamplePaymentPanel 一致;去掉小程序协议审核操作。

Architecture: 复用既有 /mini/market/{role}/payment-transfers API;在 ProtocolSamplePaymentPanel 每期次下挂转账卡片;MarketModuleForm 传入 protocolId、角色与转账字典;前端/后端协议动作白名单去掉 audit。

Tech Stack: Vue 3 + Vant(mobile-oa-h5)、FastAPI market_mobile、既有 payment transfer 服务


File map

文件 职责
mobile-oa-h5/src/market/components/ProtocolSamplePaymentPanel.vue 内嵌转账 UI + 调用
mobile-oa-h5/src/views/market/MarketModuleForm.vue 传 protocolId / role / transferTypes / canManageTransfers
mobile-oa-h5/src/market/action-policy.js 协议白名单去 audit
backend/app/services/market_support.py protocol allowed_actions 去 audit
相关 *.test.js / pytest 契约与白名单

Task 1: 去掉协议审核动作

  • Step 1: 写失败测试 — module-actions.test.js:moduleActions('protocol') 不含 audit;collectAllowedActions 交集不含 audit
  • Step 2: 跑测确认失败
  • Step 3: 改 action-policy.js 去掉 audit;后端 allowed_actions protocol 去掉 audit
  • Step 4: 更新依赖 audit 的断言;跑测通过

Task 2: 面板契约 — 转账区

  • Step 1: 写失败测试 — mobile-parity-ui.test.js 或新测:ProtocolSamplePaymentPanel 含「添加转账」「提交财务确认」「撤回」
  • Step 2: 跑测确认失败
  • Step 3: 在面板每期次下增加转账列表与操作按钮(可先静态骨架)
  • Step 4: 跑测通过

Task 3: 转账 CRUD + 提交/撤回

  • Step 1: 写失败测试 — 保存转账前校验 protocolId+schedule.id;成功后写回 id/payStatus
  • Step 2: 跑测确认失败(纯函数可抽 protocol-sample-transfer.js)
  • Step 3: 实现创建/更新/submit/withdraw + 附件上传;Form 传入 props
  • Step 4: 跑相关前端测

Task 4: 验证

  • 跑 mobile-oa-h5 相关 node tests + 必要 backend pytest
  • 更新 graphify(若改 backend)