Merge pull request #88 from GoCon/feat/timetable-slides

feat: プログラム詳細に登壇資料の埋め込みを追加

Author: mochi-yu

docs/timetable-data.md

@@ -72,6 +72,11 @@ SESSIONIZE_API_URL='https://sessionize.com/api/v2/<id>/view/All' pnpm fetch:time
   - Accepted セッションのみ残す
   - スピーカー情報をセッションへ埋め込む
   - `categoryItems` から `type` / `difficulty` / `duration` を解決する（欠けていればエラー）
+  - `questionAnswers` の questionId `138931`（登壇資料 URL）を `slidesUrl` へ変換する
+    - Speaker Deck / Docswell / Google スライド → 埋め込み用 URL
+    - それ以外のドメイン → 元 URL のまま（詳細ページでは「登壇資料を見る」リンク）
+    - Speaker Deck 公開ページなど自動変換不可 → 固定値 `needsManual`（詳細ページでは非表示）
+    - 既存 `data.json` に `needsManual` 以外の `slidesUrl` がある場合は上書きしない
   - サイト未使用のフィールドを除去する
   - 表示用の時刻・部屋は含めない（カード表示時に `sessionGrid` / `schedule` から解決）
 - `parseRawData.ts` は整形済み JSON と手動入力を `Program` のマップへ載せる薄い読み込み層
@@ -81,7 +86,8 @@ SESSIONIZE_API_URL='https://sessionize.com/api/v2/<id>/view/All' pnpm fetch:time
 - ファイル: `src/components/timetable/data.json`
 - 利用時に使いやすい形（スピーカー埋め込み済みなど）で git 追跡する
 - タイムテーブル上の配置（枠・開始時刻・部屋）は、データ本体とは別に `sessionGrid.ts` / `schedule.ts` などで管理する
-- **`pnpm transform:timetable` で上書きされる**ため、基調講演・スポンサーはここに書かない
+- **`pnpm transform:timetable` で再生成される**ため、基調講演・スポンサーはここに書かない
+- ただし `slidesUrl` については、既に埋め込み URL や外部リンクが入っている場合は再生成時も保持する（`needsManual` を手動で直した値が消えない）
 
 ## 5. 基調講演・スポンサーセッション（手動入力）
 
