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