本案例依据真实项目实施资料整理，客户名称、业务细节及部分经营数据已做脱敏处理。指标采用正式上线3个月后的脱敏统计口径，结果受门店类型、客流和运营规则影响，不构成对其他项目效果的承诺。了解案例证据分级
项目职责与事实边界
知华职责：完成门店调研、终端交互、Local-First交易架构、服务端能力、硬件适配、数据同步、试点发布和运维交接。
客户职责：确认商品、促销、会员和退换货规则，提供门店试点环境、设备与支付渠道授权，并组织收银员参与实店验证。
能力边界：现金可按离线流程处理；在线支付仍受网络和支付通道状态约束，系统不承诺断网状态下完成在线扣款。
披露边界：客户品牌、合同金额、门店地址、交易明细、支付参数和生产环境信息不公开；页面只展示脱敏后的架构、过程和汇总指标。
项目背景与核心挑战
客户是一家拥有约 120 家门店的连锁便利店品牌。原有 Windows 收银软件虽然具备基础功能，但设备投入高、启动与维护成本大，断网后无法完成基本收银；会员权益和促销规则依赖收银员记忆，总部经营数据也只能在每日收班后汇总。
客户希望在控制硬件成本的同时，让门店在网络波动时仍可持续营业，并把收银、会员、促销、库存和经营分析整合为统一体系。项目采用 Android 平板作为主要终端，但最终目标并不是简单“换设备”，而是重构门店交易与总部协同方式。
先进入门店，再确定系统边界
需求阶段连续两周在门店跟班，完整观察早班开店、午间高峰、交接班、退换货、日结与设备异常处理，避免只根据管理层描述设计操作流程。
| 业务环节 | 一线真实需求 | 系统设计重点 |
|---|---|---|
| 高峰收银 | 操作步骤少、扫码反馈快 | 常用商品快捷入口、键盘与扫码兼容 |
| 会员与促销 | 不依赖收银员记忆复杂规则 | 会员识别、优惠叠加与规则自动计算 |
| 网络异常 | 断网时仍能完成核心营业动作 | 本地商品、库存与交易队列 |
| 设备接入 | 不同门店设备能够稳定工作 | 扫码枪、打印机、钱箱的适配层 |
| 总部管理 | 及时掌握销售、库存与异常 | 增量同步、经营看板与异常追踪 |
业务功能与技术架构
Kotlin 原生 Android 应用，采用 MVVM 与 Repository 分层，Jetpack Compose 构建适合触控终端的中文收银界面。
Room / SQLite 保存商品、促销规则、会员必要信息、交易单据和待同步任务，支持门店网络异常时继续处理核心业务。
Go + Gin 承载交易、商品、库存和同步服务，PostgreSQL 按门店组织业务数据，Redis 缓存高频规则和状态。
统一维护商品、价格、促销和门店配置，汇总销售与库存数据，支持经营分析、异常监控和多门店权限管理。
Local-First：离线不是缓存一个页面
基础数据本地化：商品、价格及有效促销规则按版本同步到门店，网络不可用时仍能完成查价、扫码和规则计算。
交易本地落单：订单先写入本地数据库和待同步队列，再异步上传服务端，避免网络抖动阻塞收银动作。
幂等与冲突处理：每笔订单使用全局唯一编号，服务端按订单号保证幂等，并对库存、撤单与重复提交建立明确规则。
状态可见：终端持续展示网络、同步进度与待上传任务，异常进入人工可处理队列，而不是静默丢失。
现金可按离线流程处理；微信、支付宝等在线支付仍依赖支付通道与网络状态。系统通过状态校验、重试和人工应急流程避免重复扣款，不把“断网后自动扣款”作为默认承诺。
落地过程中解决的关键问题
扫码识别速度：相机扫码适合作为备用方案，高峰门店仍优先适配硬件扫码枪，并统一条码输入事件，降低设备差异对业务代码的影响。
促销计算性能：将门店有效规则预加载到本地，在后台线程执行匹配与重算，减少复杂叠加规则对收银界面的阻塞。
蓝牙打印稳定性：建立设备能力检测、断线重连、打印队列和补打机制，并对主流机型进行实店测试，而不是只依赖模拟环境。
操作习惯迁移：保留收银员熟悉的商品搜索、快捷键和结算顺序，用培训门店的反馈逐步调整交互，降低系统切换成本。
分阶段上线与运营保障
上线后的业务变化
正式上线 3 个月后的脱敏统计口径，数据受门店类型、客流和运营规则影响。
| 指标 | 上线前 | 上线后第 3 个月 |
|---|---|---|
| 平均单笔收银时间 | 约 28 秒 | 约 18 秒 |
| 网络异常下核心收银 | 不可用 | 离线流程可用 |
| 单店硬件投入 | 约 5,500 元 | 约 2,800 元 |
| 促销规则下发生效 | 约半天 | 约 5 分钟 |
| 经营数据时效 | T+1 汇总 | 正常网络下小于 5 秒 |
| 新员工上手时间 | 3 至 5 天 | 约 1 天 |
统计口径与可核验材料
页面指标为正式上线3个月后的脱敏汇总，比较基线来自原系统和试点门店记录；门店类型、客流、设备型号与运营规则会影响结果。经客户授权或签署保密协议后，可在不披露交易隐私和商业秘密的前提下核验以下材料。