Files
photography/backend/internal/service/storage/storage.go
xujiang a2f2f66f88
Some checks failed
部署后端服务 / 🧪 测试后端 (push) Failing after 1m37s
部署后端服务 / 🚀 构建并部署 (push) Has been skipped
部署后端服务 / 🔄 回滚部署 (push) Has been skipped
refactor: 重构后端架构,采用 Go 风格四层设计模式
## 主要变更

### 🏗️ 架构重构
- 采用简洁的四层架构:API → Service → Repository → Model
- 遵循 Go 语言最佳实践和命名规范
- 实现依赖注入和接口导向设计
- 统一错误处理和响应格式

### 📁 目录结构优化
- 删除重复模块 (application/, domain/, infrastructure/ 等)
- 规范化命名 (使用 Go 风格的 snake_case)
- 清理无关文件 (package.json, node_modules/ 等)
- 新增规范化的测试目录结构

### 📚 文档系统
- 为每个模块创建详细的 CLAUDE.md 指导文件
- 包含开发规范、最佳实践和使用示例
- 支持模块化开发,缩短上下文长度

### 🔧 开发规范
- 统一接口命名规范 (UserServicer, PhotoRepositoryr)
- 标准化错误处理机制
- 完善的测试策略 (单元测试、集成测试、性能测试)
- 规范化的配置管理

### 🗂️ 新增文件
- cmd/server/ - 服务启动入口和配置
- internal/model/ - 数据模型层 (entity, dto, request)
- pkg/ - 共享工具包 (logger, response, validator)
- tests/ - 完整测试结构
- docs/ - API 文档和架构设计
- .gitignore - Git 忽略文件配置

### 🗑️ 清理内容
- 删除 Node.js 相关文件 (package.json, node_modules/)
- 移除重复的架构目录
- 清理临时文件和构建产物
- 删除重复的文档文件

## 影响
- 提高代码可维护性和可扩展性
- 统一开发规范,提升团队协作效率
- 优化项目结构,符合 Go 语言生态标准
- 完善文档体系,降低上手难度
2025-07-10 11:20:59 +08:00

218 lines
5.9 KiB
Go

