# porcelain

**Repository Path**: aweqy/porcelain

## Basic Information

- **Project Name**: porcelain
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-29
- **Last Updated**: 2025-07-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 瓷之魂 - 中国陶瓷文化展示平台

## 项目简介

"瓷之魂"是一个展示中国陶瓷文化的全栈Web应用，通过交互式的地图和时间轴，让用户探索中国陶瓷从新石器时代到现代的发展历程。

## 技术栈

### 后端
- Spring Boot 3.x
- MySQL 8.0
- MyBatis-Plus
- Knife4j (API文档)

### 前端
- Vue 3
- Vue Router 4
- Element Plus
- Axios
- Vite

## 项目结构

```
porcelain/
├── src/                    # 后端源码
│   ├── main/java/
│   │   └── com/aweqy/porcelain/
│   │       ├── controller/ # 控制器
│   │       ├── entity/     # 实体类
│   │       ├── mapper/     # 数据访问层
│   │       ├── service/    # 业务逻辑层
│   │       └── common/     # 公共组件
│   └── resources/
│       └── application.yml # 配置文件
├── porcelain-frontend/     # 前端项目
│   ├── src/
│   │   ├── views/         # 页面组件
│   │   ├── api/           # API接口
│   │   └── router/        # 路由配置
│   ├── package.json
│   └── vite.config.js
├── sql/                   # 数据库脚本
│   ├── create_table.sql   # 建表语句
│   └── init_data.sql      # 初始化数据
└── README.md
```

## 功能特性

### 主页功能
- **朝代历程展示**：左侧展示从新石器时代到现代的朝代列表
- **交互式地图**：中间展示中国地图，点击省份可查看地区信息
- **详细信息面板**：右侧显示选中朝代或地区的详细信息
- **文献导航**：可跳转到文献详情页面查看相关文献

### 文献详情页面
- **多维度筛选**：支持按朝代、地区、文献类型筛选
- **文献列表**：展示符合条件的文献列表
- **文献详情**：点击文献可查看完整内容
- **关键词标签**：文献关键词以标签形式展示

## 数据库设计

### 核心表结构
- `dynasty_info`：朝代信息表
- `region_info`：地区信息表
- `literature_info`：文献信息表

### 数据内容
- 12个朝代的历史信息（从新石器时代到现代）
- 10个主要陶瓷产区的详细信息
- 10篇代表性文献的完整内容

## 快速开始

### 环境要求
- JDK 8+
- Node.js 16+
- MySQL 8.0+

### 后端启动
1. 创建数据库并执行SQL脚本：
```sql
-- 执行建表脚本
source sql/create_table.sql
-- 执行初始化数据脚本
source sql/init_data.sql
```

2. 修改数据库配置：
```yaml
# src/main/resources/application.yml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/porcelain_database
    username: your_username
    password: your_password
```

3. 启动后端服务：
```bash
mvn spring-boot:run
```

后端服务将在 `http://localhost:6604` 启动

### 前端启动
1. 安装依赖：
```bash
cd porcelain-frontend
npm install
```

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

前端应用将在 `http://localhost:3000` 启动

## API接口

### 朝代相关
- `GET /api/dynasty/list` - 获取所有朝代
- `GET /api/dynasty/{id}` - 获取朝代详情

### 地区相关
- `GET /api/region/list` - 获取所有地区
- `GET /api/region/{id}` - 获取地区详情
- `GET /api/region/geo/{area}` - 根据地理分区获取地区

### 文献相关
- `GET /api/literature/dynasty/{dynastyId}/region/{regionId}` - 根据朝代和地区获取文献
- `GET /api/literature/dynasty/{dynastyId}` - 根据朝代获取文献
- `GET /api/literature/region/{regionId}` - 根据地区获取文献
- `GET /api/literature/{id}` - 获取文献详情

## 部署说明

### 后端部署
```bash
mvn clean package
java -jar target/porcelain-0.0.1-SNAPSHOT.jar
```

### 前端部署
```bash
cd porcelain-frontend
npm run build
# 将dist目录部署到Web服务器
```

## 开发说明

### 代码规范
- 后端遵循Spring Boot最佳实践
- 前端使用Vue 3 Composition API
- 使用Element Plus组件库保持UI一致性

### 扩展功能建议
1. 添加更多朝代和地区数据
2. 集成真实的中国地图组件
3. 添加图片和视频资源
4. 实现用户评论和收藏功能
5. 添加搜索功能
6. 支持多语言

## 许可证

MIT License