feat(docs): Update iteration and TODO documentation with recent changes and optimizations
- Enhanced `ITERATION.md` to include new entries for front-end/API optimizations and Chat session management improvements. - Expanded `TODO.md` with a daily work summary, completed tasks, and upcoming priorities, ensuring clarity on project status and next steps. - Added a new summary document for 2026-09-10, detailing work completed across various components, including front-end fixes and API enhancements. This update improves documentation clarity and provides a comprehensive overview of recent developments and future tasks.
This commit is contained in:
@@ -19,6 +19,31 @@
|
||||
- [ ] **口径字典/问数模板种子**：本机执行 `seed-analyst-metric-dict.sql` · **`seed-analyst-query-templates.sql`**（若未灌）
|
||||
- [ ] **前端 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 客户「趋势」行。
|
||||
@@ -27,6 +52,9 @@
|
||||
|
||||
- [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` 增补
|
||||
|
||||
**明天优先**
|
||||
|
||||
@@ -71,6 +99,37 @@
|
||||
- [ ] **分析对话与问数合一** / **看板钻取** — 规格 D-09/D-12，往后排
|
||||
- [ ] **Vitest 补测**（可选）：`useChatPanel` · `api/analyst.ts` mock
|
||||
|
||||
### 前端/API · 优化 TODO（2026-09-10 硬伤盘点 · 仅现有功能）
|
||||
|
||||
> 来源：E2E 交接 + 本日修复复盘 + Agent 盘点。**不含** PRD 未做能力（BI 大屏、预警 WebSocket 订阅等）。
|
||||
|
||||
**P0 · 演示/稳定性**
|
||||
|
||||
- [ ] **启动自检页或 health 条**：Redis `6380` PING + 后端是否含 `close-all`/`status` 路由（避免「功能全在但环境像坏了」）
|
||||
- [ ] **PERF-1 复测**：Redis 正常后重测带 token 接口耗时，更新交接文档数字
|
||||
- [ ] **E2E 最小集进仓库**：登录/退出 · 客户 Chat 多轮+F5 · 清空会话（Playwright；可替代仓库外 `e2e-jinrong`）
|
||||
- [ ] **风控演示链自检**：`prepare_all.ps1` 或 SOP §2 后台账/AML/模拟是否「有故事」（`reset.ps1` 后预警常空 — 文档化进自检提示）
|
||||
|
||||
**P1 · 产品语义 / 安全观感**
|
||||
|
||||
- [ ] **分析对话与问数合一**（或下线/强引导 `AnalystChatShell`，避免菜单双入口自相矛盾）— 与上方 D-09 同项
|
||||
- [ ] **前端角色路由守卫**：`menus.tsx` 允许路径 ↔ URL 不一致时重定向（改 Hash 进别角色工作台仅 UX，后端仍 403）
|
||||
- [ ] **SSE 断流**：半条 assistant 的提示/重试或续发策略（四角色 `ChatPanel` stream）
|
||||
- [ ] **会话侧栏性能**：后端稳定后改为 `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」，
|
||||
|
||||
Reference in New Issue
Block a user