• 报告期次：第1次 ｜ 报告日期：2026-10-08 ｜ 项目组号：第6组 ｜ 项目名称：在线购物系统

• 已完成工作：买家端需求分析、核心业务流程与状态图绘制、异常场景及验收标准整理
• 成果物：一、买家前端概述与角色权限

本文档用于定义《在线购物系统 MVP》第一迭代中买家前端的页面结构、功能需求、交互规则、表单字段、异常提示和业务流程，为后续 Vue3 前端开发以及前后端接口联调提供统一依据。

本系统采用：

• 单卖家
• 单商品
• 买家免注册
• 线下交易
• 购买意向排队
• 卖家手动确认交易结果

买家无需注册和登录，即可浏览当前商品并提交购买意向。

买家属于匿名普通用户。 买家可以：

• 浏览当前商品
• 查看商品详情
• 提交购买意向
• 获取系统生成的口令码
• 凭口令码查询自己的购买意向
• 查看当前排队位次
• 在排队阶段修改姓名和联系电话
• 在排队阶段撤销购买意向
• 在交易阶段查看交易状态

买家端必须遵循以下核心规则： 提交购买意向 ≠ 进入交易 ≠ 商品冻结

具体流程为： 买家提交意向 → 进入排队 → 卖家选择队首买家开始交易 → 买家进入交易 → 商品自动冻结

因此，买家提交购买意向后，商品仍然处于“在售”状态，可以继续接受其他买家的购买意向。

页面功能：买家无需注册和登录即可访问。 由于系统采用单商品 MVP 模式，因此页面只展示当前商品，不展示商品列表。

商品信息包括：

• 商品名称
• 商品描述
• 商品图片
• 商品价格
• 商品状态

商品在售 当商品状态为“在售”时，显示提交购买意向按钮，点击后进入 BUY‑03。

商品冻结 当商品状态为“已冻结（交易中）”时，商品仍可以查看，但不能提交购买意向。按钮置灰，并显示：商品交易中，暂时无法提交购买意向。

没有在售商品 当系统当前没有在售商品时，显示：暂无在售商品，请稍后再来。同时提供管理购买意向入口，使已经提交过意向的买家仍可以查询自己的状态。

商品已下架 已经交易成功或被卖家手动下架的商品，不再作为当前商品展示。

• 在售：显示提交购买意向按钮。
• 已冻结（交易中）：显示商品详细信息，但提交按钮不可用，提示：商品交易中，暂时无法提交购买意向。

联系电话本版本只校验是否为空，不验证号码真实性。

点击提交后：

1. 前端执行表单校验
2. 校验通过后发送请求
3. 提交按钮进入加载状态，防止重复点击
4. 后端再次检查商品状态和重复意向

提交成功后，系统即时生成唯一口令码。 页面显示：

意向提交成功！ 请妥善保存下方口令码，口令码仅展示一次，丢失无法找回。

同时展示：商品名称、商品价格、提交时间、当前状态、口令码。 口令码只在提交成功页面展示一次，不发送短信，不提供找回功能。

买家从首页进入管理购买意向，输入购买意向口令码，点击查询意向。 系统根据口令码查询本人购买意向。 如果口令码不存在或已经失效：口令码已失效，无对应意向信息，不得展示其他买家的信息。

排队中 展示：商品名称、商品价格、意向状态、当前排队位次、提交时间、买家姓名、联系电话。 提供：修改联系信息、撤销购买意向按钮。

正在交易 显示：当前已进入交易流程，请等待卖家确认交易结果。 此时不允许修改姓名、不允许修改联系电话、不允许撤销意向。

交易失败并重新排队 显示：交易暂未完成，您的意向已重新进入排队队列，原口令码继续有效，买家可以查看新的排队位次。

意向失效 如果买家撤销、卖家作废、交易成功或者商品下架导致意向终结：当前购买意向已失效，无法继续管理。

系统允许同一个手机号提交不同商品的购买意向。 但是：同一商品 + 同一手机号只能存在一条有效购买意向。

最终限制由后端负责，前端负责展示错误提示。

