Files
quyun-v2/docs/portal.md
2025-12-25 17:40:40 +08:00

91 lines
5.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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
- 加载与错误:骨架屏、重试、离线提示(可选)