Media Domain
Understand AutoCore media assets, processing states, variants, ownership, storage, and failure boundaries.
MediaAsset is the metadata and ownership record for a stored object. It can be
associated with a listing or another supported product surface. The binary
object is behind a storage-provider abstraction; the database record is not the
binary itself.
Asset and variant model
An asset records type, processing status, storage key, optional public URL,
format, dimensions, duration, size, alt text, checksum, position, cover status,
and a variant manifest. Supported asset types include image, video, panorama,
3D model, document, and expertise report. The currently implemented image path
uses Sharp to auto-rotate, strip metadata, preserve a cleaned original, and
generate WebP thumb, card, detail, and hero variants without upscaling.
Processing states
| State | Meaning |
|---|---|
pending | Record exists and processing has not completed. |
processing | A processing operation is underway. |
ready | The asset can be used by supported consumers. |
failed | Processing failed and an error summary is retained for review/retry. |
Ownership and failure
The owner user is required. Listing attachment is optional, and dealer logo/cover flows use the same media and variant boundary with dealer-scoped authorization. Replacing dealer media soft-deletes or purges the previous asset through the provider abstraction rather than exposing raw storage paths. An external media provider is not claimed active by default; local and object-storage providers are configuration choices.