# 资源相关服务

> **最后更新**：2025-01-14

---

## 服务列表

### 1. [资源管理服务](./resource-service.md)

**职责**：素材资源的统一管理。

**核心功能**：

- 资源 CRUD
- 资源分类
- 资源搜索
- 资源标签

---

### 2. [附件管理服务](./attachment-service.md)

**职责**：文件附件的上传、存储、访问管理。

**核心功能**：

- 文件上传
- 文件下载
- 文件删除
- 文件元数据管理

---

### 3. [文件存储服务](./file-storage-service.md)

**职责**：对接对象存储（OSS/S3），提供统一的文件存储接口。

**核心功能**：

- 文件上传到云存储
- 生成访问 URL
- 文件删除
- 存储空间管理

---

## 服务依赖关系

```
resource-service (核心)
    └── attachment-service (附件)
            └── file-storage-service (云存储)
```

---

## 业务流程

### 文件上传流程

```
用户选择文件 → 上传到服务器 (attachment-service)
→ 转存到云存储 (file-storage-service)
→ 生成访问 URL → 创建资源记录 (resource-service)
→ 返回资源信息
```

### 文件访问流程

```
请求资源 URL → 验证权限 (resource-service)
→ 生成临时访问链接 (file-storage-service)
→ 返回文件内容
```

---

## 相关文档

- [API 设计规范](../../05-api-design.md)
- [文件存储配置](../../03-infrastructure.md)