供应链仓储物流系统产品系统

一、立项原因
在农产品/快消品流通领域，传统"纸质单据 + 电话/微信沟通"的协作模式存在三大痛点：

履约过程不可视：从生产厂 → 仓储中心 → 承运商 → 收货方，每个环节的入库、出库、运输节点信息分散在 Excel、微信群和各自独立的 CRM 系统中，核心管理方无法实时掌握货物流转状态，一旦出现超时或异常只能事后追溯，损失已经发生。
单据流转效率低：入库单、出库单、库存盘点单、物流单据依赖线下打印盖章再扫描回传，跨公司协作时一张单据可能要 3-5 天才能走完审批流，且容易出现单货不符、金额不一致等人为差错，对账成本居高不下。
仓储安全监管盲区：传统仓库依赖保安定期巡查，无法做到 24 小时实时监控，货物丢失、火灾隐患、非法入侵等事件发生时往往无法第一时间响应，事后调阅录像也因存储有限容易丢失关键证据。
本项目旨在通过统一的业务中台，打通仓储、物流、合同、监控等业务链路，让核心管理方对供应链全流程做到"看得见、管得住、追得回"。

二、行业场景与业务背景
本项目服务于 中央企业/大型贸易公司主导的供应链协同场景，典型业务形态为：核心公司（甲方）向多家供应商集中采购产品，委托第三方仓储公司提供恒温/常温存储服务，再通过合作物流商配送至全国各经销商或终端客户。
这类场景的典型客户是 国字号农业供应链企业、区域酒类流通平台、大型快消品贸易公司，他们的共同特点是：供应商数量多（数十至上百家）、仓库网点分散（跨省/跨市）、对货权管控和合规性要求高，迫切需要一套能同时服务内部团队和外部合作伙伴的统一协同平台。

# SCM 供应链协同管理平台 — 功能介绍

## 业务协同域

**公司管理**：统一维护核心公司、供应商、承运商、收货方的企业档案，支持调天眼查 API 自动回填工商信息、法人、法律诉讼等数据，辅助准入风险校验。

**合同管理**：覆盖采购/销售合同全生命周期——起草关联产品清单→绑定审批流程→多级审批→安心签电子签章→归档，合同与出入库单自动关联，超期履约触发告警。

**产品管理**：建立统一产品档案库，记录名称、规格、分类、单位、单价等，分类通过动态字典维护，出入库单据下拉选择杜绝手工差错。

**单据模板**：内置入库申请书、出库单、回执单、盘点单等 PDF 模板，支持在线自定义抬头、印章位置、表格字段，LibreOffice 渲染后可一键下载或预览。

**通知中心**：集中承载审批待办、库存预警、设备离线、合同到期、出入库完成等消息，顶部红点提示 + 列表查看。

## 仓储物流域

**仓库管理**：核心方统一管控多仓，每个仓库维护基本信息、所属企业、仓库类型、摄像头绑定、成员授权，支持草稿/启用/停用三态，详情抽屉含七个子 Tab。

**入库管理**：到货→采购员提交入库申请→仓管员扫码收货→系统自动累加库位库存，每张单追溯来源合同、产品批次、运输单号、操作记录。

**出库管理**：销售订单触发出库计划→审批后生成仓单→仓管员拣货复核→装车发运→司机电子签收，出库自动扣减库存，不足时拦截预警。

**库存管理**：多仓多维度实时总览，按仓库/库位/产品分别展示，可用量、在途量、预占量分离显示，支持批次追溯和先进先出，低于安全线自动预警。

**物流跟踪**：承运商派车→司机 APP 接单→GPS 轨迹上报→地图实时查看位置→超时告警，到达后电子回单签收。

**盘点管理**：定期发起盘点→生成清单→实物核对→自动比对账面→生成盘盈盘亏报表→审批后

独立完成
技术栈
Java 老系统（微服务集群）： Spring Boot / MyBatis / MySQL / Redis / Nacos 注册中心 / MinIO 对象存储 / Camunda 流程引擎 / CFCA 安心签 SDK。主业务服务 fsc-api-provide 承载仓储/合同/物流核心逻辑，签章能力拆为独立微服务 signature-platform。
Node 新后端（koa 重写）： Node 18+ / TypeScript / Koa 3 / tsoa 6 装饰器路由 / Prisma 5 ORM / class-validator 0.15 入参校验 / typedi 依赖注入 / node-redis 缓存 / LibreOffice headless PDF 渲染。
前端： Vue 3 / Element Plus / Vite 5 / Pinia 3 / axios。
基础设施： MySQL 8 / Redis / pnpm workspace 单体仓库（后端 + 前端 + 小程序三包）。
架构亮点
分层清晰：后端严格 model（DTO 校验）→ service（业务逻辑）→ controller（路由装饰器）三层，Controller 只做参数校验和响应包装。
Java 签章微服务独立部署：签章能力保留在 Java signature-platform 微服务，Koa 后端只做 HTTP 客户端调用（signatureClient.ts），入参/返回契约完全对齐老系统，enable=false 时自动降级 mock，避免 Node 直接操作 CFCA Java SDK 的技术风险。
业务流程配置化：不依赖 Activiti/Camunda 等重量级流程引擎，自研轻量 FlowTemplate + FlowRecord 模型。