feat(chat): Enhance session management with new API endpoints and filtering options

- Added `status` query parameter to `list_sessions_api` for filtering sessions by their status (active/closed). - Introduced `close_all_sessions_api` endpoint to allow users to close all active sessions for the current actor. - Updated `SessionRepository` to support status filtering in session listing and implemented logic for closing active sessions. - Improved Redis connection settings for better performance and reliability. This update enhances the chat functionality by providing more control over session management, improving user experience and system efficiency.
2026-09-10 22:30:07 +08:00
parent 48355cee8e
commit 9d4d4aaa6d
59 changed files with 2261 additions and 265 deletions
@@ -25,4 +25,8 @@
 | 2026-09-10 | **数据分析 Agent 护栏/口径迭代**（cherry-pick `445cfbb` 功能层）· guardrail Decimal/编号/时间窗 · 流水 N-01 消歧 · battery 脚本改 `issue_dev_token` | 远程 `data-analysis-agent` 未合 merger | guardrail / dict_service / wave6 测试 / `数据分析Agent-代码迭代.md` |
 | 2026-09-10 | **数据分析 D-06 缓存**：结果缓存表世代 + 写侧 bump（trade/alert/L3）· **模板填参**（`template_service`）· 问数页 template/cache 标签 · `804 pytest` | 用户拍板 D-06 必须 · PII 脱敏暂缓 | cache_service / template_service / analyst_agent / web |
 | 2026-09-10 | **风控前端 P1 + 演示**：台账筛选 · 适当性/AML 页 · `prepare_all.ps1` · 深潜课模块 7 | 2026-09-10 拍板收口 | web/risk · scripts/demo · docs/course |
-| 2026-09-10 | **`battery_report.json` 不入库** | 本地跑分产物 | `.gitignore` |
+| 2026-09-10 | **客户/共用 ChatPanel**：流式请求补传 `session_id`（续聊不再每轮新建会话）· `sessionStorage` 刷新恢复 · 会话侧栏 8 条分页 · 固定高度布局 | E2E 反馈 CHAT-1/2 | web · 整体测试交接 · MEMORY |
+| 2026-09-10 | **前端 E2E 问题清单收口**：`AuthProvider` 修登录崩溃/退出死循环 · Redis `socket_connect_timeout` 0.5s · 预警筛选防抖 · I18N formatter · 对话 Markdown 粗体 · A11Y `index.html` · AntD `<App>` | `docs/整体测试/前端整体测试交接.md` 登记项 | web · `database.py` · MEMORY |
+| 2026-09-10 | **答辩/课程**：`docs/答辩/答辩知识点清单.md` · 总览模块 8 · 问数课 D-06 模块 5 · 导览中心更新 | 用户答辩准备 | docs/course · MEMORY |
+| 2026-09-10 | **客服问候修复**：「你好」关键词 → `chit_chat` · LLM 失败 `CHITCHAT_DEGRADED_TEXT`（非 FALLBACK）· 游客问候快路由 | 用户反馈 Chat 无法回答问候 | customer_prompts · customer_service · visitor · tests |
+| 2026-09-10 | **产品口径落账**：Redis≠Dashboard 缓存 · 四角色 home 有图无 BI · 客户趋势=问数 self 域非 Chat 曲线（§9.6） | 用户问答澄清 | MEMORY §0/§3 · TODO §2026-09-11 · FRONTEND-HANDOFF §10 |
@@ -9,7 +9,7 @@

 **项目是什么：** 金融四 Agent（客户财富 / 代理人 / 数据分析 / 风控）共用数据层与合规底座；**不**互调 LLM，跨 Agent 走 L1/L2/L3 画像与预警表。

-**当前进度：** 需求与表设计已定 · **风控 + 平台 API + 客服 S2 Wave3 + 数据分析 S3/P2/D-06 + 前端四角色 P0 Demo** · **804 pytest** · **19 Vitest** · **Redis @ 6380** · **`merger` 工作区未 commit**
+**当前进度：** 需求与表设计已定 · **风控 + 平台 API + 客服 S2 Wave3 + 数据分析 S3/P2/D-06 + 前端四角色 P0 Demo** · **804 pytest** · **22 Vitest** · **Redis @ 6380** · **`merger` 工作区未 commit**

 **工作分支：** 团队开发在 **`merger`**；历史 `risk-control-agent` 交付冻结。

