农业是国民经济的基础产业,也是温室气体排放的重要来源。随着国家"碳达峰、碳中和"战略的深入推进与乡村振兴战略的全面展开,农产品从田间到餐桌的质量安全、环境成本与价值可信度,正成为政府监管、收购企业与城市消费者共同关心的核心议题。然而传统农产品流通链条长、主体分散,农户、合作社、收购商与消费者之间信息严重不对称:一方面,消费者扫码后往往只能看到一段无法验证的"宣传文字",溯源信息真伪难辨;另一方面,收购商与监管部门缺乏客观、可量化的绿色评价依据,绿色补贴的申报认定长期依赖人工材料,效率低且容易造假。与此同时,广大农户尤其是偏远地区的小农户数字化水平有限,网络条件不稳定,操作复杂的系统难以真正落地。
本系统正是面向上述行业痛点而设计——"城乡农品轻量溯源与碳足迹存证系统"定位于轻量级、可独立部署、支持离线使用的农品可信数据平台,其行业场景可归纳为四类。第一,产地建档与农事留痕:农户通过微信小程序或手机 APP 记录施肥、灌溉、农机作业、植保、覆膜、采收、包装、运输等全生命周期农事数据,并支持弱网离线缓存、恢复网络后批量同步,高度贴合田间实际作业环境。第二,碳足迹量化与绿色评价:平台内置农业碳排放因子库,按农事类型与物料用量自动核算单条记录及整批次的碳足迹,形成总排放、单位产量排放与分项占比报告,为绿色农产品认定提供客观数据支撑。第三,可信存证与扫码验真:系统将农事记录与碳报告的 SHA-256 摘要写入哈希链轻节点,消费者扫描二维码即可查看全链路信息并验证数据是否被篡改,从根本上解决"溯源可信度"难题。第四,绿色补贴智能申报:基于农事台账与碳报告,由智能体自动生成规范化的申报材料,大幅降低农户与合作社的申报门槛。
系统的典型用户涵盖农户、合作社、收购商、监管人员与终端消费者,贯穿"生产—流通—消费—监管"完整业务闭环。
系统围绕"一口录入、多端协同、全链可信"的理念构建功能体系,主要由八大模块组成。
多端农事录入与离线同步:微信小程序与 Flutter APP 面向农户,支持施肥、灌溉、农机、植保、覆膜、采收、包装、运输八类农事录入,字段涵盖物料名称、用量、单位、作业日期、作业面积与现场照片;APP 端基于本地数据库实现离线作业,网络恢复后携带同步令牌批量提交,服务端以令牌去重保证幂等,杜绝弱网重复提交。
批次建档与二维码生成:收购商或合作社在 Web 后台建立产品批次,系统按"AG+时间戳+农户编号"规则自动生成批次编号,绑定产地、品种、种植面积、预计产量与实际产量,并生成专属溯源二维码与访问链接,作为消费者扫码入口。
全链路溯源聚合:消费者扫码进入 H5 页面,凭批次号一次聚合展示批次档案、农事时间线、碳足迹报告与链上验真结论,公开接口免登录即可访问,做到"扫码即见、所见可验"。
碳足迹自动核算:维护带标准来源的碳排放因子库,按"用量×排放因子"逐条核算,聚合成批次总排放、单位产量排放及各环节占比,生成可视化碳报告,并附带 AI 低碳优化建议。
AI 智能体服务:Python 智能体服务编排农事数据校验、低碳建议、补贴申报文案、碳标签通俗解读四类智能体,对异常录入自动预警,向消费者输出通俗易懂的碳标签说明。
联盟链哈希存证与验真:对农事记录与碳报告计算 SHA-256 摘要并写入哈希链轻节点,形成前序哈希相链、不可篡改的账本,提供按业务类型与业务编号的验真接口。绿色补贴报表生成:整合批次、产量与碳报告数据,由智能体自动生成结构化的补贴申报材料,涵盖批次编号、产品名称、产地、实际产量与碳足迹核算结果,支持人工复核后提交主管部门,显著降低申报门槛。
统一网关与权限控制:网关完成 JWT 鉴权、农户/收购商/管理员三级角色分级、登录白名单放行、令牌桶限流与跨域处理,为多端并发访问提供统一入口
系统采用"Java 微服务 + Python 智能体 + 多端前端"的分层架构。后端基于 Spring Boot 与 Spring Cloud 构建十个服务:网关、认证、农事、批次、碳核算、存证、智能体编排、补贴报表、文件服务与公共模块,统一注册至 Nacos,MySQL 存储九张核心业务表,Redis 承担缓存支撑。
事件驱动是系统的核心设计。农事记录保存后,服务向 fanout 广播交换机发布事件,碳核算队列、AI 校验队列、农事存证队列三个消费者并行处理,实现碳足迹核算、智能校验、链上存证三条链路彼此解耦、互不阻塞;碳报告生成后再次发布事件触发报告上链。消费者采用手动消息确认机制,处理失败时拒绝且不重回队列,避免消息风暴与重复消费。
碳核算模块以高精度十进制运算保证计算精度,按"用量×排放因子"逐条核算,采用覆盖式更新生成报告、明细先清后插,并将批次、排放总量、分项摘要与创建时间拼接后计算 SHA-256 作为报告哈希。存证层以本地哈希链节点模拟联盟链:每个区块记录前序哈希形成链式结构,账本落盘并支持重启恢复,生产环境可无缝替换为 FISCO BCOS 等联盟链 SDK。
智能体层由 Python FastAPI 暴露统一接口,LangGraph 状态机按智能体名称分发路由。其关键创新是"规则兜底"机制:未配置大模型或调用异常时自动降级为本地规则,保证无大模型 API 也能跑通全链路,响应体以标志位标识是否需要二次校验;当 AI 建议超出长度阈值时直接丢弃兜底,体现安全约束。
工程实践上,全链路采用逻辑删除、乐观锁版本控制、统一返回结构、全局异常处理、网关注入内部身份头透传、密码加密存储与接口幂等等企业级设计。各服务通过声明式调用完成协作并设置兜底返回,避免单点故障沿调用链扩散;关键业务表统一配置逻辑删除与版本号,删除只更新标记、保留审计痕迹,与存证不可篡改的诉求相呼
声明:本文仅代表作者观点,不代表本站立场。如果侵犯到您的合法权益,请联系我们删除侵权资源!如果遇到资源链接失效,请您通过评论或工单的方式通知管理员。未经允许,不得转载,本站所有资源文章禁止商业使用运营!

下载安装【程序员客栈】APP
实时对接需求、及时收发消息、丰富的开放项目需求、随时随地查看项目状态
评论