买家提交购买意向后立即进入排队。 排队按照提交时间正序执行，先提交者优先。

修改姓名或联系电话不会改变排队位次。

只有排队中状态允许撤销。 撤销后：

• 买家退出队列
• 后续买家位次前移
• 原口令码失效

买家撤销意向不会直接改变商品状态。

生效：提交购买意向成功后立即生效。

持续有效：排队中、正在交易、交易失败重新排队。

失效：买家主动撤销；卖家将意向作废；交易成功；商品下架导致意向终结。

flowchart TD
    A["访问买家商品首页"] --> B{"当前是否存在商品"}
    B -- "否" --> C["暂无在售商品，请稍后再来"]
    B -- "是" --> D["查看当前商品"]
    D --> E{"商品状态"}
    E -- "在售" --> F["点击提交购买意向"]
    E -- "已冻结" --> G["按钮置灰，提示商品交易中"]
    F --> H["填写姓名和联系电话"]
    H --> I{"前端校验"}
    I -- "失败" --> H
    I -- "通过" --> J["提交购买意向"]
    J --> K{"后端校验"}
    K -- "失败" --> L["显示业务错误提示"]
    K -- "成功" --> M["生成唯一口令码"]
    M --> N["一次性展示口令码"]
    N --> O["买家保存口令码"]
    O --> P["进入购买意向队列"]
    P --> Q["等待卖家处理"]
    Q --> R["卖家选择队首买家开始交易"]
    R --> S["买家进入交易状态"]
    S --> T["商品自动冻结"]
    T --> U{"卖家确认交易结果"}
    U -- "成功" --> V["商品下架"]
    U -- "失败并作废" --> W["当前意向作废"]
    U -- "失败并重新排队" --> X["当前意向进入队尾"]
    X --> Y{"队列是否还有其他意向"}
    Y -- "有" --> Z["自动递补队首进入交易"]
    Y -- "无" --> AA["商品恢复在售"]

stateDiagram-v2
    [*] --> 在售
    在售 --> 已冻结: 卖家开始与队首买家交易
    已冻结 --> 已下架: 卖家确认交易成功
    已冻结 --> 在售: 交易失败且队列为空
    已冻结 --> 已冻结: 交易失败后自动递补下一位
    在售 --> 已下架: 卖家手动下架

注：卖家手动冻结属于后台操作。买家端只体现为商品暂时不能提交购买意向。交易中的商品禁止手动解冻。

stateDiagram-v2
    [*] --> 排队中: 提交购买意向
    排队中 --> 正在交易: 卖家开始交易
    排队中 --> 已撤销: 买家主动撤销
    正在交易 --> 已成功: 卖家确认交易成功
    正在交易 --> 已作废: 卖家确认失败并作废
    正在交易 --> 重新排队: 卖家确认失败并重新排队
    重新排队 --> 排队中: 进入队尾

场景： 买家打开页面，页面显示商品在售；卖家在后台开始与队首买家交易，商品进入冻结状态；原买家点击提交购买意向。

处理： 后端必须重新判断商品状态。如果商品已经冻结，拒绝本次提交。 前端提示：商品状态已发生变化，请刷新页面后重试。

系统按照后端实际成功处理的提交时间确定先后顺序。 后端负责并发控制、商品状态校验、排队顺序、重复意向控制。 买家不需要了解其他买家的具体信息。

• **前端：**点击后按钮进入加载状态，禁止重复点击。
• **后端：**再次检查是否已经存在有效意向。即使前端重复请求，也不能产生两条有效意向。

买家进入交易状态后：

• 商品保持冻结
• 买家不能修改信息
• 买家不能自行撤销

由卖家最终确认交易成功或者交易失败。

卖家标记交易失败后，可以将当前意向重新排队，该意向进入队尾。

• 队列还有其他买家：自动递补下一位队首买家进入交易，商品继续保持冻结状态。
• 队列为空：商品恢复在售，等待新的买家提交购买意向。

卖家选择作废，当前意向终结，口令码失效。系统继续检查其他排队意向。

