53 lines
3.0 KiB
Markdown
53 lines
3.0 KiB
Markdown
# 路由与页面结构
|
|
|
|
## 管理 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)为准，组件命名可在接入真实框架后
|
|
调整并同步本文。
|