# bird-identification-system

**Repository Path**: igjy/bird-identification-system

## Basic Information

- **Project Name**: bird-identification-system
- **Description**: 毕业设计
- **Primary Language**: JavaScript
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-03-05
- **Last Updated**: 2025-08-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 毕业设计前端

## README

# bird-identification-system

## 项目简介
本项目是基于鸟鸣声识别的鸟类分类系统的前端部分，旨在为用户和管理员提供鸟类识别、信息管理、数据采集与处理等一站式服务。前端采用 Vue3 + Vite 技术栈，界面美观，交互友好，支持多角色权限管理。

## 主要特性
- 鸟鸣声音频上传与自动识别
- 鸟类百科信息浏览
- 历史识别记录与个人收藏管理
- 用户注册、登录、个人信息维护
- 管理员后台：用户、鸟类、历史、收藏、日志、数据采集与处理、模型上传等管理功能
- 支持模型文件上传与训练集更新
- 实时特征提取任务进度推送（SSE）

## 技术栈
- [Vue3](https://vuejs.org/)
- [Vite](https://vitejs.dev/)
- [Vue Router](https://router.vuejs.org/)
- [Pinia](https://pinia.vuejs.org/)
- [Element Plus](https://element-plus.org/)
- [Axios](https://axios-http.com/)

## 目录结构
```
src/
  api/                # 所有后端接口请求封装
  assets/             # 静态资源（图片等）
  components/         # 组件（按功能模块细分）
    Admin/            # 管理员后台相关页面
    User/             # 用户端主要页面
    PersonalCenter/   # 个人中心相关页面
    BirdDetailInfo/   # 鸟类详情子页面
    ...
  router/             # 路由配置
  stores/             # Pinia 状态管理
  utils/              # 工具函数
  styles/             # 样式文件
  App.vue             # 根组件
  main.ts             # 入口文件
```

## 安装与启动

1. **克隆项目**
   ```bash
   git clone https://gitee.com/igjy/bird-identification-system.git
   cd bird-identification-system
   ```

2. **安装依赖**
   ```bash
   npm install
   ```

3. **启动开发环境**
   ```bash
   npm run dev
   ```

4. **打包构建**
   ```bash
   npm run build
   ```

> ⚠️ 需提前安装 [Node.js](https://nodejs.org/)（建议 16+），推荐使用 [pnpm](https://pnpm.io/) 或 [yarn](https://yarnpkg.com/) 也可。

## 功能说明

### 用户端
- **首页**：系统入口，导航各大功能
- **鸟类分类（识别）**：上传鸟鸣音频，自动识别鸟类
- **鸟类大全**：浏览所有支持识别的鸟类信息
- **个人中心**：历史记录、收藏夹、个人信息、密码修改等

### 管理员端
- **用户管理**：增删查改用户信息
- **鸟类信息管理**：维护鸟类百科数据
- **历史记录管理**：查看所有用户识别历史
- **收藏管理**：管理用户收藏
- **系统日志**：操作日志审计
- **数据采集及处理**：音频数据上传、特征提取、训练集更新
- **鸟类分类（识别）**：管理员专用识别入口
- **模型上传**：上传/替换识别模型文件

## 贡献方式

欢迎提交 Issue 或 Pull Request 参与项目改进！

1. Fork 本仓库
2. 新建分支 (`git checkout -b feature-xxx`)
3. 提交更改 (`git commit -m 'feat: xxx'`)
4. 推送分支 (`git push origin feature-xxx`)
5. 新建 Pull Request

## 许可证

[MIT License](./LICENSE)

## 相关链接

- 后端项目：https://gitee.com/igjy/bird