57 lines
2.3 KiB
Markdown
57 lines
2.3 KiB
Markdown
# 主项目接入清单
|
||
|
||
## 文档功能
|
||
|
||
本文档用于说明主项目需要提供哪些公共能力，以及风控模块需要向主项目注册哪些业务入口，作为代码合并和联调检查清单。
|
||
|
||
## 主项目需要提供
|
||
|
||
| 能力 | 要求 |
|
||
|---|---|
|
||
| 身份认证 | 提供有效 JWT 和统一登录流程 |
|
||
| RBAC | 从数据库加载有效角色、权限和数据范围 |
|
||
| 数据库 | 提供基线表、连接池和事务能力 |
|
||
| 路由 | 支持追加风控 Controller |
|
||
| Agent 工厂 | 支持追加注册业务 Agent 和只读工具 |
|
||
| Worker | 支持 Agent Run 和业务异步任务 |
|
||
| Outbox | 支持业务领域事件可靠投递 |
|
||
| 审计 | 支持追加 `interaction_audit` |
|
||
| 模型服务 | 提供模型端点解析和调用入口 |
|
||
| Redis | 作为可选缓存，不可用时可降级 |
|
||
| Milvus | 作为可选语义记忆，不可用时可降级 |
|
||
| 配置发布 | 支持 Agent 工具白名单和意图配置 |
|
||
|
||
## 本模块需要注册
|
||
|
||
| 注册项 | 内容 |
|
||
|---|---|
|
||
| 路由前缀 | `/api/v1/risk` |
|
||
| Agent 类型 | `agent_type=risk` |
|
||
| Agent 展示名 | 奶龙风控智能助手 |
|
||
| 允许角色 | `risk_operator`、`admin` |
|
||
| 允许入口 | `api` |
|
||
| 只读工具 | 风险概览、预警查询、预警证据 |
|
||
| 权限 | `agent:run`、`risk:alert:read`、`risk:alert:write`、`risk:alert:scan`、`risk:report:mail` |
|
||
|
||
## 数据库依赖
|
||
|
||
主项目需要确保以下类别表已经存在：
|
||
|
||
- 账号和 RBAC：`sys_user`、`sys_role`、`sys_permission`、`sys_user_role`、`sys_role_permission`、`sys_customer_assignment`。
|
||
- 风控业务：`fin_risk_alert`、`fin_risk_notification`、`biz_work_order`。
|
||
- 金融数据：客户画像、风险测评、产品、交易、资金、持仓和登录记录。
|
||
- 平台审计：`interaction_audit`。
|
||
|
||
本模块不负责新增数据库表或执行演示数据初始化。演示机数据准备规则见
|
||
`26-演示机数据插入规则.md`。
|
||
|
||
## 接入验收点
|
||
|
||
- 主项目路由能够访问本模块只读查询接口。
|
||
- 风控账号拥有角色和对应权限。
|
||
- 风控写接口和扫描接口支持并携带 `Idempotency-Key`。
|
||
- 风控账号具有有效的客户归属数据。
|
||
- Agent Run 能够调用本模块工具。
|
||
- 工具调用、处置和权限拒绝能够写入审计。
|
||
- Redis 或 Milvus 不可用时，结构化风控功能仍可用。
|