49 lines
1.3 KiB
Markdown
49 lines
1.3 KiB
Markdown
|
# 路由与页面结构
|
||
|
|
|
||
|
|
> 本文约定前端页面路由、页面职责和组件归属。没有前端页面的项目，可改成 CLI 命令、后台任务或模块入口说明。
|
||
|
|
|
||
|
|
## 页面路由
|
||
|
|
|
||
|
|
| 路由 | 页面 | MVP 说明 |
|
||
|
|
| --- | --- | --- |
|
||
|
|
| `/` | 首页 / 列表页 | 展示主入口 |
|
||
|
|
| `/items/{id}` | 详情页 | 展示单个资源详情 |
|
||
|
|
| `/login` | 登录页 | 登录入口 |
|
||
|
|
| `/settings` | 设置页 | 用户或系统配置 |
|
||
|
|
|
||
|
|
## 页面职责
|
||
|
|
|
||
|
|
### 首页 / 列表页
|
||
|
|
|
||
|
|
- 展示【核心资源列表】。
|
||
|
|
- 支持【筛选 / 搜索 / 新建】。
|
||
|
|
- 展示【状态 / 进度 / 空状态】。
|
||
|
|
|
||
|
|
### 详情页
|
||
|
|
|
||
|
|
- 根据 URL 参数定位资源。
|
||
|
|
- 展示核心信息。
|
||
|
|
- 支持 MVP 范围内的关键操作。
|
||
|
|
- 异常时展示明确错误或降级状态。
|
||
|
|
|
||
|
|
### 登录页
|
||
|
|
|
||
|
|
- 通过账号 API 建立会话。
|
||
|
|
- 登录成功后返回原目标页或首页。
|
||
|
|
|
||
|
|
## 组件建议
|
||
|
|
|
||
|
|
| 组件 | 归属 | 说明 |
|
||
|
|
| --- | --- | --- |
|
||
|
|
| `AppShell` | 全局 | 页面框架、导航、登录态入口 |
|
||
|
|
| `ItemList` | 首页 | 渲染资源列表 |
|
||
|
|
| `ItemDetail` | 详情页 | 渲染资源详情 |
|
||
|
|
| `AuthForm` | 登录页 | 登录 / 注册表单 |
|
||
|
|
|
||
|
|
## 导航规则
|
||
|
|
|
||
|
|
- 首页进入详情页：点击资源项。
|
||
|
|
- 详情页返回首页：保留返回入口。
|
||
|
|
- 未登录访问需要账号的页面时，引导登录。
|
||
|
|
- 权限不足时显示明确错误，不静默失败。
|