使用与测试指南

怎么用、怎么测，都在这一页。不用再找文件。

最后更新 2026-09-19 · 手机端 0.5.0（第 10 版）· 新增商品到期日

开始之前

三个地址、两种角色，记不住就回这儿看

网页后台和手机端用的是同一套数据。手机上开的单，刷新网页后台就能看到； 网页后台改的价格，手机同步之后就生效。

网页后台 · 电脑

七个标签页。老板管资料、看账、改参数；收银也能用，但手机更顺手

收银开单

条码框里扫码或手输后回车，商品和价格自动出来，点「确认成交」。

• 不扫码也能开单：直接在框里打商品名（「农夫」「可乐」），下面会列出来， ↑↓ 选、回车 加入，鼠标点也行。 按箱卖的商品，瓶和箱各占一行，选哪行就按哪个价、哪个换算走。 散装瓜子这种没有条码的货，只能这么加。
  纯数字一律当条码，不会跳出商品列表——扫码枪那条路一点没变。
• 扫整箱码会按箱计价、按箱折算库存。一箱 24 瓶就加 24 瓶，不是 1 件。
• 扫到没见过的码不会卡住：弹窗里填个成交价就能继续卖。这一单照常出单号， 事后在「商品 → 待完善商品」里补全，成本会自动回填到这一单。
  同一个弹窗里还有个选填的备注——一天下来可能有好几个没录入的商品， 光看条码后六位分不清哪个是哪个，随手记一句「绿色包装的辣条」， 待完善清单里就跟在商品名后面，一眼认得出。
• 某个商品还没记过初始库存时，成交后会问一句「现在还剩多少」，填了就不再问。

进货入库

扫码后会问这次的进价，填完加入，点「确认入库」。扫整箱码就按箱入库。

店员可以录进价并确认入库（老板不在店里时进货不能卡住），但确认后再查这张单， 进价和金额都看不到了。

商品与待完善

下架 / 停售

不卖了的货，点那一行的「下架」。下架不是删除：库存、历史单据、账实核对全都留着， 商品也还在这个列表里，只是标成「已下架」并且变灰。

改商品资料

每一行右边的「改资料」，一个弹窗改完名称、规格、单位、售价、进价、条码、整箱设置。 改资料不动库存——库存只能走进货、退货、盘点，这条没有例外。

商品名下面显示的是它的条码，右边小图标点一下就复制走。 按箱卖的商品会显示两个码，前面标着是哪个包装的（袋 6901028075831、箱 16901028075838）； 散装这类没有条码的显示「无条码」。

每一行右边还有个「提醒设置」，可以单独给这个商品设补货点，不影响别的商品。

初始库存

系统上线不需要停业盘点。哪个货卖到了或进到了，就在这一页填一次「现在实际还剩多少」， 填完这个货就不再问。两周左右自然就补齐了。

退货

顾客退货走这一页。填了原销售单号，成本就按当时那一单算；不填也能退，按当前平均成本算。

盘点

只填「实际数了多少」，差异系统自己算，边填边显示。选好原因（盘点、报损、试吃、自用）， 点「生成盈亏单」。

• 没填的行不动。
• 实盘数和账面一样的行不会生成单据，不会留下一堆空单。

作废

开错了单，在各个单据列表右边点「作废」。

• 系统生成一张数量和金额都取反的单，两张单都留着，库存自动还原，营业额同步扣回。
• 只有老板能作废，同一张单不能作废两次。

今日经营与对账

营业额、成交单数、退款人人可见；今天赚了多少、进货花了多少只有老板能看到。

对账卡片会显示上次自动对账的时间和结论——每天凌晨 02:30 自动跑一次，不用你记得点。 也可以随时手动点「立即对账」。

参数设置

所有阈值都在这一页，代码里没有写死任何一个业务数字。

「来源」那一列会告诉你当前值是全店设的、商品单独设的还是系统默认。 「恢复默认」是把这一层的设置删掉、回到继承上一层，不是填一个空值。

手机 APP · 安卓

收银的主力形态。手机和 PDA 装的是同一个包，不用做两套

安装

手机浏览器打开 jxc.veendev.top/app/，页面上有下载按钮和二维码。 网页后台的登录页和右上角也都有「手机端」入口。

这是自己编的包、没上应用商店，所以系统会拦一下：

• 下载完点「打开」，选继续安装
• 提示「禁止安装未知应用」就点去设置，允许浏览器安装应用，再回来装
• 小米、华为可能还会做一次安全检测，等它扫完点继续

登录与同步

第一次登录必须联网，它会把商品资料下载到手机里。右上角出现绿点「已同步」就好了。

旁边的同步按钮可以手动催一次。「今日」页底部还有个「立刻重新同步全部商品资料」， 在网页后台新建了商品、手机上却搜不到时点它。

收银与进货

底部三个标签：收银、进货、今日。

