拉新下单送券
拉新下单送券是小程序商城的老带新奖励方案：老会员把活动分享出去，拉来的人注册成会员、并且下了一笔达标的单，就给「拉新人」和「新会员」两边分别发券。送券记录在拉新下单送券查询 里查。
一、功能概述
菜单位置：O2O业务 → 商城活动 → 拉新下单送券（页面地址 /admin/o2o/wx_invitecase/）
| 用途 | 说明 |
|---|---|
| 定活动期 | 订单支付开始/结束日期，只有这段时间内支付的订单算数 |
| 定双边奖励 | 「拉新人送券」给邀请人，「新会员送券」给新注册会员 |
| 拿邀请链接 | 一键生成小程序拉新页路径 |
| 控状态 | 草稿 / 生效 / 删除三态流转 |
本页只配方案，不发券。 真正触发发券的是「新会员完成注册 + 在时间窗内支付订单」这个动作。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、刷新、删除（红色）、操作 下拉、生成链接 |
| 页签 | 右上 有效 / 删除，默认停在「有效」 |
| 列表 | 行号、状态（草稿 / 生效（绿））、方案ID、方案名（蓝色超链）、订单支付开始日期、订单支付结束日期、创建日期、备注；表头下一行是逐列搜索框 |
| 计数 | 左下角「共 N 条」 |
「操作」下拉里是生效方案、取消生效、删除方案。
新增/编辑抽屉
点「新增」或双击方案名，右侧滑出「新增方案」抽屉，右上角 取消 / 保存 / 生效。
| 段 | 字段 | 说明 |
|---|---|---|
| 基本信息 | 方案ID | 只读，新建时系统预分配 |
| 方案状态 | 只读徽标，新建为「草稿」 | |
| 创建日期 | 建方案日期 | |
| 方案名称 | 新建时预填「拉新+方案ID」，可改 | |
| 订单支付开始日期 | 日期选择器，新建时留空，需手工选 | |
| 订单支付结束日期 | 同上 | |
| 备注 | 多行文本，占位「请输入备注」 | |
| 拉新人送券 | 券类型列表 | 右上角「+ 添加券」；空时显示「暂无券类型」。发给邀请人 |
| 新会员送券 | 券类型列表 | 同上。发给新注册的会员 |
两段券列表各自独立，可以只给一边发券。
三、业务操作步骤
步骤 1：建方案
点「新增」，方案名称可沿用预填值，选订单支付开始日期和结束日期。这两个日期框的是订单支付时间，不是注册时间——新会员在窗口内付了钱才触发送券。
步骤 2：配双边奖励
在「拉新人送券」里点「+ 添加券」，选券类型、填张数；再在「新会员送券」里同样配一遍。常见做法是给老会员一张高价值券做激励，给新会员一张低门槛券引导首单。
步骤 3：保存与生效
- 保存：落草稿，回显「创建成功」/「保存成功」。
- 生效：确认框「确定要生效该方案吗？」，通过后回显「操作成功」。
- 取消生效：生效后要改，用它退回草稿。
- 删除：选中后点红色「删除」，确认框「确定要删除该记录吗？删除后不可恢复。」。
步骤 4：拿拉新链接
选中方案点「生成链接」（不要求先选中行也能点），弹窗里给出提示「拉新链接: …」，路径固定为 pages/personal/invitingCoupons/index。复制到商城装修 的组件、会员卡片或社群里即可。
四、字段详细说明
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 方案ID | fCaseId | 方案主键，新建时由系统预分配（EXEC GetOnlyNum 'WX_inviteCase'） |
| 方案名称 | fCaseName | 活动名，新建时预填「拉新+方案ID」 |
| 方案状态 | fState | 0 草稿 / 1 生效 / -1 删除（删除是逻辑删除，行还在表里，切「删除」页签能看到） |
| 创建日期 | fCreateTime | 建方案时间，保存时写 GETDATE()，列表按它倒序 |
| 订单支付开始 / 结束日期 | fStartTime / fEndTime | 计入活动的支付时间窗 |
| 备注 | fRemark | 说明文字 |
| 拉新人送券 / 新会员送券 | 明细行的 fTargetType | 0 = 拉新人（邀请人），1 = 新会员 |
方案主体在 WX_inviteCase（这张表没有 ChangeMan/ChangeDate 审计列，也没有方案编号列）；两边的券配置在同一张明细表 WX_inviteCaseDetail，列为 fId、fCaseId、fTargetType、fTypeId（券类型，指向 MCM_CakeTicketType）、fQty（张数）。添加券时弹窗只列还没加过的券类型，重复选会被过滤掉。
五、典型使用场景
场景一：首单返券。 「新会员送券」放一张满 30 减 10 的代金券，「拉新人送券」放一张 20 元券；时间窗给整月，老会员拉人注册并完成首单后两边同时到账。
场景二：只奖励新客。 「拉新人送券」留空，只在「新会员送券」里配券，做纯粹的注册礼。
场景三：活动延期。 生效后想延长窗口，先「取消生效」退回草稿，改结束日期再重新生效。
六、校验规则与常见报错
| 提示原文 | 出处 |
|---|---|
| 请输入方案名称 | 前端 |
| 请设置订单支付开始日期 | 前端 |
| 请设置订单支付结束日期 | 前端 |
| 开始日期不能为空 | 后端生效校验 |
| 结束日期不能为空 | 后端生效校验 |
| 开始日期不能大于结束日期 | 后端生效校验 |
| 拉新人送券至少要选择一种券类型 | 后端生效校验（配了拉新人段但没选券） |
| 券数量不能小于等于0 | 后端生效校验 |
| 确定要生效该方案吗？ | 生效前确认框 |
注意：本页没有右侧帮助面板，规则以校验提示为准。
七、常见问题
问：新会员注册了但没下单，会送券吗？ 答：不会。这个方案的触发条件是「新会员在订单支付时间窗内完成支付」，只注册不下单不送。要纯注册礼请用会员礼包类活动。
问：为什么两个日期叫「订单支付开始/结束日期」？ 答：它们框的是订单的支付时间，不是方案的上架时间。方案本身靠「生效」状态控制是否参与计算。
问：券发错了能收回吗？ 答：本页收不回。到拉新下单送券查询 看发放结果，作废未使用的券在线上卖券单查询 一侧处理。
问：查询页打不开，提示未开启系统选项？ 答：拉新下单送券受系统选项 InviteCaseEnable 控制，未开启时查询页会提示「未开启【拉新下单送券】系统选项（InviteCaseEnable），无法查询」。先在系统选项里打开。