补全一些接口
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 8m9s

This commit is contained in:
2026-07-27 17:17:43 +08:00
parent 072ec1db7e
commit d46ccbd319
8 changed files with 221 additions and 43 deletions

View File

@@ -11,6 +11,7 @@
- `POST /api/admin/wecom/applications/:id/members/sync`:拉取应用可见范围内的成员并原子刷新本地选择快照。
- `GET /api/admin/wecom/applications/:id/members`:按姓名或 userid 搜索并分页选择最近同步的可见成员。
- `POST /api/admin/wecom/applications/:id/templates/inspect`:输入企微后台已知模板 ID实时读取模板名称、控件 ID、类型、必填标识和选项 key供保存映射前选择控件。
- `GET /api/admin/wecom/scenes/:business_type/fields`:返回指定业务类型允许映射的系统字段编码、中文名、值类型和取值说明。
- `PUT /api/admin/accounts/:id/wecom-binding`:把系统账号绑定到管理员明确选择的 `(corp_id, userid)`,同时保存姓名快照。
- `PUT /api/admin/wecom/scenes/:business_type`:配置已知 `template_id` 和业务字段控件映射,保存前实时读取模板详情校验。
- `GET /api/admin/wecom/scenes`:分页查询退款、员工线下代充值两个稳定业务场景的当前模板映射。
@@ -50,6 +51,7 @@
## 审批场景与模板映射
- 企微没有按应用枚举全部审批模板的接口;管理员需先从企微后台取得模板 ID再调用模板检查接口读取可映射控件。
- 前端保存映射前先查询场景字段接口,以返回的 `code` 填写 `control_mapping.business_field`;字段接口与保存校验复用同一份定义。
- 稳定业务类型固定为 `refund_approval``offline_recharge_approval`,业务代码不直接写死企微模板 ID。
- 模板必须先在企业微信后台创建;本系统不创建模板,也不保存审批节点或审批人规则。
- 保存映射时调用模板详情,逐项校验控件 ID、控件类型和选择项 key并要求模板所有必填控件都有映射模板结构已变化时拒绝覆盖当前有效配置。