抽奖
抽奖是小程序商城的抽奖活动方案配置页：定好玩法（转盘 / 翻牌 / 奖池）、抽奖次数怎么来、奖品有哪些、中奖概率或库存各是多少，生效后会员在小程序里就能抽。中奖记录的查询与发放在会员业务侧，本页只出方案。
一、功能概述
菜单位置：O2O业务 → 商城活动 → 抽奖（页面地址 /admin/o2o/wx_lottery_v3/）
| 用途 | 说明 |
|---|---|
| 选玩法 | 转盘、翻牌（按概率抽）或奖池（按库存抽） |
| 攒次数 | 免费次数、每日赠送、积分兑换、下单赠送四条来源 |
| 摆奖品 | 最多 8 个奖品，每个配概率或库存、配图 |
| 圈人群 | 指定哪些微信会员卡类型可以参与 |
| 控生效 | 起止时间 + 生效/退回草稿的状态流转 |
生效后方案只读。 要改必须「取消生效」退回草稿；已删除的方案同样可以通过「取消生效」退回草稿再编辑。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、刷新、删除（红色）、操作 下拉 |
| 页签 | 右上 草稿 / 生效 / 删除 / 全部，默认停在「生效」 |
| 列表 | 行号、方案编号、方案名、模式、开始时间、结束时间、状态、免费次数、每日赠送、积分兑换、兑换积分、订单赠送、备注、创建日期；表头下一行是逐列搜索框 |
| 帮助面板 | 右侧常驻，四条原文见第六节 |
「操作」下拉里是生效方案、取消生效、删除方案三个动作。
新增/编辑抽屉
点「新增」或双击方案名，右侧滑出「新增方案」抽屉，右上角 取消 / 保存 / 生效。表单分四段：
| 段 | 字段 | 说明 |
|---|---|---|
| 基本信息 | 方案编号 | 只读，新建时系统已预分配 |
| 方案状态 | 只读徽标，新建为「草稿」 | |
| 创建日期 | 建方案日期 | |
| 方案名 | 新建时自动预填「抽奖+编号」，可改 | |
| 模式 | 下拉：转盘 / 翻牌 / 奖池；右侧灰字提示「转盘/翻牌按概率抽奖；奖池按库存抽奖」 | |
| 开始时间 / 结束时间 | 日期时间选择器，新建默认「当前时间 ~ 当年 12/31 23:59:59」 | |
| 备注 | 多行文本 | |
| 抽奖次数规则 | 免费抽奖次数 | 会员进入活动白送几次 |
| 每日赠送抽奖次数 | 灰字提示「打开抽奖界面查看抽奖次数时赠送」 | |
| 启用积分兑换抽奖次数 | 开关，关时下面两项不生效 | |
| 兑换消耗积分数 | 一次抽奖扣多少分 | |
| 每日积分兑换上限 | 一天最多用积分换几次，默认 3 | |
| 支付订单赠送抽奖次数 | 每笔达标订单送几次 | |
| 赠送次数最低订单金额 | 订单要满多少才送，默认 0.00 | |
| 规则说明 | 规则说明 | 多行文本，提示「小程序抽奖页面展示给会员的活动规则文字」 |
| 奖品明细 | 奖品行 | 最多 8 个；每行奖品类型、名称、概率或库存、配图 |
奖品类型三种：积分 / 电子券 / 未中奖（未中奖这一类只在奖池模式下使用）。电子券候选显示成「[模式]名称(价格)」，模式为兑换券 / 折扣券 / 代金券。
三、业务操作步骤
步骤 1：选玩法
| 模式 | 抽法 | 必填口径 |
|---|---|---|
| 转盘 / 翻牌 | 按概率抽 | 各奖品概率合计要 ≥0 且 ≤100 |
| 奖池 | 按库存抽 | 每个奖品总库存必须 >0，抽完即止 |
奖池模式下的「未中奖」奖品可以不配图，转盘/翻牌需要给每个奖品配图。
步骤 2：配抽奖次数来源
四条来源可以叠加：免费次数、每日赠送、积分兑换、下单赠送。只想让会员用积分玩，就把免费和每日赠送留 0，打开「启用积分兑换抽奖次数」，填兑换消耗积分数和每日上限。
步骤 3：摆奖品
在奖品明细里逐行加奖品，上限 8 个，超出时提示「最多8个奖品」。每个奖品选类型（积分 / 电子券 / 未中奖）、填概率或库存、传配图。
图片限制：单张不超过 2MB，建议 JPG 200×200。超限提示「图片大小超过2MB限制」。
步骤 4：保存与生效
- 保存：落草稿，回显「创建成功」/「保存成功」。
- 生效：确认框「确定要生效该方案吗？生效后不可编辑。」，通过后回显「操作成功」，小程序端立刻可抽。
- 取消生效：把生效或删除状态的方案退回草稿。
- 删除：列表选中后点红色「删除」，或走「操作 → 删除方案」。
四、字段详细说明
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 方案编号 | fCaseId | 抽奖方案主键 |
| 方案名 | fCaseName | 会员在小程序看到的标题 |
| 模式 | fModeId | 0 转盘 / 1 翻牌 / 2 奖池 |
| 状态 | fState | -1 删除 / 0 草稿 / 1 生效 |
| 开始时间 / 结束时间 | fStartTime / fEndTime | 活动窗口 |
| 创建日期 | fCreateTime | 建方案时间 |
| 备注 | fRemark | 内部说明 |
| 免费抽奖次数 | fFreeLotterCount | 白送次数 |
| 每日赠送抽奖次数 | fDailyAddLtCount | 打开页面即送 |
| 启用积分兑换抽奖次数 | fEnable_AddLotterCountByScore | 开关 |
| 兑换消耗积分数 | fAddLotterCountScore | 一次抽奖扣多少分 |
| 每日积分兑换上限 | fAddLtCountDailyLimit | 未设置时默认 3 次 |
| 支付订单赠送抽奖次数 | fAddLotterCountByPayBill | 达标订单送次数 |
| 赠送次数最低订单金额 | fBillMoney_AddLtCountByPayBill | 订单要满多少才送 |
| 规则说明 | fRuleDesc | 小程序抽奖页展示给会员的规则文字 |
| 参与会员类型 | WX_lottery_vipType 关联行 | 同一类型不能被多个生效方案占用 |
奖品明细每一行的字段：
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 奖品编号 | fId | 奖品行主键 |
| 类型 | fObjectType | 0 积分 / 1 电子券 / 2 未中奖（未中奖仅奖池模式用） |
| 奖品 | fObjectId | 类型为 1 时存票券类型 ID |
| 显示名称 | fDisplayName | 小程序上显示的奖品名 |
| 中奖概率 | fOdds | 百分比，转盘/翻牌模式用 |
| 总库存 | fStock | 份数，奖池模式用 |
| 每份数量 | fQty | 一份奖品给多少个 |
| 库存发出数 | fStockOut | 服务端写入，管理端只读 |
| 图片 | fImgId | 关联 WX_customImage（应用标识「小程序抽奖」） |
方案主体在 WX_lottery_case，奖品在 WX_lottery_prize，参与会员类型在 WX_lottery_vipType。
五、典型使用场景
场景一：中秋转盘拉新。 模式选转盘，免费 1 次 + 下单满 39 元再送 1 次，奖品放 1 个未中奖 + 5 张代金券 + 2 个积分档，概率合计控制在 100% 以内。
场景二：限量奖池做爆款。 模式选奖池，把 20 份实物券按库存 1 份一行地放进去，库存抽完活动自然冷却，不用担心超发。
场景三：只让高等级会员抽。 参与会员里只勾钻石卡，其它等级会员进页面看不到这个方案。
六、校验规则与常见报错
生效时按顺序校验，命中即中断。右侧帮助面板四条原文：
1、【转盘/翻牌】按概率抽奖，奖品概率合计不超过100 2、【奖池】按库存抽奖，每个奖品库存须大于0 3、生效后方案只读，可取消生效回到草稿；已删除方案也可通过“取消生效”退回草稿 4、同一会员类型不能被多个生效方案同时占用
| 提示原文 | 原因 |
|---|---|
| 请输入方案名称 | 方案名为空 |
| 最多8个奖品 / 奖品最多8个 | 奖品行数超限（前端与后端各一份文案） |
| 已启用积分兑换抽奖次数，兑换消耗积分数必须大于0 | 开关打开但积分数填了 0 |
| 奖品中奖概率合计必须大于等于0且不超过100，当前合计 X% | 转盘/翻牌概率配错 |
| 会员类型【…】已被其他生效方案占用 | 同一会员类型撞车 |
| 奖品【…】总库存必须大于0 | 奖池模式库存为 0 |
| 只有草稿状态可生效 | 对已生效/已删除方案点生效 |
| 只有生效或删除状态可退回草稿 | 对草稿点取消生效 |
| 方案已是删除状态，不能重复删除 | 重复删除 |
| 图片大小超过2MB限制 | 奖品图太大 |
七、常见问题
问：概率加起来不到 100% 会怎样？ 答：校验允许合计小于 100，缺的部分实际表现为「抽不中」。稳妥做法是显式放一个「未中奖」奖品把概率补齐。
问：奖池模式为什么不让填概率？ 答：奖池按库存抽，抽完即止，不需要概率；所以它的硬校验是「每个奖品总库存必须大于0」。
问：方案删错了还能救吗？ 答：能。到「删除」页签找到它，走「操作 → 取消生效」退回草稿即可继续编辑。
问：会员抽中的券什么时候到账？ 答：抽中电子券类奖品时按方案的发券逻辑即时发放到会员卡；要核对发放结果，到商城活动的线上卖券单查询 和会员业务侧查。