xinghuo/group_xinghuo_jinrong
1
0
Fork 0
Code Issues Pull Requests 2 Actions Packages Projects Releases Wiki Activity
Files
282f21932c3517ce034a9e5beaebcdae196f4e7d
group_xinghuo_jinrong/docs/memory/TODO.md
T
zhanghongyu_0626 973bf1b834 feat(advisor-agent): Integrate advisor agent into merger with new API structure 
- Merged `xinghuo/advisor-agent` into the `merger` branch, establishing a new API prefix `/api/advisor-agent` to avoid conflicts with existing endpoints.
- Implemented a comprehensive implementation plan detailing the integration steps, including conflict resolution, database migrations, and service adaptations.
- Introduced new files for advisor compliance, script templates, KYC, and market alerts, ensuring a cohesive addition to the existing architecture.
- Updated documentation to reflect the new structure and integration process, enhancing clarity for future development and maintenance.

This integration significantly expands the capabilities of the merger, providing a robust framework for advisor-related functionalities while maintaining compliance and operational integrity.
2026-09-12 15:14:29 +08:00

31 KiB
Raw Blame History

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 标签 + 客服问候快路由/闲聊降级 + 答辩清单/课程 + 文档（你确认后执行）
  • 风控深潜课改版（方案 1 · 7 模块 · 读者 dev）：模块 1–7 已写（含写侧并发）· jinrong-module-risk/index.html 已拼接
  • 数据分析 · 20 题 live battery：run_query_battery.py 已加 interpret: false · 本机 uvicorn + DeepSeek 跑完写 battery_report.json（不入库）
  • 口径字典/问数模板种子：scripts/dev/seed_analyst.ps1 → seed-analyst-metric-dict.sql · seed-analyst-query-templates.sql
  • 接口契约发群稿：docs/项目管理/接口契约发群-2026-09-09.md（复制到群即完成 · TODO 已勾）
  • 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 已做

  • TEST-AN-001 问数 RBAC：修复 sql_guard 缺口 A/B + deny 审计 D · v1.2 测试日志 · 820 pytest（后续 RISK/N-03 等 → 825）
  • docs/答辩/答辩知识点清单.md + 课程对齐（总览模块 8 · 问数 D-06 模块 5）
  • 客服「你好」→ 问候 keyword_route + CHITCHAT_DEGRADED_TEXT（customer_service / visitor_service · 单测 test_greeting_chitchat_without_llm）
  • 前端 E2E 清单收口（AuthProvider · Redis 连接超时 · 预警防抖 · displayLabels · 对话粗体 · 登录/a11y · docs/整体测试/前端整体测试交接.md）
  • ChatPanel CHAT-1~4：流式 session_id · sessionStorage 恢复 · 固定高度/侧栏分页 · 用户气泡白字 · 删除/清空会话
  • 会话 API：GET /sessions?status= · POST /sessions/close-all · 前端 active 双滤 + close 兜底 · test_chat 增补
  • 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 问数引导 · 平台行情详情已接 Core 历史 · Chat §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 · 见下方风控/课程待办）

  • 风控 L1/L2 Redis 不做（仅 L3 cache-aside）
  • 风控前端 P1：台账筛选 + 适当性页 + AML 扫描页一起做（自有组件栈）
  • 风控演示：scripts/demo/prepare_all.ps1 一键灌库
  • 风控深潜课：加模块 7（写侧并发）

待办（统筹 · P1 推荐顺序）

2026-09-09 P0 主链路已通；当前优先看上方「2026-09-10 批次」。

  • 代销平台 API v0.1 实现（2026-09-08）
  • web/ P0 脚手架 + 主链路真接（2026-09-09）
  • web/src/api/risk.ts 补 X-Agent-Type: risk（2026-09-09）
  • 同步 MEMORY/REQUIREMENTS/FRAMEWORK（analyst S3 · 773 基线 · D-01~D04）
  • 接口契约发群稿（docs/项目管理/接口契约发群-2026-09-09.md — 待你复制到群）

前端 web/ · P0 收尾

四角色 Demo 主链路已通（登录 → Dashboard → Chat/问数/风控 REST）；以下为 polish / 规格缺口。

  • 四角色 Dashboard · 平台只读 · ChatPanel · 游客试聊 · 行情 · 风控台账+筛选+适当性+AML+模拟交易 · 问数工作台+资产沉淀
  • 问数模板原句（2026-09-12）：match_phrases · /template-prompts · 常用问法/标星/最近 · TEST-LOG-AN-002 · 861 pytest / 27 Vitest
  • 问数 NL2SQL few-shot（2026-09-12）：仅 published 库（去掉 _BUILTIN_SQL_FEW_SHOTS）· seed-analyst-few-shots.sql
  • D-11 运行时（2026-09-12）：dict/few_shot/template · GET /assets · POST …/publish · POST /dict/ambiguity-check · 沉淀页列表/歧义 Modal · 问数 clarify 按钮
  • D-11 后续：rolled_back · 成功问数一键沉淀
  • 答辩稳套餐 ①（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 · 演示/稳定性

  • 启动自检页或 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 未起环境下的测量值，环境修好后数字会变
  • simulate 交易 UI：风控菜单「模拟交易」+ RiskSimulatePage + api/simulate.ts（演示说明 · A-3/A-1 预设）
  • 接口契约发群稿（见 docs/项目管理/接口契约发群-2026-09-09.md · 复制到群即完成）

