docs(tasks): define app and backend VLM integration
This commit is contained in:
+6
-2
@@ -11,9 +11,11 @@ T-202 的离线 P0 页面入口见[原型索引](design/index.html)。原型仅
|
||||
| `/tasks` | 任务列表 | 查看状态、筛选并进入详情 | US-002 | IX-003 |
|
||||
| `/tasks/new` | 新建任务 | 提交图片和采购约束 | US-001 | IX-002 |
|
||||
| `/tasks/{id}` | 任务详情 | 查看原始输入、时间线、候选和证据 | US-002、US-006 | IX-003、IX-008 |
|
||||
| `/settings/vlm` | VLM 服务设置 | 配置和测试后端 OpenAI 兼容服务 | US-009 | IX-010 |
|
||||
|
||||
MVP 登录后默认进入 `/tasks`。未登录访问受保护页面时跳转 `/login` 并携带安全的
|
||||
站内返回路径;只接受 `/tasks` 及其本站子路径,拒绝绝对 URL、`//` 和反斜杠。
|
||||
站内返回路径;只接受 `/tasks`、`/settings/vlm` 及其本站子路径,拒绝绝对 URL、
|
||||
`//` 和反斜杠。
|
||||
不存在和无权限必须使用不同内部原因,但页面均不得泄露任务内容。
|
||||
|
||||
## Android 页面
|
||||
@@ -28,7 +30,7 @@ Android 导航名称是逻辑目的地,具体 Compose/Fragment 形式待接入
|
||||
| `task/{id}/running` | 任务执行 | 显示步骤、返回拼多多、安全停止 | US-004、US-006 | IX-006、IX-008 |
|
||||
| `task/{id}/confirm` | 候选确认 | 接受、拒绝、无匹配或转人工;T-208 增加逐候选结构化理由 | US-005、US-008 | IX-007、IX-009 |
|
||||
| `task/{id}/result` | 任务结果 | 查看终态和同步状态 | US-002、US-006 | IX-007、IX-008 |
|
||||
| `settings` | 设备设置 | 查看权限、版本、后端和模型连接状态 | US-003、US-007 | IX-004、IX-005 |
|
||||
| `settings` | 设备设置 | 查看权限、版本、后端和只读 AI 可用状态 | US-003、US-007、US-009 | IX-004、IX-005、IX-010 |
|
||||
|
||||
## App 后端路由
|
||||
|
||||
@@ -56,6 +58,8 @@ release 和 cancel-ack 都必须匹配当前 `X-Claim-Token` 与 `claim_generati
|
||||
- 候选确认页返回不能恢复自动化。
|
||||
- 登录过期时先保存非敏感本地状态,再跳转登录;重新登录后查询服务端状态。
|
||||
- 设备设置不是首屏,任务主页是采购人员的工作入口。
|
||||
- 生产 App 的设置页不提供 VLM provider、模型、Base URL 或 API Key 控件;这些只由
|
||||
ADMIN 在管理 Web 配置。
|
||||
|
||||
## 页面组件边界
|
||||
|
||||
|
||||
Reference in New Issue
Block a user