URL追跡機能（Tracking）

生成画像を共有用ギャラリーにまとめてお客様へ共有し、閲覧（アクセス）を記録する機能。

ユーザー画面（作成・管理）公開画面（共有ギャラリー閲覧）組織管理画面（ログ確認）全生成タイプ横断

概要

ユーザー（営業担当）が、生成した画像を物件単位などで1つのギャラリー（URL追跡）にまとめ、公開URLでお客様に共有する機能。共有ページが閲覧されるとアクセスがログとして記録され、相手が見たか・いつ見たかを把握できる。

URL追跡は名前・カテゴリ・住所・備考を持ち、各生成タイプの結果を項目（TrackingItem）として複数登録する（全9生成タイプを参照可能）。
公開ページ /t/[trackingId] はログイン不要で閲覧でき、開かれると TrackingLog（IP・UA）が記録される。
ユーザーはURL追跡ごとに閲覧ログを確認できる。組織管理画面でも横断的にログを確認できる。

フロー

関連データモデル

Tracking

prisma/schema/tracking.prisma

name / category / postalAddress / note
organizationId / userId 所有
→ items / logs

TrackingItem（イメージギャラリー項目）

prisma/schema/tracking-item.prisma

trackingId 所属URL追跡
各生成タイプへの nullable FK（cleaning/decorating/.../solidFloorPlan）。1項目＝1生成結果

TrackingLog

prisma/schema/tracking-log.prisma

trackingId 対象URL追跡
ipAddress / userAgent アクセス情報

関連する画面

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

/v/trackings / /new / /[trackingId] / /edit — 一覧・作成・詳細・編集
/v/trackings/[trackingId]/items/{type} — 生成タイプ別に項目を追加
/v/trackings/[trackingId]/logs — 閲覧ログの確認

公開画面（apps/www）

/t/[trackingId] — 共有ギャラリー（閲覧時に TrackingLog を記録。オーバーレイ表示等）

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

/home — 直近URL追跡ログのウィジェット（横断確認）

主要な実装（参照）

URL追跡取得/一覧：apps/user/actions/tracking/{get,list}-tracking.ts
項目一覧：apps/user/actions/tracking-item/list-tracking-item.ts
公開ギャラリー取得：apps/www/app/(tracking)/t/[trackingId]/_actions/get-tracking.ts
閲覧ログ記録：apps/www/app/(tracking)/t/[trackingId]/_actions/create-tracking-log.ts
ログ一覧（組織管理）：apps/organization-manager/actions/tracking-log/list-tracking-log.ts

開発セッション履歴

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