待办（模块侧开放项）

客服 Agent · S2 接缝（2026-09-09 已接线 · 并行分流）

清单：docs/项目框架设计/客服Agent-合并说明.md §3–§4 · 原则只增不盖、不覆盖 main.py/chat.py/agent_service.py 整体。

  • 跑迁移 SQL：scripts/agent/migrate-customer-agent-cs-c11.sql（conversation_archive · customer_notes）（2026-09-09 本机已执行）
  • 挂游客路由：POST /api/chat/visitor → main.py
  • 编排接缝（并行）：X-Agent-Type: customer → customer_service.run_customer_chat；其余 Agent 仍 agent_service.chat
  • Wave 3 测试解禁：test_wave3_customer_service.py 19 例绿 · 基线 554 passed
  • Wave 1/2 解禁：test_wave1_* · test_wave2_* 已移出 collect_ignore 并绿（132+ 例）
  • Wave 3 profile / 4 / 5 解禁：test_wave3_profile_service · test_wave4_e2e · test_wave5_notes · 基线 730 passed
  • 1B/R1 拍板落地（2026-09-10）：sanitize_postprocess · Top-K · TEST-LOG · 776 pytest
  • Wave3 能力批次（2026-09-10）：C-04 threshold · C-05 nav · C-11/C-07/C-08 · visitor 1B 对齐 · keyword 优先级 · 786→795 pytest
  • 企业级测试包 docs/memory/tests/2026-09-10-customer-1b-r1/
  • 课程 layout 修复（2026-09-10）：showLayer 单参回退 · .module-inner CSS 别名 · build_all.py
  • 客服 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 ✓
  • 客服 RAG 接 fin_ 三库*：VisitorRagService → search_cs_knowledge（fin_product / fin_policy / fin_faq）；宿主 Tool 仍走 kb_product_rules（T-21）
  • 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

  • merge + 接缝（analyst_router · analyst_auth_adapter · 问数走 get_platform_auth_context）
  • customer self 域 + 「AI 分析有风险」尾注
  • Wave6 测试 · 迁移 migrate-analyst-d07-d11.sql · 重置 reset-analyst-d07-d11.sql
  • 前端问数页 · Scope B 冒烟 19/19
  • P2 · D-11 资产沉淀 UI（AnalystAssetsPage · POST /api/analyst/assets）— 仅写 draft 表，未接 NL2SQL/发布（2026-09-12 拍板延后）
  • P2 · 问数页 dashboard 卡片（GET /api/analyst/dashboard · AnalystQueryPage 顶部 metrics）
  • P2 · 口径字典种子 SQL（scripts/agent/seed-analyst-metric-dict.sql · 本机需手工执行）
  • customer Chat SSE（chat.py stream → prepare_customer_stream · 前端 mode="stream"）
  • STAFF-30001/30002 追加 risk_demo（jwt_service.py · 模拟交易页可造预警）
  • 445cfbb 功能层 cherry-pick（2026-09-10）：guardrail.py · dict_service.py · wave6 测试 · run_query_battery.py
  • 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 含「流水」）
  • D-06 写侧主动失效（2026-09-10）：表世代 bump · 模拟交易 core_trade · 预警/L3 写侧 · invalidate_tables + 单测
  • 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）

  • 画像 Redis L1/L2 不进风控：L1/L2 热缓存归客服线（customer_service + ProfileHotCache）；风控只保留 L3 cache-aside（profile_l3.get_profile_l3 · customer_context Tool 已走）— 不做 risk 侧 L1/L2 Redis
  • 前端用自有组件：扩页时复用 PageShell · Button（components/ui）· ApiErrorResult · AntD Table/Modal/Select（对齐 RiskAlertsPage / RiskSimulatePage），不新引 UI 库
  • 模拟交易 UI 已有：RiskSimulatePage + api/simulate.ts（A-1/A-3 预设）

P1 · 前端代码（2026-09-10 拍板 · 三页一起做 · 2026-09-10 完成）

  • 台账筛选 UI：RiskAlertsPage · alert_type / customer_id / 日期窗
  • 适当性检查页：RiskSuitabilityPage · POST /api/risk/suitability/check
  • AML 扫描页：RiskAmlScanPage · POST /api/risk/aml/scan
  • 路由/菜单：/app/risk/suitability · /app/risk/aml-scan

