使用与测试指南
怎么用、怎么测，都在这一页。不用再找文件。
最后更新 2026-09-17 · 网页后台第二版 · 安卓端首版
开始之前
三个地址、两个账号，记不住就回这儿看
| 角色 | 手机号 | 密码 | 看得到什么 |
|---|---|---|---|
| 老板 | 13800000000 | 私下问赵爽 | 全部，含进价、成本、毛利、参数设置、作废 |
| 店员 | 13800000001 | 私下问赵爽 | 不含进价、成本、毛利；改不了参数，也不能作废 |
网页后台和手机端用的是同一套数据。手机上开的单，刷新网页后台就能看到； 网页后台改的价格，手机同步之后就生效。
网页后台 · 电脑
七个标签页。老板管资料、看账、改参数；收银也能用，但手机更顺手
收银开单
条码框里扫码或手输后回车，商品和价格自动出来，点「确认成交」。
- 扫整箱码会按箱计价、按箱折算库存。一箱 24 瓶就加 24 瓶，不是 1 件。
- 扫到没见过的码不会卡住：弹窗输个成交价就能继续卖。这一单照常出单号， 事后在「商品 → 待完善商品」里补全，成本会自动回填到这一单。
- 某个商品还没记过初始库存时，成交后会问一句「现在还剩多少」，填了就不再问。
进货入库
扫码后会问这次的进价，填完加入，点「确认入库」。扫整箱码就按箱入库。
店员可以录进价并确认入库（老板不在店里时进货不能卡住），但确认后再查这张单， 进价和金额都看不到了。
商品与待完善
新建商品
填名称、规格、单位、售价、进价、条码即可。如果这个货按箱卖， 再填「一箱几个」「整箱码」「整箱价」三项，系统就会自动做箱瓶换算。
待完善商品
扫到未知码先卖出去的，都会落在这里。点「补全」填名字、进价、售价， 之前那几单的成本会自动补上。
每一行右边还有个「提醒设置」，可以单独给这个商品设补货点，不影响别的商品。
初始库存
系统上线不需要停业盘点。哪个货卖到了或进到了，就在这一页填一次「现在实际还剩多少」， 填完这个货就不再问。两周左右自然就补齐了。
退货
顾客退货走这一页。填了原销售单号，成本就按当时那一单算；不填也能退，按当前平均成本算。
盘点
只填「实际数了多少」，差异系统自己算，边填边显示。选好原因（盘点、报损、试吃、自用）， 点「生成盈亏单」。
- 没填的行不动。
- 实盘数和账面一样的行不会生成单据，不会留下一堆空单。
作废
开错了单，在各个单据列表右边点「作废」。
- 系统生成一张数量和金额都取反的单，两张单都留着，库存自动还原，营业额同步扣回。
- 只有老板能作废，同一张单不能作废两次。
今日经营与对账
营业额、成交单数、退款人人可见；今天赚了多少、进货花了多少只有老板能看到。
对账卡片会显示上次自动对账的时间和结论——每天凌晨 02:30 自动跑一次，不用你记得点。 也可以随时手动点「立即对账」。
参数设置
所有阈值都在这一页，代码里没有写死任何一个业务数字。
| 改哪一层 | 在哪改 | 效果 |
|---|---|---|
| 全店 | 「参数」页直接改，点保存 | 没单独设过的商品都跟着变 |
| 单个商品 | 「商品」页那一行点「提醒设置」 | 只影响这个商品；留空则恢复跟随全店 |
「来源」那一列会告诉你当前值是全店设的、商品单独设的还是系统默认。 「恢复默认」是把这一层的设置删掉、回到继承上一层，不是填一个空值。
手机 APP · 安卓
收银的主力形态。手机和 PDA 装的是同一个包，不用做两套
安装
手机浏览器打开 jxc.veendev.top/app/，页面上有下载按钮和二维码。 网页后台的登录页和右上角也都有「手机端」入口。
这是自己编的包、没上应用商店，所以系统会拦一下：
- 下载完点「打开」，选继续安装
- 提示「禁止安装未知应用」就点去设置，允许浏览器安装应用，再回来装
- 小米、华为可能还会做一次安全检测，等它扫完点继续
登录与同步
第一次登录必须联网，它会把商品资料下载到手机里。右上角出现绿点「已同步」就好了。
| 右上角 | 意思 |
|---|---|
| ● 已同步 | 都传上去了，没有积压 |
| ● 离线 · N 单待传 | 连不上服务器，单据存在手机里，联网会自动补传 |
| ● N 单待传 | 网络通但还在传，等几秒 |
| ● N 单被退回 | 服务器明确拒绝了某单，需要人看一眼 |
旁边的同步按钮可以手动催一次。「今日」页底部还有个「立刻重新同步全部商品资料」， 在网页后台新建了商品、手机上却搜不到时点它。
收银与进货
底部三个标签：收银、进货、今日。
- 点扫码用摄像头对准条码；也可以在条码框手输后回车（外接扫码枪也是这样）。
- 加进来之后用 + − 改数量，减到 0 就删掉这一行。
- 进货扫码后会问这次的进价。
- 未知码、整箱码、初始库存补录，行为和网页后台一样。
离线怎么工作
- 断网照样扫码、开单、成交，单据存在手机里。
- 网一通，十几二十秒自己就传上去了，你什么都不用点。
- 队列按开单顺序逐单上传。万一某单被服务器拒绝，它会停在队头标红， 不会跳过去传后面的——顺序错了账就错了。
- 每单带一个唯一标识，双击按钮、超时重试、离线重发都只算一次。
- 退出登录不会删掉没传的单，下次登录接着传。
「今日」页最上面那张卡是这台手机今天开的单，断网也有数看；下面那张是 整店今日，来自服务器，联网才有。两个数分开给，不含糊。
测试总览
按版本分三组。每组十来分钟，照着做就行
| 版本 | 在哪测 | 测什么 | 状态 |
|---|---|---|---|
| 第一版 | 电脑网页 | 主链路：建档、扫码、开单、减库存、当日营业额 | 已通过 |
| 第二版 | 电脑网页 | 参数配置、退货、盘点、作废、自动对账与备份 | 待测 |
| 安卓端首版 | 手机 | 离线开单、自动补传、本地条码字典、摄像头扫码 | 待测 |
第一版 · 网页主链路
在电脑上打开 网页后台，用老板账号。约十分钟
扫码卖一瓶水
进「收银」，条码框输 6921168509256 回车，加入后点「确认成交」。
扫整箱码，验证箱瓶换算
进「进货」，条码输 16921168509253（同一商品的整箱码），数量 1，进价填 28.80，确认入库。
扫一个没见过的码
回「收银」，条码随便输一串，比如 6999999999999，回车。
事后补全那个商品
进「商品 → 待完善商品」，点「补全」，填名字、进价、售价。
补录初始库存
进「初始库存」，填一个「现在实际还剩多少」，点记下。
看今天赚了多少，然后换店员账号
进「今日」，老板能看到营业额、单数、今天赚了多少、进货花了多少。 退出，用 13800000001 登录，再看同一个页面。
对账
「今日 → 对账 → 立即对账」。
看一眼参数
进「参数」页。
第二版 · 参数与退货盘点作废
电脑网页，老板账号。约十五分钟。第一版验的是「能开门做生意」，这一版验的是出了岔子怎么办
开测前的账面（照着对数）
| 商品 | 库存 | 成本单价 |
|---|---|---|
| 康师傅红烧牛肉面 袋装 | 10 | 3.20 |
| 可口可乐 330ml | 10 | 2.10 |
| 散装瓜子 | 10 | 8.50 |
| 农夫山泉饮用天然水 550ml | 32 | 1.24 |
| 摇摇乐 | 9 | 1.00 |
今日经营：营业额 6.00，成交 3 单，退款 0，今天赚了 5.00，进货花了 28.00。
改一个全店参数
进「参数」页，把补货点从 3 改成 8，保存。再点「恢复默认」。
只给一个商品单独设
进「商品」页，找到「可口可乐」，点那一行的「提醒设置」，填 50 确定。 再点一次看它显示什么，然后回「参数」页看全店的补货点。
验证参数真的会生效
「参数」页把「库存不够时是否允许继续卖」改成否，保存。
然后去「收银」扫 6928804011173，数量填 99，确认成交。
店员改不动参数
退出，用店员 13800000001 登录，进「参数」页。
卖一单，然后带原单退一件
换回老板账号。「收银」扫 6928804011173 数量 3 成交，记下单号。
进「退货」页，原销售单号填那个单号，扫同一个码数量 1，确认退货。
盘点
进「盘点」页，可口可乐账面显示 8，在「实际数了多少」填 6，原因选「报损」，生成盈亏单。 然后再试一次，这次填 6（和账面一样）。
作废
「收银」故意开一单错的：扫 6901028075831 数量 5 成交。
记下当前营业额和库存，然后在「最近的单」里点那单右边的作废。
对账
进「今日」页看「对账」卡片。
顺带说一句：备份
后台每天 03:30 自动导出数据库、本地保留 7 天，我做过一次恢复演练（还原进临时库，恒等式仍成立）。 整机快照也建了基线。
schtasks /Create /TN "jxc-pull-backup" /SC DAILY /ST 04:30 /F /TR "powershell -NoProfile -ExecutionPolicy Bypass -File D:\work\vv\vv-sp\vv-03-projects\vv-12-inventory\projects\server\deploy\pull-backup.ps1"
安卓端首版
在手机上测。约十分钟。先去下载安装
扫码卖一瓶水
底部选「收银」，点扫码用摄像头对准条码；没有实物就在条码框手输
6921168509256 回车。
扫整箱码
条码输 16921168509253。
把手机调成飞行模式，继续开单
打开飞行模式，然后照常扫码、加入、确认成交。
关掉飞行模式，什么都别点
等十几二十秒。
扫一个没见过的码
随便输一串没见过的码，比如 6999999999888。
初始库存就地补
如果某个商品还没记过初始库存，成交后会问一句「现在还剩多少」。
进货，然后换老板账号看
底部选「进货」，扫码后填进价，确认入库。然后退出，用老板账号登录同一个 APP。
双击不会重复扣
确认成交时快速连点两下。
我已经在模拟器上验过的
| 项目 | 结果 |
|---|---|
| 安装与启动 | 装上、能开、无崩溃 |
| 登录与主数据同步 | 成功，右上角绿点「已同步」 |
| 本地条码字典 | 手输条码，商品名与价格自动带出，走的是手机本地库 |
| 飞行模式下开单 | 照常成交，变黄点「离线 · 1 单待传」 |
| 恢复网络自动补传 | 没点任何按钮，二十秒内变回「已同步」，服务端收到那一单 |
| 事后对账 | 数量与成本两列恒等，差异 0 |
出问题怎么反馈
截图就行，不用整理
- 界面上的报错都是白话，直接截图发我。
- APP 装不上或打不开，告诉我手机型号和安卓版本。
- 数据对不上，告诉我哪个商品、你期望多少、实际多少，我从出入库记录倒查。
- 页面点了没反应，说一下哪个按钮、什么浏览器。
演示条码
测试时直接复制
| 条码 | 商品 | 按什么卖 | 售价 |
|---|---|---|---|
| 6921168509256 | 农夫山泉饮用天然水 550ml | 瓶 | 2.00 |
| 16921168509253 | 农夫山泉饮用天然水 550ml | 箱（1 箱 = 24 瓶） | 42.00 |
| 6901028075831 | 康师傅红烧牛肉面 袋装 | 袋 | 4.50 |
| 16901028075838 | 康师傅红烧牛肉面 袋装 | 箱（1 箱 = 12 袋） | 46.00 |
| 6928804011173 | 可口可乐 330ml | 罐 | 3.00 |
| （无条码） | 散装瓜子 | 斤 | 12.00 |
随便编一串没见过的码，就能测「未知码不阻塞收银」。
还没做的
说清边界，免得你测到一半找不到
手机 APP 里还没有
- 退货、盘点、作废（去网页后台）
- 新建商品（去网页后台；扫到未知码可以先卖）
- 拍照留档
整个系统还没有
- 报表：商品排行、进销存汇总、导出 Excel
- 补货提醒与压货提醒
- 商品合并的界面（服务端已支持）
- 小票打印、会员、促销
这一页由 AI 维护，每次交付后同步更新。
设计与开发过程的完整记录在项目文档里，这一页只讲怎么用、怎么测。