# chinese-herb-recognition

**Repository Path**: flyqingfeng/chinese-herb-recognition

## Basic Information

- **Project Name**: chinese-herb-recognition
- **Description**: 中草药识别系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-10-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 中药识别系统

基于 AI 深度学习的中药材图像识别与知识库管理系统。

## 功能概览

- **药材识别** — 上传中药材图片，通过 CNN 模型自动识别药材名称及置信度
- **药材知识库** — 12 种常见中药材的详细信息（分类、性味、归经、功效、主治等）
- **识别历史** — 查看个人历史识别记录
- **后台管理** — 管理员可在系统管理中对药材知识库进行增删改查
- **权限控制** — 基于 RBAC 的用户角色权限体系

## 技术栈

| 层级 | 技术 |
|------|------|
| 前端 | Vue 3 + Vite 4 + Element Plus + TypeScript |
| 后端 | Spring Boot 2.7.18 + MyBatis-Plus + JDK 17 |
| 数据库 | MySQL 5.7+ / Redis |
| 识别服务 | Python 3.9+ / FastAPI / PyTorch |
| 基础框架 | 芋道 yudao-cloud（精简版） |

## 项目结构

```
chinese-herb-recognition/
├── backend/                  # Java 后端
│   ├── my-module-herb/       # 药材识别模块（知识库 CRUD + 识别接口）
│   ├── yudao-server/         # 启动模块（Spring Boot 入口）
│   ├── yudao-module-system/  # 系统管理（用户/角色/菜单/权限）
│   ├── yudao-framework/      # 框架基础组件
│   └── sql/mysql/            # 数据库脚本
├── frontend/                 # Vue 3 前端
├── servers/                  # Python 识别服务
└── DEPLOY.md                 # 部署文档
```

## 快速开始

### 环境要求

- JDK 17+ / Maven 3.6+
- Node.js 18+ / pnpm 8+
- MySQL 5.7+ / Redis 5+
- Python 3.9+（识别服务，可选）

### 1. 初始化数据库

```bash
mysql -u root -p -e "CREATE DATABASE IF NOT EXISTS \`ruoyi-vue-pro\` DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci"
mysql -u root -p ruoyi-vue-pro < backend/sql/mysql/ruoyi-vue-pro.sql
mysql -u root -p ruoyi-vue-pro < backend/sql/mysql/herb_tables.sql
mysql -u root -p ruoyi-vue-pro < backend/sql/mysql/quartz.sql
```

默认管理员账号：`admin` / `admin123`

### 2. 启动后端

```bash
cd backend
# 修改 application-local.yaml 中的数据库/Redis 连接信息
mvn clean package -DskipTests
java -jar yudao-server/target/yudao-server.jar
```

后端默认监听 `http://localhost:48080`

### 3. 启动前端

```bash
cd frontend
pnpm install
pnpm dev
```

前端默认监听 `http://localhost`（端口 80）

### 4. 启动识别服务（可选）

```bash
cd servers
pip install torch torchvision fastapi uvicorn pillow
python src/service.py
```

### 5. 访问系统

打开浏览器访问 `http://localhost`，使用 `admin / admin123` 登录。

## 页面导航

| 路径 | 页面 | 说明 |
|------|------|------|
| `/herb/recognition` | 药材识别 | 上传图片进行 AI 识别 |
| `/herb/knowledge` | 药材知识库 | 浏览药材详情（公开） |
| `/herb/history` | 识别历史 | 个人历史识别记录 |
| `/herb-management/list` | 药材管理 | 管理员增删改药材（需登录） |

## 数据库表

| 表名 | 说明 |
|------|------|
| `herb` | 药材知识库（12 条种子数据） |
| `herb_recognition_history` | 识别历史记录 |

## 详细部署

生产环境部署（Docker、Nginx、systemd 等）请参考 **[DEPLOY.md](DEPLOY.md)**。