# 非遗连线

**Repository Path**: null7916/IntangibleCultural

## Basic Information

- **Project Name**: 非遗连线
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-27
- **Last Updated**: 2026-03-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 河南省非物质文化遗产数字博物馆

一个基于 Vue.js + Spring Boot 的数字化博物馆平台，用于展示和传承湖南省非物质文化遗产。

## 项目简介

本项目是一个完整的Web博物馆应用，采用前后端分离架构。前端使用 Vue.js 构建，后端采用 Spring Boot 框架，数据库使用 MySQL。系统旨在通过数字化手段展示湖南非物质文化遗产，为用户提供沉浸式的文化体验。

## 技术栈

### 前端技术
- **框架**: Vue.js 3 + TypeScript
- **UI框架**: Element Plus
- **3D渲染**: Three.js (用于文物3D模型展示)
- **动画**: Live2D (虚拟形象)
- **样式**: CSS3 + Tailwind CSS (部分模块)

### 后端技术
- **框架**: Spring Boot
- **ORM**: MyBatis Plus
- **数据库**: MySQL
- **AI集成**: 阿里云DashScope API (智能问答)

### 子模块技术
- **舞蹈模块**: Flask + Python (后端) + Socket.IO
- **民乐模块**: Flask + Python (后端) + Socket.IO
- **民间文学模块**: Flask + Python (后端) + Socket.IO

## 功能模块

### 核心功能
- 🏛️ **展馆浏览**: 三大展馆（湘绣馆、陶瓷馆、综合馆）的虚拟参观
- 📦 **藏品管理**: 藏品分类、详情展示、图片浏览
- 🔬 **研究学术**: 学术研究文章发布与浏览
- 🎨 **文创商城**: 创意文化产品展示与购买
- 👤 **个人中心**: 用户管理、收藏夹、购物车

### 互动功能
- 🤖 **AI智能助手**: 基于大模型的博物馆智能问答
- 🎭 **少儿非遗**: 面向儿童的互动学习模块
  - 舞蹈教学
  - 民乐欣赏
  - 民间文学阅读
- 🖼️ **3D文物**: 高清3D模型展示
- 🎭 **Live2D**: 虚拟形象交互

## 项目结构

```
├── hnmuseum.sql              # 数据库脚本
├── hnmuseum_front/          # Vue.js 前端
│   ├── src/
│   │   ├── components/       # Vue组件
│   │   │   ├── Collection/  # 藏品模块
│   │   │   ├── Exhibition/  # 展览模块
│   │   │   ├── Research/    # 研究模块
│   │   │   ├── Creation/    # 文创模块
│   │   │   ├── Index/       # 首页组件
│   │   │   └── ...
│   │   ├── assets/          # 静态资源
│   │   │   ├── css/         # 样式文件
│   │   │   ├── images/      # 图片资源
│   │   │   └── models/      # 3D模型
│   │   └── router/          # 路由配置
│   └── public/
│       ├── children/         # 少儿互动模块
│       │   ├── dance/       # 舞蹈
│       │   ├── music/        # 民乐
│       │   └── folk_literature/  # 民间文学
│       └── live2dmodels/    # Live2D模型
│
└── hnmuseum_rear/           # Spring Boot 后端
    └── src/main/java/
        └── com/hnmuseum_rear/
            ├── controller/   # 控制器
            ├── service/     # 业务逻辑
            ├── mapper/      # 数据访问
            ├── entity/      # 实体类
            └── config/      # 配置类
```

## 快速开始

### 环境要求
- JDK 1.8+
- Node.js 16+
- MySQL 5.7+
- Python 3.8+ (用于子模块)

### 后端配置

1. 创建数据库：
```sql
CREATE DATABASE hnmuseum DEFAULT CHARACTER SET utf8mb4;
```

2. 修改配置文件 `hnmuseum_rear/src/main/resources/application.yml`，配置数据库连接信息。

3. 启动后端：
```bash
cd hnmuseum_rear
./mvnw spring-boot:run
```

后端默认端口：`8088`

### 前端配置

1. 安装依赖：
```bash
cd hnmuseum_front
npm install
# 或
pnpm install
```

2. 启动开发服务器：
```bash
npm run serve
```

前端默认端口：`8080`

### 少儿互动模块配置

各少儿模块需要单独启动Flask服务：

```bash
# 舞蹈模块
cd hnmuseum_front/public/children/dance/backend
pip install -r requirements.txt
python app.py

# 民乐模块
cd hnmuseum_front/public/children/music/backend
pip install -r requirements.txt
python app.py

# 民间文学模块
cd hnmuseum_front/public/children/folk_literature/backend
pip install -r requirements.txt
python app.py
```

## 默认账户

- 管理员账户：admin / admin123
- 普通用户：user / user123

## 主要页面路由

| 路由 | 说明 |
|------|------|
| `/` | 首页 |
| `/collection` | 藏品浏览 |
| `/exhibition` | 展览信息 |
| `/research` | 学术研究 |
| `/creation` | 文创商城 |
| `/personal` | 个人中心 |
| `/museum1` | 湘绣博物馆 |
| `/museum2` | 陶瓷博物馆 |
| `/museum3` | 综合博物馆 |

## 特色功能说明

### AI智能助手
集成阿里云DashScope大模型，提供智能问答服务。配置APP_ID后即可使用。

### 3D文物展示
使用Three.js渲染三维模型，支持缩放、旋转等交互操作。

### Live2D虚拟形象
页面嵌入Live2D虚拟形象，增加互动趣味性。

### 少儿互动模块
专为儿童设计的互动学习模块，包含：
- 舞蹈教学视频和互动练习
- 民乐曲库和音乐游戏
- 民间文学作品阅读

## 许可证

本项目仅供学习交流使用。