生成ログ機能（Generation Log）

画像生成の実行記録。 組織ごとの生成数の SoTであり、生成履歴・将来の課金額計算の根拠となる横断機能。

横断機能 3アプリにまたがる生成数の SoT

概要

画像生成が1回行われるごとに GenerationLog が作られる。これは 組織ごとの生成数の SoT（Source of Truth）であり、画像生成数はこのログを数えて求める。

用途は3つ：

(1) 組織ごとの生成数の根拠 — 組織一覧の並べ替えキーや利用ボリュームの指標。
(2) 課金額計算の根拠（予定） — 将来、生成数に基づく課金額計算に用いる。※現時点では未実装。
(3) ユーザーの生成履歴 — ユーザー画面の「履歴」として、過去の生成結果を一覧表示。

データモデル

GenerationLog

prisma/schema/generation-log.prisma

各生成タイプへの nullable な外部キーを持ち、 1レコードにつき1タイプ分だけ値が入る（どのタイプの生成かを表す）。

organizationId / userId — 実行した組織・ユーザー
createdAt — 生成日時（年月集計のキー）
homestagingId? / refinementId? / cleaningId? / decoratingId? / furnishingId? / replacementId? / solidFloorPlanId? / exteriorId? / renovationId? — 生成タイプ別の参照（いずれか1つ）

※ renovationId はスキーマ上は存在するが、ペンディングのため一覧取得では未使用。

関連する画面（3アプリ横断）

ユーザー画面（apps/user・モバイル版 /v）

自分の生成履歴を「履歴」として一覧表示。各生成結果（出力画像）へのリンク。

/v/generation-logs — 生成履歴一覧

組織管理画面（apps/organization-manager）

自組織の生成ログを年月別に集計・一覧・個別閲覧。ホームに件数サマリ。

/generation-logs/[year]/[month] — 年月別の集計（count-summary）・一覧（list）・個別表示（view）
/home — 生成数サマリ・直近ログのウィジェット

システム管理画面（apps/system-manager）

運営が組織ごとの生成ログを閲覧。

/organizations/[organizationId]/generation-logs — 組織別の生成ログ

主要な実装（参照）

組織管理：apps/organization-manager/actions/generation-log/{list,get}-generation-log.ts — 組織＋createdAt 範囲（月）で絞り込み、全タイプの関連を include
システム管理：apps/system-manager/actions/generation-log/{list,get}-generation-log.ts
ユーザー履歴：apps/user/app/(vertical)/v/generation-logs/_actions/list-generation-log.ts
画面：apps/organization-manager/app/generation-logs/[year]/[month]/ / apps/user/app/(vertical)/v/generation-logs/

関連

用語：生成ログ / 画像生成数
並べ替え：組織一覧の並べ替え（画像生成数キー）
課金根拠：課金履歴機能（前月の生成ログ件数を区分別に集計し超過課金を算出）／契約プラン・Mulpay 決済

開発セッション履歴

本ドキュメントは既存実装をもとに遡及作成。今後の改修は sessions/ 配下に追記する。