产品总览与学习路径

易盾智能风控（iRisk）做的事只有一句话：判断一次用户行为有没有黑产风险，并给出可以立刻执行的处置动作。

1. 产品在解决什么问题

客户在登录、注册、下单、领券、充值、游戏对局、内容发布等关键行为发生时，会通过 SDK 或服务端接口把设备、账号、行为、网络等信息交给易盾。易盾在几百毫秒内回答三件事：

回答	产出	客户怎么用
有没有风险	风险等级（无风险 / 低 / 中 / 高）	决定是否放行
为什么有风险	命中的规则、名单、指标、风险标签	运营解释、申诉复核
该怎么处置	放行 / 拦截 / 验证码 / 二次验证 / 弹窗 / 闪退	直接执行处置动作

因此产品不是「一个接口」，而是「数据采集 + 设备识别 + 策略判定 + 处置执行 + 数据回流」的闭环。

2. 先记住六个核心概念

新同学最容易在这里迷失，先建立这张概念地图：

概念	含义	类比
业务（Business）	客户在易盾开通的一个服务实例，带唯一 businessCode	一个「场」
产品 / SKU / 套餐	客户买了什么能力、什么规格、什么计费档	「商品 + 规格 + 有效期」
策略（Strategy）	一套判定规则的组织单位，绑定某个业务与场景	「一份守则」
策略集（StrategySet）	策略的执行单元，分通用集与私有集，可并发执行	「一章守则」
规则集 / 规则 / 条件	规则集是规则的有序集合，规则由条件表达式组成	「条款 / 句子 / 判断词」
名单 / 指标 / 预处理	规则可直接引用的三类判定能力与数据准备能力	「黑名单 / 统计口径 / 数据清洗」

概念之间的归属关系：业务 → 策略 → 策略集 → 规则集 → 规则 → 条件，名单、指标、预处理作为独立能力被规则引用。

3. 系统由哪些服务组成

全仓 14 个可独立部署的服务模块，分成五层：

4. 一次检测请求的完整路径

这是全部文档的主线，后面每篇都在展开其中一段：

5. 建议的学习路径

顺序	阅读	你要能回答的问题
1	本篇 + 02 总体架构	系统有哪些服务，请求怎么流动
2	03 接入与使用指南	一个新客户从开通到跑通检测要做哪些事
3	05 智能风控检测	检测上下文里有什么，处理链怎么短路
4	06 策略中台	策略集如何被拆分并发执行
5	07-10 四个 checker	规则、名单、指标、预处理各自的输入输出
6	11-12 端侧接入	sid 与 SDK 数据是怎么来的
7	13-18 中台与平台	业务/元数据/事件/数据仓/网关/权限如何支撑
8	04 问题排查手册	线上现象该从哪一层开始查

6. 排查视角的三条经验

新同学排障时最容易「一上来就翻代码」，先记住三个判断顺序：

1. 先确认请求有没有进来：网关日志 → 检测服务入口日志。没进来就查网关鉴权、路由、客户签名，不要往下看。
2. 再确认判定有没有执行：策略执行是否命中预期策略集、预处理是否产出 prepro.* 字段。判定没执行，多半是业务/套餐不可用或策略未上线。
3. 最后才怀疑规则逻辑：到这一步再看条件表达式、名单匹配器、指标窗口与缓存版本。

详细的「现象 → 定位 → 结论」清单见 04 问题排查手册。