# CloudImage素材图库

**Repository Path**: h00ngyee/cloud-images

## Basic Information

- **Project Name**: CloudImage素材图库
- **Description**: 项目介绍：
1)所有用户都可以在平台公开上传和检索图片素材，快速找到需要的图片。可用作表情包网站、设计素材网站、壁纸网站等；
2)管理员可以上传、审核和管理图片，并对系统内的图片进行分析；
3)对于个人用户，可将图片上传至私有空间进行批量管理、检索、编辑和分析，用作个人相册、作品集等；
4)对于企业，可开通团队空间并邀请成员，共享图片并实时协同编辑图片，可用于提供商业服务，如企业活动相册等；
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-08
- **Last Updated**: 2025-12-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CloudImage

CloudImage 是一个云端图像管理平台，提供图像存储、编辑、分析及分享等功能。用户可以创建空间（Space），上传和管理图片，并进行图像搜索、色彩分析、图片扩展等高级操作。系统支持多用户协作，具备完善的权限管理体系。

## 功能特性

- **图像管理**：支持图片上传、删除、编辑、批量操作，以及图片信息维护。
- **空间管理**：用户可创建多个空间，管理空间容量、成员权限等。
- **权限控制**：基于角色的权限管理（如管理员、普通用户等），支持细粒度权限控制（上传、编辑、删除等）。
- **图像分析**：提供图像分类、标签、尺寸、色彩等维度的统计分析功能。
- **图像处理**：集成阿里云 AI 图像扩展能力，支持智能外扩画布。
- **图像搜索**：支持基于图像 URL 的搜索和色彩匹配搜索。
- **实时协作**：通过 WebSocket 支持图片编辑实时协作功能。
- **分布式架构**：基于 ShardingSphere 的图片数据分片管理，支持大规模数据存储。

## 技术栈

- 后端：Spring Boot + MyBatis Plus + ShardingSphere + Redis + Sa-Token + WebSocket + Disruptor
- 前端：Vue 3 + Vite + TypeScript + Axios
- 图像处理：阿里云 AI API
- 文件存储：腾讯云 COS
- 构建工具：Maven

## 模块结构

- **Controller 层**：提供 RESTful API 接口，处理用户请求。
- **Service 层**：业务逻辑处理，包括图片、空间、用户、权限等核心服务。
- **Mapper 层**：基于 MyBatis Plus 的数据库访问层。
- **Model 层**：实体类与 DTO，包括 VO、请求/响应模型等。
- **Manager 层**：业务组件，如 COS 文件管理、权限管理、WebSocket 管理等。
- **Utils 工具类**：如颜色相似度计算、Redis 操作等。

## 快速启动

1. **数据库准备**：执行 SQL 脚本创建相应表（user、space、picture、space_user）。
2. **配置 COS**：在 `application.yml` 中配置腾讯云 COS 的 SecretId、SecretKey、Bucket 等信息。
3. **启动后端服务**：运行 `CloudImageApplication.java` 启动 Spring Boot 服务。
4. **启动前端**：进入 `CloudImage-frontend` 目录，运行 `npm run dev` 启动开发服务器。

## 使用说明

- **用户管理**：注册、登录、权限控制。
- **空间管理**：创建、编辑、删除空间，设置空间容量和成员权限。
- **图片管理**：上传、删除、编辑图片，支持批量操作。
- **图像分析**：查看空间内图片的分类、标签、尺寸等统计信息。
- **图像扩展**：使用阿里云 AI 接口进行图像外扩。
- **图像搜索**：通过图片 URL 或色彩匹配搜索相似图片。
- **实时协作**：多人同时编辑同一张图片，实时同步编辑状态。

## 扩展性与部署

- 支持横向扩展，可通过增加服务节点提升并发处理能力。
- 图片数据采用分片存储，支持 PB 级图像数据管理。
- 可部署在本地服务器、私有云或公有云平台。

## 安全性

- 使用 Sa-Token 实现用户认证与权限控制。
- 所有敏感操作均需权限验证。
- 图片上传支持格式校验、大小限制、内容审核。
- 前端与后端采用 HTTPS 加密通信。

## 贡献指南

欢迎贡献代码，请遵循以下流程：

1. Fork 项目并创建新分支。
2. 修改代码并编写单元测试。
3. 提交 PR 并等待审核。
4. 合并代码至主分支。

## 协议

本项目采用 MIT 协议，请在使用时保留原始版权声明。