# dam-platform-service

**Repository Path**: xiyouit/dam-platform-service

## Basic Information

- **Project Name**: dam-platform-service
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-07
- **Last Updated**: 2026-09-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 数字资产管理平台 (Dam Platform Service)

基于 Spring Boot 3 + MyBatis-Plus + MySQL + MinIO + Spring AI + Elasticsearch 构建的企业级数字资产管理平台。

## 📋 功能特性

### 核心功能
- ✅ **数字资产管理** - 支持多格式文件上传、分类、标签管理
- ✅ **标签体系** - 多级树形标签结构，支持灵活分类
- ✅ **内容发布** - 从数据资产自动生成发布内容
- ✅ **仪表盘** - 实时数据统计与分析可视化
- ✅ **权限管控** - RBAC 角色权限管理
- ✅ **对象存储** - MinIO 分布式文件存储
- ⚙️ **全文检索** - Elasticsearch 集成（待启用）
- ⚙️ **AI 集成** - Spring AI 智能助手支持（待配置）

### 技术栈
| 技术 | 版本 | 说明 |
|------|------|------|
| Java | 21 | 编程语言 |
| Spring Boot | 3.2.1 | Web 框架 |
| MyBatis-Plus | 3.5.5 | ORM 框架 |
| MySQL | 8.0+ | 关系数据库 |
| MinIO | 8.5.8 | 对象存储 |
| Spring AI | 1.0.0-M5 | AI 能力集成 |
| Hutool | 5.8.25 | 工具集 |
| Caffeine | 3.1.8 | 本地缓存 |

## 🚀 快速开始

### 环境要求
- JDK 21+
- MySQL 8.0+
- MinIO (可选)
- Elasticsearch 8.11+

### 安装步骤

#### 1. 克隆项目
```bash
git clone https://github.com/your-org/dam-platform-service.git
cd dam-platform-service
```

#### 2. 数据库初始化
```bash
# 使用数据库工具执行 schema.sql
mysql -u root -p < src/main/resources/schema.sql
```

#### 3. 配置应用参数
编辑 `src/main/resources/application-dev.yml`:
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/dam_platform?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai
    username: root
    password: your_password
    
  data:
    elasticsearch:
      uris: http://localhost:9200
      username: elastic
      password: your_elastic_password
      
  ai:
    openai:
      api-key: sk-your-api-key
```

#### 4. 启动服务
```bash
# Maven 方式
mvn clean compile
mvn spring-boot:run

# 或直接运行 Application.java
```

访问地址：http://localhost:8080

## 📊 API 接口说明

### 资产管理
- `POST /api/assets/upload` - 上传文件
- `GET /api/assets/page` - 分页查询资产
- `GET /api/assets/{id}/download` - 下载文件
- `DELETE /api/assets/{id}` - 删除资产
- `POST /api/assets/{id}/tags` - 关联标签

### 标签管理
- `GET /api/tags/tree` - 获取树形标签结构
- `POST /api/tags` - 创建标签
- `PUT /api/tags/{id}` - 更新标签
- `DELETE /api/tags/{id}` - 删除标签

### 内容发布
- `GET /api/publish/page` - 分页查询发布内容
- `POST /api/publish` - 创建发布内容
- `PUT /api/publish/{id}` - 更新发布内容
- `DELETE /api/publish/{id}` - 删除发布内容

### 工作台
- `GET /api/dashboard/overview` - 获取工作台概览
- `GET /api/dashboard/publish-completion` - 发布信息完成情况分析

## 🔧 项目结构

```
dam-platform-service/
├── src/main/java/com/dam/platform/
│   ├── common/                 # 通用模块
│   │   ├── config/            # 配置类
│   │   ├── dao/             # 通用 Mapper
│   │   ├── dto/             # DTO 对象
│   │   ├── entity/          # 实体基类
│   │   ├── exception/       # 异常处理
│   │   ├── result/          # 统一响应
│   │   └── service/         # 通用服务
│   │
│   ├── asset/                # 资产模块
│   │   ├── controller/      # 控制器
│   │   ├── dao/           # Mapper 层
│   │   ├── entity/        # 实体类
│   │   └── service/       # 服务层
│   │
│   ├── tag/                  # 标签模块
│   │   ├── controller/
│   │   ├── dao/
│   │   ├── entity/
│   │   └── service/
│   │
│   ├── publish/              # 发布内容模块
│   │   ├── controller/
│   │   ├── dao/
│   │   ├── entity/
│   │   └── service/
│   │
│   ├── dashboard/            # 工作台模块
│   │   └── controller/
│   │
│   └── Application.java     # 启动类
│
├── src/main/resources/
│   ├── application.yml      # 主配置
│   ├── application-dev.yml  # 开发环境配置
│   └── schema.sql          # 数据库脚本
│
└── pom.xml                 # Maven 配置
```

## 🛠️ 常用命令

```bash
# 编译
mvn clean compile

# 运行测试
mvn test

# 打包
mvn clean package -DskipTests

# 运行 Jar 包
java -jar target/dam-platform-service-1.0.0-SNAPSHOT.jar
```

## 📝 注意事项

1. **MinIO 配置**: 如果未配置 MinIO，文件将使用相对路径存储
2. **Elasticsearch**: 如不需要全文检索功能，可注释相关配置
3. **Spring AI**: 需配置 OpenAI API Key 才能使用 AI 功能
4. **安全**: 生产环境请修改默认密码和 API 密钥

## 📄 License

MIT License

---

**技术支持**: [联系作者](mailto:example@example.com)