一只蛋的成本怎么算？——都尔霍姆蛋鸡养殖管理系统的开发逻辑与框架

一、客户到底要什么？——需求还原

客户是都尔霍姆蛋鸡养殖场：两个基地（贺胜农场、双溪农场），高床有机平养海兰褐蛋鸡，每天人工清点鸡蛋，一箱 360 枚。他们发来的需求说明书非常专业，我逐条拆解成开发任务：

二、整体框架：Node.js 服务端 + H5 单页

技术选型延续 Y2Ksoft 的成熟套路，但这次是服务端正式版（不是演示版）：

// 技术栈
后端    Node.js (Express) + node:sqlite（零依赖数据库）
前端    单页 H5（index.html + app.js），手机微信/电脑双端自适应
存储    SQLite 单文件 farm.db，全量真实持久化
权限    服务端 requireAuth + requireRole 双重校验（前端菜单只是隐藏，后端才拦截）
AI     /api/ai/suggestions 规则引擎（可配 LLM_API_KEY 升级真大模型）

// 数据表（26 张，业务闭环全覆盖）
users sessions bases houses batches materials
wh_stock wh_records feed_raw feed_finished formulas
feed_produce feed_dispatch feed_raw_recs daily
immunizations medications weights lights antibodies
monthly_costs incomes settlements ai_suggestions attachments tasks

为什么用 node:sqlite？服务器 Node 20 不支持，我们装 Node 22 到 /opt，服务开箱即用、数据库就一个文件，备份恢复 = 下载/上传一个文件，客户现场部署最简单。

三、核心开发逻辑：三层闭环

1️⃣ 填报层 → 自动计算（calcDaily）

鸡舍管理员在手机上只填 A/B/C/废品蛋枚数 + 存栏 + 死淘 + 饲料，服务端实时算出 13 项指标并和海兰褐标准对比：

function calcDaily(rec, batch){
  const end = rec.open - rec.dead - rec.cull;          // 期末存栏
  const a=rec.a_cnt, b=rec.b_cnt, c=rec.c_cnt, w=rec.waste_cnt;
  const qualCnt = a+b;                                   // 合格蛋 = A蛋+B蛋（客户术语）
  const subCnt  = c, brkCnt = w;                         // C蛋=次品, 破蛋=废品
  layRate:  eggsTotal / end * 100                          // 产蛋率
  avgEggWt: total_kg*1000 / eggsTotal                      // 均蛋重
  fcr:      feed_kg / total_kg                             // 料蛋比
  cases:    qualCnt / 360                                  // 合格件数（1件=360枚）
  deviation: |理论枚数-实际枚数| / 理论枚数                 // 重量校验，>5% 标红
  flags:    产蛋率低于标准 / 死淘偏高 / 料蛋比偏高          // 自动预警
}

2️⃣ 单据层 → 审核闭环

所有单据走「草稿 → 提交 → 审核」三步，审核通过才生效：总仓出库要审核、饲料调拨要审核、生产日报要审核。审核中心集中处理，全程留痕（谁提交、谁审核、什么时候）。

3️⃣ 成本层 → 批次滚动累计

// 单枚鸡蛋成本（核心公式）
净投入 = 鸡苗成本 + 饲料总费用 + 总仓领用(兽药疫苗耗材)
        + 分摊人工/水电/折旧 + 其他耗材 − 淘汰鸡变卖收入
单枚成本 = 净投入 ÷ 批次累计实际产蛋枚数（人工清点）
斤蛋成本 = 净投入 ÷ 批次产蛋总斤数
// 分摊规则可切换：按存栏权重自动分摊 / 直接指定鸡舍金额

四、驾驶舱：6 张图让客户"看得懂"

客户说不喜欢干巴巴的表格，更不喜欢挤成一团的数字。我们参考陆龙江 ERP 的图表风格，把驾驶舱做成 6 张图、每张都带数字：