@@ -41,14 +41,14 @@
 | `app/utils/` | **基本就绪** | trace（trace_id+request_id 双 contextvar）/ desensitize / db（引擎工厂）/ response（统一错误体+4xx/500 handler）/ exceptions（含 ApiError）已实现；logger 占位 |
 | `app/config/database.py` | **已实现** | MySQL 双引擎 + **Redis 单例**（`REDIS_URL` · **RESP2 `protocol=2`** 兼容 Docker Redis 7 / 旧 Windows Redis 3） |
 | `app/config/settings.py` | **已实现** | 双库 + risk_* 阈值 + JWT + **customer/visitor/profile** 字段 + `kb_root_dir` |
-| `app/service/customer_service.py` `visitor_service.py` | **已实现（S2 + Wave3 部分）** | 客服 14 节点 · **C-04 阈值** · **C-05 nav_query** · **C-11 匹配说明** · 游客 9 节点；共用 `sanitize_postprocess.finalize_sanitized_reply`（1B）；RAG **fin_* 三库** |
+| `app/service/customer_service.py` `visitor_service.py` | **已实现（S2 + Wave3 + 问候快路由）** | 客服 14 节点 · **C-04 阈值** · **C-05 nav_query** · **C-11 匹配说明** · **「你好」等问候关键词 → chit_chat；LLM 失败闲聊降级 `CHITCHAT_DEGRADED_TEXT`** · 游客 9 节点；共用 `sanitize_postprocess`（1B）；RAG **fin_* 三库** |
 | `app/service/threshold_service.py` | **已实现（C-04）** | L1 `threshold_pref_summary` → `customer_threshold_config`；持仓查询加权盈亏 vs 阈值 → `customer_notify_log` |
 | `app/utils/sanitize_postprocess.py` | **已实现（1B 共用）** | 数据查询 intent（含 nav_query）违禁 → 回退 fact_text；RAG/闲聊 → COMPLIANCE_REJECT；均不自动 transfer |
 | `scripts/core/*.sql` + `reset.ps1` | **已实现** | Core 模拟库 DDL + 种子 |
 | `scripts/agent/` `scripts/demo/` `scripts/dev/` | **已实现** | AML 种子 · **`prepare_all.ps1` 一键灌库** · `seed-analyst-query-templates.sql`（模板缓存）· `run_query_battery.py`（**不入库**）· `start-redis.ps1` |
 | `scripts/sync/*.py` | **已实现** | 归属同步 + Neo4j 全图 |
 | `tests/` | **已实现** | **804 用例** 1 skipped（Wave6 template/cache + Wave3 customer + 1B/R1）
-| `docs/course/` | **交互课程集** | 导览中心 + 风控深潜 **7 模块**（含模块 7 写侧并发）
+| `docs/course/` | **交互课程集** | 导览中心 + 总览 **8 模块**（含模块 8 答辩动线）+ 问数 **5 模块**（D-06）+ 风控深潜 **7 模块**（含写侧并发）· 提纲 `docs/答辩/答辩知识点清单.md`
 | `docs/PRD/PRD-风控监测Agent.md` | **已冻结（v1.1）** | 风控 PRD v1.0 + v1.1 追加 FR-8/9/10（§4A）+ 规则表附录 |
 | `docs/项目框架设计/实现方案-风控追加需求v1.1-C4C6.md` | **已定稿** | C4~C6 编码依据（经独立 AI 评审修订闭环）；分支/进度速览另见项目根 `交接文档.md` |
 | `docs/项目框架设计/合并注意事项-风控模块并入main.md` | **AL-09 已执行（2026-09-08）** | 合并接线完成；接缝见《风控Agent模块边界与合并接缝标注.md》 |
@@ -58,7 +58,7 @@
 | `docs/项目框架设计/接口契约-代销平台API-v0.2-行情扩展草案.md` | **草案（2026-09-09）** | `nav-snapshot` · `sync_market_nav` · 前端产品行情 Phase B |
 | `docs/项目框架设计/表设计/` | 已定 | Agent 共用 11 表 + agent 专用 SQL |
 | `docs/项目框架设计/Core模拟底座/` | 已定 | 无真实 Core 时的 L0 方案 |
