Files
group_xinghuo_jinrong/docs/答辩/DEMO-SOP-答辩全流程.md
T
zhanghongyu_0626 647c07062e feat(trade): Enhance trade processing and context handling in customer service
- Introduced `pending_trade` handling in the chat API to manage trade requests more effectively.
- Updated the `submit_trade_api` to allow advisors to access customer trades based on assigned roles.
- Added new methods in `GatewayRepository` for managing core holdings during trade subscriptions and redemptions.
- Implemented context-aware trade dialogue management in the customer service layer to improve user experience during multi-turn interactions.
- Enhanced the tool service to support trade actions and suitability checks, ensuring accurate processing of user requests.

This update significantly improves the trade interaction flow, providing a more robust and user-friendly experience for customers engaging in trading activities.
2026-09-13 17:45:04 +08:00

8.6 KiB
Raw Blame History

答辩 Demo · 全流程 SOP(给人看 · 亮点优先)

用途: 答辩、汇报、业务方走查——按时间选路线,每步带口述句与可展示的亮点。
上台口径: 只讲需求、业务与系统展示;不口播测试数、缺陷、实现进度。口播主稿 答辩稿.md。
内部基线(备查): docs/memory/MEMORY.md §0

分册 SOP(细节不重复写死在本页):

中文职责 路径
问数工作台逐步操作 DEMO-SOP-问数.md
风控 Swagger / 灌库 / A-1~A-12 ../项目框架设计/演示SOP-风控模块.md
答辩手册索引 README.md
口播稿 答辩稿.md
Demo 功能测试 DEMO-功能测试流程.md
答辩提纲与 Q&A 答辩知识点清单.md
HTML 答辩幻灯片 presentation/index.html
顾问合并与 API ../项目框架设计/理财顾问Agent-合并说明.md
浏览器滚动动线 ../course/jinrong-overview/index.html 模块 8

1. 答辩前准备(建议提前 45~60 分钟)

1.1 一键灌库(推荐)

cd "d:\项目\JinRong"
.\scripts\demo\prepare_all.ps1
.\scripts\demo\seed_advisor_agent.ps1    # 顾问迁移 + 合规规则 + 话术(合并后建议必跑)
python scripts/sync/sync_advisor_rel.py

仅风控重走 A-1~A-5 且库已脏: 见 演示SOP-风控模块.md §2 双库 DROP 重灌。

问数模板/指标字典缺失: .\scripts\dev\seed_analyst.ps1 或 DEMO-SOP-问数.md §1。

1.2 依赖服务

docker compose up -d redis    # 或 .\scripts\dev\start-redis.ps1
# .env: REDIS_URL=redis://127.0.0.1:6380/0
# DEEPSEEK_API_KEY=…(客服/问数解读/风控 Chat 建议有 Key;无 Key 见 §7 降级)

python -m uvicorn app.main:app --reload --host 127.0.0.1 --port 8000
# 或 .\scripts\dev\restart-dev.ps1 -Backend Local
cd web && npm run dev          # http://localhost:5173

1.3 自检(30 秒 · 给观众看「工程化」)

检查 操作 亮点话术
就绪探针 GET http://127.0.0.1:8000/api/ready (内部)前后端就绪自检
前端条 DevReadyBanner 无红字 (内部)环境不一致时告警

1.4 Demo 账号

登录页 答辩账号记号本(defenseAccounts.ts)· 主账号:

角色 Actor 默认首页
客户 CUST-9527 #/app/customer/home
适当性阻断 CUST-1001 风控 A-1 同源
理财师 STAFF-10086 #/app/advisor/home
分析员 STAFF-20001 #/app/analyst/home
风控 STAFF-30001 #/app/risk/home

答辩前验收: DEMO-功能测试流程.md P0 全绿。


2. 开场 30 秒(必背 · 与亮点挂钩)

  1. 定位: 代销四角色 AI + 统一 L0 与合规底座;强调可演示的业务闭环。
  2. 架构句: 四 Agent 不互调 LLM;跨线靠画像/预警表 + 代销 platform REST(重复能力 以 platform 为准)。
  3. 客户线: 咨询有据 · 选购清单 · 合规拒答 · 交易确认后看板更新(演示带过,不深讲)。
  4. 顾问线: 合规检测 · 市场异动 · 话术 · 顾问对话。
  5. 铁律: L0 不可被画像覆盖 · 仅 R-02 可阻断 · 风控不自动冻户 · 审计只 INSERT。

3. 路线选择

