# 路由与页面结构

T-202 的离线 P0 页面入口见[原型索引](design/index.html)。原型仅用于确认页面区块、
控件、文案和主要动作，不代表正式路由实现。

## 管理 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 |

具体状态反馈以[交互清单](08-interaction-checklist.md)为准，组件命名可在接入真实框架后
调整并同步本文。