hensei-api/app/jobs/download_character_images_job.rb
Justin Edmund deb5cfddb2 add character creation + image download API
- validate granblue_id via HEAD request to GBF CDN
- create characters with editor role check (role >= 7)
- async image download job with Redis status polling
- download_status endpoint for progress tracking
2025-12-01 00:48:40 -08:00

87 lines
2.8 KiB
Ruby

# frozen_string_literal: true
# Background job for downloading character images from Granblue servers to S3.
# Stores progress in Redis for status polling.
#
# @example Enqueue a download job
# job = DownloadCharacterImagesJob.perform_later(character.id)
# # Poll status with: DownloadCharacterImagesJob.status(character.id)
class DownloadCharacterImagesJob < ApplicationJob
queue_as :downloads
retry_on StandardError, wait: :exponentially_longer, attempts: 3
discard_on ActiveRecord::RecordNotFound do |job, _error|
character_id = job.arguments.first
Rails.logger.error "[DownloadCharacterImages] Character #{character_id} not found"
update_status(character_id, 'failed', error: 'Character not found')
end
# Status keys for Redis storage
REDIS_KEY_PREFIX = 'character_image_download'
STATUS_TTL = 1.hour.to_i
class << self
# Get the current status of a download job for a character
#
# @param character_id [String] UUID of the character
# @return [Hash] Status hash with :status, :progress, :images_downloaded, :images_total, :error
def status(character_id)
data = redis.get(redis_key(character_id))
return { status: 'not_found' } unless data
JSON.parse(data, symbolize_names: true)
end
def redis_key(character_id)
"#{REDIS_KEY_PREFIX}:#{character_id}"
end
def redis
@redis ||= Redis.new(url: ENV.fetch('REDIS_URL', 'redis://localhost:6379/0'))
end
def update_status(character_id, status, **attrs)
data = { status: status, updated_at: Time.current.iso8601 }.merge(attrs)
redis.setex(redis_key(character_id), STATUS_TTL, data.to_json)
end
end
def perform(character_id, force: false, size: 'all')
Rails.logger.info "[DownloadCharacterImages] Starting download for character #{character_id}"
character = Character.find(character_id)
update_status(character_id, 'processing', progress: 0, images_downloaded: 0)
service = CharacterImageDownloadService.new(
character,
force: force,
size: size,
storage: :s3
)
result = service.download
if result.success?
Rails.logger.info "[DownloadCharacterImages] Completed for character #{character_id}"
update_status(
character_id,
'completed',
progress: 100,
images_downloaded: result.total,
images_total: result.total,
images: result.images
)
else
Rails.logger.error "[DownloadCharacterImages] Failed for character #{character_id}: #{result.error}"
update_status(character_id, 'failed', error: result.error)
raise StandardError, result.error # Trigger retry
end
end
private
def update_status(character_id, status, **attrs)
self.class.update_status(character_id, status, **attrs)
end
end