🖼️ アバターブロック
アバターブロックは、ドメイン全体(例:ユーザープロフィール、組織)でアバターオブジェクトを操作するための再利用可能なビルディングブロックを提供します。APIレスポンス用にアバターオブジェクトを正規化し、署名付きURLを介してクラウドストレージ内のファイルを維持することに焦点を当てています。
🎯 概要
アバターブロックは以下の目的で設計されています:
- アバターオブジェクトを正規化 - ストレージの
objectIdを署名付きダウンロードURLに変換 - ファイルストレージドライバーと統合 - 安全なURL生成のため
- クリーンアップを処理 - アバターが置き換えられたときに孤立したファイルを防ぐ
📦 ブロックタイプ
🔍 スキーマ
アバターデータのバリデーション用のJSON Schema定義:
- avatarSchema: 基本アバターオブジェクトのバリデーション(objectId、type)
🔧 ブロック
アバター操作のための純粋なビジネスロジック関数:
- normalizeAvatarOfOwner: 単一の所有者のアバターを署名付きURLに正規化
- normalizeAvatarsOfOwners: 所有者のアバターリストを正規化
- deleteAvatarIfReplaced: 新しいアバターが置き換えたときに古いアバターファイルを削除
🔗 関連ドキュメント
- ファイルストレージブロック - 署名付きURL生成とファイル操作
- ユーザーブロック - アバターを使用するユーザープロフィール
- 組織ブロック - ロゴ/アバターのようなメディアを持つ組織