食品合规不再难:Craftplan如何自动聚合过敏原与营养成分到产品标签
食品合规不再难:Craftplan如何自动聚合过敏原与营养成分到产品标签
Craftplan 是一款自托管的开源 ERP 系统,专为手工食品类 D2C 小微生意设计。它最大的亮点之一,是把"过敏原声明"与"营养成分表"从繁琐的手工核算变成自动聚合:只需在原材料上打一次标签,产品标签页上的过敏原列表和营养成分数据就会随配方(BOM)自动算好、随时打印。
为什么手工做食品标签这么累 📋
对于烘焙坊、酱料作坊这类小厂,一张合规的产品标签通常要回答三个问题:
- 配料表:这个产品里到底有哪些原料?
- 过敏原:含有麸质、乳制品、坚果等哪些常见过敏原?
- 营养成分表:每 100 g(或 100 ml)含多少能量、脂肪、碳水化合物、蛋白质、盐?
配方一调整,这三样就得全部重新核算;多品种交叉使用同一种原料时,人工 Excel 极易漏项。漏标一个过敏原,轻则下架整改,重则引发顾客健康问题。
Craftplan 的思路是:合规数据只录一次,其余全部自动滚算。
Craftplan 自动聚合的三步走 ⚙️
第一步:在全局设置中统一维护过敏原库和营养项
进入 Manage → Settings,左侧就有 Allergens 和 Nutritional Facts 两个面板:
- 过敏原库:集中管理全系统可用的过敏原词条(如 Glutene、Dairy、Nuts),支持搜索过滤;
- 营养项:系统预置了欧盟法规要求(EU required)的标准项——能量(kJ/kcal)、脂肪(含饱和脂肪)、碳水化合物(含糖)、蛋白质、盐,并可自由追加自定义项。
这一层的源码分别在 allergens_component.ex 与 nutritional_facts_component.ex,标准营养项定义在 nutrition.ex 中。
第二步:给每份原材料打上"合规基因"
在 Manage → Inventory 的原材料详情页里:
- 勾选该原料涉及的过敏原(比如"全用途面粉 → 麸质");
- 填入营养成分数值,支持"每 X 克/毫升"的基准(Per 列),例如奶粉每 100 g 含多少脂肪、蛋白质。
这一步相当于把合规信息"焊"在原料上,之后无论这份原料被用到多少种产品里,都不需要重复维护。
第三步:配方(BOM)驱动,自动滚算到产品
产品的配料结构由 Recipe(BOM) 承载,见产品详情页的 Recipe 标签页:
系统随后做两件自动的事:
| 聚合对象 | 自动逻辑 | 核心源码 |
|---|---|---|
| 过敏原 | 把激活 BOM 的所有原料成分展开(支持子装配嵌套),汇总其过敏原,去重并排序 | allergens.ex |
| 营养成分 | 按"原料用量 × 单位含量"逐项求和;若产品设置了净含量(Net quantity),自动换算为每 100 g / 100 ml 的声明基准 | nutritional_facts.ex |
也就是说:配方里面粉用了 500 g,面粉标注了麸质过敏原——产品过敏原列表立刻出现 Glutene;脂肪、碳水等数值也同步按用量折算好,全程零手工。
产品标签页:合规信息一键出图 🏷️
产品详情页有专属的 Nutrition 标签页,直接展示自动计算结果("The nutritional information is automatically calculated from your recipe components."):
在此基础上还有两个面向"落地打印"的功能:
- 可打印的产品标签预览:汇总配料表、过敏原徽章、营养成分声明(含 per 100 g 基准、of which 子项缩进,符合欧盟标签习惯),点 Print 即可出图,源码见 label.ex。
- 生产批次标签快照:开启生产批次时,系统会把当前过敏原与营养数据冻结为
label_snapshot(含 Code39 条码所需字段),保证历史批次的标签可复现、可追溯,实现位于 batch_label.ex。
配合产品表单里的保质期天数、储存条件、原产地等字段,一张合规标签所需的信息在 Craftplan 里几乎"零额外录入"。
这套机制背后的完整链路 🔗
Settings(过敏原库 / 营养项)
↓
Inventory 原材料(过敏原标签 + 营养成分值)
↓
BOM 配方(原料 + 用量,支持子装配嵌套)
↓
自动计算(去重聚合 / 按 100 g 折算)
↓
产品 Nutrition 页 · 打印标签 · 批次快照
相关功能文档可参考 docs/src/pages/docs/inventory.md 中 Allergens & Nutritional Facts 一节,以及 docs/src/pages/docs/settings.md。
总结 ✅
- 录一次,处处生效:过敏原和营养数据挂在原料上,经 BOM 自动滚算到每个产品;
- 改配方即改标签:调整用量或换料后,过敏原列表与营养声明实时重算,不怕漏项;
- 面向法规设计:预置 EU required 营养项、每 100 g 声明基准、"of which" 子项结构,贴近欧盟食品标签规范;
- 可追溯:批次级标签快照让每一张历史标签都能复现。
对想认真做食品合规但又没有专职质量团队的小微食品品牌来说,Craftplan 把"合规"从周期性负担变成了一条自动流水线。


