集运发货管理系统产品系统Vibe Coding

立项原因： 传统国际集运仓库依赖人工登记包裹、Excel 记账，存在效率低、易出错、数据不互通、无法追溯等问题：包裹入库靠手抄、客户信息散落在表格、打包合箱全凭经验、运费计算靠心算、对账开票耗时费力。为解决这些问题，立项开发本系统，实现仓储集运业务的全程数字化、自动化管理。

行业场景： 本系统应用于国际物流集运仓（跨境电商集货转运）场景。业务背景为：海外客户在国内电商平台购物后，包裹集中发往国内集运仓；仓库需对海量包裹进行入库扫描、称重量方、分类上架、合并打包、分批发货，并向客户收取运费、生成报关发票。系统覆盖“入库→上架→打包→合箱→批次发货→计费开票”完整业务闭环，支持扫码枪/摄像头扫码、测量设备数据自动接入、多设备并发操作，适配仓库多人同时作业的实际环境，可显著提升出入库效率与数据准确性。

本系统是一套面向国际集运/仓储物流业务的管理系统，主要功能模块包括：

1、客户管理：客户档案、编号条码生成、地址库、VIP 等级、发货抬头维护； 2、入库管理：包裹入库扫描（手动/扫码枪/摄像头识别）、批量入库、无主件登记、测量设备数据自动接入； 3、仓储货位管理：货架/货位可视化地图、智能分配货位、一货位一客户规则、快速分配与解除分配； 4、打包管理：多包裹合并打包、普货/敏货分类、拼单拆分、单独打包（VIP）模式、打包暂存恢复； 5、合箱管理：纸箱分组、尺寸自动填充、普敏混装、箱重管理； 6、批次管理：批次锁定解锁、物流状态跟踪、发货确认； 7、面单与标签打印：客户面单、包裹标签、散箱标签批量导出，条码自动生成； 8、运费计费：体积重/实重计费、附加费规则、按客户结算； 9、发票生成：AI 自动填充产品信息、海关编码、多语言发票模板导出； 10、数据导出与审计：发货清单、装货清单、计费表一键导出，全流程操作日志。

系统支持多设备并发访问，覆盖从包裹入库、测量、上架、打包、合箱到批次发货的完整业务闭环。

我负责的具体任务： 独立负责系统的需求分析、架构设计、前后端开发、数据库设计与部署运维全流程，包括：客户/包裹/货位等数据模型设计，入库扫码、打包合箱、批次发货等核心业务逻辑开发，条码与面单标签生成，运费计费与发票导出模块，服务器部署与多设备并发环境搭建，以及日常功能迭代与问题修复。

技术栈与架构： 后端采用 Python Flask + SQLAlchemy 2.0，数据库为 SQLite（启用 WAL 模式支持多设备并发），前端使用 Jinja2 模板 + 原生 JavaScript，集成 Quagga2 摄像头扫码、条码 SVG 生成、AI 接口（DeepSeek）自动填充发票字段；部署采用 Gunicorn + Nginx 反向代理 + systemd 服务，HTTPS 加密传输。

亮点： 摄像头扫码识别、测量设备数据自动接入、AI 自动填充产品英文名与海关编码、货位可视化智能分配、体积重/实重自动计费、四合一数据报表导出。

难点： 多设备并发下 SQLite 写冲突的解决（WAL + busy_timeout + 重试机制）、复杂打包/合箱业务规则的边界处理、第三方设备协议对接、发票模板动态合并单元格生成。