go-clean-provider

name	go-clean-provider
description	Instruções para criar adaptadores de storage (NFS/S3) seguindo a Clean Architecture em Go.

O que eu faço

• Contratos e Interfaces: Oriento a implementação da interface StorageRepository definida em internal/domain/storage.go. Os métodos obrigatórios são: GetFilePath(ctx context.Context, fileID string) (string, error), SaveFile(ctx context.Context, fileID string, data []byte) error, DeleteFile(ctx context.Context, fileID string) error e ListFiles(ctx context.Context, prefix string) ([]domain.FileInfo, error).
• Tratamento de Erros: Exijo o uso dos tipos de erro do domínio: domain.ErrNotFound quando recurso não existe, domain.ErrInvalidInput para parâmetros inválidos e domain.ErrStorage para falhas de infraestrutura. Nunca retornar erros brutos de pacotes externos (como s3manager ou os) sem envolver nos tipos do domínio.
• Exemplo de Implementação:

  // internal/infrastructure/s3/provider.go
  package s3
  
  import (
      "context"
      "github.com/aws/aws-sdk-go/aws"
      "github.com/aws/aws-sdk-go/service/s3"
      "seuprojeto/internal/domain"
  )
  
  type S3Provider struct {
      client *s3.S3
      bucket string
  }
  
  func NewS3Provider(client *s3.S3, bucket string) *S3Provider {
      return &S3Provider{client: client, bucket: bucket}
  }
  
  func (p *S3Provider) GetFilePath(ctx context.Context, fileID string) (string, error) {
      _, err := p.client.HeadObjectWithContext(ctx, &s3.HeadObjectInput{
          Bucket: aws.String(p.bucket),
          Key:    aws.String(fileID),
      })
      if err != nil {
          if aerr, ok := err.(awserr.Error); ok && aerr.Code() == s3.ErrCodeNoSuchKey {
              return "", domain.ErrNotFound
          }
          return "", domain.ErrStorage.Wrap(err, "failed to check object existence")
      }
      return fileID, nil
  }
  
  func (p *S3Provider) SaveFile(ctx context.Context, fileID string, data []byte) error {
      _, err := p.client.PutObjectWithContext(ctx, &s3.PutObjectInput{
          Bucket: aws.String(p.bucket),
          Key:    aws.String(fileID),
          Body:   bytes.NewReader(data),
      })
      if err != nil {
          return domain.ErrStorage.Wrap(err, "failed to save file to S3")
      }
      return nil
  }