Product · Architecture · Delivery

小型货代 ERP
开发 Brief

面向 5–30 人货代团队的产品边界、核心数据模型、架构范式与工时估算。目标不是做一个“缩小版传统 ERP”，而是构建一个单票业务真正闭环的轻量运营系统。

Recommended shape

Job-centric FMS / TMS + Basic WMS + Operational Subledger

Deployment 内部桌面 Web 一个会计主体，少量分公司

Boundary 业务系统 ≠ 法定会计 税务、总账与报关优先集成

1,250–1,850h P1 内部精简 MVP

3–5个月典型交付周期

2名建议核心开发人数

10–20% AI 净效率改善规划值

01 / 09

产品定义

行业价值来自“业务数据只录一次，并被操作、单证、仓储和财务持续复用”，而不是堆叠模块。

Product thesis

轻量 FMS / TMS + 基础 WMS + 运营财务子账

第一版围绕报价、委托、运输节点、单证、仓储、费用、应收应付与单票利润形成完整主链路。系统必须能回答：这一票业务进行到哪里、预计赚多少钱、哪些客户没付款、哪些供应商没结算、仓库里还剩什么。

完整总账、税务申报、数电发票、监管报关、人力资源和复杂采购不应成为首版自研目标。

02 / 09

首版边界

按交付层级查看范围。P1 是建议启动范围；P2 增加生产级治理；P3 才进入门户、OCR 与外部深度集成。

客商与基础资料

客户、供应商、承运人、代理、联系人、地点、港口、机场、币种、汇率与业务类型。

首版

货代操作核心

Job、运输方式、进出口方向、主分单、运输段、集装箱、件毛体、计划与实际日期。

首版

节点与任务

可配置节点模板、负责人、计划 / 预计 / 实际时间、逾期提醒与异常备注。

首版

单证与附件

报价单、委托确认、入出仓单、账单、费用确认单、附件版本与归档。

首版

运营财务

收入成本、预估费用、应收应付、账单、发票登记、收付款核销、账龄和单票利润。

首版

基础仓储

收货、上架、库位、库存单位、移库、盘点、出库、库存流水与条码打印。

首版

报价与运价

简单运价表、成本价与销售价、报价版本、报价转 Job 与业务价格快照。

生产级治理

完整审批、审计、安全、异常恢复、监控、自动化测试、数据迁移与灾备演练。

客户门户

客户查询业务进度、下载单证、查看账单与提交资料，形成外部协同界面。

移动仓储与 OCR

扫码、拍照、弱网处理，以及账单、提单、运价表的结构化识别与人工复核。

承运人与轨迹接口

在内部数据模型稳定后，按业务价值接入船司、航司、港口与轨迹供应商。

三类能力优先集成，而不是首版自研

法定会计总账与税务、监管报关申报、大规模外部承运人接口。内部 ERP 保留业务来源、单号、币种、核销和回执关系，形成可审计的衔接层。

03 / 09

核心业务模型

避免把委托、运输、箱货、仓储、费用和发票全部塞进一张“大订单表”。界面可以简单，底层模型必须可扩展。

商业责任、实际运输与结算对象分层 Quote → Job → Shipment → Leg / Event / Charge

Quote · 报价

保存报价版本、有效期、价格组成与接受状态；转单时生成业务价格快照。

Job · 一票业务

商业、责任与利润核算的核心对象。关联客户、负责人、业务类型、状态、时间和全部下游对象。

Shipment / Consignment · 实际运输组织

支持一票业务包含多个运输对象、多个段落或分批出运。

Transport Leg
运输段

Equipment
集装箱 / 设备

Cargo Unit
件 / 托 / 批次

Milestone

计划、预计、实际时间与事件来源。

Document

单证版本、签发、哈希、撤销与归档。

Charge

收入 / 成本、币种、汇率、状态与归属。

Warehouse

收发、移库、盘点与不可直接篡改的库存流水。

04 / 09

技术与架构范式

以稳定、可审计和低运维复杂度为先。先划清领域边界，再决定是否拆分服务。

A01

领域化模块单体

Identity、Master Data、Quotation、Operations、Documents、Finance Subledger、Warehouse、Reporting、Integration 在代码中清晰隔离，但第一阶段保持单一部署和单一 PostgreSQL。

MODULAR MONOLITH
NOT MICROservices-first

A02

状态表 + 关键流水不可变

普通对象保存当前状态；运输事件、库存变动、费用审批、核销和关键操作保存追加式流水。修正通过冲销、撤销或新版本完成。

AUDITABLE
APPEND-ORIENTED

A03

RBAC 加数据范围与字段权限

权限不仅控制页面，还要控制本人 / 部门 / 分公司 / 全公司数据范围，以及成本、利润、银行信息等敏感字段。所有校验必须发生在服务端。

ROLE + SCOPE
SERVER-SIDE

A04

API-first，但不网络化一切

业务能力通过稳定服务接口暴露，为门户、移动端和外部集成预留复用路径；同一部署单元内无需为了形式而强制走网络调用。

