Files

T

zhanghongyu_0626 d394686a3b feat(advisor-agent): Integrate advisor agent functionalities and migration scripts

- Merged the `integrate/advisor-agent` branch into the `merger`, enhancing the advisor agent's capabilities with compliance, KYC, and script templates.
- Updated the testing baseline to reflect 926 passed tests, with 65 failures concentrated in the advisor agent's `test_sprint*` cases.
- Introduced new migration scripts for advisor-related database structures, ensuring smooth integration and data management.
- Enhanced documentation to include the new API structure and integration details, providing clarity for future development.

This update significantly advances the advisor agent's functionality while maintaining a structured approach to integration and testing.

2026-09-12 16:37:29 +08:00

3.3 KiB

Raw Blame History

服务对象大环境（现状 / As-Is）

来源：docs/需求拆解/业务场景优先级清单.md、docs/需求拆解/用户故事/
Core 说明： 生产环境应以真实 Core 为 L0 权威；本项目无真实 Core，开发用 jinrong_core 模拟库（见 docs/项目框架设计/Core模拟底座/）。

1. 服务对象与角色（现在）

角色	谁	在环境里干什么
C 端客户	公募投资者	看持仓、查产品、交易；正式 C1~C5 在测评系统
理财代理人	一线理财经理	服务名下客户、多系统查持仓、讲解规则、跟进
内部员工	分析、运营、合规	问数、报表、抽检会话、协同风控
风控 / 合规官	风控专员	监测大额/适当性/AML；人工审核，不自动冻户

L0 权威来源（本项目）： MySQL jinrong_core 模拟库 — 客户、C1~C5、持仓、流水、产品、代理人-客户归属。Agent 代码经 CoreReadOnlyRepository 只读 SELECT，不提供 HTTP Core API。

2. 对方现在怎么办事

客户：App/柜台看持仓；亏损无 Agent 式阈值提醒。
代理人：多后台手工汇总；话术自写，合规靠事后检查。
内部分析：SQL 或 IT 导表。
风控：事后/T+1 发现异常；适当性靠交易前规则；AML 批处理或人工。

Agent 尚未上线；后端 merger + 工作区顾问接缝（integrate/advisor-agent）：python -m pytest → 926 passed, 65 failed, 1 skipped（失败集中在顾问 test_sprint*；不含 sprint 896 passed · 1 eval 红）· web Vitest 27（2026-09-12）；问数 AN-002 · 顾问合并 docs/项目框架设计/理财顾问Agent-合并说明.md。

3. 主路径（现状 → 模拟后）

开户/测评 → Core（模拟：core_customer + core_customer_risk）写 L0
交易 → Core 流水（模拟：core_trade）；交易前适当性 R-02 已实现（模拟网关 app/gateway/ + service/suitability.py，唯一阻断点）
同步 → sync_advisor_rel.py 写入 agent 库 customer_advisor_rel；sync_neo4j.py 灌关系图
代理人服务 → 查 Core RO + 口头沟通（L2 画像表待业务实现）
风控 → 规则/人工台账；合规事后抽检

4. 环境里的关键对象

名称	含义	本项目存储
L0 正式档案	customer_id、C1~C5、年龄、职业、advisor	`jinrong_core.core_*`
持仓/流水	产品、份额、盈亏	`core_holding` / `core_trade`
代理人-客户归属	服务关系	Core 种子 → 同步 `jinrong_agent.customer_advisor_rel`
Agent 会话/画像/审计	平台业务数据	`jinrong_agent`（11 共用表 + agent 专用表）

5. 痛点与约束

痛点：客户看不清持仓与规则；代理人多系统慢、话术易违规；问数靠 SQL；风控感知滞后
不能动：正式 C1~C5 仅测评/人工变更；事实账以 Core 为准（模拟库亦只读）；监管要求审计与适当性
模拟边界：不模拟 TA/清算/报盘；**净值 365 日与模拟宽基同向（beta）** · 交易 05+08 跨月 · 持仓为单日快照 · Neo4j 由同步脚本维护

3.3 KiB Raw Blame History Unescape Escape