Files
quyun-v2/frontend/portal/pages.md
2025-12-24 22:49:39 +08:00

5.0 KiB
Raw Blame History

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
  • 加载与错误:骨架屏、重试、离线提示(可选)