### 4. 页面级说明的撰写:页面名称、入口、功能模块概述、核心操作路径、页面跳转关系
章节定位:页面级说明是原型说明文档的“骨架层”。它回答的是“用户从哪来、在这个页面上干什么、做完之后去哪”三个核心问题,是开发、测试与产品经理达成页面级共识的基准文档。本章将演练如何将业务需求拆解为结构清晰的页面级描述,并最终形成可验收的交付物模板。

产品交互原型说明与业务规则规范 - 第4节

4.1 页面级说明解决什么业务问题?

在项目交付中,经常出现以下“页面级”撕逼场景:

  • 场景A(入口缺失):开发问“这个导出按钮应该放在哪个页面?”,产品答“详细列表页”,开发追问“是从顶部导航进入的列表页还是从侧边栏进入的列表页?”——无页面标识导致开发选错入口。
  • 场景B(路径混乱):测试发现“用户从B页跳转到C页,但C页的返回按钮回到了A页,而原型里根本没有画跳转线”——页面跳转关系缺失。
  • 场景C(功能边界模糊):一个页面同时承载了“搜索、排序、批量审批、附件上传”四项功能,但说明文档只画了UI图,未区分核心功能与次要功能——开发只能按自己理解实现,上线后用户根本找不到核心操作。

页面级说明的职责就是:通过结构化的要素清单,将页面视为一个“闭环功能单元”,消灭歧义。

4.2 页面级说明的五要素拆解

一个规范的页面级说明必须包含以下五个结构化字段。每个字段的撰写逻辑与验收标准如下表:

要素 定义 撰写要点 常见错误
页面名称 该页面在系统内的唯一标识 使用“功能前缀+页面类型”格式(如“订单详情页”、“用户管理页”) 使用口语化名称(如“那个改单的页面”)
页面入口 用户到达此页面的前置路径 列出所有入口:导航菜单、按钮跳转、浮层链接、外部扫码等 只写一个入口,忽略全局搜索或消息通知入口
功能模块概述 页面承载的核心功能列表(不包含次要交互细节) 按操作频率排序:高频功能在前;用名词性短语,不写交互细节 把“按钮颜色”写进模块概述
核心操作路径 用户完成主要业务目标的操作序列 使用“步骤1→步骤2→步骤3”结构;标注关键反馈(弹窗/跳转/状态变化) 只写UI点击,不写系统返回结果
页面跳转关系 页面间的前进、后退、新开、替换关系 使用流程图或列出“从A页→B页(新开)”、“从B页→A页(返回)” 遗漏返回场景,导致用户“确定后不知道去哪”

4.3 五要素的实战撰写流程

4.3.1 第一步:提取页面名称

从需求列表或用户访谈记录中,找出所有独立页面级功能。使用以下规则命名:

  • 规则1:名称必须包含功能域(订单/商品/用户/数据) + 页面类型(列表页/详情页/编辑页/审批页/结果页)。
  • 规则2:同一功能域下的同类页面使用数字后缀区分(“订单列表页_v1”、“订单列表页_v2”用于A/B测试时)。
✅ 正确示例:“订单批量审批页”、“数据看板首页”、“用户收货地址编辑页”。
❌ 错误示例:“审批那个”、“改信息的页面”、“第一个表”。

4.3.2 第二步:穷举页面入口

针对一个页面,不要只写最常见的入口。需要从用户旅程出发,列出所有可能的来源:

  1. 主入口:左侧导航 / 顶部菜单 / 全局搜索。
  2. 次入口:按钮跳转(如点击“查看详情”进入详情页);浮层/弹窗中的链接。
  3. 系统入口:邮件/短信通知中的URL;分享链接;外部系统调用(API回调跳转)。
  4. 异常入口:操作失败的返回页(如支付失败后的重新支付页)。
用户访谈技巧:问“你在什么场景下会需要用到这个页面?”通常能发现2~3个被产品经理忽略的入口(如“我从公司群里的链接点进来的”、“用户打电话让我直接用验证码登录”)。

4.3.3 第三步:撰写功能模块概述

此步骤是需求拆解的核心产出。按照MECE原则(相互独立,完全穷尽)将页面功能拆解为若干个模块。每个模块只写一个功能短语,不写交互细节。

