【免费下载链接】craftplanSelf-hosted software for managing artisanal D2C micro-businesses项目地址https://gitcode.com/gh_mirrors/cr/craftplan点击查看免费下载Craftplan 是一款面向小批量手工生产artisanal D2C的自托管 ERP其核心 BOM物料清单系统让你把产品配方、工时步骤与自动成本汇总集中在同一处管理。本教程带你快速上手版本化配方编辑、支持批量分摊的工时步骤以及一键生成的成本汇总与定价建议——无需手写任何代码。什么是 Craftplan 的 BOM 配方系统Craftplan 的产品目录Catalog把「配方」统一建模为BOMBill of Materials物料清单。每一个产品都挂着一份 BOM里面分两部分Materials材料清单生产该成品所需的原材料或引用其他产品作为「子装配」。Labor steps工时步骤每一步人工耗时、可选的费率覆盖与批量产出数量。系统会为每个 BOM 版本自动计算「材料 人工 间接费用」的单位成本并把结果缓存下来供订单、排产、发票等功能直接读取。下面是配方编辑器的实际界面 核心理念你只管维护「最新版」配方历史版本自动归档并锁定为只读成本则始终跟着最新版走。快速上手三步进入配方编辑器登录后台进入Manage → Catalog → Products产品。点开任意产品顶部会出现Details详情与Recipe配方两个标签页。点击Recipe即进入 BOM 编辑器Details则展示定价建议与成本指标。官方对这一区域的说明见 docs/src/pages/docs/catalog.md。版本化配方只改最新版历史自动只读Craftplan 采用「简单且安全」的版本模型让你可以大胆迭代配方而不怕弄丢历史编辑器头部会显示当前版本号例如v3最新一版会带一个绿色的Latest徽标。当你在查看旧版本时顶部会出现一条金色提示横幅并提供Go to latest回到最新版按钮同时把所有输入框切换为只读防止误改历史记录。点击Show version history可打开历史弹窗列出每个版本的状态、发布时间与单位成本并可一键View跳转到指定版本。每次Save Recipe保存配方都会自动创建一个新激活版本并打上当前发布时间同时把上一版归档同一产品任何时刻只允许有一份激活的 BOM。版本号由系统自动递增最新版 1无需手动填写。这套逻辑由版本分配变更 lib/craftplan/catalog/changes/assign_bom_version.ex 完成「一个产品仅一份激活 BOM」则通过数据库唯一索引保证见 lib/craftplan/catalog/bom.ex。编辑器还支持?vNUMBER的 URL 参数可深链接到某个历史版本方便在团队间分享。添加材料与子装配支持 BOM 嵌套在Materials区域你可以添加两种组件组件类型说明Add Material从库存材料中选择展示其购买单价用于计算本行成本Add Product把另一个产品的 BOM 作为「子装配」拉进当前配方即 BOM 嵌套每一行都会显示本行小计基于该材料的单价表头会实时汇总出Total Cost材料总成本。已添加的材料/产品会从选择器中隐藏避免重复添加。产品组件还会显示该子产品的bom_unit_cost帮助你直观了解嵌套成本。 如果某个「混合料 / 自制配料」被多个成品共用Craftplan 建议改用 Intermediate Production中间体生产来单独生产并入库从而保留真实产出、批次成本与完整的上下游追溯。材料/子装配行的数据模型见 lib/craftplan/catalog/bom_component.ex其中还提供了waste_percent损耗百分比字段可用于精细控制原料损耗。工时步骤与批量分摊units_per_run 是重点Labor steps工时步骤用于记录消耗人工时间的每一步。区域顶部会显示当前时薪hourly rate与间接费用比例overhead并提供Update in settings快捷链接直达设置页。每个工时步骤包含Step名称如「Mix dough和面」。Minutes分钟该步骤耗时。Units per run每次批量产出默认1。Hourly rate override费率覆盖留空则用默认时薪支持小数便于区分装饰、预处理等不同工种。右侧Cost per unit列显示每一步折算到单件的人工成本表头则汇总总分钟数与单件人工成本。关键技巧 —— units_per_run批量分摊如果一次搅拌能同时产出 4 盘面包就把该步骤的units_per_run设为4。计算单件成本时分钟数会先除以 4再折算成钱从而把「一次批量操作」的人工费用公平地摊到每个成品上。这套单件人工成本的分摊逻辑在 lib/craftplan/catalog/services/batch_cost_calculator.ex 中实现。字段定义见 lib/craftplan/catalog/labor_step.ex。自动成本汇总与定价建议算完即缓存保存配方后系统会立即触发一次成本汇总rollup把材料成本、人工成本、间接费用与最终单位成本一并算好并持久化。计划排产planner、发票与洞察insights等功能都直接读取这份缓存因此保持 BOM 为最新状态非常重要。材料成本各行材料单价 × 用量含损耗之和。人工成本所有工时步骤折算后的单件人工成本。间接费用overhead按设置里的 overhead 百分比自动计入。单位成本unit_cost以上合计折算到每一件成品。这些值保存在catalog_bom_rollups表中模型见 lib/craftplan/catalog/bom_rollup.ex汇总触发逻辑见 lib/craftplan/catalog/services/bom_rollup.ex。Details 标签页的 Suggested Prices建议价会基于当前 BOM 单位成本套用设置里的「零售/批发」加价模式百分比或固定值自动给出建议零售价与批发价。你还能在详情页看到材料成本、毛利gross profit与加价率markup percentage等指标建议价计算见 lib/craftplan_web/live/manage/product_live/show.ex。关键源码路径速查想进一步阅读实现可从以下模块入手BOM 主模型版本/状态/发布lib/craftplan/catalog/bom.exBOM 组件材料 / 子装配lib/craftplan/catalog/bom_component.ex工时步骤模型lib/craftplan/catalog/labor_step.ex成本汇总服务lib/craftplan/catalog/services/bom_rollup.ex批量成本计算器含嵌套与分摊lib/craftplan/catalog/services/batch_cost_calculator.ex版本自动递增lib/craftplan/catalog/changes/assign_bom_version.ex配方编辑器界面lib/craftplan_web/live/manage/product_live/form_component_recipe.ex官方文档页docs/src/pages/docs/catalog.md小结把配方、工时与成本收进一个地方Craftplan 的 BOM 系统为小批量、按单生产的手工生意量身定做版本化——只改最新版历史自动归档只读随时可回看。可嵌套——材料 子装配支持复杂产品与自制配料。批量分摊——units_per_run让批量操作的工时公平摊到每个成品。自动成本汇总——保存即算单位成本与建议售价实时可得。掌握以上几点你就能在 Craftplan 中把「产品目录 配方 成本」管理得既清晰又准确为后续的排产、采购与发票打下可靠基础。赞分享【免费下载链接】craftplanSelf-hosted software for managing artisanal D2C micro-businesses项目地址https://gitcode.com/gh_mirrors/cr/craftplan点击查看免费下载相关推荐KiCad JLCPCB工具完整指南一键生成BOM与自动化装配KiCad JLCPCB工具完整指南一键生成BOM与自动化装配 KiCad JLCPCB工具是一款专为PCB设计师打造的强大插件能够帮助用户快速生成物料清单硬件开发开发工具桌面应用[18.0.0](https://github.com/yargs/yargs/compare/v17.7.2...v18.0.0) (2025-05-26)18.0.0 https://github.com/yargs/yargs/compare/v17.7.2...v18.0.0 2025 05 26 ⚠ BRECLI开发工具5个步骤轻松安装黑苹果完整Hackintosh教程与资源汇总5个步骤轻松安装黑苹果完整Hackintosh教程与资源汇总 想要在普通PC或笔记本上体验macOS系统吗Hackintosh黑苹果项目为您提供了完美的解决文档教程知识库创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考