Skip to content

ADR 008 - Slide S3 Storage

  • Date: 2026-04-01
  • Status: Active

Context

This decision defines the S3 bucket and object-key conventions for slide uploads and converted Deep Zoom output.

Decision

Each tenant receives two buckets:

  • tenant-{tenantId}-slide-upload
  • tenant-{tenantId}-slide-workspace

Object keys use this convention:

{lab department}/cases/{case identifier}/{file name without extension}/{file}

Example for an unassigned CMU-1.svs upload:

default/cases/default/CMU-1/CMU-1.svs

Converted DZI output is written beside the source structure in a dzi folder:

default/cases/default/CMU-1/dzi/CMU-1.dzi
default/cases/default/CMU-1/dzi/CMU-1_files/{tiles here}

Rationale

Separate buckets per tenant simplify security boundaries, while the object-key convention leaves room for richer case metadata later.