# ewem-fabric-trace-java

**Repository Path**: taowanwan/ewem-fabric-trace-java

## Basic Information

- **Project Name**: ewem-fabric-trace-java
- **Description**: 基于区块链Hyperledger Fabric V2.4 的农产品/商品通用万能溯源系统，一物一码溯源防伪系统，后端和智能合约采用java开发 vue+springboot+Hyperledger Fabric java区块链/区块链溯源/溯源系统/区块链溯源系统/区块链溯源平台/java智能合约
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 36
- **Forks**: 7
- **Created**: 2025-03-25
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 一物一码, 区块链, 溯源, 防伪, Fabric

## README

## 平台介绍
##### 基于Java + HyperledgerFabric开发的区块链一物一码溯源防伪系统，用户可在溯源码申请中自主选择普通溯源/区块链溯源
##### 基于区块链Hyperledger Fabric V2.4的农产品溯源/商品/通用万能溯源应用模板，可以快速使用本系统搭建自己的溯源系统，帮助想法快速落地，欢迎各位 Star

#### 麻烦大家Star支持一下，这对我们很重要！！！

#### 系统演示
* 后端演示地址：http://47.120.79.226
* 后端账号密码：  

        种植商：zzs1   密码：123456  
        生产商：scs1   密码：123456  
        物流商：wls1   密码：123456  
        销售商：xss1   密码：123456    

    管理员：账号暂不开放
#### 开源&付费版区别
| 开源 | 付费版 | 
|--|--|
| 码生成 |码生成(自定义规则) |
| 防伪码 | 防伪码(自定义规则) |
|×|溯源角色权限隔离|
|溯源|溯源|
|防伪|防伪|
|环节模板|环节模板|
|环节录入|环节录入|
|批次管理|批次管理|
|分类管理|分类管理|
|产品管理|产品管理|
|×|精美H5溯源页|
|×|数据报表|
|×|更多功能...|

### 项目地址：
* gitee：https://gitee.com/taowanwan/ewem-fabric-trace-java
* github：https://github.com/OLO520/ewem-fabric-trace-java

### 接定制开发，有需要可以加微（RYY5206）(有偿，备注来意，先star哦）

本项目基于Apache License 2.0开源协议，在【个人】的科研、学习范围内可以自由使用，请附上项目链接。如有商业需求（包括教学案例授权）或合作需求，可以加微（RYY5206）（有偿，备注来意）。如果您不同意本声明请不要使用本项目。 不可进行源码售卖(例如淘宝，csdn，咸鱼等平台售卖源码)，不可用于参加竞赛(若有需，请联系本人)。

## 环境部署
### 准备工作
JDK >= 1.8 (推荐1.8版本)
Mysql >= 5.7.0 (推荐5.7版本)
Redis >= 3.0
Maven >= 3.0
Node >= 12
提示

前端安装完node后，最好设置下淘宝的镜像源，不建议使用cnpm（可能会出现奇怪的问题）

### 运行系统
前往Gitee克隆本项目

### 后端运行
1、导入到Eclipse，菜单 File -> Import，然后选择 Maven -> Existing Maven Projects，点击 Next> 按钮，选择工作目录，然后点击 Finish 按钮，即可成功导入。
Eclipse会自动加载Maven依赖包，初次加载会比较慢（根据自身网络情况而定）
2、创建数据库ry-vue并导入数据脚本ry_2021xxxx.sql，quartz.sql
3、打开项目运行com.ruoyi.RuoYiApplication.java。

后端运行成功可以通过(http://localhost:8080 (opens new window))访问，但是不会出现静态页面，可以继续参考下面步骤部署ruoyi-ui前端，然后通过前端地址来访问。

### 前端运行
#### 进入项目目录
cd ruoyi-ui

#### 安装依赖
npm install

#### 强烈建议不要用直接使用 cnpm 安装，会有各种诡异的 bug，可以通过重新指定 registry 来解决 npm 安装速度慢的问题。
npm install --registry=https://registry.npmmirror.com

#### 本地开发 启动项目
npm run dev
4、打开浏览器，输入：(http://localhost:80 (opens new window)) 默认账户/密码 admin/admin123）
若能正确展示登录页面，并能成功登录，菜单及页面展示正常，则表明环境搭建成功

建议使用Git克隆，因为克隆的方式可以和RuoYi-Vue随时保持更新同步。使用Git命令克隆

git clone https://gitee.com/y_project/RuoYi-Vue.git
如需要使用SpringBoot3，JDK17+版本，使用Git命令切换，代码和RuoYi-Vue保持更新同步。

git checkout springboot3
提示

因为本项目是前后端完全分离的，所以需要前后端都单独启动好，才能进行访问。
前端安装完node后，最好设置下淘宝的镜像源，不建议使用cnpm（可能会出现奇怪的问题）

## 系统截图

![image-20250325110947669](/img/image-20250325110947669.png)

![image-20250325111017830](/img/微信截图_20250425095526.png)

![image-20250325111134529](/img/image-20250325111134529.png)

![image-20250325111314571](/img/image-20250325111314571.png)

![image-20250325111331568](/img/image-20250325111331568.png)

![防伪验证](img/trace_code.jpg)

![H5溯源](img/trace.jpg)

## 技术选型
* 前端采用Vue、Element UI。
* 后端采用Spring Boot、Spring Security、Redis & Jwt。
* 权限认证使用Jwt，支持多终端认证系统。
* 吃水不忘挖井人，特别感谢：[ewem](https://gitee.com/qrcode_project/ewem)。

## 区块链溯源优势

区块链在溯源系统中具有以下显著优势：

- **数据不可篡改**：区块链采用分布式账本技术，数据一旦记录在区块中，要想篡改就需要控制网络中大部分节点，成本极高，几乎不可能实现。这确保了溯源数据的真实性和完整性，比如在农产品溯源中，从种植、采摘、加工到运输等各个环节的数据一旦上链，就无法被随意更改，消费者可以放心查看产品的真实信息。
- **信息透明度高**：区块链上的所有数据对全网节点公开，相关参与者都能查看数据的完整历史记录。以供应链溯源为例，供应商、生产商、物流商和消费者等都能通过区块链浏览器查看产品的全流程信息，便于各方及时了解产品状态，发现问题也能迅速定位。
- **去中心化**：区块链没有中心化的管理机构，各个节点地位平等，共同参与系统运行和维护。这避免了单一中心化机构出现故障或被攻击导致系统瘫痪的风险，也防止了中心化机构对数据的垄断和滥用。在跨境电商溯源中，即使某个国家或地区的机构出现问题，也不会影响整个溯源系统的运行。
- **可追溯性强**：区块链通过哈希值将各个区块链接成一条链，形成完整的时间戳序列。从产品的源头到终端消费者手中的每一个环节都能清晰追溯，实现了真正意义上的 “从农场到餐桌” 的全程追溯。比如在药品溯源中，能准确追踪药品的生产批次、流通路径等信息，一旦出现问题可迅速召回相关产品。
- **智能合约自动化**：智能合约是区块链上的自动执行程序，当满足预设条件时会自动触发相应操作。在溯源系统中，可用于自动记录产品状态变化、触发相关通知等。如当产品运输到某个特定地点，智能合约自动记录到达时间，并向相关人员发送通知，提高溯源效率和准确性，减少人工干预带来的错误和欺诈风险。