目标

DGJ2 为站管家前端提供活动行为统计接口，复用 SAAS POST /inner/dgj/share/create 写入 t_statistics_share_log。本次上报曝光，不改变活动、订单、库存或支付状态。

前端契约

  • 地址：POST https://dgj-staging.kzmall.cc/scm/Share/create
  • 请求：{"share_type": 4, "source": 2, "source_activity_id": 12345}
  • 业务参数与 SAAS 小程序接口一致：share_type、source、source_activity_id 由前端传入，DGJ2 从登录态读取 sid。
  • 曝光传 share_type=4；source 是渠道，1 小程序、2 E站 APP/站管家，本接口传 2。
  • 每次成功调用新增一条曝光记录，不去重；上报失败不应阻断活动详情展示。

实现入口

  • Controller：application/controllers/scm/Share.php::create
  • Service：application/Services/Marketing/ShareSer.php::create
  • Provider：application/Providers/KzSaas/ShareProvider.php::createShare
  • SAAS 落库：app/Service/V3/ShareService.php::create

验证证据

  • PHP 语法、git diff --check 和 DGJ2 变更验证器通过。
  • 隔离 Service 测试覆盖 share_type=4 成功映射、非法参数、下游失败。
  • 旧 H5 仍固定 share_type=3。
  • Apipost API 62c27a5de3d4d 需以最新 3 个请求字段契约同步并回读。

未在开发阶段执行

未使用虚构活动 ID 请求预发落库，避免污染曝光数据。发布后使用真实活动完成一次请求，再按活动 ID、服务站和日期回查统计。