zkxw/docs/superpowers/plans/2026-10-11-market-remaining-mobile-parity-implementation.md

市场端剩余五模块移动端复刻实施计划

执行方式：当前会话内直接实施。视觉与交互以 docs/demos/2026-10-11-market-remaining-mobile-parity-demo.html 为准。

目标

将市场专员、地区经理的协议单、催缴信息、缴费信息、样本信息、运费信息共 10 个入口改造成与 Web 端字段、动作一致的移动端卡片界面；复用现有 mobile-oa-h5 市场模块路由和表单框架，不复制业务逻辑，不制造仅前端可见的假动作。

实施步骤

1. 锁定展示契约

   • 新增列表展示适配器及单元测试，覆盖五模块标题、状态、完整字段、金额格式、角色差异和动作标签。
   • 所有卡片动作与后端返回的 allowedActions 取交集，避免越权按钮。

2. 补齐后端移动端协议能力

   • 为协议列表返回卡片所需字段。
   • 新增带业务来源参数的协议审核、软删除接口；访问控制继续经过租户、角色、数据范围校验。
   • 扩展协议 allowedActions，并以测试覆盖状态限制和路由契约。

3. 补齐其余列表摘要

   • 缴费列表增加已缴、待缴、期次进度摘要。
   • 催缴列表补充协议状态。
   • 运费列表携带当前角色可见样本，并对市场专员只展示隐私提示，不泄露隐藏数量。

4. 重做移动端列表壳层

   • 去除绿色大头部和状态下拉，只保留白色导航标题与搜索框。
   • 新增动作改为右下角 56px 圆形悬浮按钮。
   • 使用 Vant List 滚动触底分页加载，保留首屏失败、追加失败和空状态处理。
   • 卡片展示 Web 端同等信息，并提供详情、编辑、审核、删除及各模块专属动作。

5. 表单组件移动化

   • 下拉字段统一改为 Vant Picker；日期时间统一改为 Vant DatePicker/TimePicker。
   • 采集地区变化后清空并重新加载采集医院，实现数据库选项级联。
   • 上传字段改为“上传卡片 + 已上传附件卡片”同排布局，选择后立即上传，支持预览和删除。

6. 验证与图谱

   • 运行 mobile-oa-h5 市场单测及生产构建。
   • 运行后端市场模块定向测试。
   • 更新后端代码知识图谱（移动端 H5 暂无独立图谱任务）。

完成标准

• 两类角色的五模块列表均采用模板卡片布局，无状态筛选下拉。
• 有新增权限的页面只显示右下角圆形 + 按钮。
• 列表滚动自动分页，查询会重置分页并重新请求。
• 列表和详情动作由后端授权，协议审核/删除真实可用。
• 地区/医院联动、数据库下拉、附件卡片、缴费/样本/运费专属动作均可用。
• 测试与构建通过，无跨应用主色混用。