ライブ・フェス機能 テーブル設計書

最終更新: 2026-05-08 関連 Issue: #528, #776

1. 概要

Vercel Postgres（Neon）上に構築するライブ機能のテーブル設計書。 #527 の結論（Neon 採用・react-leaflet・JIS 2桁コード）を前提とする。

対象テーブル

データストア方針

• ライブ関連データ（本設計書の対象）: Neon（Vercel Postgres） を正とする
• 現行データ（メンバー・リリース等）: Vercel Blob / JSON を継続
• メンテナンス: VSCode で CSV を直接編集し、シードスクリプトで Neon に投入（#609）

2. テーブル定義

2-1. venues（会場）

会場の基本情報と react-leaflet 表示用の座標を管理する。

CREATE TABLE venues (
  venue_id    VARCHAR(8)    PRIMARY KEY,
  name        VARCHAR(255)  NOT NULL,
  prefecture  CHAR(2)       NOT NULL,
  latitude    DECIMAL(9,6),
  longitude   DECIMAL(9,6)
);

備考:

• DECIMAL(9,6) は整数部 3桁・小数部 6桁（精度 約 0.1m）
• PostGIS 不使用（精細な地図表示は不要という #527 の方針に準拠）
• 座標未登録の会場はマップ上に表示しない

インデックス:

CREATE INDEX idx_venues_prefecture ON venues (prefecture);

2-2. tours（ツアー）

ツアー単位の情報を管理する。

CREATE TABLE tours (
  tour_id     VARCHAR(20)   PRIMARY KEY,
  title       VARCHAR(255)  NOT NULL,
  release_id  VARCHAR(255)
);

備考:

• release_id は Blob 管理の releases.json を参照するため、DB レベルの FK 制約は設けない

2-3. lives（公演）

個別公演の日程・会場・所属ツアーを管理する。

CREATE TABLE lives (
  live_id   VARCHAR(20)   PRIMARY KEY,
  tour_id   VARCHAR(20)   REFERENCES tours (tour_id),
  venue_id  VARCHAR(8)    NOT NULL REFERENCES venues (venue_id),
  date      DATE          NOT NULL,
  time      TIME,
  title     VARCHAR(255)
);

インデックス:

CREATE INDEX idx_lives_tour_id  ON lives (tour_id);
CREATE INDEX idx_lives_venue_id ON lives (venue_id);
CREATE INDEX idx_lives_date     ON lives (date);

2-4. member_lives（メンバー × 公演紐づけ）

メンバーと公演の多対多関係を管理する（#517 で使用）。

CREATE TABLE member_lives (
  member_id  VARCHAR(50)   NOT NULL,
  live_id    VARCHAR(20)   NOT NULL REFERENCES lives (live_id),
  PRIMARY KEY (member_id, live_id)
);

備考:

• member_id は Blob 管理の members.json を参照するため、DB レベルの FK 制約は設けない
• PK = (member_id, live_id) の複合主キーで重複を防ぐ

インデックス:

CREATE INDEX idx_member_lives_live_id ON member_lives (live_id);

2-5. prefecture_codes（都道府県コード変換）

members.birthplace（自由文字列）を JIS 2桁コードに変換するための参照テーブル（#520 ご当地ライブ検出で使用）。

CREATE TABLE prefecture_codes (
  prefecture_code  CHAR(2)       PRIMARY KEY,
  name             VARCHAR(20)   NOT NULL,
  aliases          TEXT[]
);

備考:

• aliases は birthplace の表記ゆれ吸収のために使用（部分一致マッチング）
• 初期データ: 47都道府県分を CSV（prefecture.csv）からシード投入
• 海外拡張コード（#674）: 海外公演対応のため以下3コードを追加（aliases は空）

2-6. members（出身地照合用）

Blob の members.json から出身地情報のみを複製し、会場の都道府県との照合に使用する（#520 専用テーブル）。

CREATE TABLE members (
  member_id   VARCHAR(50)   PRIMARY KEY,
  birthplace  VARCHAR(255)
);

備考:

• members.json の profile.birthplace を定期同期または手動投入
• 都道府県コードへの変換は prefecture_codes テーブルとのマッチングでアプリ層が担当
• この members テーブルは Blob の members.json を置き換えるものではない

2-7. festivals（フェス）

参加フェスの開催情報を管理する。複数日開催フェスのうち参加する1日を1レコードとして管理する。

CREATE TABLE festivals (
  festival_id  VARCHAR(50)   PRIMARY KEY,
  name         VARCHAR(255)  NOT NULL,
  date         DATE          NOT NULL,
  venue_id     VARCHAR(8)    NOT NULL REFERENCES venues (venue_id)
);

インデックス:

CREATE INDEX idx_festivals_venue_id ON festivals (venue_id);
CREATE INDEX idx_festivals_date     ON festivals (date);

2-8. setlists（セットリスト）

ツアーまたはフェスの演奏曲目・順序を管理する（#775）。

CREATE TABLE setlists (
  setlist_id   VARCHAR(80)   PRIMARY KEY,
  type         VARCHAR(10)   NOT NULL,
  tour_id      VARCHAR(20)   REFERENCES tours (tour_id) ON DELETE SET NULL,
  festival_id  VARCHAR(50)   REFERENCES festivals (festival_id) ON DELETE SET NULL,
  seq          INT           NOT NULL,
  track_id     VARCHAR(255)  NOT NULL
);

備考:

• tour_id と festival_id は排他的（いずれか一方のみ設定）
• track_id は Blob 管理の releases.json を参照するため、DB レベルの FK 制約は設けない
• 画面表示時に track_id を releases.json で解決し、曲名・YouTube 動画 ID を取得する

インデックス:

CREATE INDEX idx_setlists_tour_id     ON setlists (tour_id);
CREATE INDEX idx_setlists_festival_id ON setlists (festival_id);

3. ER 図（ライブ機能テーブル）

4. CSV 投入フォーマット（シード用）

#609（Neon スキーマ実装）でのシード投入に使用する CSV フォーマット。

venues.csv

venueId,name,prefecture,latitude,longitude
13001,日本武道館,13,35.693200,139.749700

tours.csv

tourId,title,releaseId
2026B,モーニング娘。'26 コンサートツアー春 – Rays Of Light –,

lives.csv

tourId,liveId,date,time,venueId
2026B,2026B001,2026-04-11,13:00,13002

prefecture.csv

prefecture,name
01,北海道
13,東京都

festivals.csv

festivalId,name,date,venueId
2025-SUMMERSONIC-TK,SUMMER SONIC 2025（東京）,2025/8/16,11005

setlists.csv

setlistId,type,tourId,festivalId,seq,trackId

5. 設計上の注意点

prefecture フィールドの型

CHAR(2) を使用し、先頭ゼロを文字列として保持する。INTEGER や SMALLINT にすると 01 → 1 に変換されて照合が崩れる。

Blob データとの FK 制約

member_id（members.json 参照）・release_id（releases.json 参照）は Blob 管理のデータを参照するため、DB レベルの外部キー制約を設けない。整合性はアプリ層で担保する。

座標精度

DECIMAL(9,6) は整数部 3桁 + 小数部 6桁で、精度 約 0.11m（11cm）。react-leaflet での表示用途に十分。PostGIS 導入は不要。

6. 更新履歴