# Portal 页面规划（frontend/portal）

> 目标：先列“有哪些页面”，后续再逐页细化（模块、接口、状态、权限、埋点等）。

## 信息架构（按访问角色）

- 访客：未登录浏览、搜索、查看内容与租户主页
- 用户：登录后下单/订单/个人中心
- 租户管理员：在 Portal 内进入“租户管理”相关功能（内容发布、订单管理、租户/团队管理等）

## A. 公共访问（访客可用）

| 页面 | 建议路由 | 说明 |
| --- | --- | --- |
| 首页推荐内容列表 | `/` | 推荐内容流、榜单/专题位（如需要） |
| 内容分类（分类/Tag 列表） | `/tags` | 内容分类入口（可支持分组/热门） |
| Tag 详情（聚合列表） | `/tags/:tagId` | 该 Tag 下内容列表 + 排序/筛选 |
| 搜索入口 | `/search` | 搜索框 + 热门搜索/历史（可选） |
| 搜索结果列表 | `/search?keyword=` | 结果列表 + 筛选/排序（时间/价格/热度等） |
| 内容详情页 | `/contents/:contentId` | 图文/媒体详情、目录/章节（如有）、推荐、收藏/分享/举报（可选） |
| 租户个人主页（公开） | `/tenants/:tenantId` | 租户介绍、内容列表、置顶内容（可选） |
| 帮助中心/客服 | `/help` | FAQ、联系渠道、工单入口（可选） |
| 条款与隐私 | `/terms`、`/privacy` | 法务必备页面 |
| 系统页 | `/404`、`/500`、`/maintenance` | 404/错误/维护页 |

## B. 认证与账号（登录相关）

| 页面 | 建议路由 | 说明 |
| --- | --- | --- |
| 登录 | `/auth/login` | 支持手机号/邮箱（按产品需要） |
| 注册 | `/auth/register` | 注册与协议勾选 |
| 忘记密码 | `/auth/forgot-password` | 找回密码流程 |
| 验证（邮箱/手机） | `/auth/verify` | 验证码校验、重发（如需要） |
| 账号注销（可选） | `/settings/account/close` | 合规要求时提供 |

## C. 交易与订单（用户）

| 页面 | 建议路由 | 说明 |
| --- | --- | --- |
| 下单/确认订单（如有支付） | `/checkout` | 收货/交付信息、优惠（可选） |
| 支付结果页（如有支付） | `/payment/result` | 成功/失败/重试 |
| 我的订单列表 | `/me/orders` | 订单筛选：全部/待支付/进行中/已完成/售后 |
| 订单详情 | `/me/orders/:orderId` | 订单状态、交付信息、售后入口 |
| 售后/退款（可选） | `/me/after-sales` | 退款申请、进度、售后记录 |
| 发票/收据（可选） | `/me/invoices` | 需要开票时启用 |

## D. 个人中心（用户）

| 页面 | 建议路由 | 说明 |
| --- | --- | --- |
| 个人中心首页 | `/me` | 入口聚合：订单、收藏、资料、租户管理入口（若为管理员） |
| 个人资料 | `/me/profile` | 昵称/头像/简介等 |
| 安全设置 | `/me/security` | 修改密码、绑定/解绑手机邮箱、设备管理（可选） |
| 收藏/关注（可选） | `/me/favorites` | 收藏内容/关注租户 |
| 浏览历史（可选） | `/me/history` | 最近浏览 |
| 消息通知/站内信（可选） | `/me/notifications` | 系统通知、订单通知 |
| 地址簿（可选） | `/me/addresses` | 仅在需要实体交付时启用 |

## E. 租户创建申请（用户 -> 租户）

| 页面 | 建议路由 | 说明 |
| --- | --- | --- |
| 租户创建申请 | `/tenant/apply` | 申请表单、资质材料上传（如需要） |
| 申请进度/状态 | `/tenant/apply/status` | 审核中/通过/驳回原因、重新提交 |
| 租户切换（多租户可选） | `/tenant/switch` | 账号存在多个租户时的切换入口 |

## F. 租户管理员（在 Portal 内的管理区）

> 角色：租户管理员（或具备管理权限的成员）。

| 页面 | 建议路由 | 说明 |
| --- | --- | --- |
| 管理概览（仪表盘） | `/admin` | 数据概览：内容、订单、收益等（按需要） |
| 内容列表（管理） | `/admin/contents` | 草稿/已发布/已下架/审核中（如有） |
| 内容发布/编辑 | `/admin/contents/new`、`/admin/contents/:contentId/edit` | 发布表单、预览、定时发布（可选） |
| 素材库（可选） | `/admin/assets` | 图片/附件上传与管理 |
| 订单列表（管理） | `/admin/orders` | 订单筛选、导出（可选） |
| 订单详情（管理） | `/admin/orders/:orderId` | 发货/交付、退款处理、备注（可选） |
| 租户列表（管理员需求） | `/admin/tenants` | 你规划的“查看租户列表”（若仅本租户可见可调整为团队/成员列表） |
| 租户设置 | `/admin/settings` | 租户资料、主页信息、联系方式等 |
| 团队成员与权限（可选） | `/admin/team` | 成员、角色、权限管理 |
| 操作日志（可选） | `/admin/audit-logs` | 关键操作审计 |
| 财务结算/提现（可选） | `/admin/finance` | 对账、提现、结算记录（如涉及分账） |

## G. 通用页面与状态（不一定是独立路由）

- 空状态：无内容/无订单/无搜索结果
- 权限页：未登录拦截、无权限（403）
- 加载与错误：骨架屏、重试、离线提示（可选）