# 答辩 Demo · 全流程 SOP（给人看 · 亮点优先）

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

**分册 SOP（细节不重复写死在本页）：**

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

---

## 1. 答辩前准备（建议提前 45～60 分钟）

### 1.1 一键灌库（推荐）

```powershell
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`](../项目框架设计/演示SOP-风控模块.md) §2 双库 DROP 重灌。

**问数模板/指标字典缺失：** `.\scripts\dev\seed_analyst.ps1` 或 [`DEMO-SOP-问数.md`](DEMO-SOP-问数.md) §1。

### 1.2 依赖服务

```powershell
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`](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`](../项目框架设计/理财顾问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`](答辩知识点清单.md) §九。

---

## 9. 资料包

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

**维护：** 同步 [`README.md`](README.md) · **答辩稿** · 知识点清单 · 功能测试 · 幻灯片 · 总览课模块 8。

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