客户查询需求

1. 菜单定位

对应原型菜单：Customer Search。

客户查询是客服定位客户和进入客户 360 的唯一主入口。客户 360 不作为左侧菜单，从查询结果或其他业务上下文打开。

2. 建设目标

支持客服通过手机号、客户 ID、订单号、BVN/NIN 后几位等信息定位授权 App 内客户。
支持展示客户跨 App 账户关系，并持续标识 App 来源。
支持在客户 360 内查看进件、借款、还款、认证/登录、工单和日志。
支持从客户上下文创建工单或打开业务详情。
所有敏感字段默认脱敏，明文查看独立授权并审计。

3. 查询条件

字段	说明
Keyword	可输入客户 ID、姓名、脱敏手机号、BVN/NIN 后几位、订单号
App	限制在当前授权 App 范围内

后续可扩展为独立字段：

手机号。
全局客户 ID。
App 客户 ID。
订单号 / 进件号。
BVN / NIN。
客户状态。

4. 查询结果

列表字段：

全局客户 ID。
姓名。
脱敏手机号。
脱敏 BVN / NIN。
客户状态。
风险提示。
授权可见 App。
当前问题。
操作入口：Open 360、New Ticket。

交互规则：

点击客户打开客户 360 Tab。
点击 New Ticket 时自动带入客户上下文。
最近查询只保存必要条件摘要，不保存敏感明文。
无结果时提示检查 App Scope、查询条件格式和权限范围。

5. 客户 360

5.1 顶部信息

全局客户 ID。
姓名。
脱敏手机号。
脱敏 BVN / NIN。
客户状态。
风险提示。
最近登录。
当前问题摘要。

5.2 App 账户切换

客户可能命中多个 App 账户。客户 360 需要按 App 展示：

App 客户 ID。
产品。
账户状态。
授信状态。
借款状态。
最近订单。
注册时间。

5.3 二级内容

页签	内容	对应文档
Applications	进件状态、结果、可解释原因	13-进件查询需求
Loans / Repayment	借款、放款、还款计划、实还流水	14-借款与还款查询需求
Auth / Login	认证状态、失败原因、登录设备摘要	本文
Tickets	客户关联工单	12-工单中心需求
Logs	查询和处理轨迹	22-审计日志需求

6. 认证与登录

认证信息字段：

App。
认证类型：BVN、NIN、KYC、活体等。
认证状态。
认证时间。
失败原因。
脱敏认证手机号。
身份照片或认证图片入口。

登录信息字段：

App。
登录时间。
设备摘要。
登录结果。

控制要求：

身份照片默认不直接展示，查看需独立权限。
不展示风控策略阈值或可被反向利用的信息。
查看敏感认证信息必须写审计日志。

7. 权限与审计

查询客户必须具备 customer.search。
查看客户 360 必须具备 customer.read。
查看认证照片、手机号明文、BVN/NIN 明文必须具备敏感字段权限。
跨 App 查询结果必须限制在当前账号授权 App 范围内。
客户查询、客户 360 查看、敏感字段查看、创建工单入口均需审计。

8. 验收口径

客服能通过 Customer Search 定位客户并打开客户 360。
同一客户命中多个 App 时，客户 360 能按 App 切换展示。
客户 360 能打开进件、借款、工单等上下文详情。
敏感字段默认脱敏，明文查看受权限控制。
无权限 App 数据不会出现在查询结果或下拉选项中。