IDEMPOTENCY
RAW PAYLOAD RETENTION

A05

预留行业标准映射

海运事件与对象向 DCSA 靠拢；空运预留 MAWB、HAWB、Piece 与 ONE Record 映射；电子单证保留 ID、版本、签发、哈希和撤销状态。

DCSA · IATA
FIATA · GS1

05 / 09

工时拆解

人时包含产品、设计、开发、测试、部署和上线支持。通过交付层级切换查看总体规模与工作包分布。

P1 · 内部精简 MVP

1,250–1,850 人时

Job、节点、附件、费用、应收应付、单票利润、基础仓储、权限与导出，可进入内部试运行。

典型周期3–5 个月

核心开发2 人

产品 / 业务0.3–0.5 FTE

QA 测试0.3–0.5 FTE

工时不能简单按开发人数线性压缩；需求确认、UAT、迁移和上线存在天然串行环节。外部接口需在取得正式文档、测试环境和认证流程后单独评估。

06 / 09

实施路线

采用纵向切片：先让一票业务从创建到关闭完整跑通，再扩展更多业务类型与自动化能力。

Phase 0

业务蓝图

抽取 10–20 票代表性案例，梳理现有表格、单证、费用与收付款，形成术语表、状态模型、字段字典、权限矩阵和端到端验收场景。

2 周约 80–120 人时

Phase 1

平台基础与主数据

完成组织、账号、角色、审批、日志、客户供应商、地点、币种、费用代码和附件，并打通第一条纵向 Job 流程。

基础设施可持续迭代

Phase 2

操作与单证

实现 Job、Shipment、运输段、箱货、节点、任务与核心单证，优先覆盖最常见的两至四类业务流程。

第一闭环可进行业务试跑

Phase 3

运营财务与仓储

形成费用 → 审核 → 账单 → 收付款 → 核销 → 账龄，以及收货 → 库存流水 → 出库 → 剩余库存的两条完整闭环。

经营闭环财务与仓库逐笔核对

Phase 4

迁移、UAT 与渐进上线

首轮只迁移主数据、在途 Job、未结应收应付和当前库存。选择一个业务组并行运行，再逐步扩大使用范围。

2–4 周并行与对账

07 / 09

AI 辅助开发范式

这个项目适合大量使用 AI 编程工具，但不适合“能跑就上线”的纯 Vibe Coding。

Operating model

Spec-first.
Test-backed.
Agent-assisted.

先定义不变量

状态转换、核销规则、汇率口径、库存约束、权限边界和回滚方式先于代码。

AI 加速执行

适合 CRUD、查询、导入导出、页面组件、单证模板、测试脚手架和开发文档。

人承担责任

财务规则、数据迁移、权限、安全、灾备和生产发布必须由有经验人员审查与签字。

表单、CRUD、查询、Excel

AI 适配高

模式稳定、反馈快、容易通过自动化测试和样例数据验证。

工作流、状态与报价规则

AI 适配中

代码可以生成，但业务人员必须确认允许的状态变化、例外和版本语义。

多币种、核销、利润与库存

高审查

错误可能长期污染经营数据；应使用明确的领域函数、数据库约束和逐笔对账测试。

生产发布、安全与恢复

人工负责

AI 可辅助检查，但不能替代生产权限、备份恢复演练、变更审批和事故责任。

08 / 09

自研、采购或混合

自研并不会天然形成竞争优势。差异化核心值得自研，强合规与通用基础设施应优先采购或集成。

Buy

采购成熟 SaaS

适合流程高度标准、人员少、没有特殊计费 / 分润 / 集成需求的团队。上线快，运维和合规责任较低。

主要代价：流程适配与长期订阅成本。

Recommended · Hybrid

差异化自研 + 成熟能力集成

自研 Job、节点、仓储、运营费用和单票利润；集成正式会计、数电发票、报关、邮件短信与对象存储。

适合：希望保留业务独特性，同时控制合规与维护风险。

Build

完整自研

只有当系统将成为业务模式的一部分，或现有产品与独特结算、协同和客户平台严重不匹配时才合理。

主要代价：长期产品、工程、安全和合规投入。

09 / 09

参考来源

产品范围与范式综合参考货代软件、行业数据标准、中国会计与数据合规规范，以及安全和工程实践。

Magaya货代、仓储、追踪与会计的一体化产品结构

DCSA Booking & Track and Trace海运订舱、事件与统一数据模型

DCSA Developer PortalBooking、Schedules、eBL、VGM 等实施资源

IATA ONE Record空运共同数据模型与安全 Web API

FIATA Digital Bill of Lading数字单证身份、完整性与审计轨迹

GS1 Logistic Label物流单元、地点与条码标识基础

Microsoft · DDD & Microservices领域边界、独立部署与组织成熟度评估

OWASP Top 10服务端访问控制、日志与审计原则

中华人民共和国财政部会计信息化工作规范与会计软件基本功能规范

国家互联网信息办公室网络数据安全管理条例与数据安全要求

METRAI 编程工具对资深开发者效率影响的实验研究