tbianchini/shopit-back
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
a94ac7a473b00dfcc2c2235dcc52a7a9077c06cc
shopit-back/app/Domains/Attachable/documentacion/README.md
ncoronel e619c51ac9 Refactor attachment cropping functionality to support multiple variants 
- Introduced AttachmentCrop model to manage crop variants for attachments.
- Updated Attachment model to remove direct crop fields and establish relationships with AttachmentCrop.
- Modified AttachmentService to handle storing and updating multiple crop variants (desktop and mobile).
- Adjusted validation rules to accommodate new crop structure.
- Updated database migration to create attachment_crops table and migrate existing crop data.
- Refactored tests to ensure compatibility with the new cropping structure and validate multiple crop variants.
- Enhanced documentation to reflect changes in attachment handling and cropping capabilities.
2026-08-18 14:40:22 -03:00

1.9 KiB
Raw Blame History

Dominio Attachable

Propósito

Centraliza el almacenamiento y la metadata de archivos adjuntos. Acepta archivos subidos o contenido Base64, los persiste en S3 y registra su tipo, MIME, extensión, tamaño, nombre original y clave única. Para imágenes también permite guardar un original junto con variantes recortadas para desktop y mobile.

Componentes principales

  • Models/Attachment.php: representa un adjunto y genera URL temporales de acceso.
  • Models/AttachmentCrop.php: relaciona un original con su crop desktop o mobile y la imagen generada.
  • Services/AttachmentService.php: almacena, copia y elimina archivos, compensando en S3 si falla la escritura en base de datos.
  • Enums/AttachmentType.php: clasifica imágenes, videos, PDF, audio, documentos y otros archivos.
  • Exceptions/AttachmentStorageException.php: expresa fallos propios del almacenamiento.

Flujo principal

  1. El consumidor entrega un UploadedFile o una cadena Base64 y un directorio.
  2. El servicio valida el contenido, detecta MIME/extensión y genera una clave UUID.
  3. El archivo se guarda en el disco s3.
  4. Se crea el registro Attachment; ante error se elimina el objeto que había sido subido.

API y dependencias

No expone rutas HTTP propias. Lo consumen otros dominios, especialmente Catalog y Tenant. Depende de Laravel Storage, Symfony Mime y del modelo Attachment.

Consideraciones

  • El directorio no puede quedar vacío después de normalizarlo.
  • Cada eje del crop guarda start_percentage y end_percentage, cumpliendo 0 <= start < end <= 100.
  • attachment_crops guarda una fila por variante con los rangos horizontal/vertical y el attachment procesado.
  • Al eliminar el original mediante el servicio también se eliminan todas sus variantes recortadas.
  • La eliminación se considera fallida si S3 no confirma el borrado.
  • Las URL generadas son temporales; el vencimiento predeterminado es de 10 minutos.