• 点扫码用摄像头对准条码；也可以在框里手输后回车（外接扫码枪也是这样）。
• 打商品名也能找货：输「农夫」「可乐」，下面列出来点一下就加进单。 一个包装占一行，选哪行就按哪个价、哪个换算走。散装这种没条码的货只能这么加。 这一步也走手机本地库，断网照样能搜。
  纯数字一律当条码，不会跳出商品列表——扫码枪那条路一点没变，和网页后台同一条规则。
• 加进来之后用 + − 改数量，减到 0 就删掉这一行。
• 进货扫码后会问这次的进价。
• 扫到没见过的码，成交价和选填的备注在同一个弹窗里填完。 备注会跟着单子传到后台，挂在商品名后面，补全时一眼认得出是哪个货。
• 扫到已下架的货会明说「已经下架了，不能再卖」，不会当成未知码去建新商品。 这一条离线也管用——下架状态是随主数据同步到手机本地的。
• 整箱码、初始库存补录，行为和网页后台一样。

退货

在收银页右上角的「退货」。顾客站在柜台前要退货时，店员人正好就在收银页。

两种退法，看手上有没有小票：

1. 有小票，按单号退。填上原销售单号，点「查这张单」， 顾客当时买的每一样都会列出来：买了几个、单价多少、已经退过几个、还能退几个。 点某一行的「退」，填个数量就加进这一单——不用对着小票重新扫一遍。
   手机上敲 XS202609180001 太难，旁边还有「最近」， 从这台手机开过的单里直接挑。
2. 没小票，直接扫码退。单号留空，扫要退的货（或打商品名）就行。 这时按当前平均成本回库。

• 加货的方式和开单完全一样：扫码、输条码、打商品名。
• 退货同样能离线做，联网自动补传——顾客站在柜台前同样等不了网。 断网时查不了原单，但可以不填单号先把货退掉。
• 下架的货仍然可以退：不能再卖，不代表以前卖出去的不能退回来。

商品（手机上改）

底部第三个标签。不用再回电脑改商品了——新货到了、价格调了、条码贴错了， 人站在货架前当场改完。

• 顶部搜商品名或条码，右边按钮可以扫码直接找。
• 下面两个带数字的筛选：待完善、待补初始库存。 这两件事最容易忘，有就显红点。
• 点进某个商品：改名称、规格、单位、售价、进价、条码、整箱设置； 下架 / 重新上架；进货提醒；补全；补初始库存。
• 详情页最下面是这个货最近的出入库——站在货架前想知道 「上次什么时候进的、多少钱」，看这里。网页后台反而没有这一块。
• 右下角新建商品：条码框旁边的图标可以扫码带入，一屏填完。

升级（应用内）

不用再来网页下载了。右上角「⋮」→「关于 / 检查更新」， 有新版本时那个图标上会自己挂一个小红点，进去点「下载并升级」就行。

• 页面上能看到：你现在是第几版、服务器上是第几版、新版改了什么、包多大。
• 下载是真的进度条。下到一半断网会明说没下完，不会装个残包上去。
• 升级不会动手机里已经开的单，也不会清掉商品资料——是升级，不是重装。
• 登录过期也能升。升级检查不依赖登录态——令牌过期的人更需要能升上来。

离线怎么工作

• 断网照样扫码、开单、成交，单据存在手机里。
• 网一通，十几二十秒自己就传上去了，你什么都不用点。
• 队列按开单顺序逐单上传。万一某单被服务器拒绝，它会停在队头标红， 不会跳过去传后面的——顺序错了账就错了。
• 每单带一个唯一标识，双击按钮、超时重试、离线重发都只算一次。
• 退出登录不会删掉没传的单，下次登录接着传。

「今日」页最上面那张卡是这台手机今天开的单，断网也有数看；下面那张是 整店今日，来自服务器，联网才有。两个数分开给，不含糊。

测试总览

按版本分三组。每组十来分钟，照着做就行

第一版 · 网页主链路

在电脑上打开 网页后台，用老板账号。约十分钟

第二版 · 参数与退货盘点作废

电脑网页，老板账号。约十五分钟。第一版验的是「能开门做生意」，这一版验的是出了岔子怎么办

安卓端首版

在手机上测。约十分钟。先去下载安装

出问题怎么反馈

截图就行，不用整理

• 界面上的报错都是白话，直接截图发我。
• APP 装不上或打不开，告诉我手机型号和安卓版本。
• 数据对不上，告诉我哪个商品、你期望多少、实际多少，我从出入库记录倒查。
• 页面点了没反应，说一下哪个按钮、什么浏览器。

演示条码

测试时直接复制

随便编一串没见过的码，就能测「未知码不阻塞收银」。

还没做的

说清边界，免得你测到一半找不到

这一页由 AI 维护，每次交付后同步更新。
设计与开发过程的完整记录在项目文档里，这一页只讲怎么用、怎么测。