6.6 KiB
需求拆解（对照开发）
来源：
docs/需求拆解/业务场景优先级清单.md（P0）
合规：docs/需求拆解/Agent风险与合规约束汇总.md
数据：docs/需求拆解/数据交互矩阵.md
本轮范围
- 目的： 四 Agent 服务四类人群，统一数据层 + 合规底座，可对话闭环。
- 明确不做： 自动交易、营销推荐、Agent 互调 LLM、自动冻户、Streamlit、P3 平台能力。
合并状态（2026-09-08）： AL-09 接线完成（merger 分支）——宿主 Wave 0 与风控模块共存；JWT/login 统一；chat/risk 走模块鉴权；502 pytest 绿。
Wave 0 · 共用底座
| ID | 需求 | 验收对照 | 状态 | TODO |
|---|---|---|---|---|
| F-01 | JWT + RBAC + 数据归属 | 越权 403 + audit；JWT 手册 §13 | 已完成（T-01，2026-09-07）：auth_service 验签/吊销 + deps 工厂（Bearer 全环境 + dev debug 头兜底）+ X-Agent-Type 准入矩阵 + 归属断言（B6 已有）；越权 403 + audit + input_guard_log 双写 | |
| F-02 | 全量审计留痕 | trace_id 可还原 | 已完成（T-02，2026-09-07）：http_access 审计中间件 + X-Trace-Id/X-Request-Id 双贯通 + 4xx/500 统一错误体；业务判定审计 B6 已接 | |
| F-03 | 输入防护 | input_guard_log | 完成（2026-09-07，T-03）：prompt_injection（词表纯函数检测，T-03 初版 42 条、2026-09-09 实测扩至 45 条 = 18+11+9+7，命中即拒）/ oversize（4000，Pydantic 硬顶 20000）/ rate_limit（Redis 固定窗口 actor 级 30 次/分 fail-open）；chat 链路 blocked 全留痕，fail-fast 不建会话 | — |
| F-04 | Core 只读层 | 不改 Core 账；Repository 只 SELECT | 已完成（T-04，2026-09-07）：core_ro（含风控扩展）经 app/tool/core_tools.py 三只读 Tool 接入 chat（L0/持仓/流水）；Tool 层归属校验（A-01 语义：customer 本人/advisor assigned/risk_officer 全量）+ agent_tool_call 全留痕；Core 侧仍仅 SELECT | |
| R0-DB | MySQL 共用 11 表 + Redis | 01-mysql-共用底座.sql | SQL 已定；本机已灌库（B9b 走查验证） | T-05（本机已完成） |
| R0-CORE | Core 模拟 + 同步 | reset.ps1 + sync 脚本 | 脚本已落地 | T-05 |
F-01 部分完成说明： B6 已落地 app/api/deps.py（AuthContext Pydantic + get_auth_context() 工厂，dev 从 X-Debug-Role/X-Debug-Actor 头构造；T-01 就绪后仅替换工厂内部为 JWT 解析）。
F-04 完成说明（T-04，2026-09-07）： app/repository/core_ro.py（含风控扩展）仅 SELECT 不变；对话接入经 app/tool/core_tools.py（query_customer_profile / query_holdings / query_recent_trades，TOOL_REGISTRY 白名单）+ app/service/tool_service.py（run_tool：归属校验→执行→agent_tool_call 落库）；agent_service 图为 START→tool→llm→guard，customer_id 由会话注入不接受 LLM 生成。风控五 Tool（C1 四只 + C5 追加 query_overdue_alerts，RISK_TOOL_REGISTRY 实 5 个）复用同一 runner。
Wave 1 · 内部 Agent P0
| ID | 需求 | 验收对照 | 状态 | TODO |
|---|---|---|---|---|
| D-01~D-04 | 分析：客户/产品/预警查数 + SQL 留痕 | analytics_query_log | 已实现（S3+D-09 子集 · 2026-09-11）：问数默认 interpret=false（仅表/SQL）· POST /api/analyst/interpret 按需解读（看图说话） · sql_guard/guardrail · self 域尾注 |
|
| A-01~A-05 | 代理人：画像/规则/草稿/流程/合规巡检 | 非归属 403；草稿不外发 | 未做 | T-20 |
Wave 2 · 风控 P0
详细需求见
docs/PRD/PRD-风控监测Agent.md（v1.0 冻结 + v1.1 追加 FR-8/9/10）；范围含 R-04（P1 顺手做）、R-05 仅预留 L3 接口。
| ID | 需求 | 验收对照 | 状态 | TODO |
|---|---|---|---|---|
| R-01 | 大额预警 | risk_alert pending_review | 已实现（B1~B6，A-1/A-2 用例绿） | |
| R-02 | 适当性阻断请求 | 唯一阻断场景 | 已实现（ |
|
| R-03 | AML 命中通知 | 不自动冻户 | 已实现（aml_service + scan API + L3 联动；对话线随 C1~C3 完成，A-6 验收通过） | |
| R-04 | 频繁/试探模式预警 | 聚合出单 + 去重 | 已实现（B1 规则 + B2 聚合去重） | |
| R-05 | L3 画像写入 | 最小写入（最高档合并） | 已实现（profile_l3 防降级；risk_score 一期保持 NULL 归评分模型首写） |
|
| FR-8 | 客户资产配置集中度预警（RISK-006） | A-10：R4+R5 占比 ≥ 阈值出单（并入事件类聚合）；对话线只读展示 | 已实现（C4 fe4801b，2026-09-07） |
|
| FR-9 | 预警单处置时效监控与自动升级（RISK-007） | A-11：超时分级升级（payload 承载不改 status）+ 幂等 + 降噪 | 已实现（C5 90d0660 + escalation_scan 脚本，2026-09-07） |
|
| FR-10 | 代理人异常行为链识别（RISK-008） | A-12：条件 A/B/C 触发 + 代理人维度出单（payload.actor_id）+ 明细仅 officer/manager 可见 | 已实现（C6 66ec7eb + agent_behavior_scan 脚本，2026-09-07） |
Wave 3 · 客户 P0
| ID | 需求 | 验收对照 | 状态 | TODO |
|---|---|---|---|---|
| C-01 | 持仓查询 | Core 只读 fact_text · 无买卖指导 | 已实现 · holding_query |
|
| C-02 | 产品规则咨询 | fin_product RAG + 免责 | 已实现 · Wave1~2 | — |
| C-03 | 政策/FAQ | fin_policy / fin_faq RAG | 已实现 · Wave1~2 | — |
| C-04 | 亏损阈值提醒 | customer_threshold_config + 持仓查询追加提醒 |
已实现（2026-09-10） · threshold_service |
|
| C-05 | 产品净值 | Core 快照；禁止实时盘口 | 已实现 · Chat nav_query · 平台 nav/history 详情（区间 1M~ALL · 日/周 · 走势/涨跌柱/组合 · 时间轴）· Phase B sync 未做 |
|
| C-07 | 风评查询 / 重测引导 | Core L0；重测引导 App/网点 | 部分已实现 · 无 Agent 内问卷 | T-41 |
| C-08 | 配置目标 | L1 槽 allocation_target |
部分已实现 · 无偏离检测/调仓 | T-41 |
| C-11 | 适当性匹配说明 | 非营销推荐；联动 R-02 | 部分已实现 · 「我能买什么」→ suitability；「推荐稳赚」仍 reject | T-42 |
Wave 3 未做： 主动 push/cron 阈值通知 · Phase B 行情 sync · GraphRAG 式推荐 · 自动调仓。