cmroubao/docs/routes.md

路由与页面结构

管理 Web

路由	页面	职责	用户故事	交互
/login	管理登录	建立服务端管理会话	US-007	IX-001
/tasks	任务列表	查看状态、筛选并进入详情	US-002	IX-003
/tasks/new	新建任务	提交图片和采购约束	US-001	IX-002
/tasks/{id}	任务详情	查看原始输入、时间线、候选和证据	US-002、US-006	IX-003、IX-008

MVP 登录后默认进入 /tasks。未登录访问受保护页面时跳转 /login 并携带安全的 站内返回路径。不存在和无权限必须使用不同内部原因，但页面均不得泄露任务内容。

Android 页面

Android 导航名称是逻辑目的地，具体 Compose/Fragment 形式待接入 Roubao 源码后确定。

目的地	页面	职责	用户故事	交互
login	登录/设备绑定	建立人员与设备身份	US-007	IX-004
tasks	任务主页	就绪检查、获取或继续任务	US-003	IX-005
task/{id}/preview	任务预览	检查原始要求并开始	US-003、US-004	IX-005、IX-006
task/{id}/running	任务执行	显示步骤、返回拼多多、安全停止	US-004、US-006	IX-006、IX-008
task/{id}/confirm	候选确认	接受、拒绝、无匹配或转人工	US-005	IX-007
task/{id}/result	任务结果	查看终态和同步状态	US-002、US-006	IX-007、IX-008
settings	设备设置	查看权限、版本、后端和模型连接状态	US-003、US-007	IX-004、IX-005

导航规则

• App 有活跃任务时启动后优先恢复该任务，不允许直接领取下一条。
• CLAIMED 进入预览；RUNNING 进入执行；WAITING_CONFIRMATION 进入候选确认； 终态进入结果。
• 从执行页切换拼多多后，使用前台服务通知返回执行页。
• 候选确认页返回不能恢复自动化。
• 登录过期时先保存非敏感本地状态，再跳转登录；重新登录后查询服务端状态。
• 设备设置不是首屏，任务主页是采购人员的工作入口。

页面组件边界

组件	归属	说明
TaskForm	管理 Web	只管理表单状态和可访问反馈，创建逻辑在 usecase
TaskStatusBadge	管理 Web	统一状态中文和语义，不内置状态迁移
ExecutionTimeline	管理 Web/App	展示只追加事件
ReadinessPanel	Android	汇总权限、安装、网络和活跃任务
TaskRequirementSummary	Android/Web	展示原始输入和 AI 派生信息，视觉上明确区分
CandidateReview	Android/Web	展示候选与硬约束校验，不执行自动化动作
ExecutionController	Android	UI 命令入口，委托 workflow，不直接调用 Accessibility

具体状态反馈以交互清单为准，组件命名可在接入真实框架后 调整并同步本文。