# exhibition

**Repository Path**: ancon318/exhibition

## Basic Information

- **Project Name**: exhibition
- **Description**: huizhanguanjia
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-15
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

我来帮你撰写 README。首先需要了解项目的具体结构和内容。


让我继续查看项目的关键配置文件和技术细节：


现在我已经了解了项目的基本结构。这是一个markdown
# Exhibition Management System

展览管理系统 | 一个现代化的
```展览信息管理平台

## 📋 目录

- [项目简介](#项目简介)
- [技术栈](#技术栈)
- [项目结构](#项目结构)
- [快速开始](#快速开始)
- [API 文档](#api-文档)
- [功能模块](#功能模块)
- [贡献指南](#贡献指南)
- [许可证](#许可证)

---

## 🎯 项目简介

本项目是一个功能完整的展览管理系统，提供展览信息的数字化管理能力。系统采用前后端分离架构，支持灵活的部署和扩展。

**核心特性：**
- ✅ 现代化前端技术栈，响应式设计
- ✅ RESTful API 设计规范
- ✅ JWT 认证授权机制
- ✅ MyBatis Plus 高效数据访问
- ✅ Swagger 接口文档自动生成

---

## 🛠 技术栈

### 后端技术
| 技术 | 版本 | 说明 |
|------|------|------|
| Java | 17 | 开发语言 |
| Spring Boot | 3.2.0 | 应用框架 |
| MyBatis Plus | 3.5.5 | ORM 框架 |
| MySQL | 8.0+ | 主数据库 |
| H2 Database | - | 测试数据库 |
| JWT | 0.12.3 | 认证授权 |
| Lombok | - | 代码简化 |
| Swagger/OpenAPI | - | 接口文档 |

### 前端技术
| 技术 | 版本 | 说明 |
|------|------|------|
| Vue.js | 3.4.21 | 渐进式框架 |
| Vite | 5.2.0 | 构建工具 |
| Vue Router | 4.3.0 | 路由管理 |
| Pinia | 2.1.7 | 状态管理 |
| Axios | 1.6.8 | HTTP 客户端 |
| Element Plus | 2.6.1 | UI 组件库 |
| ECharts | 5.5.0 | 数据可视化 |
| Day.js | 1.11.10 | 日期处理 |

---

## 📁 项目结构

```
exhibition/
├── backend/                 # 后端服务
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/       # Java 源代码
│   │   │   └── resources/  # 配置文件
│   │   └── test/           # 测试代码
│   ├── pom.xml            # Maven 配置
│   └── start-backend.bat  # Windows 启动脚本
│
├── frontend/               # 前端应用
│   ├── src/               # 源代码
│   ├── public/            # 静态资源
│   ├── index.html         # 入口文件
│   ├── package.json       # npm 配置
│   └── vite.config.js     # Vite 配置
│
└── database/              # 数据库脚本
```

---

## 🚀 快速开始

### 环境要求

- **后端**：JDK 17+, Maven 3.6+
- **前端**：Node.js 16+, npmbash
git clone https://gitee.com/ancon318/exhibition.git
cd exhibition
```

### 2. 后端部署

```bash
cd backend

# 方式一：使用 Maven 构建
mvn clean package
``` -DskipTests

# 方式二：使用启动脚本（Windows）
start-backend.bat

# 方式三：直接运行
java -jar target/exhibition-manager-1.0.0.jar
```

**后端默认端口：** `8080`

### 3. 前端部署

```bash
cd frontend

# 安装依赖
npm install

# 开发模式启动
npm run dev

# 构建生产版本
npm run build

# 预览构建结果
npm run preview
```

**前端默认端口：** `3000`

### 4. 访问应用

- **前端页面**：http://localhost:3000
- **后端 API**：http://localhost:8080
- **API 文档**：http://localhost:8080/swagger-ui.html

---

## 📖 API 文档

项目集成了 Swagger/OpenAPI 3.0，访问以下地址查看完整的 API 文档：

```
http://localhost:8080/swagger-ui.html
```

API 文档支持：
- 在线接口测试
- 请求/响应示例查看
- 接口分组管理

---

## 📦 功能模块

> 根据实际业务需求补充具体功能模块

### 基础功能
- [ ] 用户认证与授权
- [ ] 展览信息管理
- [ ] 展品数据管理
- [ ] 数据统计报表

### 扩展功能
- [ ] 二维码生成
- [ ] 数据可视化展示
yaml

```server:
  port: 8080

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/exhibition
    username: your_username
    password: your_password

mybatis-plus:
  mapper-locations: classpath*:/mapper/**/*.xml
```

### 前端配置

修改 `frontend/vite.config.js`javascript
server: {
  proxy: {
    '/api': {
      target: 'http://localhost:8080',
      changeOrigin: true
    }
  }
}
```

---

## 🧪 测试

```bash
# 后端单元测试
cd backend
mvn test

# 前端测试
cd frontend
npm run test
```

---

## 📝 贡献指南

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature
```/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

---

## 📄 许可证

本项目采用 MIT License - 详见 [LICENSE](LICENSE) 文件

---

## 📞 联系方式

- **作者**：ancon318
- **仓库**：https://gitee.com/ancon318/exhibition

---

> 💡 **提示**：如需了解更多技术细节，请查看各模块目录下的详细文档。
```

---

## ✅ 建议

1. **补充数据库初始化脚本** - 当前 `database` 目录为空，建议添加 SQL 初始化文件
2. **添加环境配置示例** - 建议提供 `application.example.yml` 作为配置模板
3. **完善功能说明** - 根据实际开发进度，补充具体功能模块的详细描述
4. **添加截图** - 建议在 README 中添加项目截图，提升可读性

---

需要我根据项目的实际代码逻辑，帮你补充更多具体的功能说明或配置细节吗？