1、立项原因：糖酒快消仓储长期依赖纸质单据与人工记录，出入库靠手写核对，错拣、漏拣、串货频发且难以追溯；仓库面积大、货位密集，需要一台可单手操作的手持终端把作业指令、货位信息和扫码校验前置到现场，同时解决外籍及港台员工的语言使用问题，因此立项建设 LIP-WMS 手持终端作业系统。
2、行业场景与业务背景：面向糖酒批发与快消品仓储配送中心，覆盖收货、上架、拣货、复核、发货、盘点、移库、打包称重等日常作业；终端部署在企业内网，需适配多型号 PDA 扫描枪与蓝牙标签打印机，服务一线仓管员高频连续作业，对响应速度与操作容错要求较高。
1、功能模块：登录鉴权、菜单权限、收货上架、拣货反拣发货、库存盘点与移库、打包称重、扫码作业、蓝牙打印、多语言切换、应用内升级、服务器配置。
2、主要功能描述：① 登录页支持图形验证码与 RSA 公钥加密密码，登录态本地持久化，Token 失效自动清理并跳转登录；② 登录后按服务端下发的菜单树渲染首页「菜单/仓库/我的」三个页签，页面与按钮权限由后端控制并缓存本地，断网可读；③ 作业单据页由服务端元数据（字段、页签、字典、引用）动态渲染，支持字段显隐、只读必填校验、主副单位数量换算联动，业务字段调整无需发版；④ 对接 PDA 硬件扫描枪连续扫描，扫码结果本地留痕，完成收货—上架—拣货—复核—发货全链路作业；⑤ 支持简中/英文/繁中（香港）/繁中（台湾）四语言运行时切换，以及蓝牙标签与单据打印。
1、我负责的具体任务：搭建项目基础框架（网络层、数据层、路由与通用组件）、登录与服务器配置模块、服务端驱动动态表单引擎、扫码作业页面的通用渲染逻辑，以及多语言切换、蓝牙打印接入和应用内升级。
2、技术栈与架构：Kotlin + Jetpack Compose/Material3 + Navigation-Compose，MVVM（ViewModel + StateFlow），Repository 统一封装 Retrofit/OkHttp/Gson，Room + SharedPreferences 本地持久化，Gradle 多模块管理打印 SDK。
3、实现亮点与难点：以密封类统一网络成功/空数据/业务失败/异常四态，用扩展函数收敛 loading、Toast 与异常兜底；解析 dynMeta 生成 FormModel 实现表单动态渲染，复用到 100+ 作业页面；多语言基于应用级 Locale + CompositionLocalProvider 实现不重建 Activity 的即时切换；难点在于弱网与内网自签证书场景下的稳定性兜底、后端字段频繁变更的防御式解析，以及扫码枪连续输入时的表单焦点自动跳转。
评论