Schema for physical storage locations (redundancy tracking).

Tracks where each file instance is physically stored. Each instance can have multiple locations for redundancy (1-5 copies across different buckets).

Redundancy Example

If storage_redundancy_copies = 2, each file instance will have 2 location records:

# Location 1: Backblaze B2
%FileLocation{
  path: "/uploads/018e3c4a-9f6b-7890-thumbnail.jpg",
  status: "active",
  priority: 0,
  file_instance_uuid: "...",
  bucket_uuid: "018e3c4a-1111-7890-abcd-ef1234567890"
}

# Location 2: Cloudflare R2
%FileLocation{
  path: "/uploads/018e3c4a-9f6b-7890-thumbnail.jpg",
  status: "active",
  priority: 0,
  file_instance_uuid: "...",
  bucket_uuid: "018e3c4a-2222-7890-abcd-ef1234567890"
}

Status Flow

• active - File is available at this location
• syncing - File is being uploaded/copied
• failed - Upload or sync failed
• deleted - File has been removed from this location

Fields

• path - Full path within the bucket
• status - Current state of this location
• priority - Retrieval priority (0 = lowest, higher = preferred)
• last_verified_at - Last health check timestamp
• file_instance_uuid - Which instance this location stores
• bucket_uuid - Which bucket this file is stored in

Examples

# Active location on local storage
%FileLocation{
  path: "/var/uploads/018e3c4a-9f6b-7890-large.jpg",
  status: "active",
  priority: 0,
  last_verified_at: ~N[2025-10-28 10:00:00],
  file_instance_uuid: "...",
  bucket_uuid: "018e3c4a-3333-7890-abcd-ef1234567890"
}

# Syncing to cloud backup
%FileLocation{
  path: "/uploads/018e3c4a-9f6b-7890-large.jpg",
  status: "syncing",
  priority: 0,
  file_instance_uuid: "...",
  bucket_uuid: "018e3c4a-4444-7890-abcd-ef1234567890"
}