-| `web/` | **P0 Demo 齐备（2026-09-10）** | 四角色 Dashboard/Chat · 问数工作台（**模板/缓存标签**）· 资产沉淀 · 风控台账筛选+适当性+AML+模拟交易 · 平台行情 · **分析对话仍为轻量占位**（NL2SQL 走问数页） |
+| `web/` | **P0 Demo 齐备 + E2E/Chat 缺陷已修（2026-09-10）** | 四角色 Dashboard/Chat · **`ChatPanel` 流式续聊 `session_id` + 刷新恢复** · 会话侧栏分页 · 固定面板高度 · 清单见 `docs/整体测试/前端整体测试交接.md` |

 **本地 bootstrap（首次）：** 完整步骤与前置说明见 `FLOW.md` §0（权威），速览：

@@ -77,10 +77,14 @@

 **AL-09 合并后架构（一句话）：** 宿主 `gateway/` + 模块 `deps.py` **双栈并存**；对外登录/token **统一**；chat/risk 均走模块鉴权；接缝 S2 用 `auth_adapter`。

-**下一步（见 TODO）：** git commit `merger` · 20 题 battery 实跑 · 客服手工验收/TEST-LOG · 接口契约发群 · analyst Q17/Q7 挂账 · D-09/N-03/N-07 未做
+**下一步（见 TODO · §2026-09-11 接续）：** git commit `merger`（含问候修复）· 前端加载体验（batch nav / 客户端缓存）· 产品口径文档已落 MEMORY §3 · battery · 客服验收 · D-09/D-12 往后排
+
+**⚠️ 前端 E2E 未跑测试（2026-09-10）：** 该轮走查**只做到「25 路由能渲染 + 无 console/HTTP 错误」，不是逐功能详测** —— 数字/图表/交互正确性、**接口错误态**、对话多轮与会话管理、适当性通过路径、交易拦截路径等**均未验证**（CHAT-1~4 就是这样漏掉的）。**未跑清单见 `TODO.md` §「前端 E2E · 未跑测试」**，报告见 `docs/整体测试/前端整体测试交接.md`。

 **Redis（2026-09-09）：** 推荐 **Docker** `jinrong-redis`（`redis:7-alpine`）· 宿主机 **6380** → 容器 6379 · `.env` `REDIS_URL=redis://127.0.0.1:6380/0` · 客户端 **RESP2**（`database.py` / `redis_gateway.py`）。

+**Redis 不加速页面看板（2026-09-10 澄清）：** Redis 管 **Chat 会话窗口 / 问数 D-06 结果 / 限流 / L3 热读**；**平台 GET（持仓/净值/预警列表）与 Dashboard hooks 每次进页仍打 MySQL**，前端无跨路由缓存 · 净值 **`fetchNavMap` 按产品 N 次 HTTP** → 体感「每页都转圈」见 `TODO.md` §2026-09-11 · `FRONTEND-HANDOFF.md` §10。
+
 **前端启动（`web/`）：** `npm install` → `npm run dev`（`5173`，`/api` 代理 `8000`）· 验收四 demo 账号见 **`docs/frontend/FRONTEND-HANDOFF.md` §8** · 改 UI 后跑 `npm run build && npm run test && npm run lint`。

 **平台 API 硬规则（2026-09-08 拍板）：** 路由 **A · 按业务域**（`/api/customers` 等）；与 Agent 功能重复时 **以本平台 API 为准**；命名见契约 §2；合并时统一改 canonical 路径。
@@ -166,6 +170,7 @@ audit_log 等审计表（只 INSERT）
 | **C-11** | 「我能买什么/匹配产品」→ `suitability_check` + Core 可购列表；**「推荐稳赚/买什么好」仍 reject** | `customer_prompts._ELIGIBLE_PRODUCTS_KW` |
 | **C-07** | 风评查询走 Core；**「重新测评/重做风评」** → 引导 App/网点（Agent 内不做问卷） | `customer_prompts._RISK_KW` |
 | **C-08** | 仅 L1 槽位 `investment.allocation_target`（13 槽）；**无自动偏离检测/调仓** | `profile_slots.py` |
+| **客户「趋势/走势」** | **客户 Chat**：仅 **C-05 最新净值快照** + 持仓/流水；**走势预测/实时盘口 reject**；**无 Chat 内净值历史曲线 Tool** · **统计类趋势**（近 N 日笔数、结构描述）→ **问数** `POST /api/analyst/chat` · **`self` 域**（拍板 `数据分析Agent-合并说明.md` §9.6 · 尾注「AI 分析有风险」）· **D-12 看板钻取未做** | 问数 ≠ 客户助手 · Phase B 行情 sync 未做 |
 | **L0 优先** | 抽槽与 L0 撞车**永远听 L0**；L1 只 enrich 措辞 | `profile_slots` D7 |

 ------