数字防重叠的细节：折线图数据点多时，只标「峰值点 + 末尾点」，末尾 4 条线上下错开（-6/-19/+12/+23），标准虚线不标数字，图例里显示最新值——客户一眼看清，不会糊成一团。

五、AI 决策中心：客户要的"掌握经营状况"

客户原话："整个系统必须有 AI 来决策、来控制整个系统的变化情况，这样客户才能掌握自己的经营状况、做成改变和变化"。我们做了规则引擎版（可升级真 LLM）：

• 健康评分（0-100 仪表）：优秀≥85 / 良好≥70 / 关注≥55 / 风险<55
• 7 维度诊断：产蛋率 vs 标准、累计死淘率、料蛋比、体重均匀度、单枚成本、疫苗临期、库存预警
• 行动清单：按优先级排序（红=立即处理 / 黄=近期安排），带具体数字和操作建议
• 趋势预判：近 7 天产蛋率升/降/平 + 一句话提醒

客户每天登录 → 看分数 → 看问题清单 → 照着行动 → 数据改善 → 分数上升。系统替他盯指标，他做决策——这才是"驱动型系统"。

六、系统截图（12 张，实拍 4K）

以下全部为系统真实界面（演示数据 7.5 个月 / 613 条生产记录 / 4 个在产批次），方便客户直接看效果：

01 · 登录页（第一印象）

客户提供的真实鸡舍照片做背景 + 左右双栏布局（左品牌区 + 右玻璃登录卡），四季贵州水色光球氛围。

02 · 运营驾驶舱（核心）

4 大 KPI + 6 张图表（产蛋率趋势/燃尽图/鸡舍排行/蛋重趋势/蛋品帕累托/疫苗到期）+ 预警中心 + 在产鸡舍一览。

03 · AI 决策中心

健康评分仪表 + 维度诊断 + 行动清单（按优先级）+ 趋势预判，客户每天打开就知道"该做什么"。

04 · 每日生产填报（客户术语）

手机主表单：A蛋/B蛋/C蛋(次品)/废品蛋四档录入，自动合并 A+B=合格、自动算产蛋率/件数/校验，海兰褐标准偏离标红。

05 · 技术台账

免疫记录（带到期提醒）/ 用药保健（仅追溯）/ 每周体重均匀度（vs 标准曲线）/ 光照变更 / 抗体检测。

06 · 物资总仓

兽药疫苗耗材先入总仓 → 领用下发鸡舍自动扣库存计成本，低库存/临期预警，台账完整。

07 · 饲料车间

原料仓/配方库/配料生产（自动扣原料+增成品）/调拨鸡舍（自动计成本），独立于总仓。

08 · 批次成本核算

成本看板（批次卡+单枚/斤蛋成本）/ 直接成本自动抓取 / 月度分摊 / 淘汰鸡冲减 / 纵向对比分组柱 / 批次结算归档。

09 · 报表与数据看板

单舍全周期追溯：产蛋率/蛋重/料蛋比/死淘/饲料消耗曲线，全部与海兰褐标准对比。

10 · 单据审核中心

所有单据草稿→提交→审核三步闭环，集中审批、全程留痕，审核通过才生效。

11 · 基础档案 + 12 · 用户与权限

基地/鸡舍（含月折旧）/批次（鸡苗总金额+计划淘汰）/物料档案；用户增删改、角色+鸡舍分配、禁用启用、重置密码。

七、踩过的坑（给后来者）

• 子路径部署 404：前端 JS 引用必须相对路径（js/app.js），写 /js/app.js 在 /duerholm/ 子路径下必 404，页面只剩空壳
• 服务器 Node 版本：node:sqlite 需要 Node 22+，服务器装 /opt/node22 单独跑，不动系统 Node
• SQLite 保留字：values 是保留字，字段改名 result_values
• 图表数字防重叠：多折线全标数字必糊，只标峰值+末尾、上下错开、虚线不标
• 演示数据要"够震撼"：1 月起 7.5 个月、613 条生产记录、4 批次、免疫 16 条——数据少撑不起系统的美观