xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
Files
793c0307f850b8fd09f57c29f89f121f7b3fa150
group_xinghuo_jinrong/docs/memory/TODO.md
T
zhanghongyu_0626 793c0307f8 feat(risk): Enhance risk management functionality and access control 
- Updated `RiskListAccess` and `ThresholdWriteAccess` to enforce access control in the risk repository and threshold repository, ensuring only authorized roles can perform sensitive operations.
- Introduced new methods in `RiskRepository` for counting pending alerts and listing alerts with access checks, improving data security and compliance.
- Enhanced the `chat.py` and `deps.py` files to integrate compliance roles into the risk management matrix, allowing for more granular access control.
- Updated documentation to reflect the new testing baseline of 825 passed tests, indicating improved stability and functionality across the application.

This update significantly strengthens the risk management capabilities, ensuring robust access control and compliance with organizational policies.
2026-09-11 17:07:22 +08:00

312 lines
30 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# TODO
> 大任务开始时更新；完成一步打钩并验证后再往下。
> **新 Agent：** 先看 `MEMORY.md` §0 交接清单，再从此处取下一项。
## 进行中
**2026-09-11 批次**（`merger` · 基线 **825 pytest** · `npm run build` 绿）：TEST-RISK-001 修复 · N-03/N-07 · `/api/ready` · C-04 演示 push · 画像 L1 懒读 · **未 commit**
### 本批次 · 优先收尾（推荐顺序）
- [ ] **git commit `merger`**：Wave3 + analyst D-06/模板缓存 + 风控前端/灌库/深潜课7 + 问数 UI 标签 + **客服问候快路由/闲聊降级** + 答辩清单/课程 + 文档（你确认后执行）
- [x] **风控深潜课改版（方案 1 · 7 模块 · 读者 dev）**：模块 1–7 已写（含写侧并发）· `jinrong-module-risk/index.html` 已拼接
- [ ] **数据分析 · 20 题 live battery**：`run_query_battery.py` 已加 `interpret: false` · 本机 `uvicorn` + DeepSeek 跑完写 `battery_report.json`（**不入库**）
- [x] **口径字典/问数模板种子**：`scripts/dev/seed_analyst.ps1` → `seed-analyst-metric-dict.sql` · `seed-analyst-query-templates.sql`
- [x] **接口契约发群稿**：`docs/项目管理/接口契约发群-2026-09-09.md`（复制到群即完成 · TODO 已勾）
- [x] **TEST-AN-001 签核（开发侧）**：`TEST-LOG-2026-09-11-AN-001.md` v1.3 · A/B/D 已修 · **825 pytest**（含 RISK 修复 +1）
- [ ] **前端 E2E 补齐未跑测试**（见下方「前端 E2E · 未跑测试」；2026-09-10 走查只做到「路由能渲染」，**不是逐功能详测**）
### 2026-09-10 日终 · 工作清单（给用户/答辩交接）
**今天已完成（代码 + 文档 · 工作区多未 commit）**
| 类别 | 内容 |
| --- | --- |
| 前端 E2E 收口 | `AuthProvider`（登录崩溃/退出死循环）· Redis 连接超时 0.5s · 预警客户 ID 防抖 · `displayLabels`/`formatDateTime` · 对话 `**` 粗体 · 登录重入/a11y/`index.html` · AntD `<App>` |
| ChatPanel | 流式续聊 `session_id` · `sessionStorage` 恢复 · 固定高度/侧栏分页 · 用户气泡白字 · 单条删除/清空历史 |
| 会话 API | `GET /sessions?status=` · `POST /sessions/close-all` · 侧栏仅 active（服务端+客户端双滤）· close 兜底 · `test_chat` 增补 |
| 文档 | `docs/整体测试/前端整体测试交接.md`（BUG/CHAT 状态列）· `FRONTEND-HANDOFF` §8/§9 · `ITERATION` · `MEMORY`（22 Vitest）· **前端/API 优化 TODO**（本节 §前端/API · 优化） |
| 盘点 | Agent 输出「现有功能硬伤」→ 已写入下方优化 TODO（P0~P3） |
**正在做 / 未验证闭环**
- [ ] **本机验证**：重启 **uvicorn**（含 `close-all`）+ **Redis 6380** + 前端强刷 → 客户助手「清空历史」· 多轮 Chat F5 · 四角色登录/退出
- [ ] **CHAT-1~4 回归**：E2E 脚本去 `login()` 内 reload workaround（仓库外 `e2e-jinrong`）
- [ ] **PERF-1 复测**：Redis 正常后重测带 token 接口耗时，更新交接文档数字
**将要做（已记入 TODO · 推荐顺序）**
1. 上方「本批次 · 优先收尾」（commit merger · battery · 客服验收 · 发群稿）
2. `§前端/API · 优化 TODO` **P0**（启动自检 · E2E 进仓库 · PERF 复测）
3. `§2026-09-11 接续`（进页转圈 · 看板钻取口径 · 客户趋势拍板）
4. `§前端 E2E · 未跑测试` P1（对话详测 · 错误态 · 数据对账 · 边界路径）
### 2026-09-11 接续（2026-09-10 晚对话落账 · 明天干）
> 工作区已有改动 · **未 commit**。先读 `MEMORY.md` §0（Redis≠页面缓存）· §3 客户「趋势」行。
**Tonight 已做**
- [x] **TEST-AN-001 问数 RBAC**：修复 sql_guard 缺口 A/B + deny 审计 D · v1.2 测试日志 · **820 pytest**（后续 RISK/N-03 等 → **825**）
- [x] `docs/答辩/答辩知识点清单.md` + 课程对齐（总览模块 8 · 问数 D-06 模块 5）
- [x] 客服「你好」→ 问候 `keyword_route` + `CHITCHAT_DEGRADED_TEXT`（`customer_service` / `visitor_service` · 单测 `test_greeting_chitchat_without_llm`）
- [x] **前端 E2E 清单收口**（`AuthProvider` · Redis 连接超时 · 预警防抖 · `displayLabels` · 对话粗体 · 登录/a11y · `docs/整体测试/前端整体测试交接.md`）
- [x] **ChatPanel CHAT-1~4**：流式 `session_id` · `sessionStorage` 恢复 · 固定高度/侧栏分页 · 用户气泡白字 · 删除/清空会话
- [x] **会话 API**：`GET /sessions?status=` · `POST /sessions/close-all` · 前端 active 双滤 + close 兜底 · `test_chat` 增补
- [x] **TEST-RISK-001 修复（F1–F11 子集）**：`repo_access` · service_risk 只读 · compliance 矩阵 · **825 pytest** · 日志 v1.1
**明天优先**
- [ ] **前端进页转圈**：batch 净值 API 或合并请求 · 客户端 stale-while-revalidate（见 `FRONTEND-HANDOFF.md` §10）
- [ ] **看板演示口径**：四角色 `/app/{role}/home` 有图表；无 BI 大屏 · D-12 钻取仍 open
- [ ] **客户持仓产品趋势（若要做）**：拍板 Chat 历史 nav Tool vs 问数引导 · 现状 §9.6 仅问数 `self` 域
### 需拍板（定了再开任务）
| 项 | 选项 / 说明 |
| --- | --- |
| **C-04 阈值 push** | 维持 inline（现状） vs Redis pub / 定时扫仓 |
| **C-11 匹配说明放开度** | 已拍板：「我能买什么」→ suitability；「推荐稳赚」仍 reject |
| **`battery_report.json`** | **已拍板：不入库**（`.gitignore` · 本地跑 `run_query_battery.py` 生成） |
| **本地 `data-analysis-agent` 分支** | 是否 `git pull xinghuo data-analysis-agent` 对齐远程（与 merger 独立） |
**已拍板（2026-09-10 · 见下方风控/课程待办）**
- [x] 风控 L1/L2 Redis **不做**（仅 L3 cache-aside）
- [x] 风控前端 P1：**台账筛选 + 适当性页 + AML 扫描页一起做**（自有组件栈）
- [x] 风控演示：**`scripts/demo/prepare_all.ps1` 一键灌库**
- [x] 风控深潜课：**加模块 7（写侧并发）**
---
## 待办（统筹 · P1 推荐顺序）
> 2026-09-09 P0 主链路已通；**当前优先看上方「2026-09-10 批次」**。
- [x] **代销平台 API v0.1 实现**（2026-09-08）
- [x] **`web/` P0 脚手架 + 主链路真接**（2026-09-09）
- [x] **`web/src/api/risk.ts` 补 `X-Agent-Type: risk`**（2026-09-09）
- [x] **同步 `MEMORY/REQUIREMENTS/FRAMEWORK`**（analyst S3 · 773 基线 · D-01~D04）
- [x] **接口契约发群稿**（`docs/项目管理/接口契约发群-2026-09-09.md` — 待你复制到群）
### 前端 `web/` · P0 收尾
> **四角色 Demo 主链路已通**（登录 → Dashboard → Chat/问数/风控 REST）；以下为 polish / 规格缺口。
- [x] 四角色 Dashboard · 平台只读 · ChatPanel · 游客试聊 · 行情 · 风控台账+筛选+适当性+AML+模拟交易 · 问数工作台+资产沉淀
- [x] **问数结果标签**：`AnalystQueryPage` 展示 `template_hit` / `cache_hit`（2026-09-10）
- [x] **答辩稳套餐 ①（2026-09-11）**：A1 sql_guard Q17 · A5 流水 clarify 单测 · C1 种子 +2 模板 · D1 分析对话重定向/菜单收 · E1 `docs/答辩/DEMO-SOP-问数.md` · 答辩清单同步
- [ ] **分析对话菜单下线或强引导**（问数页已承载解读）· **看板钻取** — D-12 往后排
- [ ] **Vitest 补测**（可选）：`useChatPanel` · `api/analyst.ts` mock
### 前端/API · 优化 TODO（2026-09-10 硬伤盘点 · 仅现有功能）
> 来源：E2E 交接 + 本日修复复盘 + Agent 盘点。**不含** PRD 未做能力（BI 大屏、预警 WebSocket 订阅等）。
**P0 · 演示/稳定性**
- [x] **启动自检页或 health 条**：`GET /api/ready` + 前端 `DevReadyBanner`（Redis + close-all/问数路由）
- [ ] **PERF-1 复测**：Redis 正常后重测带 token 接口耗时，更新交接文档数字
- [ ] **E2E 最小集进仓库**：登录/退出 · 客户 Chat 多轮+F5 · 清空会话（Playwright；可替代仓库外 `e2e-jinrong`）
- [ ] **风控演示链自检**：`prepare_all.ps1` 或 SOP §2 后台账/AML/模拟是否「有故事」（`reset.ps1` 后预警常空 — 文档化进自检提示）
**P1 · 产品语义 / 安全观感**
- [ ] **分析对话菜单** — **已重定向** `/analytics/chat` → 问数；菜单项已删（2026-09-11 答辩稳）
- [ ] **前端角色路由守卫**：`menus.tsx` 允许路径 ↔ URL 不一致时重定向（改 Hash 进别角色工作台仅 UX，后端仍 403）
- [ ] **SSE 断流**：半条 assistant 的提示/重试或续发策略（四角色 `ChatPanel` stream）· **心跳注释帧已加**（`: ping`），断连重试仍 open
- [ ] **会话侧栏性能**：后端稳定后改为 `status=active` 分页即可，去掉全量扫页 + 双端 close 兜底
**P2 · 展示 / 数据 / 闭环**
- [ ] **I18N 扫尾**：行情/持仓风险码/图表轴等仍可能露英文或原始枚举
- [ ] **对话 Markdown**：列表/链接（现仅 `**` 粗体）
- [ ] **OBS-2 种子 UTF-8**：`fix_utf8_seed.py` + 客户资料页扩字段前必做
- [ ] **资产沉淀页**：仅有 POST 表单，补列表/发布态或菜单降级说明
- [ ] **AntD 6 弃用 API 清告警**（OBS-1 余量）
- [ ] **HashRouter 生产说明**：Nginx SPA fallback 写入 `FRONTEND-HANDOFF` 部署节
**P3 · 验证债（与「前端 E2E · 未跑测试」重叠）**
- [ ] 接口错误态逐页打断验证 · 数据与后端 raw 对账 · 适当性/模拟/AML/处置边界路径
### 前端 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` · 复制到群即完成）
## 待办（模块侧开放项）
### 客服 Agent · S2 接缝（2026-09-09 已接线 · 并行分流）
> 清单：`docs/项目框架设计/客服Agent-合并说明.md` §3–§4 · 原则只增不盖、不覆盖 `main.py`/`chat.py`/`agent_service.py` 整体。
- [x] **跑迁移 SQL**：`scripts/agent/migrate-customer-agent-cs-c11.sql`（`conversation_archive` · `customer_notes`）（2026-09-09 本机已执行）
- [x] **挂游客路由**：`POST /api/chat/visitor` → `main.py`
- [x] **编排接缝（并行）**：`X-Agent-Type: customer` → `customer_service.run_customer_chat`；其余 Agent 仍 `agent_service.chat`
- [x] **Wave 3 测试解禁**：`test_wave3_customer_service.py` 19 例绿 · 基线 **554 passed**
- [x] **Wave 1/2 解禁**：`test_wave1_*` · `test_wave2_*` 已移出 `collect_ignore` 并绿（132+ 例）
- [x] **Wave 3 profile / 4 / 5 解禁**：`test_wave3_profile_service` · `test_wave4_e2e` · `test_wave5_notes` · 基线 **730 passed**
- [x] **1B/R1 拍板落地**（2026-09-10）：`sanitize_postprocess` · Top-K · TEST-LOG · 776 pytest
- [x] **Wave3 能力批次**（2026-09-10）：C-04 threshold · C-05 nav · C-11/C-07/C-08 · visitor 1B 对齐 · keyword 优先级 · **786→795 pytest**
- [x] **企业级测试包** `docs/memory/tests/2026-09-10-customer-1b-r1/`
- [x] **课程 layout 修复**（2026-09-10）：`showLayer` 单参回退 · `.module-inner` CSS 别名 · `build_all.py`
- [x] **客服 KB 第二套（fin_*）· Ollama 灌库**（2026-09-09 本机）：
1. `ollama pull bge-m3` ✓
2. Ollama 服务 `http://127.0.0.1:11434` ✓
3. **Windows**：`MILVUS_URI` 须英文绝对路径（如 `C:/Users/Windows/.jinrong/milvus/milvus.db`），中文项目路径 faiss 会炸
4. `python scripts/kb/build_collections.py --rebuild`（原料 `data/kb_collections/`）✓ 9 块
5. `python scripts/kb/test_search.py` ✓
- [x] **客服 RAG 接 fin_* 三库**：`VisitorRagService` → `search_cs_knowledge`（`fin_product` / `fin_policy` / `fin_faq`）；宿主 Tool 仍走 `kb_product_rules`（T-21）
- [x] **tool 层实现 + 种子文档**：`document_parser` / `embedding_tool` / `milvus_tool` + `data/kb_collections/*`（2026-09-09）
### 数据分析 Agent · S3 接缝（2026-09-09 已接线）
> 清单：`docs/项目框架设计/数据分析Agent-合并说明.md` · **825 passed** · 冒烟 `scripts/dev/smoke_analyst.py`
- [x] merge + 接缝（`analyst_router` · `analyst_auth_adapter` · 问数走 `get_platform_auth_context`）
- [x] customer `self` 域 + 「AI 分析有风险」尾注
- [x] Wave6 测试 · 迁移 `migrate-analyst-d07-d11.sql` · 重置 `reset-analyst-d07-d11.sql`
- [x] 前端问数页 · Scope B 冒烟 19/19
- [x] **P2 · D-11 资产沉淀 UI**（`AnalystAssetsPage` · `POST /api/analyst/assets`）
- [x] **P2 · 问数页 dashboard 卡片**（`GET /api/analyst/dashboard` · `AnalystQueryPage` 顶部 metrics）
- [x] **P2 · 口径字典种子 SQL**（`scripts/agent/seed-analyst-metric-dict.sql` · 本机需手工执行）
- [x] **customer Chat SSE**（`chat.py` stream → `prepare_customer_stream` · 前端 `mode="stream"`）
- [x] **STAFF-30001/30002 追加 risk_demo**（`jwt_service.py` · 模拟交易页可造预警）
- [x] **445cfbb 功能层 cherry-pick**（2026-09-10）：`guardrail.py` · `dict_service.py` · wave6 测试 · `run_query_battery.py`
- [x] **D-06 双层缓存**（2026-09-10）：结果缓存+表世代写侧失效 · 模板填参 · 问数页标签 · 种子 SQL
- [ ] **D-09 多轮追问** · [x] **N-03 溯源明细** · [x] **N-07 转人工** — N-03/07 最小闭环（sample + escalate + 问数页按钮）
### 数据分析 Agent · 445cfbb 合入后开放项
- [ ] **20 题 live battery 跑分**（见上方「本批次 · 优先收尾」）
- [ ] **agent 编排接流水 Ambiguity**：`dict_service` 已返 Ambiguity · 确认 `analyst_agent` 反问链路在 live 20 题里生效（Q 含「流水」）
- [x] **D-06 写侧主动失效**（2026-09-10）：表世代 bump · 模拟交易 `core_trade` · 预警/L3 写侧 · `invalidate_tables` + 单测
- [x] **D-06 模板缓存**（2026-09-10）：`template_service` 匹配+填参 · 问数编排跳过 LLM · 种子 `seed-analyst-query-templates.sql`
- [ ] **D-06 PII 脱敏后再缓存** — 暂缓（全仓脱敏方案未定）
- [ ] **已知挂账（迭代文档）**：Q7 无城市字段静默改职业 · 待排期（**Q17 已修**）
- [ ] **远程分支同步**（可选）：本地 `data-analysis-agent` @ `fd9464d` 落后 `xinghuo/data-analysis-agent` 2 commit
### 风控 Agent · 2026-09-10 拍板收口
> **后端主链路（FR-1~10 · 对话 6 Tool · 处置 API）已完成。** 下列为 polish / 演示 / 文档，不是「风控坏了」。
**拍板（已定 · 不再扩 scope）**
- [x] **画像 Redis L1/L2 不进风控**：L1/L2 热缓存归**客服线**（`customer_service` + `ProfileHotCache`）；风控只保留 **L3 cache-aside**（`profile_l3.get_profile_l3` · `customer_context` Tool 已走）— **不做** risk 侧 L1/L2 Redis
- [x] **前端用自有组件**：扩页时复用 `PageShell` · `Button`（`components/ui`）· `ApiErrorResult` · AntD `Table/Modal/Select`（对齐 `RiskAlertsPage` / `RiskSimulatePage`），不新引 UI 库
- [x] **模拟交易 UI 已有**：`RiskSimulatePage` + `api/simulate.ts`（A-1/A-3 预设）
**P1 · 前端代码（2026-09-10 拍板 · 三页一起做 · 2026-09-10 完成）**
- [x] **台账筛选 UI**：`RiskAlertsPage` · `alert_type` / `customer_id` / 日期窗
- [x] **适当性检查页**：`RiskSuitabilityPage` · `POST /api/risk/suitability/check`
- [x] **AML 扫描页**：`RiskAmlScanPage` · `POST /api/risk/aml/scan`
- [x] **路由/菜单**：`/app/risk/suitability` · `/app/risk/aml-scan`
**P1 · 演示一键灌库（2026-09-10 完成）**
- [x] **`scripts/demo/prepare_all.ps1`**：双库 DROP → core + agent 种子 → AML → prepare_risk_demo → sync_advisor_rel
- [x] **TEST-RISK-001 修复**：见 `docs/memory/tests/2026-09-11-risk-agent-e2e/TEST-LOG-2026-09-11-RISK-001.md` v1.1 · `sandbox_risk_test.py` D 节期望 `TypeError`
**P2 · 深潜课（2026-09-10 完成）**
- [x] **模块 7 · 写侧并发**：`modules/07-concurrency.html` · nav 7 dots · `build.sh` / python 拼接 `index.html`
**后端 / 架构 · 挂账（非 P1 · 动契约前先出方案）**
- [ ] **AL-06**：chat 链路 `risk_suitability_log.actor_id` 暂落 SYSTEM（`agent_tool_call` 已覆盖发起者；改须动 `core_tools`/`kb_tools` 冻结签名）
**对话 Tool（risk Chat SSE）— 已完成**
- [x] risk Chat SSE（`ChatPanel` · `X-Agent-Type: risk`）
- [x] 6 只 Tool 已注册（含 `query_agent_behavior`）
**运维 / 演示 checklist（脚本已有 · 非产品化 · 见 `演示SOP-风控模块.md`）**
> 走查时手工跑即可；**不等于**后端缺 API。
- [ ] `subscribe_alerts.py` → Redis `risk:pub:alert` 实时推送演示
- [ ] `escalation_scan.py` / `agent_behavior_scan.py`（FR-9/10 · cron 无 UI，运维手跑）
- [ ] `rebuild_alerts.py`（engine_error 补偿）
- [x] SOP §2 灌库：`seed-aml-list.sql` + `prepare_risk_demo.sql`（`reset.ps1` 只重建 core）→ **`prepare_all.ps1` 一键串联**
- [ ] 走查样例 A-1~A-5 · FR-9/10 · L3 high 样例（文档步骤，非代码任务）
### 客服 Agent · Wave3 开放项（2026-09-10 后）
- [x] **C-04 push/cron（演示最小）**：`POST .../threshold-check?push=` · `scripts/demo/push_threshold_alerts.py` · 持仓页「检查阈值提醒」
- [ ] **C-05 Phase B**：`nav-snapshot` sync · 前端行情 Phase B（见 v0.2 草案）
- [ ] **C-08 偏离检测**：仅 L1 槽位，无自动调仓建议
- [ ] **Vitest**：客户 Chat 新 intent 无前端单测（后端已覆盖）
- [ ] **手工验收 + TEST-LOG 签核**（见上方「本批次 · 优先收尾」）
### 画像 Redis · cache-aside（2026-09-09 · **客服域，非风控**）
- [x] **L3 热读（风控）**：`get_profile_l3` cache-aside · `customer_context` Tool 已走此路径
- [x] **L1 懒读（客服）**：`ProfileHotCache.get_style_tags_lazy` · 写侧 `warm_l1` · `customer_service` 已切懒读
- [ ] **L2 热读/写（顾问）**：表与 JWT scope 已有 · Repository/Redis **未实现** — **风控不做**
- [x] **【前端接入·方案 B】chat 拉侧三端点**（commit `8328c24`，2026-09-08）：`GET /api/chat/sessions`（本人+本 Agent 线分页列表）、`GET /api/chat/sessions/{id}/messages`（历史消息升序分页，closed 仍可读）、`POST /api/chat/sessions/{id}/close`（active→closed，重复/非 active 409）；chat.py 抽 `_resolve_agent_type`/`_assert_chat_entry`/`_guard_session` 三守卫供四端点共用，POST "" 行为零回归；risk_manager 在对话线数据面保持 403（PRD 4A.1）。测试 482→**494 绿**；独立评审 P0=0，P1（close 并发 rowcount 静默 200）已修复
- [x] **【前端接入·方案 C】SSE 流式对话**（commit `01ec5fc`，2026-09-08）：新增 `POST /api/chat/stream`（OpenAI 兼容 chunk：首帧 meta → delta → finish_reason=stop → `[DONE]`）；`agent_service.stream_chat` 生成器 + `needs_disclaimer`；`_guard_request`/`_prepare_turn` 与同步端点共用守卫；`session_repository.insert_turn` user+assistant 同事务落库（修评审 P0/P1）。测试 494→**503 绿**。遗留：无心跳帧、断连留空会话待清理
- [x] chat 同步/流式落库免责声明口径统一（2026-09-09）：`chat.py` `_assistant_content_for_persist` · sync/stream 共用 · `test_chat` 回归
- [x] 2026-09-05 memory 文件夹更新（新 Agent 交接清单）
> **AL-09 已完成（2026-09-08）**——见 `docs/项目框架设计/合并注意事项-风控模块并入main.md` 执行记录。
- [x] **【AL-09】合并接线**（2026-09-08）：JWT 统一 · 模块 chat 恢复 · auth_adapter · test_module_boundary 绿 · **502 pytest 绿**
- [x] T-04 Core RO 封装为 Tool 节点；A-01 归属校验（chat Tool 接入 + agent_tool_call 落库）—— **完成（2026-09-07）**：`app/tool/core_tools.py`（L0/持仓/流水三只读 Tool + TOOL_REGISTRY 白名单）+ `app/service/tool_service.py`（关键词意图仅 customer/advisor；归属校验对齐 deps.assert_customer_access 口径——Tool 层拒绝不抛 403 而 blocked 留痕，纵深防御；run_tool 执行+落库，落库失败降级）+ agent_service 图 tool 节点（START→tool→llm→guard；结果注入 LLM 上下文，降级回复带摘要）+ session_repository.insert_tool_call（message_id 一期 NULL）。**A-01 口径：本任务只做 Tool 层归属校验语义（customer 本人/advisor assigned/risk_officer 全量/其余拒），A-01 完整场景（代理人画像）仍归 T-20**；risk 分支四 Tool 归 C1 复用 run_tool。**评审闭环（2026-09-07）：首评 P1×2+P2×3+P3×2 → 修复 `40a9ee2` → 复审 P2×1+P3×4 → 修复 `1216d26`，pytest 321 绿；入参白名单+days 钳制、公共鉴权双写 `utils/authz.py`、list_holdings LIMIT 均落地**
- [x] T-21 Milvus Lite + kb_product_rules 首批入库 —— **完成（2026-09-07，commits e34973f~535c8a0 共 6 个 + 评审闭环 9cc2e59）**：`app/service/embedding.py`（Ollama bge-m3 批量 /api/embed 1024 维，四类失败一律 EmbeddingError 不静默降级）+ `app/service/milvus_service.py`（kb_product_rules 幂等建集合+upsert+search_kb 溯源/effective_date 合规过滤）+ `data/kb/` 6 只种子产品手册（prospectus/fee/rule/risk 四节 24 块）+ `scripts/kb/build_kb.py`（--dry-run/--kb-dir）+ `app/service/rag_service.py` 落地（search_knowledge→chunks+source_refs，异常上抛防 LLM 编造）+ `app/tool/kb_tools.py` 挂注册表第三层（**ToolSpec 新增 skip_access_check**：公开知识无归属语义，advisor 无绑定客户可查；意图层限定 customer/advisor，risk 不开放——用户拍板）+ tool_node 按 spec 白名单注入 query + summarize 溯源口径。**真库验收：24 块入库，search_knowledge("基金申购") Top3 命中申赎规则（score 0.73+），溯源完整**。三坑收口：Milvus Lite 跨进程重开须显式 load / faiss 不支持中文路径（本机 .env 改 C:/Users/YUAN/.jinrong/milvus/）/ build_kb sys.path 引导。知识库 API（上传/重建端点）一期不做（knowledge.py 仍空壳，用户拍板），425 绿
- [x] T-03 输入防护规则（F-03：prompt_injection/oversize/限流）—— **完成（2026-09-07，commits 497554d/65b45aa/cc6f34f/207fc79）**：`app/service/input_guard.py`（注入短语词表 42 条四类纯函数检测 + `inspect_message` oversize 4000 先于 injection + `check_rate_limit` Redis INCR 固定窗口 actor 级 30 次/分 fail-open）+ chat 路由接入（顺序：鉴权→准入→空白→限流 429→注入/超长 400→归属→会话；被拒 fail-fast 不建会话不落消息，blocked 落 input_guard_log，留痕降级不改拒绝语义；Pydantic 硬顶 20000，业务限 4000 移 guard 层换留痕）+ redis_gateway.incr + settings.guard_rate_limit_*；拍板：命中即拒不清洗、仅 blocked 留痕、词表代码常量可审计。**独立 AI 评审 PASS with findings（P0=0；P2×3 已收口：词表断言修正/补 7 条同构变体/窗口 TTL 断言+EXPIRE 失败取舍锁定；P3 已收 session_id 截断，挂账对抗变体扩表）**，378 绿
- [x] 风控阶段 C（C0 pytest-asyncio / C1 chat_tools / C2 risk 分支 StateGraph / C3 A-6 验收）—— **完成（2026-09-07）**：`app/service/risk/chat_tools.py` 四只读 Tool（alert_query/customer_context/suitability_check/aml_lookup）挂 `RISK_TOOL_REGISTRY`；`tool_service.run_tool` 改查 core+risk 统一注册表 `get_registered_tool` 且恒传 `risk_repo`；`_normalize_params` 读 spec 白名单；`match_intent` 按 agent 分组扩 risk 关键词；`agent_service.tool_node` 守卫放宽（`requires_customer=False` 允许无绑定客户，支撑 A-6 全量待审）；A-6 验收+诱导处置边界（无处置 Tool、系统提示禁自动处置、诱导只触发只读且预警状态不变）；**独立 AI 评审 PASS（P0=0，P2 补 advisor 归属/空 product_id 单测已收口），345 绿，tag `risk-m3`**
### 风控模块（PRD v1.0 已冻结 · `docs/PRD/PRD-风控监测Agent.md`，事件驱动线不依赖 T-07 可先行）
- [x] T-30 风控事件线 —— **全部完成（B1~B9b，M2 tag risk-m2）**：规则引擎/预警聚合/L3/AML/交易网关/4 API/演示走查 11/11 PASS + 核查单①~⑥收口，均经独立 AI 评审闭环；scan_all 幂等读后写无锁留痕（接批量时 run_locked）
- [x] T-31 `service/suitability.py` 公共校验（SUIT-001~008）+ `POST /api/risk/suitability/check` —— **交付=suitability 服务函数+单测（77 例；check API 随 B6 带鉴权+直调审计）；MySQL 手工 SQL 对照（阶段 A 评审 P2-8）2026-09-07 收口：4 组演示组合真库 SQL 推导与函数判定逐项一致（演示 SOP 核查单附行）。【2026-09-07 阶段一退役】SUIT-001~008 编号体系已随 AL-05 换核退役，判定内核改为 main 的 core_ro.check_suitability（C×R 矩阵 + JR-AST/FM 契约），测试按 main 契约重写（原 77 例作废，全量基线 425→406）**
- [x] T-32 预警台账与人工处置 API + 对话线 —— **台账/处置 API 已由 B6 覆盖并复审通过（A-7/A-9 用例绿）；交付=对话线，归阶段 C（C1~C3，T-07 已就绪）**
## 已完成
- [x] 2026-09-07 风控 M2 收尾（M4 复核）：MEMORY/TODO 状态与边界文字对齐（任务映射 T-30/T-31/T-32 口径确认；B7 复审留痕「成功响应不包裹外壳」演进口径维持并登记开发计划 M4 节）——风控阶段 B 正式完结
- [x] 2026-09-07 T-01 JWT 鉴权（commit 36f476f + 评审闭环 61711cb）：`app/service/auth_service.py` Auth SDK（HS256 dev/RS256 生产、必填 claims 显式校验、jti 吊销 fail-open、RS256/HS256 算法白名单互斥）+ `deps.get_auth_context` 工厂替换（Bearer 全环境优先；debug 头降级 dev 兜底，双闸门=APP_ENV+无 RS256 公钥）+ X-Agent-Type 交叉校验（手册 §4.6/§5.4 AGENT_ACCESS_MATRIX）+ `scripts/dev/issue_dev_token.py` 签发 CLI + lifespan 改验 jwt_ready
- [x] 2026-09-07 T-02 审计中间件（commit 3cec034）：`app/api/audit_middleware.py` http_access 全量访问审计（actor 经 request.state.auth，排障路径/OPTIONS 跳过，写库失败降级）+ 独立 request_id（X-Request-Id 贯通，B7 复审 P3-4）+ 422/404/405/500 统一错误体（500 由 trace 中间件兜底回写 trace 头，B7 复审 P2-2）+ input_guard_log 双写（挂账⑧收口；401 归 platform、四 Agent 入口写 guard）
- [x] 2026-09-07 T-07 LangGraph 骨架（commit fb18c04）：`agent_service` StateGraph（llm→guard）+ DeepSeek/langchain-openai（无 key 降级明确标注）+ 四 Agent 边界 system prompt + customer/risk 免责声明（has_disclaimer）+ 单测 mock LLM 不依赖外网
- [x] 2026-09-07 T-06 chat 最小闭环（commit ee5c78a）：`api/chat.py` POST /api/chat（X-Agent-Type 分流+准入+归属校验+SessionGuard AUTH_403_SESSION_AGENT+closed 409）+ `session_repository`（agent_session/agent_message）+ `memory_service`（Redis 窗口 sess:{agent}:{id}:msgs TTL2h N≤20，miss/异常回源 MySQL）+ main 挂载
- [x] 2026-09-07 Wave 0 独立 AI 评审有条件通过→闭环（commit 61711cb）：P2×5（python-jose>=3.5.0 防 CVE / audit 降级测试 / JWT 通道 chat 用例 / debug 兜底纵深防御 / 留痕失败降级显式化）+ P3×11 顺手，273 测试绿
- [x] 2026-09-05 init 项目记忆目录 + `app/` 脚手架（api/service/tool/model/config/utils）
- [x] 2026-09-05 需求拆解文档（业务场景/矩阵/合规）
- [x] 2026-09-05 表设计 + 技术选型 + JWT 手册
- [x] 2026-09-05 Core 模拟库 `scripts/core/*` + `reset.ps1` + 文档
- [x] 2026-09-05 `core_ro.py` + `settings.mysql_core_database` + sync 脚本
- [x] 2026-09-05 Agent 编排依赖改为 LangGraph（requirements.txt）
- [x] 2026-09-05 memory 文件夹更新（新 Agent 交接清单）
- [x] 2026-09-10 merger 批次（工作区 · **804 pytest** · 未 commit）：Wave3 · analyst D-06 · 风控前端/灌库/深潜课7 · 问数 template 标签
- [x] 2026-09-10 客服 Wave3 + analyst 445cfbb cherry-pick + 课程 layout 修复（**795 pytest** · 已并入上项）
- [x] 2026-09-09 数据分析 Agent S3 合并接线 + 问数页 + 迁移/冒烟（`773 passed` · commit `af9fb71`）
- [x] 2026-09-09 数据分析 Agent 需求规格定稿 v1.1（`docs/需求拆解/01-数据分析Agent需求规格.md`）
Reference in New Issue View Git Blame Copy Permalink