Data: 2025-01-16
Versão: 1.0.0
Status: ✅ Implementado
O Sistema de Mídia do Arah fornece infraestrutura completa para armazenamento, processamento e gerenciamento de mídias (imagens, vídeos, áudios, documentos). O sistema foi projetado para ser seguro, escalável e preparado para migração para cloud storage quando necessário.
Valores Mantidos: Mídias servem para documentar território e fortalecer comunidade, não para capturar atenção.
┌─────────────────────────────────────────────────────────┐
│ API Layer │
│ MediaController (Endpoints REST) │
└─────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ Application Layer │
│ MediaService (Lógica de negócio) │
│ - Upload/Download │
│ - Associação a entidades │
│ - Soft delete │
└─────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ Infrastructure Layer │
│ - IMediaStorageService (LocalMediaStorageService) │
│ - IMediaProcessingService (LocalMediaProcessingService)│
│ - IMediaValidator (MediaValidator) │
│ - IMediaAssetRepository (PostgresMediaAssetRepository) │
│ - IMediaAttachmentRepository (PostgresMediaAttachment) │
└─────────────────────────────────────────────────────────┘
↓
┌─────────────────────────────────────────────────────────┐
│ Domain Layer │
│ - MediaAsset (entidade) │
│ - MediaAttachment (entidade) │
│ - MediaType (enum) │
│ - MediaOwnerType (enum) │
└─────────────────────────────────────────────────────────┘
Representa um arquivo de mídia armazenado no sistema.
Propriedades:
Id (Guid): Identificador únicoUploadedByUserId (Guid): ID do usuário que fez uploadMediaType (MediaType): Tipo de mídia (Image, Video, Audio, Document)MimeType (string): Tipo MIME do arquivo (ex: "image/jpeg")StorageKey (string): Chave única no sistema de armazenamentoSizeBytes (long): Tamanho do arquivo em bytesWidthPx (int?): Largura em pixels (apenas para imagens/vídeos)HeightPx (int?): Altura em pixels (apenas para imagens/vídeos)Checksum (string): Checksum SHA-256 para verificação de integridadeCreatedAtUtc (DateTime): Data/hora de criaçãoDeletedByUserId (Guid?): ID do usuário que deletou (soft delete)DeletedAtUtc (DateTime?): Data/hora de exclusão (soft delete)Métodos:
Delete(Guid deletedByUserId, DateTime deletedAtUtc): Soft deleteRestore(): Restaura mídia deletadaRepresenta a associação de uma mídia a uma entidade do sistema.
Propriedades:
Id (Guid): Identificador únicoMediaAssetId (Guid): ID da mídia associadaOwnerType (MediaOwnerType): Tipo da entidade proprietáriaOwnerId (Guid): ID da entidade proprietáriaDisplayOrder (int): Ordem de exibição (quando múltiplas mídias)CreatedAtUtc (DateTime): Data/hora de criaçãoTipos de Owner:
User: Avatar/foto de perfilPost: Imagens em postsEvent: Imagens em eventosStoreItem: Imagens em anúncios (marketplace)ChatMessage: Imagens em mensagensTipo MIME:
appsettings.jsonTamanho de Arquivo:
MediaStorageOptionsDimensões de Imagem:
Path Traversal:
Checksum:
Permissões:
Rate Limiting:
POST /api/v1/media/upload
Content-Type: multipart/form-data
Authorization: Bearer {token}
file: {arquivo}
Resposta:
{
"id": "guid",
"uploadedByUserId": "guid",
"mediaType": "IMAGE",
"mimeType": "image/jpeg",
"storageKey": "images/2025/01/guid.jpg",
"sizeBytes": 1024,
"widthPx": 1920,
"heightPx": 1080,
"checksum": "abc123...",
"createdAtUtc": "2025-01-16T10:00:00Z",
"isDeleted": false
}
GET /api/v1/media/{id}
Resposta: Arquivo binário com Content-Type apropriado
GET /api/v1/media/{id}/info
Resposta: MediaAssetResponse (JSON)
DELETE /api/v1/media/{id}
Authorization: Bearer {token}
Resposta: 204 No Content (apenas criador pode deletar)
Para usar S3, configure:
{
"MediaStorage": {
"Provider": "S3",
"S3BucketName": "meu-bucket",
"S3Region": "us-east-1",
"S3AccessKeyId": "AKIA...",
"S3SecretAccessKey": "...",
"S3Prefix": "media"
}
}
Características:
Para usar Azure Blob Storage, configure:
{
"MediaStorage": {
"Provider": "AzureBlob",
"AzureBlobConnectionString": "DefaultEndpointsProtocol=https;AccountName=...",
"AzureBlobContainerName": "media",
"AzureBlobPrefix": "media"
}
}
Características:
O sistema implementa cache de URLs de mídia usando IDistributedCache:
ConnectionStrings:Redis estiver configuradoUrlCacheExpiration)Configuração:
{
"MediaStorage": {
"EnableUrlCache": true,
"UrlCacheExpiration": "24:00:00"
},
"ConnectionStrings": {
"Redis": "localhost:6379"
}
}
{
"MediaStorage": {
"Provider": "Local",
"LocalPath": "wwwroot/media",
"MaxImageSizeBytes": 10485760,
"MaxVideoSizeBytes": 52428800,
"MaxImageWidthPx": 4000,
"MaxImageHeightPx": 4000,
"AutoResizeMaxWidthPx": 1920,
"AutoResizeMaxHeightPx": 1920,
"EnableUrlCache": true,
"UrlCacheExpiration": "24:00:00",
"EnableAsyncProcessing": true,
"AsyncProcessingThresholdBytes": 5242880,
"S3BucketName": null,
"S3Region": "us-east-1",
"S3AccessKeyId": null,
"S3SecretAccessKey": null,
"S3Prefix": null,
"AzureBlobConnectionString": null,
"AzureBlobContainerName": null,
"AzureBlobPrefix": null
}
}
wwwroot/
media/
images/
2025/
01/
{guid}.jpg
{guid}.png
videos/
2025/
01/
{guid}.mp4
Quando uma imagem é uploadada:
Para imagens grandes (> 5MB), o sistema pode processar de forma assíncrona:
AsyncMediaProcessingBackgroundService processa a imagemConfiguração: EnableAsyncProcessing: true em MediaStorageOptions
✅ Todas as pendências foram resolvidas!
20260120120000_AddMediaSystem.cs)O sistema usa MediaStorageFactory para criar instâncias de IMediaStorageService baseado na configuração:
var factory = serviceProvider.GetRequiredService<MediaStorageFactory>();
var storageService = factory.CreateStorageService();
A factory:
CachedMediaStorageService)Última Atualização: 2025-01-16
Funcionalidades Opcionais: ✅ 100% Implementado (Cloud Storage, Cache, Processamento Assíncrono, Testes de Performance)