POS GO - 顺丰泰国快递员上门揽收系统

POS GO 是顺丰泰国快递员上门揽收系统，服务于顺丰泰国的上门取件业务。系统采用前后端分离架构，前端早期为 Web 手机端，后期平滑升级为安卓 / iOS 客户端；后端基于 .NET Core 8 + SQL Server 构建，全链路 JWT + 刷新令牌认证。系统为快递小哥提供上门揽收、拍照上传、封车、批量装车的移动化作业能力，并依托 Kafka 消息上报与 Hangfire 定时补偿保障大并发作业的可靠性与数据一致性。

作为一线快递员的移动作业入口，POS GO 将揽收全流程搬上手机：扫码 / 输入运单号发起揽收、现场拍照留档、批量装车一次完成，封车后通过 Kafka 实时上报状态，任何一次上传失败都会被记录并由 Hangfire 定时重试，多次失败自动告警，确保每一票快件数据不丢失。

1. 登录与安全认证

基于 JWT + 刷新令牌的前后端分离认证体系，访问令牌短期有效、刷新令牌轮换续期，配合令牌黑名单保障移动端弱网、多设备场景下的安全性与连续性。

2. 上门揽收

快递员现场上门揽收快递，录入运单信息并上传揽收现场图片留档，揽收数据即时落库，为后续封车、装车环节提供完整数据基础。

3. 批量装车（最大 3000 快件）

单次作业支持最大批量 3000 个快件的批量装车。由于第三方接口不支持批量操作，整体提交会导致超时，系统通过分批次、多线程、并发控制等手段提交 3000 个快件的装车操作，整体耗时控制在 3 分钟以内，在满足第三方接口约束的同时保证作业时效。

4. 封车与 Kafka 状态上报

装车完成后执行封车操作，通过 Kafka 消息队列实时上报封车状态，实现业务流与数据流的解耦，支撑上层运营系统对车辆装载状态的实时感知。

5. 失败重试与告警

针对 Kafka 上报等关键环节设计上传失败记录表，由 Hangfire 定时任务定期扫描重试；多次重试仍失败的作业自动触发告警，保障异常可发现、可恢复。

6. 今日汇总与用户信息

快递员可随时查看今日汇总（揽收 / 装车 / 封车统计）与个人用户信息，作业成果一目了然。

总体架构

客户端层
 └─ Web 手机端（早期）→ 安卓 / iOS 客户端（后期演进）
后端服务
 └─ .NET Core 8 Web API（JWT + 刷新令牌认证）
数据与中间件
 └─ SQL Server（业务数据存储，SqlSugar ORM）
 └─ Kafka（封车状态上报，业务流与数据流解耦）
 └─ Hangfire（上传失败重试 + 多次失败告警）

技术选型一览

体验说明

关于 POS GO

本项目为顺丰泰国内部业务系统，出于业务安全考虑，暂不提供网址和账号进行体验。如您对项目感兴趣或有任何建议，欢迎通过博客的联系方式反馈。

其他亮点

• 大批量并发：最大 3000 快件批量装车，分批次 + 多线程 + 并发控制，整体 3 分钟内完成不超时
• 移动端演进：Web 手机端平滑升级为安卓 / iOS 客户端，认证与业务逻辑无缝衔接
• 可靠上报：Kafka 封车状态上报 + 失败记录表 + Hangfire 定期重试，多次失败自动告警
• 安全认证：JWT + 刷新令牌，令牌黑名单保障移动端多设备安全