feat(pretalx): return difficulty, track, and tags on sessions (#171)

[pan93412]

Closes #171.

Summary

/api/session 先前把 tags 寫死成空陣列，且沒有 difficulty、track 欄位。本 PR 依照 issue #171 的提案，仿照 2025 的做法把這三項補上：

• 新增 tracks / tags 兩張 Pretalx table 的抓取與 schema — PRETALX_TABLES 加入 tracks、tags，新增 TrackSchema、TagSchema（getPretalxItemKey 以 id 為 key,直接相容）。
• 新增 parser — parseTrack(submission.track id → { id, name } 多語)、parseTags(submission.tags id[] → tag 名稱 string[])、parseDifficulty(把投稿者填寫的難度原始字串正規化成 Elementary/Intermediate/Advanced/Professional enum)。
• 兩個 handler 輸出新欄位 — index.get.ts 與 [id]/index.get.ts 都帶上 difficulty、track,並用 parseTags 取代 tags: []。
• schema 補欄位 — SessionSummarySchema 新增 difficulty、track,tags 內容改為實際 tag 名稱。

項目	來源	處理
difficulty	answers Q270	正規化成英文 enum
track	submission.track(id)→ tracks table	輸出 { id, name }(多語)
tags	submission.tags(id[])→ tags table	id → tag 名稱 string[]

Example output

實際打 /api/session 驗證（測試環境指向 coscup-2025 event）。

單筆 session：

{
  "id": "3LWSX3",
  "language": "中文",
  "difficulty": "Elementary",
  "track": {
    "id": 461,
    "name": { "en": "Main Session Track", "zh-hans": "" }
  },
  "tags": ["原綜合軌"]
}

全體覆蓋率（共 341 場）：

{
  "total_sessions": 341,
  "with_difficulty": 328,
  "with_track": 341,
  "with_nonempty_tags": 73
}

• difficulty 出現值：["Advanced", "Elementary", "Intermediate"]（皆已正規化）
• tags 範例："early-bird", "program-invitation", "cn", "Misc - DevOps", "原綜合軌"
• track.name.en 範例："Cloud Native Days Taipei", "Golang Taiwan", "Data Infrastructure"

單筆詳細端點 /api/session/{id} 同樣帶上這三個新欄位。

Notes

• pnpm lint 與 pnpm typecheck 皆通過。
• 測試用的 2025 資料 locale key 為 zh-hant,而既有的 PretalxLocaleSchema 只取 en 與 zh-hans(room/type 名稱也是相同行為),因此 2025 資料的 track.name.zh-hans 會是空字串;2026 正式資料若採 zh-hans 則會正常填入。此為既有、跨欄位一致的設計,本 PR 未更動。

https://claude.ai/code/session_01DEyZKJJtSf8Hm8vDLpqiZZ

---

Generated by Claude Code

[rileychh-dokploy-coscup]

Dokploy Preview Deployment

Name	Status	Preview	Updated (UTC)
Nuxt	❌ Failed	Preview URL	2026-06-02T02:53:34.152Z

[Copilot]

Pull request overview

This PR extends the Pretalx-backed session API so session responses can include difficulty, track, and real Pretalx tag metadata instead of always returning an empty tag list.

Changes:

• Adds Pretalx tracks and tags table schemas and fetches them with cached Pretalx data.
• Adds parser helpers for session difficulty normalization, track lookup, and tag lookup.
• Updates session list/detail handlers and shared session schemas to expose difficulty, track, and populated tags.

Reviewed changes

Copilot reviewed 6 out of 6 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
shared/types/session.ts	Adds session difficulty and track response schemas/types.
shared/types/pretalx.ts	Adds Pretalx tracks/tags table definitions and result typing.
server/utils/pretalx/parser.ts	Adds parsing helpers for difficulty, track, and tags.
server/utils/pretalx/index.ts	Fetches tracks and tags alongside existing Pretalx tables.
server/api/session/index.get.ts	Includes difficulty, track, and parsed tags in session list responses.
server/api/session/[id]/index.get.ts	Includes difficulty, track, and parsed tags in session detail responses.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[pan93412]

@mirumodapon 交給你看看～ #172 的「標籤」篩選，會需要「議程軌」和「難度」（標籤）相關的篩選維度。另外如果要符合 COSCUP 2025 的設計稿，也會需要這些內容。

[pan93412]

@codex review

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0f68f7e7c8

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".