P1 · 演示一键灌库（2026-09-10 完成）

  • scripts/demo/prepare_all.ps1：双库 DROP → core + agent 种子 → AML → prepare_risk_demo → sync_advisor_rel
  • 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 完成）

  • 模块 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）— 已完成

  • risk Chat SSE（ChatPanel · X-Agent-Type: risk）
  • 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 补偿）
  • 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 后）

  • C-04 push/cron（演示最小）：POST .../threshold-check?push= · scripts/demo/push_threshold_alerts.py · 持仓页「检查阈值提醒」
  • C-05 Phase B：nav-snapshot 外部 sync（Core 内 07 历史种子 + nav/history API + 详情页 已做 · 见 v0.2 草案）
  • C-08 偏离检测：仅 L1 槽位，无自动调仓建议
  • Vitest：客户 Chat 新 intent 无前端单测（后端已覆盖）
  • 手工验收 + TEST-LOG 签核（见上方「本批次 · 优先收尾」）

画像 Redis · cache-aside（2026-09-09 · 客服域，非风控）

  • L3 热读（风控）：get_profile_l3 cache-aside · customer_context Tool 已走此路径
  • L1 懒读（客服）：ProfileHotCache.get_style_tags_lazy · 写侧 warm_l1 · customer_service 已切懒读
  • L2 热读/写（顾问）：表与 JWT scope 已有 · Repository/Redis 未实现 — 风控不做
  • 【前端接入·方案 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）已修复
  • 【前端接入·方案 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 绿。遗留：无心跳帧、断连留空会话待清理
  • chat 同步/流式落库免责声明口径统一（2026-09-09）：chat.py _assistant_content_for_persist · sync/stream 共用 · test_chat 回归
  • 2026-09-05 memory 文件夹更新（新 Agent 交接清单）

AL-09 已完成（2026-09-08）——见 docs/项目框架设计/合并注意事项-风控模块并入main.md 执行记录。

  • 【AL-09】合并接线（2026-09-08）：JWT 统一 · 模块 chat 恢复 · auth_adapter · test_module_boundary 绿 · 502 pytest 绿

  • 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 均落地

  • 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 绿

  • 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 绿

  • 风控阶段 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 可先行）

  • T-30 风控事件线 —— 全部完成（B1~B9b，M2 tag risk-m2）：规则引擎/预警聚合/L3/AML/交易网关/4 API/演示走查 11/11 PASS + 核查单①~⑥收口，均经独立 AI 评审闭环；scan_all 幂等读后写无锁留痕（接批量时 run_locked）
  • T-31 service/suitability.py 公共校验（SUIT-001008）+ 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-001008 编号体系已随 AL-05 换核退役，判定内核改为 main 的 core_ro.check_suitability（C×R 矩阵 + JR-AST/FM 契约），测试按 main 契约重写（原 77 例作废，全量基线 425→406）**
  • T-32 预警台账与人工处置 API + 对话线 —— 台账/处置 API 已由 B6 覆盖并复审通过（A-7/A-9 用例绿）；交付=对话线，归阶段 C（C1~C3，T-07 已就绪）

已完成

  • 2026-09-07 风控 M2 收尾（M4 复核）：MEMORY/TODO 状态与边界文字对齐（任务映射 T-30/T-31/T-32 口径确认；B7 复审留痕「成功响应不包裹外壳」演进口径维持并登记开发计划 M4 节）——风控阶段 B 正式完结
  • 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
  • 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）
  • 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 不依赖外网
  • 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 挂载
  • 2026-09-07 Wave 0 独立 AI 评审有条件通过→闭环（commit 61711cb）：P2×5（python-jose>=3.5.0 防 CVE / audit 降级测试 / JWT 通道 chat 用例 / debug 兜底纵深防御 / 留痕失败降级显式化）+ P3×11 顺手，273 测试绿
  • 2026-09-05 init 项目记忆目录 + app/ 脚手架（api/service/tool/model/config/utils）
  • 2026-09-05 需求拆解文档（业务场景/矩阵/合规）
  • 2026-09-05 表设计 + 技术选型 + JWT 手册
  • 2026-09-05 Core 模拟库 scripts/core/* + reset.ps1 + 文档
  • 2026-09-05 core_ro.py + settings.mysql_core_database + sync 脚本
  • 2026-09-05 Agent 编排依赖改为 LangGraph（requirements.txt）
  • 2026-09-05 memory 文件夹更新（新 Agent 交接清单）
  • 2026-09-10 merger 批次（工作区 · 804 pytest · 未 commit）：Wave3 · analyst D-06 · 风控前端/灌库/深潜课7 · 问数 template 标签
  • 2026-09-10 客服 Wave3 + analyst 445cfbb cherry-pick + 课程 layout 修复（795 pytest · 已并入上项）
  • 2026-09-09 数据分析 Agent S3 合并接线 + 问数页 + 迁移/冒烟（773 passed · commit af9fb71）
  • 2026-09-09 数据分析 Agent 需求规格定稿 v1.1（docs/需求拆解/01-数据分析Agent需求规格.md）
Reference in New Issue View Git Blame Copy Permalink