Skip to content

eccimage

Version: v1 Scope: per-tenant+store Owning service: ecc-image-render-service

An eccimage record represents a static image asset that has been uploaded into the ECC rendering environment for a tenant. These images are not tied to a specific ESL or page; instead they are referenced by ECC models as graphical elements — logos, product photographs, promotional banners, decorative borders, and similar assets that appear in ECC-rendered label layouts.

The ID for an eccimage is derived from the image's original relative path using base32 lowercase encoding. This encoding scheme means that the same original_path always produces the same id, so re-uploading an updated version of an image at the same path naturally overwrites the existing eccimage record without requiring consumers to update their references.

The actual image data is stored in LFS under a content-addressed filename (the SHA-256 hash of the file contents), enabling deduplication across tenants: identical image bytes from different paths share the same LFS object.

ID pattern

t/{tenantid}/s/{storeid}/eccimages/{imageid}

  • t/{tenantid} — tenant namespace
  • s/{storeid} — store within the tenant
  • eccimages/{imageid} — where imageid is the base32 lowercase encoding of original_path

Example: 

original_path = "images/logos/brand_a.png"
imageid       = base32lowercase("images/logos/brand_a.png")
full id       = t/10001/s/S001/eccimages/aezd...

Schema

Field Type Description
id string Primary ID. Derived from original_path via base32 lowercase encoding so that the same path always maps to the same ID
original_path string The relative path as it was uploaded or referenced by ECC models. Examples: images/logos/brand_a.png, promo/banner.jpg. This is the stable reference that model definitions use; it does not change when the image is updated with new content
file_path string LFS path to the image file. The filename is the SHA-256 hex digest of the file content, enabling deduplication. Format: ecc/t/{tenantid}/images/{sha256}.{ext}

Consumed by

Service Why
ecc-image-render-service Resolves original_path references from ECC model definitions to LFS image data during rendering
  • eccmodel — the model definition that references eccimage records by their original_path
  • eccparameters — the per-store global parameters singleton; provides rendering context alongside the model
  • ecceslimage — the ESL-page-specific rendered output that ecc-image-render-service produces using eccimage assets