这是一个纯粹的、面向业务逻辑和交互细节的**产品需求文档 (PRD)**。

该文档完全剔除了技术实现代码（如Java类、数据库SQL、API参数），专注于**功能定义、业务流程、界面元素、交互逻辑及异常处理**，旨在让UI设计师知道画什么，让前端/后端开发人员知道业务逻辑是什么。

---

## 目录
1. [产品全局概述](#1-产品全局概述)
   - [1.1 产品定位](#11-产品定位)
   - [1.2 核心业务流程](#12-核心业务流程)
   - [1.3 关键逻辑说明](#13-关键逻辑说明)
2. [用户端 - 微信小程序 (C端)](#2-用户端---微信小程序-c端)
   - [2.1 首页](#21-首页)
   - [2.2 开门鉴权流程](#22-开门鉴权流程)
   - [2.3 购物进行中](#23-购物进行中)
   - [2.4 订单结算页](#24-订单结算页)
   - [2.5 个人中心](#25-个人中心)
3. [商户运营端 - PC管理后台 (B端)](#3-商户运营端---pc管理后台-b端)
   - [3.1 仪表盘](#31-仪表盘)
   - [3.2 商品管理](#32-商品管理)
   - [3.3 设备管理](#33-设备管理)
   - [3.4 订单中心 & 异常处理](#34-订单中心--异常处理)
   - [3.5 营销中心](#35-营销中心)
   - [3.6 财务对账](#36-财务对账)
4. [商家运营端 - 微信小程序 (移动运维)](#4-商家运营端---微信小程序-移动运维)
   - [4.1 工作台首页](#41-工作台首页)
   - [4.2 智能补货](#42-智能补货)
   - [4.3 设备控制](#43-设备控制)
5. [全局异常逻辑与风控需求](#5-全局异常逻辑与风控需求)
   - [5.1 逃单与坏账处理](#51-逃单与坏账处理)
   - [5.2 网络异常处理](#52-网络异常处理)
   - [5.3 门锁安全](#53-门锁安全)
6. [交互体验细节](#6-交互体验细节)

---

# 智能视觉识别售卖机系统 - 产品需求文档 (PRD)

| 文档属性 | 内容 |
| :--- | :--- |
| **项目名称** | 智能视觉识别售卖机系统 |
| **文档版本** | V1.0 (产品核心版) |
| **核心模式** | 视觉识别 + 信用免密支付 + 即拿即走 |
| **底层支撑** | 哈哈零兽 (Haha Lingshou) 智能柜能力 |

---

### 版本控制历史
| 版本号 | 修改日期 | 修改人 | 修改内容 |
| :--- | :--- | :--- | :--- |
| V1.0 | 2026-01-23 | 系统 | 初始版本，完成核心功能需求文档 |

---

### 术语定义
| 术语 | 解释 |
| :--- | :--- |
| 视觉识别 | 基于人工智能技术，通过摄像头拍摄的视频或图像识别商品的技术 |
| 信用免密支付 | 基于用户的信用评分（如微信支付分、支付宝芝麻分），无需输入密码即可完成支付的方式 |
| 即拿即走 | 用户扫码开门后，可直接拿走商品，关门后系统自动识别并扣款的购物模式 |
| 后结算模式 | 先购物后结算的模式，用户先拿走商品，系统后识别并扣款 |
| 挂起订单 | 当AI识别置信度低于85%时，系统不自动扣款，生成需要人工审核的订单 |
| 虚拟货架 | 虽然是视觉柜，但仍需配置的商品摆放信息，用于计算满载率 |
| 快照对比模式 | 运维补货时，系统对比开门前和关门后的商品快照，自动盘点库存的模式 |

---

## 1. 产品全局概述

### 1.1 产品定位
一款基于人工智能视觉识别技术的智能零售终端管理系统。用户无需逐个扫码商品，只需扫码开门，自由选购，关门后系统自动识别拿走的商品并完成扣款，实现“无感支付”购物体验。

### 1.2 核心业务流程
1.  **用户**：扫码 -> 授权（微信/支付宝分）-> 开门 -> 拿货 -> 关门 -> 收到扣款通知。
2.  **运营**：PC端配置商品AI模型 -> 同步设备。
3.  **运维**：小程序扫码开门 -> 补货 -> 关门 -> 系统自动盘点库存。

### 1.3 关键逻辑说明 (基于视觉柜特性)
*   **后结算模式**：先购物后结算，必须强依赖“微信支付分”或“支付宝芝麻分”进行风控。
*   **识别延迟**：用户关门后，云端AI需要5-15秒分析视频，因此订单生成是异步的，前端需有对应的等待交互。
*   **证据链**：每一笔订单必须关联一段“购物视频”，用于解决用户对AI识别结果的异议。

---

## 2. 用户端 - 微信小程序 (C端)

### 2.1 首页
*   **页面结构**：
    *   **顶部**：黄色导航栏，左侧房子图标，中间显示“AI零售柜”标题，右侧三个图标（更多、收起、设置）。
    *   **中部**：背景为商品图案，中间显示“AI零售柜”大标题。
    *   **底部（核心）**：黄色大圆形按钮，上面有扫码图标和“扫码开门”文字。
    *   **底部两侧**：左侧“我的”图标和文字，右侧“退款”图标和文字。
    *   **底部信息**：显示“微信支付分 | 550分及以上优享”和“客服电话：”文字。
*   **交互逻辑**：
    *   点击“扫码开门” -> 调用摄像头。
    *   解析二维码：若非本机柜二维码，提示“无效二维码”；若是，进入开门鉴权流程。

### 2.2 开门鉴权流程 (核心交互)
*   **登录判断**：未登录用户强制拉起微信手机号授权登录。
*   **风控前置检查**：
    1.  **检查未完成订单**：若用户有一笔订单状态为“识别中”或“待支付”，弹窗提示“您有上一笔订单正在处理，请稍候再试”，禁止开门。
    2.  **检查信用分**：
        *   调用支付分接口。若分数 < 550（后台可配），弹窗提示“您的信用分不足，请充值余额使用”。
        *   若未签约免密支付，跳转至微信/支付宝签约页。
*   **开门反馈**：
    *   **开门成功**：手机震动反馈，跳转至【购物进行中】页面。
    *   **开门失败**：弹窗提示具体原因（如：设备离线、设备被占用、库存不足）。

### 2.3 购物进行中 (状态机页面)
此页面根据设备状态实时变化，不仅是静态页。

*   **阶段一：选购中 (门已开)**
    *   **文案**：大字提示“门已开，请选购商品”。
    *   **操作**：显示“遇到问题？（如门没开）”链接，点击可申请“辅助远程开门”或“报修”。
    *   **倒计时**：若开门超过60秒未关门，页面变红提示“请尽快关门”。
*   **阶段二：结算中 (门已关)**
    *   **触发条件**：用户关上柜门。
    *   **交互**：展示动态Loading动画，文案“AI正在识别商品，请稍候...”。
    *   **超时处理**：若等待超过30秒未出结果，页面自动跳转至首页，并顶部通告“订单处理中，稍后将推送账单通知”。

### 2.4 订单结算页
*   **展示要素**：
    *   购物清单：商品图、名称、数量、单价。
    *   优惠明细：优惠券扣减、会员折扣。
    *   实付金额：突出显示。
*   **支付逻辑**：
    *   系统默认自动发起免密扣款。
    *   **扣款成功**：显示“支付成功”，展示“查看购物视频”按钮。
    *   **扣款失败**（如余额不足）：显示“支付失败”，底部出现“立即支付”按钮，引导用户手动完成支付。

### 2.5 个人中心
*   **我的订单**：
    *   列表页显示状态：识别中、已完成、待付款、退款/售后。
    *   **详情页特色功能**：
        *   **购物回放**：内嵌视频播放器，播放哈哈零兽API返回的该笔交易监控片段（用户存疑时的核心证据）。
        *   **申请售后**：针对识别错误的商品，用户可勾选并上传照片申诉。
*   **钱包/卡包**：
    *   余额充值：固定金额充值卡片（充100送5）。
    *   免密管理：查看当前免密支付签约状态，支持解约（需校验无欠款）。
    *   优惠券：查看可用/失效券。

---

## 3. 商户运营端 - PC管理后台 (B端)

### 3.1 仪表盘 (Dashboard)
*   **核心数据**：今日销售额、今日订单数、客单价、新增用户数。
*   **设备概况**：在线设备数、离线设备数、**缺货设备数**（库存<20%）、**异常设备数**（门未关/摄像头故障）。
*   **待办事项**：待审核的挂起订单、待处理的退款申请。

### 3.2 商品管理 (关联AI模型)
由于视觉识别依赖图片训练，此模块与传统电商不同。
*   **商品库**：
    *   **基础信息**：商品名、分类、成本价、零售价、规格。
    *   **条码 (Barcode)**：必须录入标准的69码。
    *   **AI模型图 (关键)**：
        *   上传要求：必须上传**白底图**或**6个面的包装展开图**。
        *   **同步状态**：显示该商品在底层AI库的状态（未同步、同步中、已生效、训练失败）。
        *   *逻辑约束*：未通过“已生效”状态的商品，严禁上架到设备中（因为AI不认识，会导致无法扣款）。

### 3.3 设备管理
*   **设备档案**：
    *   绑定：输入机身序列号 (SN) 绑定到商户。
    *   点位信息：所属区域（省市区）、详细地址（写字楼/学校）、经纬度（用于小程序地图）。
*   **虚拟货架**：虽然是视觉柜，但需配置“最大容积”或“推荐摆放图”，以便计算满载率。
*   **二维码下载**：生成设备专属的开门二维码，用于打印张贴。

### 3.4 订单中心 & 异常处理
*   **订单列表**：包含所有交易流水。
*   **挂起订单审核 (特色功能)**：
    *   **场景**：当AI识别置信度低于85%（如遮挡严重），系统不自动扣款，生成“挂起单”。
    *   **操作界面**：左侧播放购物视频，右侧显示AI识别出的疑似商品列表。
    *   **人工修正**：管理员根据视频，勾选或修改实际拿走的商品及数量，点击“确认扣款”，系统再向用户发起扣款。

### 3.5 营销中心
*   **优惠券配置**：满减券、折扣券、单品券。支持设置有效期、发放总量。
*   **活动规则**：新用户首单立减、充值赠送规则。

### 3.6 财务对账
*   **资金流水**：每一笔订单的微信/支付宝交易单号、手续费、入账金额。
*   **异常账单**：统计“已拿货但扣款失败（坏账）”的记录。

---

## 4. 商家运营端 - 微信小程序 (移动运维)

### 4.1 工作台首页
*   **看板**：展示该运维人员负责区域的设备状态（正常/缺货/离线）。
*   **快捷入口**：扫码补货、远程开门、故障上报。

### 4.2 智能补货 (快照对比模式)
*   **场景**：运维人员到达设备前进行补货。
*   **流程**：
    1.  **身份识别**：小程序扫码，系统识别为“运维人员”。
    2.  **开门类型选择**：选择“补货开门”（区别于测试开门或购物开门）。
    3.  **物理补货**：柜门弹开，运维整理货层，放入商品，关门。
    4.  **自动盘点**：
        *   关门后，云端对比“开门前快照”与“关门后快照”。
        *   **结果确认**：小程序弹出“补货清单确认页”，显示系统识别到的【新增商品及数量】。
        *   **人工修正**：若AI识别有误（如多识别了一瓶水），运维人员可手动修改数量，点击“确认提交”。系统以运维提交的数据更新本地库存。

### 4.3 设备控制
*   **远程开门**：用于解决用户扫码无法开门，或门锁卡住的紧急情况。需记录操作日志及原因。
*   **设备重启**：下发远程指令重启安卓工控机。

---

## 5. 全局异常逻辑与风控需求

### 5.1 逃单与坏账处理
*   **余额不足**：若用户拿走商品后，免密扣款失败。
    *   系统自动将该用户标记为“欠费状态”。
    *   小程序端：用户下次打开小程序，弹窗强制要求补缴欠款，否则无法使用任何功能。
    *   短信触达：发送欠费催缴短信。
*   **恶意行为**：若识别到视频中有遮挡摄像头、暴力掰门行为，管理员可在后台将该用户拉入黑名单，永久禁止扫码。

### 5.2 网络异常处理
*   **断网购物**：
    *   视觉柜强依赖网络上传视频。若检测到网络信号极差，用户扫码时应直接提示“设备网络不佳，暂停服务”，防止开门后视频无法上传导致无法结算。
*   **开门超时**：
    *   扫码后若5秒内未收到开门成功指令，小程序自动停止Loading并提示“连接超时，请重试”。

### 5.3 门锁安全
*   **门未关报警**：若门锁传感器检测到开启状态超过5分钟，向商家端小程序推送最高级别报警，并发送短信给运维人员。

---

## 6. 交互体验细节 (UX Requirements)

1.  **响应速度**：扫码到开门动作必须在 3秒内 完成（依赖后端优化与Redis缓存）。
2.  **Loading动效**：在“识别结算中”阶段，必须使用趣味性文案（如“AI正在数数...”）或进度条，缓解用户的焦虑感。
3.  **视频播放**：订单详情页的视频播放需支持全屏、拖动进度条，且默认静音，点击开启声音。

---

这份文档通过业务视角，详细规定了系统应该“长什么样”以及“怎么工作”，开发团队可依据此文档进行详细的技术方案设计。