package storage
import (
"context"
"fmt"
"io"
"mime/multipart"
"os"
"path/filepath"
"photography-backend/internal/config"
"go.uber.org/zap"
)
// UploadedFile 上传后的文件信息
type UploadedFile struct {
Filename string `json:"filename"`
OriginalURL string `json:"original_url"`
ThumbnailURL string `json:"thumbnail_url,omitempty"`
Size int64 `json:"size"`
MimeType string `json:"mime_type"`
}
// StorageService 存储服务接口
type StorageService interface {
UploadPhoto(ctx context.Context, file multipart.File, filename string) (*UploadedFile, error)
DeletePhoto(filename string) error
GetPhotoURL(filename string) string
GenerateThumbnail(ctx context.Context, filename string) error
}
// LocalStorageService 本地存储服务实现
type LocalStorageService struct {
config *config.Config
logger *zap.Logger
uploadDir string
baseURL string
}
// NewLocalStorageService 创建本地存储服务
func NewLocalStorageService(config *config.Config, logger *zap.Logger) *LocalStorageService {
uploadDir := config.Storage.Local.BasePath
if uploadDir == "" {
uploadDir = "./uploads"
}
baseURL := config.Storage.Local.BaseURL
if baseURL == "" {
baseURL = fmt.Sprintf("http://localhost:%d/uploads", config.App.Port)
}
// 确保上传目录存在
if err := os.MkdirAll(uploadDir, 0755); err != nil {
logger.Error("Failed to create upload directory", zap.Error(err))
}
// 创建子目录
dirs := []string{"photos", "thumbnails", "temp"}
for _, dir := range dirs {
dirPath := filepath.Join(uploadDir, dir)
if err := os.MkdirAll(dirPath, 0755); err != nil {
logger.Error("Failed to create subdirectory", zap.String("dir", dir), zap.Error(err))
}
}
return &LocalStorageService{
config: config,
logger: logger,
uploadDir: uploadDir,
baseURL: baseURL,
}
}
// UploadPhoto 上传照片
func (s *LocalStorageService) UploadPhoto(ctx context.Context, file multipart.File, filename string) (*UploadedFile, error) {
// 保存原图
photoPath := filepath.Join(s.uploadDir, "photos", filename)
out, err := os.Create(photoPath)
if err != nil {
s.logger.Error("Failed to create file", zap.String("path", photoPath), zap.Error(err))
return nil, err
}
defer out.Close()
// 重置文件指针
file.Seek(0, 0)
// 复制文件内容
size, err := io.Copy(out, file)
if err != nil {
s.logger.Error("Failed to copy file", zap.Error(err))
return nil, err
}
// 获取文件信息
_, err = out.Stat()
if err != nil {
s.logger.Error("Failed to get file info", zap.Error(err))
return nil, err
}
uploadedFile := &UploadedFile{
Filename: filename,
OriginalURL: s.GetPhotoURL(filename),
Size: size,
MimeType: s.getMimeType(filename),
}
s.logger.Info("Photo uploaded successfully",
zap.String("filename", filename),
zap.Int64("size", size))
return uploadedFile, nil
}
// DeletePhoto 删除照片
func (s *LocalStorageService) DeletePhoto(filename string) error {
// 删除原图
photoPath := filepath.Join(s.uploadDir, "photos", filename)
if err := os.Remove(photoPath); err != nil && !os.IsNotExist(err) {
s.logger.Error("Failed to delete photo", zap.String("path", photoPath), zap.Error(err))
return err
}
// 删除缩略图
thumbnailPath := filepath.Join(s.uploadDir, "thumbnails", filename)
if err := os.Remove(thumbnailPath); err != nil && !os.IsNotExist(err) {
s.logger.Warn("Failed to delete thumbnail", zap.String("path", thumbnailPath), zap.Error(err))
}
s.logger.Info("Photo deleted successfully", zap.String("filename", filename))
return nil
}
// GetPhotoURL 获取照片 URL
func (s *LocalStorageService) GetPhotoURL(filename string) string {
return fmt.Sprintf("%s/photos/%s", s.baseURL, filename)
}
// GetThumbnailURL 获取缩略图 URL
func (s *LocalStorageService) GetThumbnailURL(filename string) string {
return fmt.Sprintf("%s/thumbnails/%s", s.baseURL, filename)
}
// GenerateThumbnail 生成缩略图
func (s *LocalStorageService) GenerateThumbnail(ctx context.Context, filename string) error {
// TODO: 实现缩略图生成逻辑
// 这里需要使用图像处理库,如 imaging 或 bild
s.logger.Info("Generating thumbnail", zap.String("filename", filename))
// 示例实现 - 实际项目中应该使用图像处理库
photoPath := filepath.Join(s.uploadDir, "photos", filename)
thumbnailPath := filepath.Join(s.uploadDir, "thumbnails", filename)
// 检查原图是否存在
if _, err := os.Stat(photoPath); os.IsNotExist(err) {
return fmt.Errorf("original photo not found: %s", filename)
}
// 这里应该实现实际的缩略图生成逻辑
// 暂时复制原图作为缩略图
sourceFile, err := os.Open(photoPath)
if err != nil {
return err
}
defer sourceFile.Close()
destFile, err := os.Create(thumbnailPath)
if err != nil {
return err
}
defer destFile.Close()
_, err = io.Copy(destFile, sourceFile)
if err != nil {
return err
}
s.logger.Info("Thumbnail generated successfully", zap.String("filename", filename))
return nil
}
// getMimeType 根据文件扩展名获取 MIME 类型
func (s *LocalStorageService) getMimeType(filename string) string {
ext := filepath.Ext(filename)
switch ext {
case ".jpg", ".jpeg":
return "image/jpeg"
case ".png":
return "image/png"
case ".gif":
return "image/gif"
case ".webp":
return "image/webp"
case ".bmp":
return "image/bmp"
default:
return "application/octet-stream"
}
}
// NewStorageService 根据配置创建存储服务
func NewStorageService(config *config.Config, logger *zap.Logger) StorageService {
switch config.Storage.Type {
case "s3":
// TODO: 实现 S3 存储服务
logger.Warn("S3 storage not implemented yet, using local storage")
return NewLocalStorageService(config, logger)
case "minio":
// TODO: 实现 MinIO 存储服务
logger.Warn("MinIO storage not implemented yet, using local storage")
return NewLocalStorageService(config, logger)
default:
return NewLocalStorageService(config, logger)
}
}