国际货运代理管理系统产品系统Vibe Coding

业务背景
国际货运代理（货代）是连接进出口企业、承运人、海关、仓储与保险等环节的核心服务业，业务链条长、参与方多、单据繁杂。本项目（ir-server）定位为一套面向货代企业的「业务运营中台」，以「货代委托单（ForwardOrder）」为主线，覆盖委托受理、装箱/服务项拆解、调度派车、费用账单、审批管控到结算计提的完整作业闭环，并逐步补齐报关、订舱、出货与 AI 船舶追踪等能力。项目采用 B2B2C 多租户 SaaS 架构，支持多公司隔离与权限套餐，底层基于若依（RuoYi）框架扩展，并内置代码生成器以支撑快速交付。
行业场景
系统服务于中小货代企业的日常运营：业务员受理客户委托并拆解为具体服务项；调度人员安排拖车、订舱与仓储；财务人员按服务项与客户、服务商对账计费；报关人员基于委托/出货单编制报关草单、正式单并推送单一窗口；管理层通过统一后台监控在途订单、费用与风险。多公司 SaaS 形态还使同一平台可服务集团内多家独立法人或外部签约客户。
立项原因
传统货代企业普遍依赖 Excel、邮件与纸质单证作业，存在数据孤岛、版本混乱、跨环节无法追溯等痛点；而国际贸易合规要求日趋严格，报关作为刚需且高风险环节，缺乏标准化、可审计、可验收的系统支撑将直接带来监管与经营风险。立项旨在构建一套可快速搭建、自带多租户权限与代码生成能力的行业运营中台，将分散的作业流程线上化、结构化、可追溯。
旨在解决的产品问题
1. 流程线上化缺失：以委托单为主线的端到端作业闭环，替代人工流转，消除信息断点。
2. 报关能力缺位与不可控：现有报关模块代码已实现草单/正式单/单一窗口/报价，但缺产品定义与验收标准，需产品化形成可测、可审的闭环。
3. 合规风险高：通过报关合规 AI 校验（监管条件、两用物项、危化品、CITES 等）复用贸易合规资产，形成差异化竞争力与风险防线。

系统采用 B2B2C 多租户 SaaS 架构，以货代委托单为主线，提供从委托受理到结算计提的端到端作业能力，并覆盖报关、订舱、出货与 AI 追踪。功能分为五层：
一、多租户与权限底座
- 公司管理：配置多公司主体，实现 SaaS 租户隔离。
- 权限套餐：按公司定制菜单、操作与按钮级权限。
- 用户/部门/角色/菜单/字典：标准 RBAC，支持树形组织与数据范围权限。
- 日志与运维：操作日志、登录日志、在线用户、服务监控、缓存监控。
二、核心业务运营（九大模块）
- 委托管理：以委托单为主线受理客户委托并拆解为服务项。
- 调度管理：拖车、订舱、仓储等作业调度与在途跟踪。
- 费用与账单：按服务项与客户、服务商对账计费并结算计提。
- 报价管理：客户与供应商报价。
- 审批管理：费用与单据审批流管控。
- 消息通知：业务事件驱动提醒。
三、报关管理（国际贸易核心）
- 草单/正式单：由委托或出货单派生，录入 HS 编码、品名、数量、单价、贸易国别等要素，支持要素缓存校验。
- 单一窗口申报：推送正式单并回写申报状态与海关编号。
- 报关报价与费用关联。
- 报关合规 AI 校验：依据监管条件、两用物项、危化品、CITES 等清单自动校验，形成风险防线。
- 状态联动：报关状态（草单/申报/放行/异常/结关）回写委托单与总部订单，触发费用计提。
四、基础数据与系统支撑
- 客户/服务商档案与基础数据维护。
- 代码生成器：按表自动生成前后端 CRUD 代码并下载。
- 系统接口：自动生成 Swagger/Knife4j 文档。
- 状态轨迹引擎：统一记录订单状态流转与备注。

一、技术栈
后端以 Java 17 + SpringBoot 2.5.4 为核心，安全用 SpringSecurity + JWT，数据层 MyBatis-Plus 3.5.1 + MySQL + Redis 缓存，分页 pagehelper，工具 hutool/fastjson2；代码生成基于 MyBatis-Plus Generator + Velocity；API 文档 knife4j；导入导出 easyexcel/easypoi，PDF 用 pdfbox；对象存储腾讯云 COS/cos-sts 与七牛 SDK；系统监控 oshi。前端基线 Vue 2.6 + ElementUI + vuex + avue，新方向 Vue3 + Element Plus。工程为多模块 Maven（ir-common / ir-generator / ir-modules-server），基于若依前后端分离版。
二、系统架构
采用 B2B2C 多租户 SaaS 分层架构：通用层 ir-common（注解/组件/配置/常量/工具/统一返回与分页）；代码生成层 ir-generator（按表元数据产出前后端 CRUD）；业务层 ir-modules-server（modules 组织业务，common 内集成 MyBatis-Plus、Security、Token、切面与异步任务）。鉴权走 SpringSecurity+JWT，持久化 MySQL + Redis 缓存，knife4j 自动出 API 文档。
三、实现亮点
1. 代码生成器：按表一键生成前后端 CRUD 并下载，大幅降低重复开发。
2. 多租户权限套餐：按公司定制菜单/操作/按钮级权限，支撑 SaaS 多主体隔离。
3. 状态轨迹引擎：pub_status / pub_status_log / pub_order_remar