@@ -181,7 +186,7 @@ Core 模拟：scripts/core/reset.ps1 · 文档 docs/项目框架设计/Core模
 启动：uvicorn app.main:app --reload → GET /health
 Redis：`docker compose up -d redis` · `REDIS_URL=redis://127.0.0.1:6380/0` · `scripts/dev/start-redis.ps1`
 测试：python -m pytest（**804 绿**；集成需本机 MySQL + AML + 风控演示数据）
-前端：cd web && npm run dev · npm run build/test/lint（**19** Vitest）· 四角色 Demo 见 `docs/frontend/FRONTEND-HANDOFF.md` §8
+前端：cd web && npm run dev · npm run build/test/lint（**22** Vitest）· 四角色 Demo 见 `docs/frontend/FRONTEND-HANDOFF.md` §8
 问数模板：mysql … < scripts/agent/seed-analyst-query-templates.sql
 风控一键灌库：.\scripts\demo\prepare_all.ps1
 运维/演示脚本：scripts/demo/subscribe_alerts.py（订阅推送演示）· rebuild_alerts.py TRD-xxx（引擎异常补偿重放）
@@ -60,7 +60,7 @@
 | 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` | ~~T-40~~ |
-| C-05 | 产品净值 | Core 最新净值快照；禁止实时盘口 | **已实现（2026-09-10）** · `nav_query`；「实时净值」reject | ~~T-40~~ |
+| C-05 | 产品净值 | Core 最新净值快照；禁止实时盘口 | **已实现（2026-09-10）** · `nav_query`；「实时净值」reject · **无 Chat 历史走势曲线**；统计趋势见问数 self 域（合并说明 §9.6） | ~~T-40~~ |
 | C-07 | 风评查询 / 重测引导 | Core L0；重测引导 App/网点 | **部分已实现** · 无 Agent 内问卷 | T-41 |
 | C-08 | 配置目标 | L1 槽 `allocation_target` | **部分已实现** · 无偏离检测/调仓 | T-41 |
 | C-11 | 适当性匹配说明 | 非营销推荐；联动 R-02 | **部分已实现** · 「我能买什么」→ suitability；「推荐稳赚」仍 reject | T-42 |
@@ -9,7 +9,7 @@

 ### 本批次 · 优先收尾（推荐顺序）

- [ ] **git commit `merger`**：Wave3 + analyst D-06/模板缓存 + 风控前端/灌库/深潜课7 + 问数 UI 标签 + 文档（你确认后执行）
+- [ ] **git commit `merger`**：Wave3 + analyst D-06/模板缓存 + 风控前端/灌库/深潜课7 + 问数 UI 标签 + **客服问候快路由/闲聊降级** + 答辩清单/课程 + 文档（你确认后执行）
 - [x] **风控深潜课改版（方案 1 · 7 模块 · 读者 dev）**：模块 1–7 已写（含写侧并发）· `jinrong-module-risk/index.html` 已拼接
 - [ ] **数据分析 · 20 题 live battery**：`uvicorn` + DeepSeek → `python scripts/dev/run_query_battery.py` → 本地写 `scripts/dev/battery_report.json`（**已拍板：不入库** · 见 `.gitignore`）
 - [ ] **客服 · 手工验收**：`docs/memory/tests/2026-09-10-customer-1b-r1/MANUAL-CHECKLIST.md`（CUST-9527 持仓/sanitize/R1 种子）
@@ -17,6 +17,22 @@
 - [ ] **测试包签核**：`TEST-LOG-2026-09-10-CS-001` → 模块负责人 zhangyong 确认
 - [ ] **接口契约发群稿**：`docs/项目管理/接口契约发群-2026-09-09.md`（复制到群即完成）
 - [ ] **口径字典/问数模板种子**：本机执行 `seed-analyst-metric-dict.sql` · **`seed-analyst-query-templates.sql`**（若未灌）
+- [ ] **前端 E2E 补齐未跑测试**（见下方「前端 E2E · 未跑测试」；2026-09-10 走查只做到「路由能渲染」，**不是逐功能详测**）
+
+### 2026-09-11 接续（2026-09-10 晚对话落账 · 明天干）
+
+> 工作区已有改动 · **未 commit**。先读 `MEMORY.md` §0（Redis≠页面缓存）· §3 客户「趋势」行。
+
+**Tonight 已做**
+
+- [x] `docs/答辩/答辩知识点清单.md` + 课程对齐（总览模块 8 · 问数 D-06 模块 5）
+- [x] 客服「你好」→ 问候 `keyword_route` + `CHITCHAT_DEGRADED_TEXT`（`customer_service` / `visitor_service` · 单测 `test_greeting_chitchat_without_llm`）
+
+**明天优先**
+
+- [ ] **前端进页转圈**：batch 净值 API 或合并请求 · 客户端 stale-while-revalidate（见 `FRONTEND-HANDOFF.md` §10）
+- [ ] **看板演示口径**：四角色 `/app/{role}/home` 有图表；无 BI 大屏 · D-12 钻取仍 open
+- [ ] **客户持仓产品趋势（若要做）**：拍板 Chat 历史 nav Tool vs 问数引导 · 现状 §9.6 仅问数 `self` 域

 ### 需拍板（定了再开任务）

@@ -54,6 +70,33 @@
 - [x] **问数结果标签**：`AnalystQueryPage` 展示 `template_hit` / `cache_hit`（2026-09-10）
 - [ ] **分析对话与问数合一** / **看板钻取** — 规格 D-09/D-12，往后排
 - [ ] **Vitest 补测**（可选）：`useChatPanel` · `api/analyst.ts` mock
+
+### 前端 E2E · 未跑测试（2026-09-10 走查缺口）
+
+> ⚠️ **口径说明：** 2026-09-10 那轮 E2E **不是逐功能详测**。25 条路由的断言只是「页面渲染出来 + 无 console error + 无 4xx/5xx」，
+> **页面上的数字、图表、交互是否正确一律未验证**。下面这些是**明确没跑**的，**复测前不要当作已验证**。
+> 报告与脚本：`docs/整体测试/前端整体测试交接.md` · 脚手架在仓库外 `C:/Users/Windows/e2e-jinrong/`。
+> **反例佐证：** CHAT-1~4 这四条真实缺陷是**后来别人发现的**，走查时完全漏掉 —— 因为对话线每条只发了 1 句就收工。
+
+**P1**
+
+- [ ] **对话模块详测**（最优先 · CHAT-1~4 已修需回归）：多轮连发 · F5 刷新保持同一 session · 会话侧栏分页 · 会话切换/删除/关闭 · 并发发送 · 超长消息 · 断流重连
+- [ ] **接口错误态**：主动打断后端（停 uvicorn / 改 proxy 返 500 / 制造超时），逐页验证 `ApiErrorResult` 是否给出 code / message / trace ID + 可重试 —— 这是 `FRONTEND-HANDOFF.md` §8 白纸黑字的验收项，**本轮完全未验证**
+- [ ] **数据正确性**：拿后端原始响应逐项核对前端渲染值（持仓市值/盈亏、AUM、预警条数、仪表指标卡）—— 本轮**一次都没对过**
+- [ ] **业务边界路径**：
+  - 适当性：只跑了 A-1 阻断，**通过路径未测**
+  - 模拟交易：只跑了放行，**风控拦截路径未测**
+  - 预警处置：只提交一次，**其余状态流转 / 校验失败未测**
+  - AML 扫描：只全量跑一次，**未核对结果正确性**
+
+**P2**
+
+- [ ] **图表正确性**：`@ant-design/charts` 数据映射、空数据、单点、极值 —— 本轮只确认「渲染出来没报错」
+- [ ] **排序/分页正确性**：只确认「点了不崩」，**未验证排序真的有序、翻页真的换内容**
+- [ ] **资产沉淀**：只确认表单渲染，**从未提交过一条**
+- [ ] **客户档案**：只看到 5 个字段（customer_id / display_name / risk_code / risk_expires_at / phone_masked），其余字段渲染未验证（另见 OBS-2 后端 `occupation:"???"` 乱码）
+- [ ] **掩码持久化**：眼睛按钮状态跨路由 / 刷新 / 重登录的行为未全量验证
+- [ ] **PERF-1 复测**：Redis 起到 6380 后重测接口耗时 —— 当前记录的 **2.05s 是 Redis 未起环境下**的测量值，环境修好后数字会变
 - [x] **simulate 交易 UI**：风控菜单「模拟交易」+ `RiskSimulatePage` + `api/simulate.ts`（演示说明 · A-3/A-1 预设）
 - [x] **接口契约发群稿**（见 `docs/项目管理/接口契约发群-2026-09-09.md` · 复制到群即完成）