POS Hub - 顺丰泰国驿站收件系统

POS Hub 是顺丰泰国驿站收件系统，面向便利店 / 门店等终端派件场景，为扩展顺丰泰国的末端派件能力而构建。快递小哥将快件送到门店交接，门店核准接收后即可等待客户到店取件；客户凭短信运单号即可完成出库取件，快件超时未处理则自动提示退回小哥，过程中如涉及费用则通过二维码支付完成收款。

系统采用前后端分离架构，前端基于 Vue 主流框架构建，后端基于 .NET Core 8 构建，业务数据库使用 SQL Server，日志库使用 MongoDB，通过 SqlSugar ORM 访问数据，全链路 JWT + 刷新令牌认证。项目一期已建设完成，二期扩展能力规划开发中。

1. 首页工作台

首页作为门店店员的工作台，集中展示今日待取 / 已出库 / 超时快件等关键信息与各功能入口，让店员快速掌握门店收件与取件状态。

2. 登录与安全认证

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

3. 小哥到店交接（交接码）

快递小哥到店交接快件，系统生成 交接码 用于核对接交信息，门店店员扫码 / 输入交接码即可查看交接快件明细，完成小哥与门店间的快件交接。

4. 门店入库（核准接收）

门店核对交接快件信息后执行入库（核准接收），快件进入「待取件」状态，等待客户到店取件。

5. 客户取件出库

客户到店取件时提供短信运单号，店员录入运单号后系统自动校验快件信息并完成出库。

6. 确认出库

出库环节提供确认出库二次确认，校验运单号与客户信息无误后正式完成出库操作，确保快件去向准确可追溯。

7. 超时退回小哥

快件在门店超过约定时限仍未处理时，系统自动标识超时快件，门店可一键退回小哥，快件重新进入派送流转，保障快件时效。

8. 二维码支付

取件或退回环节涉及费用时，通过 二维码支付 完成收款，支付结果即时回调系统更新快件状态，全程可追踪。

9. 今日 / 每日盘点

提供今日盘点与每日盘点能力，按日统计入库 / 出库 / 退回等作业明细，帮助门店与运营核对快件账实一致。

10. 数据初始化同步

项目内置数据初始化同步机制：回调接口接收第三方系统的推送通知后，读取第三方数据 URL，通过流式读取文件（防止内存膨胀）分批次入库，并按数据主键执行新增或更新，保证数据不重复且始终保存最新状态。

总体架构

客户端层
 └─ Vue 前端（门店店员作业界面）
后端服务
 └─ .NET Core 8 Web API（JWT + 刷新令牌认证）
数据与中间件
 └─ SQL Server（业务数据存储，SqlSugar ORM）
 └─ MongoDB（日志库）
 └─ Kafka（全量操作上报）
 └─ Hangfire（失败重试 + 告警提醒）

技术选型一览

体验说明

关于 POS Hub

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

其他亮点

• 可靠上报：全量操作 Kafka 上报，失败默认重试 3 次，进入失败列表，Hangfire 定时重试，依旧失败自动告警并人工处理
• 流式同步：回调接口接收第三方推送，流式读取数据文件分批次入库，按主键新增或更新，防内存膨胀且数据不重复
• 核心自研：负责整个项目的框架搭建、支付系统、出库入库等核心功能开发
• 安全认证：JWT + 刷新令牌，令牌黑名单保障门店多设备场景安全