# Paintbrush

**Repository Path**: qianmu_jun/Paintbrush

## Basic Information

- **Project Name**: Paintbrush
- **Description**: Paintbrush项目
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-10
- **Last Updated**: 2025-10-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🎨 Paintbrush - 图片分享社区

<div align="center">
  <h3>基于 Spring Boot + Vue 3 的现代化图片分享平台</h3>
  <p>
    <img src="https://img.shields.io/badge/SpringBoot-3.1.3-brightgreen.svg" alt="Spring Boot">
    <img src="https://img.shields.io/badge/Vue-3.5.13-4FC08D.svg" alt="Vue 3">
    <img src="https://img.shields.io/badge/ElementPlus-2.10.1-409EFF.svg" alt="Element Plus">
    <img src="https://img.shields.io/badge/MySQL-8.0-blue.svg" alt="MySQL">
    <img src="https://img.shields.io/badge/Redis-3.2+-red.svg" alt="Redis">
  </p>
</div>

## 📋 项目简介

Paintbrush 是一个优美的图片分享社区平台，采用前后端分离架构设计。用户可以上传、浏览、管理个人图片，支持分类管理、浏览统计、用户信息管理等核心功能。项目采用现代化技术栈，具有良好的扩展性和维护性。

## 🏗️ 软件架构

### 系统架构

```
┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│    用户前端      │    │    后端服务      │    │    数据存储      │
│                 │    │                 │    │                 │
│  Vue 3 + Vite   │◄──►│  Spring Boot    │◄──►│     MySQL       │
│  Element Plus   │    │   + MyBatis     │    │     Redis       │
│  Vue Router     │    │   + JWT         │    │  文件存储        │
│  Pinia          │    │                 │    │                 │
└─────────────────┘    └─────────────────┘    └─────────────────┘
```

### 技术栈

| 分层 | 技术选型 | 版本 |
|-----|---------|------|
| **前端** | Vue 3 + Vite + Element Plus | 3.5.13 / 6.2.4 / 2.10.1 |
| **后端** | Spring Boot + MyBatis | 3.1.3 |
| **数据库** | MySQL + Redis | 8.0+ / 3.2+ |
| **认证** | JWT Token | - |

### 分层架构

```
表现层 (Controller) → 业务层 (Service) → 持久层 (Mapper) → 数据层 (Database)
```

## ✨ 核心功能

- 🔐 **用户系统**: 注册登录、信息管理、头像上传
- 🖼️ **图片管理**: 上传编辑、分页浏览、搜索删除
- 📂 **分类功能**: 按分类浏览、筛选功能
- 📱 **响应式设计**: 移动端适配
- 🔒 **安全机制**: JWT认证、权限控制、参数校验

## 📁 项目结构

```
Paintbrush/
├── Paintbrush-Backend/         # Spring Boot 后端
│   ├── controller/             # 控制器层
│   ├── service/                # 业务层
│   ├── mapper/                 # 数据访问层
│   ├── pojo/                   # 实体类
│   └── resources/              # 配置文件
├── Paintbrush-UserFrontend/    # Vue 3 前端
│   ├── src/api/                # API接口
│   ├── src/views/              # 页面组件
│   ├── src/stores/             # 状态管理
│   └── src/router/             # 路由配置
├── Paintbrush.sql              # 数据库脚本
└── Paintbrush接口文档.md        # API文档
```

## 🛠️ 环境要求

| 环境 | 版本 |
|-----|------|
| JDK | 17+ |
| Node.js | 16+ |
| MySQL | 8.0+ |
| Redis | 3.2+ |
| Maven | 3.8+ |

## 🚀 快速开始

### 1. 数据库配置

```bash
# 创建数据库
CREATE DATABASE Paintbrush CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

# 导入数据
mysql -u root -p Paintbrush < Paintbrush.sql

# 启动Redis
redis-server
```

### 2. 后端启动

```bash
cd Paintbrush-Backend
# 修改 application.yml 中的数据库配置
mvn spring-boot:run
```

### 3. 前端启动

```bash
cd Paintbrush-UserFrontend
npm install
npm run dev
```

## 🌐 访问地址

- 前端：http://localhost:5173
- 后端：http://localhost:8080
- 文档：`Paintbrush接口文档.md`

## 📊 数据库设计

| 表名 | 说明 | 核心字段 |
|-----|------|---------|
| user | 用户表 | username, password, nickname, avatar |
| picture | 图片表 | picture_name, painter, link, category_id |
| category | 分类表 | category_name, category_alias |

## 📈 扩展计划

- [ ] 图片收藏和评论
- [ ] 用户关注系统
- [ ] 消息通知
- [ ] 云存储集成
- [ ] Docker部署

## 📄 开源协议

本项目仅供学习和研究使用。

## 👨‍💻 作者信息

- **开发者**: 浅暮
- **Bilibili**: @浅暮QVQ
- **邮箱**: 2924180200@qq.com
- **项目地址**: https://gitee.com/qianmu_jun/Paintbrush

---

<div align="center">
  <p>⭐ 如果这个项目对你有帮助，请给它一个 Star！</p>
</div>