路线 时长 适合 覆盖
A · 精华 6~8 分钟 时间紧 §4 步骤 0→1→2→3
B · 标准答辩 12~15 分钟 答辩/评审 步骤 0~4 + 6 收口
C · 全亮点 20~25 分钟 技术深度 §4 全部 + §5 可选 + 基金转换

4. 标准演示步骤(按顺序 · 每步「操作 → 亮点 → 口述」)

步骤 0 · 登录与 Dashboard

操作 亮点 口述句
登录 客户 → 首页 图表/持仓 · 脱敏只遮 UI 「Dashboard 走 platform API 只读 Core」
顶栏 Actor ID 与 JWT sub 一致 「Tool 归属、问数域绑在这个 id 上」

步骤 1 · 客户财富线(Chat · 交易带过)

操作 亮点 口述句
客户助手 · 问持仓/净值 Core 只读 · 出口净化 「回答有据,不是模型编造」
问 「我能买什么」 序号清单 · 适当性 「能买什么讲清楚,清单不被改写成计数」
可选:一次确认(Chat 或交易中心) 看板刷新 「用户确认后,首页和助手看到同一持仓——带过即可」
可选:「推荐稳赚」 合规拒绝 「不能乱承诺收益」

步骤 2 · 风控事件线

操作 亮点 口述句
模拟交易 A-3 预警 pending · core_trade 「仅 R-02 在网关 blocked」
台账 处置 stats · 409 状态机 · audit 同事务 「Agent 不能改状态,REST 处置」
可选:基金转换 · 演示预置 T+1 节奏 「受理和确认分开,符合基金业务习惯」

步骤 3 · 问数

操作 亮点 口述句
客户总数 模板 Tag · 缓存 Tag 「D-06 模板 + 表世代 bump」
分析该数据 /interpret · D-10 「解读只有本轮 Q+表」
可选:POST /analyze 图表 Modal 「问数与 Chat 路由拆分」
近30天流水 clarify N-01 「多义不猜口径」

步骤 4 · 理财师顾问工作台(2026-09-12 合入 · 标准答辩建议展示)

操作 亮点 口述句
换 STAFF-10086 → 合规检测 POST .../compliance/content-check 「顾问线 REST 与 Chat 并行,写 audit」
市场异动 扫描 Core 净值 · 异动单 「D1 接缝已修;扫描可演示 created 条数」
话术模板 CRUD / 引用 「与问数 template_service 不同域」
可选:顾问助手 Chat 1~2 轮 理财师对话 「和客服是不同业务编排」

合并说明:理财顾问Agent-合并说明.md


步骤 5 · 风控 Chat(只读 · 30 秒)

操作 亮点 口述句
风控登录 → 风控助手 6 只只读 Tool 「查可以,改状态走 REST」

步骤 6 · 收口

展示 口述
幻灯片「业务价值收口」 四角色 · 可解释 · 可处置 · 可演示
docs/course/ 会后自助深潜

5. 亮点清单(可穿插口述)

主题 展示动作 一句话
客户交易闭环 Chat 清单 + Modal + 交易中心 holding 同步 · 首页刷新
顾问 REST 合规 + 异动 /api/advisor-agent 已合入 merger
基金转换 风控菜单转换页 T+1 受理/确认分离
问数 analyze 问数页分析助手 /analyze 文/图
合规双护栏 sanitize + sql_guard 输入 + 执行前 guard
Ready /api/ready 半升级第一道灯
设计栈 Inter + Radix 状态阶 2026-09-13 前端补强

6. 可选加深(路线 C)

项 操作
问数 battery run_query_battery.py(不入库)
风控 A-4 / A-12 聚合 · 行为链
架构治理课 jinrong-architecture-governance
顾问冒烟 python scripts/dev/advisor_e2e_smoke.py

7. 无 DeepSeek Key

能力 无 Key 时
问数解读/analyze 可能 degrade — 跳过按钮
客服 Chat Tool 事实类仍可用
顾问 KYC 对话 依赖 LLM 的步骤跳过

8. Q&A 指针

见 答辩知识点清单.md §九。


9. 资料包

docs/答辩/README.md
docs/答辩/答辩稿.md
docs/答辩/DEMO-功能测试流程.md
docs/答辩/presentation/index.html
docs/答辩/答辩知识点清单.md

维护: 同步 README.md · 答辩稿 · 知识点清单 · 功能测试 · 幻灯片 · 总览课模块 8。

内部备查(不上台): 工程边界与测试数字见 MEMORY · 知识点清单 §八 · DEMO-功能测试流程.md。