freedak/BossAi

Fork 0

Files

T

selfreleaseandDevin 4de36547cd

CI / 后端测试 (push) Has been cancelled

Details

CI / 前端构建 (push) Has been cancelled

Details

feat: BossAi v2.0 UI/UX 重构 + 看板断点续接 + 多轮上下文

- 新增 web2/ 前端:任务卡看板、风险雷达、决策日志、我的团队、快捷指令
- ChatPanel 增强:风险卡置顶、案卡接入、起诉状向导、语音输入
- 事项看板:点击查看详情弹窗、断点续接(恢复历史对话+matterId)
- 保密模式恢复:密码验证后重建内存 session,保留多轮上下文
- 多轮对话:ask/ask-stream/ask-analyze 注入 session 历史,AI 有上下文
- 追问优化:紧扣用户问题,不再偏离主题(社保问社保,工伤问工伤)
- 对话区可滚动,输入区固定可见
- 状态机放宽:允许从任意非终态转到 pending_expert
- session 存活检查端点,后端重启后自动重建 session
- DB migration:风险推送表、案卡表

Generated with [Devin](https://devin.ai)

Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>

2026-08-31 08:38:33 +08:00

16 KiB

Raw Blame History

BossAi UIUX 重构任务拆分

版本：v1.0
状态：已交付（三阶段全部完成）
日期：2026-08-30
关联：PRD v2.0、ADR-002、CHG-20260830-001
执行前读取顺序：run.md → 本文档 → CHG-20260830-001 → 1-prd-bossai.md → ADR-001/002

总览

三阶段，每阶段可独立交付。任务编号一旦分配不复用。

阶段	周期	核心交付	TASK 范围
一	2 周	老板台 + 案卡看板 + 移动端底部 Tab	TASK-001 ~ TASK-012
二	2 周	快捷指令 + 我的团队 + 语音输入	TASK-013 ~ TASK-020
三	2 周	风险雷达 + 决策日志 + ChatPanel 升级	TASK-021 ~ TASK-028

依赖关系：

阶段一 ──→ 阶段二 ──→ 阶段三
TASK-003(DB) → TASK-004(API) → TASK-005~008(前端)
TASK-006(案卡前端) → TASK-013(快捷指令)
TASK-010(团队后端) → TASK-011(团队前端)

阶段一：老板台 + 案卡看板（P0，2 周）

TASK-001：DB migration — 案卡表

描述：新增 matters 表，扩展 sessions 表关联案卡
依赖：无
验收：
- matters 表创建，字段见 PRD §7.1
- matters.code 唯一索引
- matters.user_id 索引
- sessions 表新增 matter_id nullable 外键
- migration 脚本 + rollback 脚本
- seed 1 条测试案卡
测试：migration up/down 各跑一次，schema 校验

TASK-002：DB migration — 专家关系表

描述：新增 expert_relations 表
依赖：无
验收：
- expert_relations 表创建，字段见 PRD §7.3
- (user_id, expert_id) 联合唯一索引
- migration + rollback
测试：migration up/down 校验

TASK-003：后端 — 案卡 CRUD API

描述：实现案卡增删改查端点
依赖：TASK-001
端点：
- GET /matters?status=xxx — 按状态分组返回案卡看板
- POST /matters — 创建案卡（绑定 session_id）
- GET /matters/{id} — 案卡详情（含会话消息摘要）
- PATCH /matters/{id}/status — 更新状态
- POST /matters/{id}/close — 闭环（可选填 execution_result）
验收：
- 租户隔离（user_id 校验）
- 状态机校验（非法转换 422）
- code 自动生成 MTR_{YYYYMMDD}_{seq}
- OpenAPI 同步
- 单元测试覆盖 CRUD + 权限 + 状态机
测试：pytest 覆盖正常/越权/非法状态转换

TASK-004：后端 — 案卡状态自动流转

描述：在现有 ask-analyze 流程中自动推进案卡状态
依赖：TASK-003
验收：
- 首次提问时自动创建案卡（status=new）
- AI 返回 questions 时 → status=asking_facts
- 事实提交后 → status=pending_confirm
- 用户确认分析 → status=analyzing
- 流式分析完成 → status=analyzing（保持）
- 问专家 → status=pending_expert
- 不破坏无案卡的旧会话（matter_id nullable）
测试：集成测试覆盖全状态流转

TASK-005：后端 — 老板台聚合 API

描述：新增 /dashboard/today 聚合端点
依赖：TASK-003
端点：GET /dashboard/today

{
  "greeting": "早上好，张总",
  "high_risks": [{ "matter_id": 1, "title": "...", "level": "red" }],
  "pending_confirm": [{ "matter_id": 2, "title": "...", "scene": "legal" }],
  "expert_replies": [{ "consultation_id": 1, "expert_name": "...", "snippet": "..." }],
  "health_score": { "legal": 80, "operation": 60, "compliance": 70 }
}

验收：
- 聚合高风险案卡（risk_level=red/orange）
- 聚合待确认案卡（status=pending_confirm）
- 聚合未读专家回复
- health_score 基于案卡风险分布计算
- 单元测试
测试：pytest 覆盖空数据/正常数据

TASK-006：前端 — 导航重构（共享 NavConfig）

描述：合并 Sidebar/MobileNav 的重复常量为单一 NavConfig
依赖：无
验收：
- 新建 src/lib/nav-config.ts，导出 USER_NAV、EXPERT_NAV、ADMIN_NAV
- Sidebar 和 MobileNav 消费同一配置
- 补齐 MobileNav 缺失的"我的画像"入口
- 补齐 Header 标题映射（/history、/profile、/admin/*）
- 新增路由：/matters、/team、/decisions-log、/me
- lint + build 通过
测试：手动验证导航一致性

TASK-007：前端 — 老板台页面

描述：重构 Dashboard 为"老板台"
依赖：TASK-005、TASK-006
页面：src/pages/Dashboard.tsx
验收：
- 顶部问候语（按时段）
- 高风险提醒卡片（红/橙底，[立即处理]按钮）
- 待确认事项列表（[去确认]跳转案卡）
- 专家回复摘要（[查看回复]跳转）
- 经营健康度条形图（recharts）
- 加载/空态/错误状态覆盖
- 移动端适配
测试：手动验证 + 响应式

TASK-008：前端 — 事项看板页面

描述：新增案卡看板
依赖：TASK-003、TASK-006
页面：src/pages/Matters.tsx
验收：
- 看板分列：待补充事实 / 待确认 / 分析中 / 待专家 / 已闭环
- 案卡卡片：图标+标题+场景标签+时间+[继续/确认]按钮
- 点击案卡 → 跳转对应 ChatPanel 并恢复会话
- 移动端横向滚动看板列
- 案卡左滑归档（移动端手势）
- 加载/空态（引导完善画像）
测试：手动验证 + 响应式

TASK-009：前端 — 案卡组件抽取

描述：抽取 MatterCard 公共组件
依赖：TASK-008
组件：src/components/common/MatterCard.tsx
验收：
- props: matter / onClick / onArchive
- 状态色映射（new=blue, asking_facts=amber, pending_confirm=indigo, analyzing=purple, pending_expert=orange, closed=gray）
- 更新 ui-components.md 登记
测试：组件渲染测试

TASK-010：前端 — ChatPanel 接入案卡

描述：ChatPanel 新建会话时创建案卡，状态随会话流转
依赖：TASK-004、TASK-008
改动：src/components/common/ChatPanel.tsx
验收：
- 新建会话时调用 POST /matters 绑定
- 顶部显示案卡标题（可编辑）
- 状态流转时调用 PATCH /matters/{id}/status
- 分析完成后显示"闭环"按钮
- 闭环时弹窗可选填执行结果
- 不破坏无案卡的旧会话
测试：集成测试覆盖创建→流转→闭环

TASK-011：前端 — 移动端底部 Tab + FAB

描述：移动端导航重构为底部 Tab + FAB
依赖：TASK-006
组件：src/components/layout/BottomTab.tsx、src/components/layout/Fab.tsx
验收：
- 底部 4 Tab：老板台 / 事项 / 团队 / 我
- "我"页聚合 profile/history/settings/knowledge 入口
- FAB(+) 全局浮动，点击弹出快捷指令占位（阶段二实现）
- md 以上隐藏底部 Tab，显示 Sidebar
- 触控区 ≥ 44×44px
- 活跃 Tab 高亮
测试：响应式手动验证

TASK-012：阶段一构建验证

描述：lint + typecheck + build + 手动冒烟
依赖：TASK-001 ~ TASK-011
验收：
- npm run lint 无 error
- npm run build 通过
- 后端 pytest 通过
- 手动冒烟：老板台→案卡→ChatPanel→闭环全流程
- 移动端底部 Tab 全功能可达
- 更新 run.md（若有新命令）
- 更新 ui-components.md

阶段二：快捷指令 + 我的团队（P1，2 周）

TASK-013：后端 — 快捷指令 API

描述：新增 /quick-commands 画像驱动指令生成
依赖：无
端点：GET /quick-commands

{
  "legal": [{ "id": "contract_review", "label": "查合同风险", "template": "我有一份合同，帮我看看..." }],
  "decision": [{ "id": "expand", "label": "该不该扩张", "template": "我在考虑开新店..." }],
  "life": [...]
}

验收：
- 基于画像行业/规模生成个性化指令
- 画像不全时返回通用指令 + 缺口提示
- 指令模板预填问题，留关键细节占位符
- 单元测试
测试：pytest 覆盖画像完整/缺失

TASK-014：前端 — 快捷指令面板

描述：FAB 点击弹出底部抽屉
依赖：TASK-011、TASK-013
组件：src/components/common/QuickCommandPanel.tsx
验收：
- 底部抽屉动画（300ms slide-up）
- 分组展示：法务/经营/生活
- 指令网格卡片（图标+标签）
- 点击指令 → 预填模板到 ChatPanel 输入框 → 跳转对应页面
- 底部语音输入按钮 + 文字输入框
- 画像不全时显示"完善画像解锁更精准建议"
- 抽屉可下拉关闭
测试：手动验证 + 响应式

TASK-015：前端 — 语音输入

描述：快捷指令面板支持语音输入
依赖：TASK-014
验收：
- 使用 Web Speech API（webkitSpeechRecognition）
- 中文识别（lang='zh-CN'）
- 识别结果实时填入输入框
- Safari/不支持浏览器隐藏语音按钮（降级）
- 识别中状态动画
测试：Chrome 验证，Safari 降级验证

TASK-016：后端 — 我的团队 API

描述：新增 /team 端点，聚合专家关系
依赖：TASK-002
端点：GET /team

[{
  "expert_id": 1, "name": "王律师", "avatar": "...", "categories": ["劳动法"],
  "online": true, "consultation_count": 3, "last_consulted_at": "...",
  "last_topic": "用工纠纷"
}]

验收：
- 自动从 consultation 记录聚合关系
- 首次咨询自动创建 expert_relations 记录
- 后续咨询更新 count/last_consulted_at
- 单元测试
测试：pytest 覆盖聚合逻辑

TASK-017：前端 — 我的团队页面

描述：重构 Experts 为"我的团队"
依赖：TASK-016、TASK-006
页面：src/pages/Team.tsx（替代/兼容 Experts）
验收：
- "我的团队"列表：头像+姓名+擅长+在线状态+关系深度
- 每人卡片：[发消息] [新咨询] 按钮
- [新咨询] → 跳转 ChatPanel，自动带上历史上下文摘要
- 底部"找新专家"入口 → 跳转完整专家库
- 空态："你还没有咨询过专家，去逛逛专家库"
- 保留原有 Experts 页面作为完整专家库（/experts）
测试：手动验证

TASK-018：前端 — 团队一键咨询上下文

描述：从"我的团队"发起咨询时自动带上历史
依赖：TASK-017
验收：
- 跳转 ChatPanel 时传入 expertId + lastTopic
- ChatPanel 顶部显示"咨询王律师·上次话题：用工纠纷"
- 首条消息自动带上"基于上次咨询..."上下文
- 问专家弹窗默认选中该专家
测试：手动验证上下文传递

TASK-019：前端 — 移动端"我"页面

描述：新增移动端"我"聚合页
依赖：TASK-011
页面：src/pages/Me.tsx
验收：
- 头像+姓名+行业规模标签
- 入口列表：我的画像 / 对话历史 / 知识库 / 设置
- 仅移动端底部 Tab 可达，桌面端无此路由
- 桌面端这些入口仍在 Sidebar
测试：响应式验证

TASK-020：阶段二构建验证

描述：lint + typecheck + build + 手动冒烟
依赖：TASK-013 ~ TASK-019
验收：
- lint/build 通过
- 后端 pytest 通过
- 冒烟：FAB→快捷指令→预填→提问→问专家→我的团队
- 语音输入 Chrome 验证
- 更新 ui-components.md

阶段三：风险雷达 + 决策日志 + ChatPanel 升级（P1-P2，2 周）

TASK-021：DB migration — 风险推送表

描述：新增 risk_alerts 表
依赖：无
验收：
- risk_alerts 表创建，字段见 PRD §7.2
- (user_id, read_at) 索引
- migration + rollback
测试：migration 校验

TASK-022：后端 — 风险雷达扫描任务

描述：定时扫描知识库新规 + 画像匹配，生成推送
依赖：TASK-021
验收：
- 定时任务（APScheduler 或简单轮询），每日 1 次
- 扫描知识库近 7 天新增文档，匹配用户画像行业
- 生成 risk_alerts 记录（level=blue/orange）
- 文档上传后触发即时扫描（level=red/orange/blue）
- 单元测试
测试：pytest mock 定时任务

TASK-023：后端 — 风险推送 API

描述：风险推送查询与标记已读
依赖：TASK-022
端点：
- GET /risk-alerts?unread=true — 未读推送列表
- POST /risk-alerts/{id}/read — 标记已读
验收：
- 租户隔离
- unread 过滤
- 单元测试
测试：pytest

TASK-024：前端 — 老板台风险推送卡片

描述：老板台集成风险推送
依赖：TASK-005、TASK-023
改动：src/pages/Dashboard.tsx
验收：
- 高风险推送置顶（红/橙底）
- [立即处理] → 跳转相关案卡或知识库文档
- [稍后] → 标记已读
- Header 铃铛角标显示未读数
- 点击铃铛 → 下拉推送列表
测试：手动验证

TASK-025：前端 — 决策日志页面

描述：新增决策日志
依赖：TASK-003
页面：src/pages/DecisionsLog.tsx
验收：
- 按月分组展示闭环案卡
- 每条：日期+场景图标+标题+决定摘要+执行情况标记
- [标记结果] → 弹窗选顺利/受阻/未执行 + 备注
- 月度统计条：本月决策数、已执行率
- 空态："你还没有闭环的决策，去处理进行中的事项"
测试：手动验证

TASK-026：前端 — ChatPanel 风险卡置顶

描述：风险卡从消息流提取为置顶固定卡片
依赖：TASK-010
改动：src/components/common/ChatPanel.tsx、RiskCardView.tsx
验收：
- 分析完成后风险卡固定在对话区顶部
- 可折叠/展开
- [分享] 按钮 → 复制链接或文本
- [导出] 按钮 → 下载 PDF/Markdown
- 消息流中保留风险卡引用锚点
测试：手动验证

TASK-027：前端 — 起诉状三步向导

描述：要素式起诉状改为三步向导
依赖：TASK-010
组件：src/components/common/FilingWizard.tsx
验收：
- 步骤1 预览：展示模板+已填要素
- 步骤2 编辑：可修改要素值
- 步骤3 导出：下载 / 发送给专家 / 复制
- 步骤指示器
- 替换当前一键生成按钮
- 更新 ui-components.md
测试：手动验证

TASK-028：阶段三构建验证 + 三端视觉对齐

描述：lint + typecheck + build + 三端视觉对齐
依赖：TASK-021 ~ TASK-027
验收：
- lint/build 通过
- 后端 pytest 通过
- C 端主色 indigo-600 落地
- Admin Header 深色 + amber-400 + ADMIN 徽章
- 冒烟：风险推送→老板台→决策日志→起诉状向导
- 更新 run.md（定时任务配置）
- 更新 ui-components.md
- 更新 CHANGELOG.md

执行规则

按阶段顺序执行，阶段内任务可并行（后端/前端分离）
每个 TASK 完成后：
- 标记 [x]
- 更新 ui-components.md（若涉及组件）
- 更新 run.md（若涉及新命令/配置）
DB 变更必须先 migration 再 API 再前端
不删无关代码，旧页面保留为兼容入口直到新页面验证通过
commit 前缀：feat(uiux) / feat(api) / feat(db) / fix / refactor
PR ≤ 400 行，单一职责

验收检查清单（整体）

阶段一完成标准

老板台展示今日要事
案卡看板全状态流转
ChatPanel 接入案卡
移动端底部 Tab 可用
build + pytest 通过

阶段二完成标准

FAB 快捷指令基于画像
语音输入 Chrome 可用
我的团队显示关系
一键咨询带上上下文
build + pytest 通过

阶段三完成标准

风险推送出现在老板台
决策日志可标记结果
风险卡置顶可分享
起诉状三步向导
三端视觉对齐
build + pytest 通过
CHANGELOG 同步

16 KiB Raw Blame History Unescape Escape

BossAi UIUX 重构任务拆分

总览

阶段一：老板台 + 案卡看板（P0，2 周）

TASK-001：DB migration — 案卡表

TASK-002：DB migration — 专家关系表

TASK-003：后端 — 案卡 CRUD API

TASK-004：后端 — 案卡状态自动流转

TASK-005：后端 — 老板台聚合 API

TASK-006：前端 — 导航重构（共享 NavConfig）

TASK-007：前端 — 老板台页面

TASK-008：前端 — 事项看板页面

TASK-009：前端 — 案卡组件抽取

TASK-010：前端 — ChatPanel 接入案卡

TASK-011：前端 — 移动端底部 Tab + FAB

TASK-012：阶段一构建验证

阶段二：快捷指令 + 我的团队（P1，2 周）

TASK-013：后端 — 快捷指令 API

TASK-014：前端 — 快捷指令面板

TASK-015：前端 — 语音输入

TASK-016：后端 — 我的团队 API

TASK-017：前端 — 我的团队页面

TASK-018：前端 — 团队一键咨询上下文

TASK-019：前端 — 移动端"我"页面

TASK-020：阶段二构建验证

阶段三：风险雷达 + 决策日志 + ChatPanel 升级（P1-P2，2 周）

TASK-021：DB migration — 风险推送表

TASK-022：后端 — 风险雷达扫描任务

TASK-023：后端 — 风险推送 API

TASK-024：前端 — 老板台风险推送卡片

TASK-025：前端 — 决策日志页面

TASK-026：前端 — ChatPanel 风险卡置顶

TASK-027：前端 — 起诉状三步向导

TASK-028：阶段三构建验证 + 三端视觉对齐

执行规则

验收检查清单（整体）

阶段一完成标准

阶段二完成标准

阶段三完成标准

16 KiB

Raw Blame History