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