# 路由与页面结构

> 本文约定前端页面路由、页面职责和组件归属。没有前端页面的项目，可改成 CLI 命令、后台任务或模块入口说明。

## 页面路由

| 路由 | 页面 | MVP 说明 |
| --- | --- | --- |
| `/` | 首页 / 列表页 | 展示主入口 |
| `/items/{id}` | 详情页 | 展示单个资源详情 |
| `/login` | 登录页 | 登录入口 |
| `/settings` | 设置页 | 用户或系统配置 |

## 页面职责

### 首页 / 列表页

- 展示【核心资源列表】。
- 支持【筛选 / 搜索 / 新建】。
- 展示【状态 / 进度 / 空状态】。

### 详情页

- 根据 URL 参数定位资源。
- 展示核心信息。
- 支持 MVP 范围内的关键操作。
- 异常时展示明确错误或降级状态。

### 登录页

- 通过账号 API 建立会话。
- 登录成功后返回原目标页或首页。

## 组件建议

| 组件 | 归属 | 说明 |
| --- | --- | --- |
| `AppShell` | 全局 | 页面框架、导航、登录态入口 |
| `ItemList` | 首页 | 渲染资源列表 |
| `ItemDetail` | 详情页 | 渲染资源详情 |
| `AuthForm` | 登录页 | 登录 / 注册表单 |

## 导航规则

- 首页进入详情页：点击资源项。
- 详情页返回首页：保留返回入口。
- 未登录访问需要账号的页面时，引导登录。
- 权限不足时显示明确错误，不静默失败。