リリース データ設計書

最終更新: 2026-07-21

1. 概要

Neon（Vercel Postgres）release テーブルに格納される Release（リリース）エンティティのデータ設計。 Release は他の全機能（トラックリスト・プレイリスト・ユニット・タイムライン・曲対比等）から参照される最も基盤的なエンティティの一つだが、専用のデータ設計書がこれまで存在しなかった（#1379）。

2. 背景・目的

3. 型定義

Release インターフェース（types/release.ts）

export const ReleaseSchema = z.object({
  id: z.string().min(1),
  title: z.string(),
  releaseDate: z.string(),
  format: z.string().min(1),
  source: z.string().min(1),
  sourceUrl: z.string(),
  links: z.array(ExternalLinkSchema).optional(),
  tracks: z.array(TrackSchema).optional(),
});
export type Release = Omit<z.infer<typeof ReleaseSchema>, 'format'> & { format: ReleaseFormat };

4. Blob → Neon 移行（v4.1.0、#853）

4-1. Prisma モデル（prisma/schema.prisma）

model Release {
  releaseId   String @id @db.VarChar(255)
  title       String @db.VarChar(255)
  releaseDate String @db.VarChar(20)
  format      String @db.VarChar(50)
  source      String @db.VarChar(255)
  sourceUrl   String @db.Text

  tracks Track[]

  @@map("releases")
}

• Release.id（Zod）と Release.releaseId（Prisma）は同一値。lib/releases.ts の mapRelease が変換時にリネームする
• links フィールドに対応する DB カラムは存在しない（§4-2）
• 読み取りは lib/releases.ts の fetchReleasesFromDB / getReleases（unstable_cache）経由で行う。旧 getReleasesFromBlob（lib/blob.ts）は移行前の実装として残るが、アプリの読み取り経路としては使われていない

4-2. links フィールドが未使用である理由

ReleaseSchema.links は型定義上は存在するが、mapRelease（lib/releases.ts）はこのフィールドを設定しない。リリース単位の YouTube MV URL 自動取得は「Neon に保存先がなくクォータを空振りするため」廃止済みである（#1123、詳細 → バッチ設計書 W2「ディスコグラフィー同期バッチ」手順8）。リリース単位のリンクは廃止され、リンクは全てトラック単位の Track.links[] に一元化されている。

4-3. sync-discography バッチによる書き込み

MusicBrainz からの取得・手動登録リリースのマージ・Neon への保存フローの詳細は → バッチ設計書 W2「ディスコグラフィー同期バッチ」を参照すること。

5. Member との紐付け（MemberReleaseLink）

Release と Member の関連は永続ファイルを持たず、lib/member-release-linker.ts により実行時に算出される。

MemberReleaseLink インターフェース（types/member-release-link.ts）

export interface MemberReleaseLink {
  memberId: string;
  releaseId: string;
  linkType: LinkType;
  confidence: Confidence;
  reason: string;
}

算出アルゴリズム（linkMemberToReleases）

1. 実質基準日の算出: profile.joinDate の翌月1日以降・profile.gradDate 以前に発売された最初のシングル（format === 'single' かつ完全日付）の発売日を「実質基準日」とする
   • 該当するシングルが存在しない場合、そのメンバーは（override 指定分を除き）全リリースが対象外となる
2. 在籍期間判定: 各リリースについて、発売日が実質基準日以降・卒業日以前であれば紐付け対象とする
   • 発売日の精度（YYYY-MM-DD=full / YYYY-MM=month / YYYY=year）に応じて比較粒度を揃える
   • precision === 'full' の完全一致判定は confidence: 'high'、部分日付での推定判定は confidence: 'medium'
   • 発売日不明（precision === 'none'）のリリースは判定不能として除外
3. override による補正: MemberReleaseLinkOverride（{ memberId, releaseId, action: 'include' | 'exclude', linkType?, reason }）が指定されたペアは、上記アルゴリズムに優先して強制的に含める／除外する。ただし本書執筆時点では override を永続化するデータファイルは存在せず、呼び出し元が空配列を渡している

呼び出し箇所

app/members/[id]/page.tsx（メンバー詳細の関連リリース表示）・app/releases/[id]/page.tsx（リリース詳細の参加メンバー表示）・lib/timeline-utils.ts の buildReleaseMemberLookup（タイムライン画面・/api/events のイベント↔メンバー紐付け）から呼び出される。

6. ER 図

→ ER 図 を参照すること。Release はコア音楽データ・タイムライン統合イベントの各セクションに登場する。

7. 関連設計書

改訂履歴