@@ -156,5 +162,6 @@ export const manualSessions: SessionProgram[] = [
 
 1. `SESSIONIZE_API_URL` を指定して `pnpm fetch:timetable` を実行する（または GitHub Actions に任せる）
 2. `pnpm transform:timetable` で `data.json` を生成する
-3. 基調講演・スポンサーは `manualSessions.ts` を編集する
-4. `data.json` / `manualSessions.ts` の変更をコミットする
+3. `slidesUrl` が `needsManual` のセッションは、埋め込み用 URL を `data.json` に手動で書く（次回 transform でも保持される）
+4. 基調講演・スポンサーは `manualSessions.ts` を編集する
+5. `data.json` / `manualSessions.ts` の変更をコミットする

scripts/transform-timetable-data.ts

@@ -4,6 +4,8 @@
  * - Accepted のみ残す
  * - スピーカー情報をセッションへ埋め込む
  * - categoryItems から type / difficulty / duration を解決する（欠けていればエラー）
+ * - 登壇資料 URL は埋め込み形式へ変換し slidesUrl として残す
+ *   （想定外ドメインは元 URL。変換不可は needsManual。既存の URL は上書きしない）
  * - 部屋・開始時刻は Sessionize に含まれないため、ここでは扱わない
  *   （sessionGrid.ts / schedule.ts で手動紐づけする）
  *
@@ -13,6 +15,12 @@
 import fs from "node:fs";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import {
+  isPreservableSlidesUrl,
+  parseSlideEmbed,
+  SLIDES_URL_NEEDS_MANUAL,
+  toSlidesUrl,
+} from "../src/components/timetable/parseSlideEmbed.ts";
 
 const rootDir = path.resolve(
   path.dirname(fileURLToPath(import.meta.url)),
@@ -59,6 +67,7 @@ type ShapedSession = {
   speaker: Speaker;
   description: string;
   duration?: WorkshopDuration;
+  slidesUrl?: string;
 };
 
 type ShapedData = {
@@ -80,15 +89,23 @@ type RawSpeaker = {
   links?: RawSpeakerLink[];
 };
 
+type RawQuestionAnswer = {
+  questionId: number;
+  answerValue?: string | null;
+};
+
 type RawSession = {
   id: string;
   title: string;
   description?: string;
   speakers?: string[];
   categoryItems?: number[];
+  questionAnswers?: RawQuestionAnswer[];
   status: string;
 };
 
+const SLIDES_QUESTION_ID = 138931;
+
 type RawData = {
   sessions?: RawSession[];
   speakers?: RawSpeaker[];
@@ -111,6 +128,53 @@ function normalizeDescription(description: string): string {
   return description.replace(/\r\n/g, "\n");
 }
 
+function extractSlidesUrl(session: RawSession): string | undefined {
+  const answer = (session.questionAnswers ?? []).find(
+    (qa) => qa.questionId === SLIDES_QUESTION_ID,
+  );
+  const value = answer?.answerValue?.trim();
+  if (!value) {
+    return undefined;
+  }
+
+  return toSlidesUrl(parseSlideEmbed(value));
+}
+
+function resolveSlidesUrl(
+  session: RawSession,
+  existingSlidesUrls: Map<string, string>,
+): string | undefined {
+  const parsed = extractSlidesUrl(session);
+  const existing = existingSlidesUrls.get(session.id);
+
+  if (
+    existing &&
+    isPreservableSlidesUrl(existing) &&
+    (!parsed || parsed === SLIDES_URL_NEEDS_MANUAL)
+  ) {
+    return existing;
+  }
+
+  return parsed;
+}
+
+function loadExistingSlidesUrls(filePath: string): Map<string, string> {
+  const map = new Map<string, string>();
+  if (!fs.existsSync(filePath)) {
+    return map;
+  }
+
+  const existing = JSON.parse(fs.readFileSync(filePath, "utf8")) as {
+    sessions?: Array<{ id?: string; slidesUrl?: string }>;
+  };
+  for (const session of existing.sessions ?? []) {
+    if (session.id && session.slidesUrl) {
+      map.set(session.id, session.slidesUrl);
+    }
+  }
+  return map;
+}
+
 function requireExactlyOne<T>(
   categoryItems: number[],
   mapping: ReadonlyArray<readonly [number, T]>,
@@ -153,6 +217,7 @@ function parseSpeaker(rawSpeaker: RawSpeaker, sessionId: string): Speaker {
 function transformSession(
   session: RawSession,
   speakerMap: Map<string, RawSpeaker>,
+  existingSlidesUrls: Map<string, string>,
 ): ShapedSession {
   const categoryItems = session.categoryItems;
   if (!categoryItems || categoryItems.length === 0) {
@@ -208,10 +273,18 @@ function transformSession(
     shaped.duration = proposal.duration;
   }
 
+  const slidesUrl = resolveSlidesUrl(session, existingSlidesUrls);
+  if (slidesUrl) {
+    shaped.slidesUrl = slidesUrl;
+  }
+
   return shaped;
 }
 
-function transform(raw: RawData): ShapedData {
+function transform(
+  raw: RawData,
+  existingSlidesUrls: Map<string, string>,
+): ShapedData {
   if (!raw.sessions) {
     throw new Error("rawData.json に sessions がありません");
   }
@@ -225,7 +298,9 @@ function transform(raw: RawData): ShapedData {
 
   const sessions = raw.sessions
     .filter((session) => session.status === "Accepted")
-    .map((session) => transformSession(session, speakerMap));
+    .map((session) =>
+      transformSession(session, speakerMap, existingSlidesUrls),
+    );
 
   return { sessions };
 }
@@ -240,7 +315,8 @@ function main(): void {
   }
 
   const raw = JSON.parse(fs.readFileSync(inputPath, "utf8")) as RawData;
-  const shaped = transform(raw);
+  const existingSlidesUrls = loadExistingSlidesUrls(outputPath);
+  const shaped = transform(raw, existingSlidesUrls);
   fs.writeFileSync(outputPath, `${JSON.stringify(shaped, null, 2)}\n`, "utf8");
 
   console.log(`Wrote ${outputPath} (${shaped.sessions.length} sessions)`);