画像キレイ機能（Refinement）

物件写真の明るさ・色味・歪みなどを補正し、内容を変えずに“キレイ”に見せる生成タイプ。複数画像をグループ単位でまとめて一括処理する。

生成タイプユーザー画面 / PC版(/h) 専用グループ構造（唯一）生成エンジン: Google Gemini

概要

物件写真の明るさ・色味・歪みなどを補正し、写真を“キレイ”に見せる機能。家具消しやホームステージングと異なり、 写真の内容（写っているもの）は変更しない。複数の画像をグループにまとめ、グループ単位でまとめて処理する点が最大の特徴。

グループ＝一括処理用の画像の束。1物件の写真一式を1グループにまとめる使い方が基本（用語: グループ）。
画面はPC版（/h）のみ。9種の生成タイプ中、PC版に画面を持つのは本機能のみ（他はモバイル版/v 専用。PC版/モバイル版参照）。
生成入力は入力画像＋指示のみとシンプル。指示は AiInstruction(kind=Refinement) の共通プロンプト由来で、スタイル等のマスタは持たない。
生成エンジンは Google Gemini（@google/genai）。
生成のたびに画像生成数（GenerationLog）が記録される。

データ構造（グループと画像）

グループに複数の Refinement（個々の画像）が属する。生成はグループ詳細画面の generation-starter から実行し、グループ内の画像をまとめて補正する。

関連する画面

apps/user（PC版 /h）

/h/refinement-groups — グループ一覧（検索フォーム付き）
/h/refinement-groups/new — 新規グループ作成（画像を投入）
/h/refinement-groups/[refinementGroupId] — グループ詳細（画像一覧・生成実行・一覧表示切替）
/h/refinement-groups/[refinementGroupId]/images — グループへ画像を追加
/h/refinement-groups/[refinementGroupId]/edit — グループ名などの編集

関連データモデル

RefinementGroup

prisma/schema/refinement-group.prisma

name? グループ名
isUnlisted 一覧非表示
→ refinements（1:N）

Refinement

prisma/schema/refinement.prisma

refinementGroupId? 所属グループ
inputImageUri 入力画像
outputImageUri? 補正結果
instructions? 生成時の指示

AiInstruction

prisma/schema/ai-instruction.prisma

kind = Refinement の共通指示
→ システム管理画面で編集

GenerationLog

prisma/schema/generation-log.prisma

refinementId? 生成元への参照
→ 画像生成数の集計元

主要な実装（参照）

生成：apps/user/actions/refinement/generate-image/ — 入力画像＋指示を Gemini に渡し補正
画像一覧：apps/user/actions/refinement/list-refinement.ts — グループ・生成完了・月で絞り込み可
グループ取得/一覧/更新：apps/user/actions/refinement-group/{get,list,update}-refinement-group.ts
画面：apps/user/app/(horizontal)/h/refinement-groups/

開発セッション履歴

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