テーブルリレーション
Subseek の DB スキーマにおけるテーブル間のリレーションを Mermaid ER 図で可視化する。各テーブルの詳細定義は DBスキーマ を参照。
全体 ER 図
アプリケーション管理テーブルと Better Auth 管理テーブルを含む全体像。
リレーション一覧
users を起点としたリレーション
| 関係 | 相手テーブル | カーディナリティ | 削除時の挙動 | 用途 |
|---|---|---|---|---|
| sessions | sessions | 1:N | CASCADE | ログインセッション |
| accounts | accounts | 1:N | CASCADE | OAuth プロバイダーごとの連携情報 |
| subscriptions | subscriptions | 1:N（reference_id 経由） | なし | Stripe サブスクリプション（Better Auth 管理、"free" は行を持たない） |
| user_video_access | user_video_access | 1:N | なし（履歴として残す） | クレジット消費履歴・動画アクセス権 |
| favorite_channels | favorite_channels | 1:N | CASCADE | お気に入りチャンネル |
| search_histories | search_histories | 1:N | CASCADE | 検索履歴 |
| referred_by | users（自己参照） | N:1（referred_by 経由） | SET NULL | 紹介者と被紹介者の関係。紹介者が退会しても被紹介者のアカウントは残す |
| ad_reservations | ad_reservations | 1:N | なし（履歴として残す） | ダイレクト広告の予約 |
| advertiser_profiles | advertiser_profiles | 1:N | なし（プロフィールは履歴として残す） | ダイレクト広告の広告主プロフィールマスタ。個人／法人の使い分けや代理店的運用のため UNIQUE にはしない |
注記
user_video_access と subscriptions と ad_reservations と advertiser_profiles は CASCADE しない。ユーザー削除後もクレジット消費履歴・Stripe 課金履歴・広告配信履歴・広告主プロフィール（返金・監査ログ要件・特商法対応を含む）を残して運用・分析に利用するため、アプリケーション側で論理削除・匿名化を行う方針。
注記
subscriptions.reference_id は FK 制約を持たない（Better Auth Stripe プラグインの仕様）。将来 organization 単位の課金を導入したときに、reference_id を users.id / organizations.id の両方で使い回せるようにしている。
channels を起点としたリレーション
| 関係 | 相手テーブル | カーディナリティ | 削除時の挙動 | 用途 |
|---|---|---|---|---|
| videos | videos | 1:N | なし | チャンネル配下の動画一覧 |
| favorite_channels | favorite_channels | 1:N | なし | お気に入りされているユーザー |
videos を起点としたリレーション
| 関係 | 相手テーブル | カーディナリティ | 削除時の挙動 | 用途 |
|---|---|---|---|---|
| user_video_access | user_video_access | 1:N | なし | 動画を閲覧したユーザーのアクセス権 |
ad_slots を起点としたリレーション
| 関係 | 相手テーブル | カーディナリティ | 削除時の挙動 | 用途 |
|---|---|---|---|---|
| ad_reservations | ad_reservations | 1:N | なし | スロット内の各 position の予約 |
advertiser_profiles を起点としたリレーション
| 関係 | 相手テーブル | カーディナリティ | 削除時の挙動 | 用途 |
|---|---|---|---|---|
| ad_reservations | ad_reservations | 1:N | なし（snapshot として残す） | 契約時点の事業者情報のコピー元 |
ad_reservations を起点 としたリレーション
| 関係 | 相手テーブル | カーディナリティ | 削除時の挙動 | 用途 |
|---|---|---|---|---|
| ad_click_logs | ad_click_logs | 1:N | なし（予約削除後もログは残す） | クリック計測ログ |
| ad_impression_daily | ad_impression_daily | 1:N | なし | インプレッション日次集計（CTR 算出用） |
複合主キー
| テーブル | 主キー構成 | 備考 |
|---|---|---|
user_video_access | (user_id, video_id) | ユーザー × 動画の一意制約 |
favorite_channels | (user_id, channel_id) | ユーザー × チャンネルの一意制約 |
Better Auth 管理テーブルの扱い
users / sessions / accounts / verifications は Better Auth が管理するため、drizzle.config.ts の tablesFilter からは除外されている（マイグレーション対象外）。ただしアプリケーションテーブルから FK 参照するため、スキーマ定義自体は packages/db/src/schema/auth-schema.ts に残している。
- Better Auth 自体がテーブルのマイグレーションを行う
- Drizzle ORM からは読み取り・FK 参照のみ行う
- ER 図には参考として掲載
スキーマ定義ファイル
実装は packages/db/src/schema/ 配下を参照。
| ファイル | 対応テーブル |
|---|---|
auth-schema.ts | users / sessions / accounts / verifications |
channels/channels.ts | channels |
videos/videos.ts | videos |
user-video-access/user-video-access.ts | user_video_access |
subscriptions/subscriptions.ts | subscriptions |
favorite-channels/favorite-channels.ts | favorite_channels |
search-histories/search-histories.ts | search_histories |
ad-slots/ad-slots.ts | ad_slots |
advertiser-profiles/advertiser-profiles.ts | advertiser_profiles |
ad-reservations/ad-reservations.ts | ad_reservations |
ad-click-logs/ad-click-logs.ts | ad_click_logs |
ad-impression-daily/ad-impression-daily.ts | ad_impression_daily |