需求文档.md 13 KB
这是一个纯粹的、面向业务逻辑和交互细节的产品需求文档 (PRD)。
该文档完全剔除了技术实现代码（如Java类、数据库SQL、API参数），专注于功能定义、业务流程、界面元素、交互逻辑及异常处理，旨在让UI设计师知道画什么，让前端/后端开发人员知道业务逻辑是什么。
目录
智能视觉识别售卖机系统 - 产品需求文档 (PRD)
| 文档属性 | 内容 |
|---|---|
| 项目名称 | 智能视觉识别售卖机系统 |
| 文档版本 | V1.0 (产品核心版) |
| 核心模式 | 视觉识别 + 信用免密支付 + 即拿即走 |
| 底层支撑 | 哈哈零兽 (Haha Lingshou) 智能柜能力 |
版本控制历史
| 版本号 | 修改日期 | 修改人 | 修改内容 |
|---|---|---|---|
| V1.0 | 2026-01-23 | 系统 | 初始版本，完成核心功能需求文档 |
术语定义
| 术语 | 解释 |
|---|---|
| 视觉识别 | 基于人工智能技术，通过摄像头拍摄的视频或图像识别商品的技术 |
| 信用免密支付 | 基于用户的信用评分（如微信支付分、支付宝芝麻分），无需输入密码即可完成支付的方式 |
| 即拿即走 | 用户扫码开门后，可直接拿走商品，关门后系统自动识别并扣款的购物模式 |
| 后结算模式 | 先购物后结算的模式，用户先拿走商品，系统后识别并扣款 |
| 挂起订单 | 当AI识别置信度低于85%时，系统不自动扣款，生成需要人工审核的订单 |
| 虚拟货架 | 虽然是视觉柜，但仍需配置的商品摆放信息，用于计算满载率 |
| 快照对比模式 | 运维补货时，系统对比开门前和关门后的商品快照，自动盘点库存的模式 |
1. 产品全局概述
1.1 产品定位
一款基于人工智能视觉识别技术的智能零售终端管理系统。用户无需逐个扫码商品，只需扫码开门，自由选购，关门后系统自动识别拿走的商品并完成扣款，实现“无感支付”购物体验。
1.2 核心业务流程
- 用户：扫码 -> 授权（微信/支付宝分）-> 开门 -> 拿货 -> 关门 -> 收到扣款通知。
- 运营：PC端配置商品AI模型 -> 同步设备。
- 运维：小程序扫码开门 -> 补货 -> 关门 -> 系统自动盘点库存。
1.3 关键逻辑说明 (基于视觉柜特性)
- 后结算模式：先购物后结算，必须强依赖“微信支付分”或“支付宝芝麻分”进行风控。
- 识别延迟：用户关门后，云端AI需要5-15秒分析视频，因此订单生成是异步的，前端需有对应的等待交互。
- 证据链：每一笔订单必须关联一段“购物视频”，用于解决用户对AI识别结果的异议。
2. 用户端 - 微信小程序 (C端)
2.1 首页
- 页面结构：
- 顶部：黄色导航栏，左侧房子图标，中间显示“AI零售柜”标题，右侧三个图标（更多、收起、设置）。
- 中部：背景为商品图案，中间显示“AI零售柜”大标题。
- 底部（核心）：黄色大圆形按钮，上面有扫码图标和“扫码开门”文字。
- 底部两侧：左侧“我的”图标和文字，右侧“退款”图标和文字。
- 底部信息：显示“微信支付分 | 550分及以上优享”和“客服电话：”文字。
- 交互逻辑：
- 点击“扫码开门” -> 调用摄像头。
- 解析二维码：若非本机柜二维码，提示“无效二维码”；若是，进入开门鉴权流程。
2.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 智能补货 (快照对比模式)
- 场景：运维人员到达设备前进行补货。
- 流程：
- 身份识别：小程序扫码，系统识别为“运维人员”。
- 开门类型选择：选择“补货开门”（区别于测试开门或购物开门）。
- 物理补货：柜门弹开，运维整理货层，放入商品，关门。
- 自动盘点：
- 关门后，云端对比“开门前快照”与“关门后快照”。
- 结果确认：小程序弹出“补货清单确认页”，显示系统识别到的【新增商品及数量】。
- 人工修正：若AI识别有误（如多识别了一瓶水），运维人员可手动修改数量，点击“确认提交”。系统以运维提交的数据更新本地库存。
4.3 设备控制
- 远程开门：用于解决用户扫码无法开门，或门锁卡住的紧急情况。需记录操作日志及原因。
- 设备重启：下发远程指令重启安卓工控机。
5. 全局异常逻辑与风控需求
5.1 逃单与坏账处理
- 余额不足：若用户拿走商品后，免密扣款失败。
- 系统自动将该用户标记为“欠费状态”。
- 小程序端：用户下次打开小程序，弹窗强制要求补缴欠款，否则无法使用任何功能。
- 短信触达：发送欠费催缴短信。
- 恶意行为：若识别到视频中有遮挡摄像头、暴力掰门行为，管理员可在后台将该用户拉入黑名单，永久禁止扫码。
5.2 网络异常处理
- 断网购物：
- 视觉柜强依赖网络上传视频。若检测到网络信号极差，用户扫码时应直接提示“设备网络不佳，暂停服务”，防止开门后视频无法上传导致无法结算。
- 开门超时：
- 扫码后若5秒内未收到开门成功指令，小程序自动停止Loading并提示“连接超时，请重试”。
5.3 门锁安全
- 门未关报警：若门锁传感器检测到开启状态超过5分钟，向商家端小程序推送最高级别报警，并发送短信给运维人员。
6. 交互体验细节 (UX Requirements)
- 响应速度：扫码到开门动作必须在 3秒内 完成（依赖后端优化与Redis缓存）。
- Loading动效：在“识别结算中”阶段，必须使用趣味性文案（如“AI正在数数...”）或进度条，缓解用户的焦虑感。
- 视频播放：订单详情页的视频播放需支持全屏、拖动进度条，且默认静音，点击开启声音。
这份文档通过业务视角，详细规定了系统应该“长什么样”以及“怎么工作”，开发团队可依据此文档进行详细的技术方案设计。