README

moonbit-rulesorigin

A typed MoonBit rules-of-origin and supply-chain accumulation engine.

rules-of-origin

supply-chain

trade-compliance

bom

Download zip

Author

hjuuhj

Version

0.1.3

License

Apache-2.0

Repository

github.com/hjuuhj/moonbit-rulesorigin

Last updated

2 months ago

Downloads

No dependencies

#moonbit-rulesorigin

MoonBit 原产地与供应链累积判定引擎。它把商品、材料、供应商声明、加工步骤、产品编码和证据链组织成可复盘的 BOM 判定输入，并输出 Qualified、NotQualified 或 InsufficientInformation 三态结果。

项目提供离线、确定性的类型化库和 JSON/JSONL CLI，适合贸易合规、采购协同和供应链分析应用。核心判定不依赖网络、OCR、数据库或商业平台，调用方可以在批处理、服务端和 WASM 环境中复用。

#What it covers

多层 BOM 图：节点、边、数量、金额、拓扑校验和环检测。
原产地事实：完全获得、原产/非原产/未知状态、供应商区域与声明引用。
税则改变：CTC、CTH、CTS 的 2/4/6 位级别比较和例外位。
区域价值成分：以整数基点表示百分比，避免浮点边界误差。
加工规则：必需工序、指定区域和最小加工禁止工序。
累积：无累积、双边累积、区域累积和跨境加工模式。
规则版本基础字段：协定编号、版本、生效日期、成员区域。
证据链：每个材料返回状态、主体和说明，缺失事实单独列出。
结构化 JSON 输入与 JSONL 批处理输出。
声明生命周期：有效期、证据覆盖、置信度和供应商冲突诊断。
协定目录：规则版本、生效日期、成员区域和版本差异比较。
采购分析：候选材料替代、区域约束、RVC 重新计算和敏感性排序。
审计报告：规则级条目、证据引用、缺失动作和稳定文本报告。
固定 benchmark：多层 BOM、RVC 临界值、声明冲突和采购候选数据集。

CLI 参数、退出码和 shell 适配说明见 docs/api/cli-contract.md。固定数据集和操作计数说明见 docs/benchmarks/verification-fixtures.md。

#Quick start

需要最新版 MoonBit 工具链。CI 会打印实际安装的版本；当前验证使用 moon 0.1.20260819 / moonc v0.10.9+6e6c44045，其他环境应以各自的 CI 输出为准。

moon check --target all --deny-warn
moon test --target all --deny-warn
moon fmt --check
moon info
./scripts/normalize_generated_interfaces.ps1
git diff --check

运行仓库内置的端到端示例：

moon run cmd/rulesorigin -- --demo

JSON codec 和 CLI 单元测试覆盖结构化输入。Unix shell 可以把短 JSON 作为单个参数传给 --json；批量程序调用使用 --jsonl。Windows shell 对 JSON 引号的转义规则不同，推荐先在程序中调用 codec，或使用 --demo 验证安装。

moon run cmd/rulesorigin -- --demo

输入字段和规则示例见 examples/basic.json，领域语义见 docs/domain/rules-of-origin.md。

#Package layout

Package	Responsibility
core	原产地事实、证据、协定版本和输入错误
evaluate	BOM 图校验、三态决策、规则结果和证据引用
rules	税则改变、RVC、加工和累积策略
codec	JSON DTO、领域转换和稳定 JSON 输出
cli	--json / --jsonl 命令逻辑
cmd/rulesorigin	可执行入口
assurance	供应商声明有效期、证据覆盖和冲突诊断
agreements	协定规则目录、版本选择和差异报告
planning	采购替代场景、约束校验和敏感性分析
audit	判定审计轨迹、缺失动作和文本报告
benchmarks	固定业务 fixture、预期结果和操作计数

#Scope and extension points

项目只接受结构化数据；调用方可以在 codec 外增加 OCR 适配器、原产地证书生成或外部法规同步，但这些适配器应自行保留来源、版本和人工复核边界。核心库不依赖网络、文件系统或数据库。

#Ecosystem boundary

为明确生态边界，本项目在 MoonCakes 以 origin、customs、tariff、supply chain、BOM、provenance、rules of origin 等关键词检索，没有发现功能相同的成熟 MoonBit 原产地判定引擎。moonflowgraph、graph-algebra 和 license_checker 是相邻但不同的图、算法或许可证工具，本项目没有复制或依赖它们。