客户运营、C 端营销活动与优惠券

本文整理 C 端营销活动、客户活动、优惠券、新人券、活动商品、活动报名、库存和限购。它和 E站活动、普通销售活动、秒杀活动都有关联，但表和入口相对独立。

业务目标

  • OPS 创建面向 C 端或客户的营销活动。
  • 活动配置商品、图片、服务站范围、库存、限购和赠品。
  • 服务站或客户报名/参与。
  • 优惠券模板支持发放、作废、加库存、关联活动。
  • 活动开始/结束通过任务通知。

入口文件

  • 活动控制器：application/controllers/market/ClientActivity.php
  • 优惠券控制器：application/controllers/market/ClientCoupon.php
  • 内部优惠券：application/controllers/inner/ClientCoupon.php
  • 活动任务：application/controllers/tasks/ClientActivity.php
  • 活动服务：application/Services/Marketing/ClientActivitySer.php
  • 优惠券服务：application/Services/Marketing/ClientCouponSer.php

核心表

| 表 | 用途 | | --- | --- | | t_mkt_client_activity | C 端营销活动 | | t_mkt_client_activity_goods | 活动商品 | | t_mkt_client_activity_relations | 活动服务站/关系 | | t_mkt_client_activity_imgs | 活动图片 | | t_mkt_client_activity_apply | 活动报名 | | t_mkt_client_coupon_templates | 优惠券模板 | | t_mkt_client_coupon_send_log | 优惠券发放日志 |

核心方法

活动：

  • ClientActivitySer::add / update：创建和编辑活动。
  • addApply / updateApply：报名申请。
  • list / validList / getListBySid：活动列表。
  • switchStatus：启停。
  • top：置顶。
  • uploadExcel / uploadGoodsExcel：导入商品。
  • addInventory：加活动库存。
  • lockInventory / unlockInventory：锁定/释放活动库存。
  • addBuyLimit：增加限购。
  • refund / confirmRefund：退款相关。

优惠券：

  • ClientCouponSer::add / update：新增/编辑券。
  • sendCoupon / sendNewerCoupon：发券。
  • invalid：作废。
  • addStock / consumeStock：加库存/扣库存。
  • relationActivity：关联活动。
  • uploadPhoneExcel：导入手机号。
  • checked / reject：审核。

任务：

  • ClientActivity::activityOverdue：活动过期。
  • startNotify / endNotify：开始/结束通知。

主流程

flowchart TD
  A["创建营销活动"] --> B["配置商品、服务站、图片、库存"]
  B --> C["活动上线"]
  C --> D["服务站/客户参与或报名"]
  D --> E["锁定活动库存或发放优惠券"]
  E --> F["下单/支付/退款"]
  F --> G["更新活动订单、库存、券使用记录"]
  C --> H["开始/结束任务通知"]

异常流程

  • 活动不可见：查状态、上下线时间、服务站范围、平台类型。
  • 商品导入失败：查模板、商品状态、价格、库存、错误文件。
  • 活动库存不足：查活动库存、锁定库存、订单状态。
  • 优惠券发放失败：查模板状态、库存、手机号导入、发放日志。
  • 新人券异常：查新人开关、服务站开关、发放条件。

常用 rg 命令

rg -n "ClientActivitySer|addInventory|lockInventory|unlockInventory|uploadGoodsExcel" application/controllers/market application/Services/Marketing
rg -n "ClientCouponSer|sendCoupon|sendNewerCoupon|consumeStock|uploadPhoneExcel" application/controllers/market application/controllers/inner application/Services/Marketing
rg -n "MKT_CLIENT_ACTIVITY|MKT_CLIENT_COUPON|activityOverdue|startNotify|endNotify" application

改动风险和回归清单

  • 活动：创建、编辑、启停、置顶、导入商品、加库存、限购。
  • 服务站范围：指定服务站、活动报名、活动详情。
  • 优惠券：模板、发券、作废、加库存、核销、发放日志。
  • 库存：活动锁定、释放、退款恢复。
  • 任务：开始通知、结束通知、过期关闭。