项目概览
AllinWebPOS 是面向多行业、多门店、多终端的 Web POS 演示系统，当前演示环境已导入多店型数据并启用 HTTPS。
适用场景
销售演示
使用店型账号快速切换到餐饮、零售、批发、连锁等场景，按本手册的演示路径完成客户讲解。
试用培训
客户可按流程体验登录、开单、加料、支付、厨房、库存、会员和报表，不需要先准备真实业务数据。
实施验收
实施人员可按验收清单检查账号、路由、接口、店型数据、H5 点单和 SSL 部署是否完整。
产品介绍
AllinWebPOS 将门店 POS、后台经营、会员营销、库存供应链和顾客自助点单合成一套可演示、可部署、可扩展的经营系统。
一套系统覆盖门店交易全链路
面向中国、港澳台和欧美门店，支持多语言、多币种、多店型数据和多终端交易。销售可以用同一套环境演示快餐、正餐、茶饮、生鲜、便利、服饰、批发与连锁场景。
移动收银与桌面收银并行手机端适合走动开单，桌面端适合固定 POS 与高峰收银。
多行业商品与库存模型覆盖 SKU、加料、称重、批次、仓库、供应商和盘点。
顾客自助点单渠道H5 与小程序共用公开 API，可与 POS 订单、厨房和报表连通。
快速开始
5 分钟完成一轮标准演示，适合首次给客户展示系统能力。
- 打开后台登录页 访问 https://demo.allinwebpos.com/login，在右侧演示账号区选择店型卡片。
- 切换店型与区域设置 点击 `快餐茶饮`、`正餐酒楼`、`服饰零售` 等卡片后，系统会自动填入租户编码、账号、密码，并切换语言和币种。
- 进入收银台开单 登录后默认进入收银台。选择分类、商品和加料，检查购物车、折扣、会员、挂单、支付按钮。
- 查看后台管理 进入后台菜单，依次查看商品、订单、库存、会员、促销、报表、打印机和系统配置。
- 体验 H5 点单 打开 H5 点单页，添加商品到购物车并提交订单。
演示账号
所有演示账号密码统一为 admin123。平台管理员仍可使用 admin / admin123。
| 租户编码 | 店型 | 账号 | 语言 / 币种 | 推荐演示重点 |
|---|---|---|---|---|
DEMO_QSR | 快餐茶饮 | qsr_owner | 简体中文 / CNY | 快速收银、套餐、加料、H5 扫码点单 |
DEMO_TABLE | 正餐酒楼 | tbl_owner | 繁体中文 / HKD | 桌位、厨房单、多人堂食、组合支付 |
DEMO_TEA | 茶饮烘焙 | tea_owner | 繁体中文 / TWD | 规格、温度、甜度、加料、礼盒 |
DEMO_FRESH | 生鲜称重 | frs_owner | 简体中文 / CNY | 称重商品、批次、库存预警 |
DEMO_CSTORE | 便利零售 | cvs_owner | 简体中文 / CNY | 条码商品、日用零售、促销券 |
DEMO_FASHION | 服饰零售 | fsn_owner | English / USD | SKU、尺码、区域货币、零售库存 |
DEMO_WHOLESALE | 批发配送 | whs_owner | English / EUR | 批发报价、仓配、供应商 |
DEMO_CHAIN | 连锁多店 | chn_owner | 简体中文 / CNY | 多门店、区域、渠道菜单发布 |
推荐演示路径
根据不同客户类型选择不同演示脚本，避免一次性展示过多菜单。
餐饮客户 15 分钟脚本
- 登录 `DEMO_QSR`展示演示账号卡片、语言币种切换、租户隔离。
- 收银台点单选主食、饮品、加料，说明购物车和加料 grid 布局。
- 支付与厨房创建订单后切到厨房视图，说明出餐状态和催单。
- H5 扫码点单打开 H5 点单入口，客户自行加购和提交订单。
零售客户 15 分钟脚本
- 登录 `DEMO_CSTORE` 或 `DEMO_FASHION`强调 SKU、条码、尺码和多币种。
- 商品与库存查看商品、分类、库存查询、仓库和供应商。
- 会员与营销查看会员等级、标签、促销和优惠券模板。
- 报表分析展示营业额、热销商品、会员分析、库存预警。
连锁客户 20 分钟脚本
- 登录 `DEMO_CHAIN`展示总店和分店、多门店数据隔离。
- 总部商品与渠道菜单说明统一商品、渠道菜单发布、H5/小程序共用配置。
- 库存与仓配查看仓库、调拨、采购、盘点和批次。
- 权限与审计展示用户角色、敏感授权、审计日志。
批发客户 20 分钟脚本
- 登录 `DEMO_WHOLESALE`展示 EUR 币种和英文区域配置。
- 批发管理查看批发客户、批发订单、收款和利润。
- 供应链查看供应商、采购单、仓库和库存流水。
- 财务报表展示收支汇总和经营看板。
收银台操作手册
收银台是演示的第一屏，适合展示高频操作效率和不同店型的商品结构。
标准开单步骤
- 选择商品分类左侧或顶部分类用于快速过滤商品。餐饮类可展示主食、饮品、加料、套餐；零售类可展示条码和 SKU。
- 添加商品到购物车点击商品卡片后进入购物车。重复点击会增加数量，购物车每一行保留独立加料和备注。
- 选择加料与规格餐饮和茶饮店型会出现加料面板，使用 grid 布局承载甜度、温度、配料、套餐等选项。
- 应用会员或优惠选择会员、优惠券、促销后，购物车金额和应付金额实时刷新。
- 完成支付支持现金、银行卡、微信、支付宝、会员余额等方式。演示环境可使用模拟支付完成闭环。
讲解重点
低延迟点击
购物车行使用稳定 ID，商品加料使用 Map 读取，减少重复计算带来的卡顿。
多终端适配
同一业务支持 PC、手机、平板路由，移动端更适合店员走动收银。
离线兜底
离线订单可进入同步队列，网络恢复后补传，适合网络不稳定门店。
后台功能说明
后台按经营域组织菜单，覆盖营业、商品、库存、会员营销、运营和系统设置。
| 功能域 | 菜单 | 说明 | 演示建议 |
|---|---|---|---|
| 概览 | 数据概览 | 展示销售、订单、会员、热销商品、趋势。 | 登录后先看经营状态。 |
| 营业管理 | 订单、支付单、退款单、离线同步、报表、财务 | 覆盖订单生命周期、收款退款、对账和经营分析。 | 用历史订单说明 POS、H5、小程序多来源。 |
| 商品管理 | 商品、分类、加料、属性 | 维护商品资料、SKU、规格、加料、组合商品。 | 茶饮/餐饮演示加料，服饰演示尺码 SKU。 |
| 库存管理 | 库存、仓库、供应商、采购、盘点 | 支持库存查询、预警、批次、采购入库和盘点。 | 生鲜和批发客户重点展示。 |
| 会员营销 | 会员、标签、促销、优惠券 | 支持会员等级、积分、储值、标签分群和营销券。 | 便利店和连锁客户重点展示。 |
| 运营管理 | 员工、门店、排队、批发 | 处理门店、员工、叫号和批发业务。 | 正餐演示排队，批发展示批发订单。 |
| 系统设置 | 用户、菜单、门店配置、区域配置、行业配置、插件、敏感授权、打印机、对接、租户、审计 | 覆盖权限、行业模板、区域币种、插件扩展和审计。 | 面向老板或 IT 管理员说明可管可控。 |
H5 与小程序点单
H5 与小程序共用公开 customer API、渠道菜单发布和桌码 token 模型。
桌码 token 规则
{tenantCode}-{tableNo}
示例:
/customer/table/DEMO_QSR-A01
/customer/table/DEMO_TABLE-B01
/mini/table/DEMO_QSR-A01公开 API
| 接口 | 用途 | 示例 |
|---|---|---|
GET /api/v1/customer/stores/{storeCode} | 获取公开店铺信息 | DEMO_QSR |
GET /api/v1/customer/menu | 获取 H5/小程序菜单 | storeCode=DEMO_QSR |
POST /api/v1/customer/orders/preview | 预览订单金额 | 购物车金额试算 |
POST /api/v1/customer/orders | 创建顾客订单 | 提交后进入订单管理 |
店型与行业能力
演示数据覆盖不同地区、语言、币种与经营模式，方便对标银豹 POS 和海外同类产品。
快餐茶饮
快速点单、加料、套餐、取餐号、H5 自助下单。
DEMO_QSR正餐酒楼
桌位、区域、厨房单、堂食人数、排队叫号。
DEMO_TABLE茶饮烘焙
规格、温度、甜度、加料、礼盒、会员复购。
DEMO_TEA生鲜称重
称重、批次、保质期、库存预警、采购入库。
DEMO_FRESH便利零售
条码、促销、优惠券、会员积分、日结报表。
DEMO_CSTORE服饰零售
颜色尺码 SKU、美元币种、零售库存。
DEMO_FASHION批发配送
批发客户、供应商、采购、仓库、利润分析。
DEMO_WHOLESALE连锁多店
多门店、总部视角、渠道菜单、租户隔离。
DEMO_CHAIN设备与终端适配
演示环境按真实门店终端来组织界面：PC 后台、POS 收银、平板厨房、手机 H5/小程序，以及打印、扫码、称重等外设。
PC / POS 大屏
后台表格、收银商品网格和购物车采用稳定列宽，适合横屏收银机和桌面浏览器。
手机 H5 / 小程序
页面控制最大宽度、安全区、底部购物车和横向分类，避免刘海屏与浏览器工具栏造成偏移。
门店外设
打印机、厨打、扫码枪、称重设备按接口模块预留，文档演示中可结合小票和厨房流程说明。
核心业务流程
下面是用于实施培训和产品验收的流程说明。
开店配置流程
餐饮堂食流程
零售库存流程
会员营销流程
验收清单
用于确认演示环境、文档站和业务功能是否可交付。
环境验收
- HTTPS 域名可访问，HTTP 自动跳转 HTTPS。
- 后台登录页可打开，演示账号可登录。
- H5、小程序演示页可打开并加载菜单。
- API 域名返回公开店铺 JSON。
- 7 个后端服务保持运行。
功能验收
- 收银台可添加商品、加料、预览和支付。
- 订单管理可查看 POS、H5、小程序来源订单。
- 商品、分类、SKU、加料数据完整。
- 库存、仓库、供应商、采购和盘点可查询。
- 会员、促销、优惠券、报表可展示演示数据。
自动化测试
npm run smoke
npm run test:features常见问题
演示、培训和部署过程中最常见的问题处理。
登录失败怎么办？
确认租户编码、账号和密码同时匹配。例如 `DEMO_QSR / qsr_owner / admin123`。平台管理员使用 `admin / admin123`，租户编码可留空。
H5 页面没有商品？
优先检查 `storeCode` 是否为演示租户编码或总店编码，例如 `DEMO_QSR` 或 `QSR-HQ`。再检查公开 API 是否返回菜单数据。
出现 404 怎么办？
前端路由应由 Nginx 回退到 `index.html`。若部署到新域名，需要确认 `try_files $uri $uri/ /index.html` 已配置。
证书续期失败怎么办？
确认 `/.well-known/acme-challenge/` 可通过 HTTP 访问，且证书续期后执行 `nginx -s reload`。