ホームステージング機能（Homestaging）

概要

ユーザー（不動産事業者の担当者）が現場で撮影した室内写真をアップロードし、スタイル・間取り・部屋タイプ・居住人数などを 設定して、家具や装飾が配置されたホームステージング済みの室内画像をAIで生成する機能。 空室の物件を魅力的に見せるための営業・販促素材を、実際に家具を搬入することなく作成できる。

• 1件 = 1つの仕上げ案件。入力画像ごとに Homestaging レコードを作成し、一覧で管理する。
• 画面はモバイル版（/v）のみ。PC版（/h）には画面を持たない（PC版/モバイル版 参照。意図的な未対応）。
• 生成エンジンは Google Gemini（@google/genai）。
• 生成した画像は共有・複製でき、一覧非表示にもできる。
• 生成のたびに 画像生成数（GenerationLog）が記録される。

生成フロー（ライフサイクル）

生成への入力

生成処理（actions/homestaging/generate-image）に渡される入力は以下。スタイル・部屋タイプは マスタから選択し、それぞれが持つAIへの指示（instructions）が生成に反映される。

関連する画面

apps/user（モバイル版 /v）

• /v/homestagings — 一覧（検索フォーム付き）
• /v/homestagings/new — 新規作成（入力画像アップロード）
• /v/homestagings/[homestagingId] — 詳細（生成実行・共有・複製・一覧表示切替）
• /v/homestagings/[homestagingId]/edit/name — 名前の編集
• /v/homestagings/[homestagingId]/edit/details — 詳細（居住人数など）の編集
• /v/homestagings/[homestagingId]/edit/floor-plans — 間取りの編集
• /v/homestagings/[homestagingId]/edit/styles — スタイルの編集

関連データモデル

マスタ管理（スタイル・部屋タイプ）

スタイル（HomestagingStyle）・部屋タイプ（HomestagingRoomKind）は organizationId を持ち（null=全組織共通／値あり=組織独自）、管理者の種別で扱える範囲が分かれる。

実装：apps/system-manager/actions/homestaging-style/・homestaging-room-kind/、 apps/organization-manager/actions/homestaging-style/（一覧は organizationId = 自組織 で絞り込み）。 生成時はスタイル/部屋タイプの instructions が指示として使われる。

主要な実装（参照）

• 作成：apps/user/actions/homestaging/create-homestaging.ts — inputImageUri を受け取りレコード作成（入力画像はクライアントから S3 へ直接アップロード。2026/06/10 セッション）
• 生成：apps/user/actions/homestaging/generate-image/ — Gemini を呼び出し画像生成（generate-image-with-gemini）
• 取得/一覧/更新/削除：apps/user/actions/homestaging/{get,list,update,delete}-homestaging.ts
• 間取り画像アップロード：apps/user/actions/homestaging/upload-homestaging-floor-plan-image.ts
• 画面：apps/user/app/(vertical)/v/homestagings/
• API：apps/user/app/api/homestagings/

開発セッション履歴

本ドキュメントは既存実装をもとに遡及作成したもの。今後の改修はセッション単位で sessions/ 配下に追記する。

• 2026/06/10 各画像生成フォームの presigned URL 直アップロード化（横展開） — 入力画像をクライアントから S3 へ直接アップロードし VPC/ECS/WAF コストを削減（ホームステージング含む5機能の横断改修）