条件引擎
条件引擎是系统标签的「算人」工具：选中一个系统标签，先看它现在能圈到多少会员（执行条件查询），确认人数符合预期后，再把这批会员正式写成标签与会员的关联关系（结果写入关联表）。改完标签条件、上线新标签、怀疑人数不对时，都在这个窗口验证，不用等第二天凌晨的批量计算。
功能路径：系统菜单 → 会员管理 → 会员画像 → 条件引擎
一、功能概述
标签管理里配置的是一串条件表达式，条件引擎负责把这串表达式变成人：
- 试算：按标签上配置的条件从画像指标表里筛会员，只返回人数，不改任何数据；
- 落库：把筛出来的会员批量写入标签-会员关联表，关联关系一旦写入，会员画像查看里就能看到这条标签，营销计划也就能圈到这批人。
窗口列表只显示系统标签（手工标签、组合标签、临时标签不在这张表里），每行带它的条件摘要、当前会员数与最后计算时间，所以它同时是「所有系统标签口径清单」的查看页。
二、界面布局说明
| 区域 | 内容 |
|---|---|
| 页面标题 | 条件引擎 |
| 查询条件 · 系统标签 | 下拉框，默认「不限」，其余选项是本账套的全部系统标签名称；两个动作按钮都靠它取标签 |
| 工具栏动作 | ▶ 执行条件查询、结果写入关联表 |
| 通用动作 | 查询、重置、导出、★ 方案 |
| 结果表格 | 列：标签ID / 标签名 / 类型 / 条件摘要 / 会员数 / 最后计算时间 |
| 分页 | 默认每页 50 条，可选 20/30/50/100/200 |
「条件摘要」列显示标签的条件原文，例如 10按消费行为=(未消费天数>60)、10按消费行为=(累计消费金额 介于 1 和 2 之间)；摘要是从条件配置渲染出来的自然语言串，与会员画像查看里的「条件说明」列同源。「最后计算时间」是最近一次把这个标签的人写入关联关系的时间，全部标签在夜间批量任务里统一刷新，所以正常运行的账套这一列通常都是凌晨同一个时刻。
三、业务操作步骤
步骤 1：选标签
在「系统标签」下拉里选中要验证的标签。不选标签直接点动作按钮，会提示「请先在条件面板选择标签」。
步骤 2：试算人数
点执行条件查询，稍等片刻后页面提示：
标签【唤醒沉睡会员】匹配 188709 个会员（耗时 2.3 秒）
这一步只查不写，可以放心反复试。人数与预期不符时，回标签管理用「设置条件」调整阈值或时间窗，再回来重算。
步骤 3：写入关联表
人数符合预期后点结果写入关联表，确认框为：
将条件匹配的会员写入标签-会员关联表（自动去重），确认执行？
确认后提示：
标签【唤醒沉睡会员】匹配 188709 个会员，新增关联 312 行（已存在的自动跳过）
「新增关联」是本次新落到关联表的行数。上一次已经存在的会员会被跳过，所以同一个标签重复执行不会产生重复打标，也不会把已经不在条件内的会员自动摘掉——清理旧会员要靠夜间批量计算，或到标签管理「查看会员」里人工移除。
如果一个人都没圈到，会提示「标签【某标签】未匹配到会员，无可写入数据」，此时不会写入任何数据。
步骤 4：核对结果
写完后列表的「会员数」「最后计算时间」会同步刷新，再到会员画像查看里抽 2～3 个已知符合条件的会员卡号查一下，能看到这个标签就说明关联正常。
四、条件目录与时间窗
标签条件按维度分组，条件之间是**「且」**关系（叠加后取交集）。常用项如下（具体以标签条件编辑页左栏列出的目录为准）：
| 维度 | 条件项 | 参数类型 |
|---|---|---|
| 按消费行为 | 累计消费金额、累计充值金额、平均消费金额、消费次数、充值次数 | 金额（元）/ 次数，可配比较符与区间 |
| 按商品喜好 | 消费过的品类、消费过的商品 | 选品类或商品 |
| 按会员特征 | 会员生日距离、会员归属门店 | 天数区间 / 门店 |
| 按卡券购销 | 次卡消费次数、次卡购买次数、次卡失效期限、优惠券使用数量、优惠券领取数量、优惠券失效期限 | 次数 / 张数 / 期限区间 |
带时间范围的条件要选时间窗，取值固定四种口径：最近N天、本周、上周、本月、上月。时间窗决定这条条件统计哪一段流水；不选时默认按最近 30 天统计。
五、典型使用场景
| 场景 | 操作路径 |
|---|---|
| 新标签上线前验证 | 标签管理建好系统标签并保存条件 → 条件引擎选它 → 执行条件查询 → 人数在合理区间 → 结果写入关联表 |
| 活动当天临时圈人 | 选活动标签 → 执行条件查询确认人数 → 结果写入关联表 → 立刻去营销计划执行该人群 |
| 怀疑标签口径出问题 | 逐个选标签执行条件查询，对比提示人数和列表「会员数」，差异大的就是条件被改过而关联表还没刷新 |
| 批量核对全部口径 | 直接用列表当清单看：每行一个系统标签的条件摘要与人数，导出留档做口径评审 |
六、权限控制与前置条件
- 需要「条件引擎」的功能授权；执行条件查询是只读的，结果写入关联表会修改打标关系，建议只开放给总部运营；
- 前提是画像指标表有数据（见ETL管理）。指标表为空时任何条件都圈不到人，提示会显示匹配 0 个会员；
- 单次条件查询有 30 秒超时保护，条件过宽、时间窗过长时报错「条件查询失败: ...」，先收窄条件再试；
- 大规模人群（十万级以上）写入关联表会占用较长时间，建议避开营业高峰执行。
七、常见问题
1. 点执行条件查询提示「请先在条件面板选择标签」
- 原因：「系统标签」下拉停在「不限」；
- 处理：下拉里选中一个具体标签，两个按钮都以这个标签为准。
2. 试算出 0 人
- 原因：条件之间是「且」关系，叠加后交集为空；时间窗选得太窄；或会员指标还没刷新；
- 处理：一次只留一个条件试算，逐条往上加，看加上哪一条后人没了；再到 ETL 管理确认最近一次日计算是否成功。
3. 人数对，但营销计划里圈不到人
- 原因：只做了「执行条件查询」，没有「结果写入关联表」。营销计划取的是关联表，不是条件表达式；
- 处理：补一次结果写入关联表，再回到营销计划重新估算覆盖人数。
4. 会员已经不符合条件了，标签还挂着
- 原因：写入关联表只新增、不删除，历史打标不会自动摘除；
- 处理：需要立刻清理时到标签管理「查看会员」里勾选移除；日常靠夜间批量计算按标签重算。
5. 提示「条件查询失败」或查询卡住很久
- 原因：条件太宽触发 30 秒超时，或标签用的是旧版条件格式；
- 处理：先缩短时间窗、加一个金额或次数阈值缩小范围；旧格式标签到标签管理「设置条件」里重新保存成新格式后再试。