示例:订单详情页的功能模块清单

  • 订单基础信息展示
  • 商品明细列表(图片、名称、单价、数量)
  • 物流信息跟踪(物流公司、运单号、最新轨迹)
  • 售后入口(申请退款/退货按钮)
  • 操作记录时间轴
避坑:不要将“按钮颜色为蓝色”或“弹窗宽度600px”写进功能模块概述。这些属于交互规范,应在单独的“交互说明”或“视觉标注”中定义。

4.3.4 第四步:定义核心操作路径

核心操作路径 = 用户完成主要业务目标必须经过的点击/输入序列。通常一个页面有1~2条核心路径。路径中需要包含系统反馈节点。

示例:“订单批量审批页”的核心操作路径

用户勾选待审批订单(最多50条) → 点击“批量通过”按钮
    → 系统弹出二次确认浮层(文案:“确认通过所选X条订单?”)
    → 用户点击“确认”
    → 系统加载并显示审批进度条
    → 审批完成,页面刷新并显示最新结果(成功条目/失败条目 + 失败原因)

4.3.5 第五步:绘制页面跳转关系(含SVG流程图)

页面跳转关系是五要素中最容易遗漏但最影响开发排期的部分。需要明确每个操作(按钮、链接、定时事件)触发的跳转类型:新开页面、当前页替换、返回上一页、浮层(非跳转)。

以下是一个“用户购买退换”场景的页面跳转关系SVG图,展示页面间的前进、返回与异常路径。

页面跳转关系示例:购买退换流程 商城首页 商品列表页 商品详情页 订单确认页 支付结果页 售后申请页 订单列表页 点击“全部商品” 点击商品卡片 点击“立即购买” 点击确认支付 点击“查看订单”(返回) 订单异常 → 申请售后 图例说明:实线 = 正常业务路径 | 虚线 = 返回路径 | 红色虚线 = 异常/售后路径

此SVG图展示了5个核心页面节点和6条跳转关系,包含:正常购买路径(蓝色/绿色/橙色/紫色)、返回路径(青色虚线)以及异常售后路径(红色虚线)。在每个跳转箭头上标注了触发操作(点击按钮/链接),开发工程师可以直接据此实现路由配置。

4.4 交付物模板:页面级说明文档

在一个完整的需求交付物中,每个页面都需要一份如下结构的独立卡片。以下是一个可直接复用的模板:

模板:PAGE-001 商品详情页
页面名称:商品详情页(Product Detail Page)
入口来源:
  - 主入口:商品列表页点击任意商品卡片
  - 次入口:搜索结果页点击商品标题
  - 外部入口:营销短信中的商品短链接(需跟踪utm参数)

功能模块概述:
  [高频] 商品主图展示与放大 / 商品规格选择 / 加入购物车 / 立即购买
  [中频] 商品描述图文展示 / 用户评价列表
  [低频] 分享按钮 / 品牌关注 / 收藏按钮

核心操作路径(购买路径):
  用户选择规格(尺码/颜色) → 点击“立即购买”
    → 系统验证库存(有货则跳转订单确认页;无货则弹出“库存不足”提示浮层)
    → 订单确认页承载后续流程

页面跳转关系:
  从:商品列表页(点击商品卡片) → 当前页(新开页)
  从:当前页(点击“立即购买”且库存充足) → 订单确认页(替换当前页)
  从:当前页(点击“加入购物车”) → 无页面跳转(显示“已加入购物车”toast)
  从:当前页(点击浏览器后退按钮) → 回到商品列表页
  从:外部链接(无referrer) → 当前页(新开页,带来源标记)
验收标准(Checklist):
  • ✅ 页面名称是否使用“功能域+页面类型”格式?
  • ✅ 是否穷举≥2个入口(主+次)?
  • ✅ 功能模块是否按频率排序,且不包含UI细节?
  • ✅ 核心操作路径是否包含系统反馈节点?
  • ✅ 页面跳转关系是否包含前进、返回、异常场景?

4.5 本章小结

页面级说明是产品需求文档中最具结构化的输出物之一。通过页面名称、入口、功能模块概述、核心操作路径、页面跳转关系五要素,可以在开发前消除大部分的页面级歧义。本章提供的模板与SVG流程图可直接用于实际项目的交付物模板,建议与全局流程图和交互说明配套使用,形成完整的需求链。