卖家确认交易成功后：

1. 商品进入已下架状态
2. 商品进入历史商品
3. 当前意向交易成功
4. 相关未完成意向终结
5. 相关口令码失效
6. 买家不能再提交该商品购买意向

flowchart LR
    A["BUY‑01 商品浏览首页"] --> B["BUY‑02 商品详情页"]
    B --> C["BUY‑03 购买意向提交页"]
    C --> D["BUY‑04 提交成功页"]
    D --> E["BUY‑05 意向口令码管理页"]
    A --> E
    E --> F["BUY‑06 意向详情/状态页"]
    F --> E

买家前端负责：

• 页面展示
• 表单输入
• 基础表单校验
• 商品状态展示
• 按钮状态控制
• 错误提示
• 口令码一次性展示
• 排队位次展示
• 页面跳转
• 防止重复提交

后端负责：

• 商品状态最终校验
• 购买意向创建
• 同商品同手机号重复意向限制
• 队列管理
• 先到先得排序
• 口令码生成
• 口令码验证
• 买家意向状态管理
• 商品状态流转
• 交易结果处理
• 失败后的自动递补
• 数据持久化
• 并发控制

本次迭代属于：需求分析 & 原型设计阶段

本次完成：

• 买家角色与权限定义
• 买家页面清单
• 页面功能设计
• 页面交互规则
• 表单字段定义
• 表单校验规则
• 异常提示文案
• 口令码机制
• 购买意向排队机制
• 商品状态设计
• 买家意向状态设计
• 买家业务流程
• 异常场景
• 页面导航
• 前后端职责划分
• 买家端验收标准

本 MVP 买家端不包含：

• 买家注册
• 买家登录
• 在线支付
• 物流配送
• 商品评价
• 消息通知
• 短信通知
• 口令码找回
• 买家之间的信息查看
• 自动刷新商品状态

商品 同一时间只允许一件商品处于在售状态。 商品成功交易后下架，卖家才可以继续发布下一件商品。

买家 买家无需注册，通过口令码管理购买意向。

排队 购买意向按照提交时间先后顺序排队。卖家无权跳过队首买家选择其他买家进行交易。

冻结 商品不会因为买家提交意向而立即冻结。 只有卖家手动选择队首买家开始交易后：队首买家进入交易 + 商品自动冻结。

交易失败 交易失败后：卖家决定当前意向“作废”或“重新排队”。 重新排队后：当前意向进入队尾，原口令码继续有效。

• 如果还有其他买家：系统自动递补下一位队首买家进入交易。
• 如果没有其他买家：商品恢复在售。

交易成功 交易成功后：商品下架，当前交易完成，相关意向终结。

flowchart TD
    A["匿名浏览当前商品"] --> B{商品是否在售?}
    B -- 是 --> C["填写姓名 + 联系电话"]
    C --> D["提交购买意向"]
    D --> E["生成一次性口令码"]
    E --> F["进入排队"]
    F --> G["等待卖家处理"]
    G --> H["卖家选择队首买家开始交易"]
    H --> I["买家进入交易"]
    I --> J["商品自动冻结"]
    J --> K["线下交易"]
    K --> L{交易结果}
    L -- 成功 --> M["商品下架"]
    L -- 失败 --> N["卖家处理当前意向"]
    N --> O{"处理方式"}
    O -- 作废 --> P["意向终结"]
    O -- 重新排队 --> Q["进入队尾"]
    Q --> R["自动递补下一位"]
    R --> S{"队列是否有人"}
    S -- 有 --> H
    S -- 无 --> T["商品恢复在售"]

本次买家前端设计最终遵循以下核心原则： 免注册、单商品、先到先得、线下交易、卖家控制交易、系统自动维护状态。

其中最重要的业务关系为：

• 提交购买意向 ≠ 商品冻结
• 卖家开始交易 = 队首买家进入交易 + 商品自动冻结
• 交易失败 = 作废或重新排队
• 重新排队 = 原口令码继续有效 + 进入队尾
• 交易成功 = 商品下架 + 当前意向终结

（评审后填写）