wxapp-cloud-action-matrix.md 4.4 KB

WXAPP 云函数接口迁移矩阵

口径

  • 基线来自旧 uni-app 源码静态扫描生成的 SOURCE_API_ACTIONS,共 91 个唯一 action。
  • 统一新入口为 POST /api/functions/xiaoshu/app/gateway。
  • 已有云函数映射 26 个,另有 65 个以 HTTP 501 和 migration_blocked: <原因> 显式拒绝。矩阵不存在未知 action。
  • “已映射”表示已有云函数代码与权限边界;完成 H5 切换前仍需逐页响应字段回归。

已映射的 26 个 action

领域 action
版本 app_update
内容 content_get, content_list, content_list_llk, content_uphis, node_get, node_list
商品只读 product_get, product_list, product_stock_list
账号 user_get, user_info_name, user_list, user_login_passwd, user_register, user_update, user_update_pwd, user_update_pwdall, e_user_list
学习/预约只读 e_get_21list, e_get_21list_tj, e_order_detail, e_record_detail, e_words_list, user_point_list
反馈 guestbook_add

已实测 content_list 在公司帐套下返回 92,435 条,modelId=56 返回 108 条。读取用 Psql 并强制 company=7pIbDBJmKx,所有客户端输入均使用参数化查询。

因目标 Schema/历史数据缺失而阻塞

能力 action 缺失项
购物车 cart_list 无购物车类
优惠券 coupon_list, coupon_usrgot_add, coupon_usrgot_list 无优惠券实例和用户领取关系类
订单/物流 order_delivery, order_get, order_list, order_signfor, user_shop_order, user_shop_sales 无订单、商品明细、销售和物流类
订单评价 order_comment_add, order_comment_list 无评价类
支付 payment_cart, payment_cart_again, payment_success 无订单/支付明细类
发票 invoice_add, invoice_del, invoice_get, invoice_list, invoice_upd 无发票类
收货地址 receaddr_add, receaddr_del, receaddr_get, receaddr_list, receaddr_upd 无地址类
提现账户 user_bank_add, user_bank_del, user_bank_get, user_bank_list 无提现账户类
收藏 user_star_add, user_star_del, user_star_is 无用户收藏关系类
会员订单 user_group_usr_supply, user_group_usr_upgrade 无会员购买/续费订单类
投票 vote_add, vote_ask, vote_question 无可证明的投票记录类
部门 user_dept 无可证明的用户部门关系

上述接口要恢复 1:1 能力,必须先补建 Schema,并取得可迁移的旧数据;仅有空表或空成功响应不能算迁移完成。

因外部服务、安全或合规而阻塞

能力 action 需要的前置条件
短信验证码 mcode_send, user_login_mobile, user_register_mobile 新短信服务商凭据、验证码存储和限流
微信授权 user_sync2 新微信容器流程和凭据
资金/积分 user_cash_add, user_cash_list, user_coin_recharge, user_exp_transfer, user_money_recharge, user_money_transfer 支付凭据、不可变事务账本和业务规则
支付密码 user_update_paypwd 独立哈希服务和重置流程
实名认证 user_rnauth_add, user_rnauth_get, user_rnauth_upd 合规审核、加密存储和访问审计

有数据但尚未能证明 1:1 语义

能力 action 待确认/待实现
内容写入 content_add, content_update CommonModel 与 addon 表双写事务
商品写入 product_del, product_sale_change, product_stock_change 门店管理员权限与库存账本
课程/生词 e_ck_list, e_add_words CourseBinding + VocabularyWord + 用户进度联表语义
学习写入 stu_record_update_v2, unit_record_update 学习主记录、addon 和单元聚合的原子写入
预约 e_order_tongji, e_order_update_v2 统计口径、状态机和角色权限
发布 pub_add, pub_list Pub 业务类型、审核与可见范围

前端切换决策

当前 Angular H5 仍保留旧 WXAPP 入口。在 65 个 action 中包含登录、订单、支付和学习写入等主流程时,直接全量切换会导致页面大面积中断。切换条件是:

  1. 先对齐缺失 Schema/数据和第三方凭据。
  2. 完成剩余 action 的云函数事务、权限和字段回归。
  3. 将 H5 会话改为 Parse sessionToken,再一次性切换到 /api/functions/xiaoshu/app/gateway。