# ruoyi-gallery

**Repository Path**: helloqidi/ruoyi-gallery

## Basic Information

- **Project Name**: ruoyi-gallery
- **Description**: 若依画廊，可用于家庭等团体、个人的私密相册，在移动端H5上传图片和视频，并可选择共享给其他用户。
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-10-23
- **Last Updated**: 2025-12-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## 一、系统简介
这个系统的名称是“若依画廊”，可用于家庭等团体、个人的私密相册，实现的核心需求是：用户在移动端H5页面上传图片和视频形成画廊记录，并可共享给其他用户查看；管理员在管理后端可管理用户、管理画廊记录。

**有用的话请鼓励❤️下作者，右上角☝️watch、star、fork三连点🙏🙏🙏一波**

## 二、系统设计理念
### 1.架构简单与高可维护性、安全
- 使用前后端一体的开发方式，弃用Redis与前后端分离，做到极简化部署
- 移动端不使用微信小程序，而是采用H5，减少部署成本与平台依赖
- 采用OSS云存储，降低应用服务器带宽要求，也可无限扩展
- 基于若依开源框架，可随它的安全升级而升级
- 核心技术栈：Spring Boot + MyBatis + Thymeleaf + X File Storage(OSS云存储)

### 2.AI编程辅助
- 增加了通义灵码（.lingma目录）、Trae（.trae目录）的项目工程规则，可快速实现AI辅助编程
- 本项目大量使用了AI辅助编程

## 三、主要功能
### （一）管理后台PC端功能
1.  用户管理：用户是系统操作者，该功能主要完成系统用户配置。
2.  部门管理：配置系统组织机构，树结构展现支持数据权限。
3.  菜单管理：配置系统菜单，操作权限，按钮权限标识等。
4.  角色管理：角色菜单权限分配、设置角色按机构进行数据范围权限划分。
5.  字典管理：对系统中经常使用的一些较为固定的数据进行维护。
6.  画廊管理：对所有画廊记录进行维护。

### （二）移动端H5功能
#### 1. 登录：
- 账号+密码 登录
#### 2. 上传画廊图片记录：
- 可上传多张图片；
- 上传后，可再增加或删除图片；
- 可拖拽图片进行排序；
- 识别第一张图片的日期形成该画廊的记录日期，该记录日期可修改；
- 可录入描述文字；
- 可设置是否共享给其他用户
#### 3. 上传画廊视频记录:
- 可上传一个视频；
- 识别视频的日期形成该画廊的记录日期，该记录日期可修改；
- 可录入描述文字；
- 可设置是否共享给其他用户
#### 4. 编辑画廊图片记录：
- 可增加或删除图片；
- 可拖拽图片进行排序；
- 可修改记录日期；
- 可修改描述文字；
- 可删除整个画廊记录；
- 可设置是否共享给其他用户
#### 5. 编辑画廊视频记录：
- 可修改记录日期；
- 可修改描述文字；
- 可删除整个画廊记录
- 可设置是否共享给其他用户
#### 6. 用户的画廊记录列表：
- 把用户自己上传的和其他用户共享的画廊记录，按照记录日期由近到远来展示图片和视频记录；
- 列表中的画廊图片记录，最多显示9张缩略图；点击任意一张图片时，全屏展示该图片，左右滑动可展示该画廊图片记录的其他图片。
- 列表中的画廊视频记录，默认不播放；点击该视频时，全屏播放。

## 四、运行步骤
### （一）开发
1. 拷贝 application-example.yml 文件为 application.yml； 修改OSS文件存储的配置信息，目前集成的是七牛云存储，通过X File Storage可集成几乎所有本地存储、云存储，不限于阿里云 OSS、华为云 OBS、七牛云 Kodo、腾讯云 COS、百度云 BOS、又拍云 USS、MinIO、 Amazon S3等。
2. 修改 application-druid.yml 数据库地址账号信息； 执行sql/ ry_20250416.sql，日期随版本变化；执行 sql/gallery.sql 。
3. 启动RuoYiApplication.java

### （二）访问
```bash
# 默认账号密码
账号：admin
密码：admin123

# H5访问地址
地址：http://localhost

# 管理后台访问地址
地址：http://localhost/login2
```

## 五、系统截图
### 1.管理后台PC端
<table>
    <tr>
        <td><img src="./images/pc-login.png"/></td>
        <td><img src="./images/pc-home.png"/></td>
    </tr>
    <tr>
        <td><img src="./images/pc-auth.png"/></td>
        <td><img src="./images/pc-gallery.png"/></td>
    </tr>
    <tr>
        <td><img src="./images/pc-file.png"/></td>
    </tr>
</table>

### 2.移动端H5
<table>
    <tr>
        <td><img src="./images/h5-login.png"/></td>
        <td><img src="./images/h5-home.png"/></td>
        <td><img src="./images/h5-add.png"/></td>
    </tr>
    <tr>
        <td><img src="./images/h5-pic-add.png"/></td>
        <td><img src="./images/h5-video-add.png"/></td>
        <td><img src="./images/h5-pic-edit.png"/></td>
    </tr>
    <tr>
        <td><img src="./images/h5-pic-preview.png"/></td>
        <td><img src="./images/h5-search.png"/></td>
    </tr>
</table>

## 六、感谢以下开源项目
### 1.ruoyi/若依
[ruoyi](https://github.com/yangzongzhuan/RuoYi-fast "若依")

### 2.X File Storage
[x-file-storage](https://gitee.com/dromara/x-file-storage "x-file-storage")