会员签到
会员签到是小程序商城的签到送积分/送券方案配置页：定好「连续签到几天、每天给多少分、满几天额外送什么券」，生效后会员在小程序里就能天天签。它只管规则和奖励，会员的实际签到记录在客户端 ERP 的会员业务里查。
一、功能概述
菜单位置：O2O业务 → 商城活动 → 会员签到（页面地址 /admin/o2o/wx_vipsign/）
| 用途 | 说明 |
|---|---|
| 定签到周期 | 一个「连续签到周期」内怎么算连续、什么时候清零 |
| 定每日奖励 | 首次签到给多少分、之后每天递增多少、封顶递增到多少 |
| 定累计奖励 | 连续签满 N 天，额外送积分或送电子券 |
| 圈定人群 | 全部会员，或只让某几类微信会员卡类型参与 |
| 控制生效期 | 开始/结束日期决定方案在小程序里露出的时间窗 |
一个周期内只允许一个生效方案。 方案生效后就不可编辑，要改只能取消生效回到草稿，或者做下一个周期的新方案。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 工具栏 | 新增、刷新、删除（红色按钮，未选中行时点了没反应）、操作 下拉 |
| 页签 | 右上角 生效 / 全部 两个切换，默认停在「生效」 |
| 列表 | 行号、方案编号、方案名称、制定日期、参与会员、开始日期、结束日期、连续签到周期、方案状态、备注；表头下方一行是逐列搜索框 |
| 帮助面板 | 右侧常驻，原文见第六节 |
| 计数 | 左下角「共 N 条」 |
「操作」下拉里是四个动作：生效方案、取消方案、停用方案、删除方案。
方案状态三种：草稿（可改）、生效（在小程序里跑着）、停用（下线但保留）。列表里的状态列还会在方案日期不匹配时追加后缀，比如「生效(未到时间)」「生效(已过期)」。
新增/编辑抽屉
点「新增」或双击方案名称，右侧滑出编辑抽屉，标题为「新增方案」，右上角是 取消、保存、生效 三个按钮。表单分三段：
| 段 | 字段 | 说明 |
|---|---|---|
| 基本信息 | 方案编号 | 只读，系统预分配，新建时就已经填好 |
| 方案状态 | 只读徽标，新建时为「草稿」 | |
| 制定日期 | 建方案的日期 | |
| 方案名称 | 必填 | |
| 开始日期 / 结束日期 | 日期选择器，格式 yyyy/MM/dd；新建时默认今天 ~ 当年 12/31 | |
| 连续签到周期（天） | 步进框，单位「天」 | |
| 参与会员 | 默认「全部会员」，点右侧 ... 从微信会员卡类型里多选 | |
| 签到备注 | 输入框提示「请输入签到备注（生效前必填）」 | |
| 每日签到 | 首次签到积分 | 第一天签到给多少分 |
| 每次递增积分 | 之后每天在前一天基础上多加多少分 | |
| 最高递增积分 | 递增的封顶值 | |
| 连续签到 | 签到天数 | 单位「天」，输入框后有灰字说明「（每次触发奖励的连续天数阈值）」 |
| 赠送积分 | 达到阈值时额外送的积分 | |
| 赠送电子券 | 下拉选券，默认「-- 请选择 --」 | |
| 赠送张数 | 选券后填送几张 |
电子券下拉里每张券显示成「[模式]名称(价格)」，模式分别是兑换券 / 折扣券 / 代金券。
三、业务操作步骤
步骤 1：新建方案
点「新增」，填方案名称、起止日期和连续签到周期。方案编号不用管，系统已经给了。
参与会员默认「全部会员」，即所有微信会员卡类型都能签；只给部分等级玩时，点 ... 改成指定类型。
步骤 2：配每日奖励
「每日签到」三段数字决定会员每天签到能拿多少分：
| 字段 | 举例 | 效果 |
|---|---|---|
| 首次签到积分 = 5 | 第 1 天 | 得 5 分 |
| 每次递增积分 = 2 | 第 2、3、4 天 | 依次 7、9、11 分 |
| 最高递增积分 = 10 | 递增上限 | 每日得分不会超过 5+10 |
三项全填 0 表示每日签到不给分，只玩累计奖励。
步骤 3：配连续（累计）奖励
「连续签到」是达到阈值时的一次性额外奖励：签到天数填 7、赠送积分填 50，就是连续签满 7 天再送 50 分；也可以改成送电子券并填张数。
每日规则和累计规则至少要配一个，两边全空保存时会被拦下。
步骤 4：保存与生效
- 保存：只落草稿，回显「保存成功」（新建时是「创建成功」），小程序端看不到。
- 生效：确认框「确定要生效该方案吗？生效后不可编辑。」，通过后回显「操作成功」。生效后抽屉里的字段全部变只读，想改只能走「操作 → 取消方案」退回草稿。
- 停用：在列表选中一行，用「操作 → 停用方案」，方案立刻从小程序下线，但配置保留。
- 删除：列表选中后点红色「删除」，确认框「确定要删除该记录吗？删除后不可恢复。」。
四、字段详细说明
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 方案编号 | fCaseID | 方案主键，一个方案一行 |
| 方案编号（自填） | fCaseNo | 门店自己认的短编号 |
| 方案名称 | fCaseName | 必填 |
| 方案状态 | fCaseState | 0 草稿 / 1 生效 / 2 停用 |
| 制定日期 | DefineDate | 建方案时由服务端取当前时间写入 |
| 生效日期 | fPostDate | 点生效时写入，取消生效不清 |
| 开始日期 / 结束日期 | fBegDay / fEndDay | 小程序露出的时间窗 |
| 连续签到周期（天） | fContinuSignCycle | 连续天数在这个周期内累计，到点清零 |
| 参与会员 | fVipTypeList / fVipTypeNameList | 会员类型 ID 串与名称串，名称串默认「全部会员」 |
| 签到备注 | fRemark | 生效前必填 |
| 每日规则条数 / 累计规则条数 | fLineCount1 / fLineCount2 | 保存时按实际行数回填 |
| 删除标记 | SignDelete / DeleteMan / DeleteDate | 删除是打标记，不物理删行 |
每日规则（WX_VIPDailySignRule，按 fLineIndex 排序）：
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 首次签到积分 | fFirstScore | 第一天给多少分 |
| 每次递增积分 | fAddScore | 之后每天多加多少分 |
| 最高递增积分 | fMaxScore | 递增封顶 |
累计（连续）奖励（WX_VIPTotalSignRule）：
| 界面字段 | 落库字段 | 含义 |
|---|---|---|
| 签到天数 | fSignDays | 触发奖励的连续天数阈值 |
| 赠送积分 | fLargessScore | 达到阈值额外送的积分 |
| 赠送电子券 | fTicketType | 票券类型 |
| 赠送张数 | fTicketCount | 一次送几张 |
方案主体在 WX_VIPSignCase，两张规则表按 fCaseID 与主表关联。
五、典型使用场景
场景一：日常拉活跃。 连续签到周期填 30 天，首次 5 分、每天递增 1 分、封顶 10 分，再配一条「连续 7 天送 50 分」。会员天天有盼头，一个月一个周期自动重新开始。
场景二：签满送券。 累计规则里签到天数填 15、赠送电子券选一张单品券、张数 1，作为半个月坚持的奖励。注意累计规则只能配一条，想同时送积分又送券就得再开一个方案。
场景三：只给金卡会员玩。 参与会员点 ...，只勾金卡类型；其它类型会员进小程序签到页会看不到这个活动。
六、校验规则与常见报错
保存/生效时按顺序校验，命中即中断：
| 提示原文 | 原因 |
|---|---|
| 请输入方案名称 | 方案名称为空 |
| 生效前必须填写签到备注 | 点「生效」时备注还是空的 |
| 生效前必须填写备注 | 同上，走「操作 → 生效方案」时的提示 |
| 每日规则和累计规则不能同时为空 | 两段奖励一个都没配 |
| 只有暂存状态可编辑规则 | 方案已生效，规则表被锁 |
| 目前只允许添加1条累计签到奖励规则 | 累计规则想加第二条 |
| 确定要生效该方案吗？生效后不可编辑。 | 生效前的确认框 |
右侧帮助面板的原文，解释了连续天数为什么会被清零：
1、【连续签到周期】内只发一次 【连续签到】标签页里配置的奖励 2、连续签到天数达到【连续签到周期】时，截断连续签到天数，重新开始计算连续天数
七、常见问题
问：生效后发现奖励配错了，能直接改吗？ 答：不能。生效后表单锁定，先到列表用「操作 → 取消方案」退回草稿，改完再生效。
问：为什么会员签了 30 天没有第二次累计奖励？ 答：这是设计如此——连续签到周期内，累计奖励只发一次。要再发就得把周期改短或新建下一个周期的方案。
问：「停用」和「删除」怎么选？ 答：停用保留配置，随时可以再启用；删除不可恢复。活动临时下线用停用，确认这版方案作废才用删除。
问：签到记录在哪里查？ 答：本页只配方案，不查记录。会员的实际签到明细、发分发券结果在客户端 ERP 的会员业务模块里查。