บันทึกเวอร์ชัน

sitemap 納入行程／目的地；TravelAgency／TouristTrip／TouristDestination JSON-LD；hreflang

• 新增`src/lib/seo.ts`、`site-url.ts`、`JsonLd`；全站 Organization／行程／目的地結構化資料
• 修改`sitemap.xml` 含已上架行程與目的地（依有翻譯的語系）
• 修改首頁／行程／目的地：canonical、hreflang、Open Graph
• 修改行銷 SEO 檢查清單狀態更新
• 修改`CONSTITUTION.md` §十三 行銷／SEO／GEO 準則；§六.13、§10.5b；Cursor `project-constitution.mdc`

訪客分析加圖表；熱門頁顯示完整可點網址

• 新增依賴 `recharts`；每日趨勢／漏斗／熱門頁／語系／來源／地區圖表
• 新增分析 API 回傳 `daily`（依日 PV、工作階段、CTA、詢價）
• 修改熱門頁面列表顯示完整網址並可開新分頁

詢價寫入 UTM／落地頁；行銷歸因可在後台查看

• 新增migration `020_inquiry_utm_fields.sql`
• 新增`UtmCapture`＋session 保留首次 UTM；詢價 API／後台詳情顯示
• 修改行銷檢查清單：NAS 匯出與 GA4 監控牆說明

後台訪客分析報表；CTA／橫幅／詢價埋點；行銷 SEO 檢查清單與選配 GA4

• 新增`/admin/analytics`：PV、停留、工作階段、熱門頁、語系／來源／地區、漏斗、CTR
• 新增`GET /api/admin/analytics/summary`
• 新增Hero／行程／詢價埋點；`analytics-client`；migration `019` meta
• 新增`sitemap.xml`、`robots.txt`；[`MARKETING-SEO-CHECKLIST.md`](planning/MARKETING-SEO-CHECKLIST.md)
• 新增選配 `NEXT_PUBLIC_GA_MEASUREMENT_ID`（同意後才載入 gtag）

後台與前台皆可查看從 v0.1.0 起的完整版本修改說明

• 新增`/admin/changelog`：後台版本紀錄（日期、摘要、修正項目）
• 新增`/[locale]/changelog`：前台版本紀錄（頁尾可進入）
• 新增`VersionChangelogView`：後台／前台共用列表元件
• 新增`app-changelog.generated.ts`：build 時由 VERSION-CHANGELOG 產生
• 修改`sync-app-version.mjs`：同步目前版本與完整 changelog
• 修改後台導覽「版本紀錄」；頂欄版本號可點入；頁尾加「版本紀錄」連結

後台手機預覽比例對齊前台 Hero，減少與實機落差

• 修改`HeroCropPreview`：手機預覽改約 9:19（對齊全寬×85svh）；加文案區示意
• 修改桌面預覽改約 16:10；編輯／預覽說明強調勿只看電腦焦點

後台橫幅儲存／刪除改安靜重整，不再整頁轉圈

• 修改`HomepageBannerManager`：儲存橫幅／主標、刪除、匯入後改 `load({ silent: true })`

修復 Hero 多數 Pexels 影片 403；失敗時顯示封面

• 修改雲端 DB：安平晚渡／赤崁夕照／鼓門煙濤／沙屯浴日改可用 Pexels 變體
• 修改`HeroSection`：影片載入失敗（403）時回退封面，不再只剩綠底
• 新增`scripts/fix-pexels-banner-urls.mjs`、`check-banner-video-urls.mjs`

Hero：輪播秒數長於影片總長時，播完即切下一張

• 修改`HeroSection`：實際停留 = min(輪播秒數, 影片總長)；檔案影片播完即切下一張
• 修改後台說明：輪播秒數長於影片總長時的行為

後台橫幅自動偵測並顯示影片總長秒數

• 新增`src/lib/video-duration.ts`（檔案／Vimeo 偵測總長）
• 修改後台編輯橫幅：顯示「影片總長」；可一鍵套用為輪播秒數

後台頂欄版本號改為 build 時寫入常數，正式站可正確顯示

• 新增`scripts/sync-app-version.mjs`、`src/lib/app-version.generated.ts`
• 修改`getAppVersion` 讀產生常數；`npm run build` 先同步版本
• 修改頂欄版本樣式加亮（淺綠標籤）

修復正式站 build 失敗（後台橫幅 Client 元件誤拉 `next/headers`）

• 新增`src/lib/banner-shared.ts`（型別／秒數常數，可供 Client 使用）
• 修改後台橫幅相關元件改從 `banner-shared` 匯入，不再經 `banners.ts` 拉到 supabase server

Hero 播放 mp4／檔案影片時，不再先顯示不相符的靜態封面再切到影片

• 修改`HeroSection`：可播的檔案影片不疊 poster／底圖，改用影片首幀
• 修改後台橫幅：封面說明強調須與影片首幀一致

橫幅編輯彈窗加寬；垂直焦點在預覽右側；輪播秒數獨立綠底區塊

• 修改`BannerEditModal`：彈窗 `max-w-6xl`；焦點改為預覽＋右側垂直滑桿＋下方水平滑桿
• 修改`HeroCropPreview`：電腦橫式預覽取消過矮上限，左右更寬
• 修改輪播停留秒數移出文案區，改獨立綠底區塊（較易看見）
• 新增`globals.css` `.admin-focus-y-slider` 垂直滑桿樣式

後台頂欄右上顯示目前版本號（與 VERSION-CHANGELOG 同步）

• 新增`src/lib/app-version.ts`（讀取目前版本）
• 修改後台 `Sidebar` 頂欄：姓名左側顯示版本（如 `v0.10.36`）
• 修改`admin/(protected)/layout` 傳入版本；`globals.css` 樣式

Hero 輪播每張橫幅可設停留秒數（5–30，預設 12）

• 新增migration `018_banner_display_seconds.sql`；`run-migration-018.mjs`
• 修改後台橫幅：輪播停留秒數滑桿；列表顯示秒數
• 修改前台 `HeroSection`：依目前這張的秒數換下一張
• 修改banners API／型別／`check-db-schema` 含 `display_seconds`

修復 Cookie 橫幅「拒絕非必要／自訂設定」在白底隱形

• 修改`CookieConsentBanner`：拒絕／自訂改深灰字＋灰框（勿用深色用的 btn-outline）

後台 Hero 焦點改為電腦橫式／手機直式並排，預覽與滑桿同欄

• 修改`BannerEditModal`：焦點區左右兩欄，各含預覽＋滑桿
• 修改`HeroCropPreview`：預覽標籤簡化為橫式／直式

Hero 遮罩調淡；YouTube／Vimeo 嵌入 cover 比例修正

• 修改`HeroSection`：遮罩透明度降低，影片更清楚、白字仍可讀
• 修改`HeroSection`：嵌入 iframe 改 16:9 cover（取代固定 300%）
• 修改`HeroCropPreview`：後台預覽遮罩同步調淡

Hero 後台上架步驟化；Vimeo／外部網址與 Cloudinary 上傳並用；Vimeo 封面升至 1920

• 修改`ImageUpload`：可關閉檔案上傳、白話錯誤（未設定 Cloudinary 不紅字逼上傳）
• 新增`/api/admin/cloudinary-config`、`cloudinary-client-upload`：瀏覽器直傳影片
• 修改`cloudinary`／`upload`：支援 video；`.env.example` 註明 Unsigned Preset
• 修改Vimeo 自動封面升級為 `-d_1920`（`video-embed`、`banners`、fix 腳本）

後台 Hero 上架說明：建議尺寸與電腦／手機雙焦點

• 修改`BannerEditModal` 上架說明：1920×1080、電腦／手機裁切、焦點用法、mp4 建議
• 修改`HomepageBannerManager` 列表頁標題旁簡述建議尺寸與雙焦點

後台首頁橫幅邏輯全面加固（驗證／錯誤／匯入／排序）

• 修復Vimeo／YouTube 可延遲封面；server enrich 後再檢查
• 修復翻譯 upsert 失敗回 500；匯入八景失敗回滾
• 修復影片 URL 僅允許 YouTube／Vimeo／mp4／webm
• 修復啟用切換／列表載入錯誤提示；查詢失敗不再當空列表
• 修復影片網址 onChange 競態；reorder 第二段失敗補償
• 修改列表顯示排程狀態；編輯改以 ↑↓ 排序（隱藏手動數字）

Vimeo Hero 改用不依賴 `background=1` 的嵌入參數

• 修改`buildVimeoEmbed` 改為 autoplay+mute+loop+controls=0（避免 background 403）
• 修改Hero iframe 移除可能影響驗證的 referrerPolicy

Vimeo Hero 封面改高解析度（約 1280px）

• 修改`fetchVimeoPosterUrl` 以 oEmbed `width=1920` 取約 1280px 縮圖
• 修改前台／儲存時自動升級低解析度 `i.vimeocdn.com` 封面
• 修改雲端 DB 台北 101 封面已升級

修復 Hero 完全空白（Vimeo 封面失效 + 無底圖）

• 修復停用失效的 `vumbnail.com`，改 Vimeo oEmbed 縮圖
• 修復Hero 嵌入影片時一律先顯示 poster 底圖，iframe 失敗仍有畫面
• 新增`scripts/fix-vimeo-banner-posters.mjs` 批次修復舊封面

修復 Hero Vimeo 影片因三重 iframe 無法播放

• 修復`HeroSection` 改為單一背景播放器（原 mobile/tablet/desktop 各載入一次 Vimeo）
• 新增`scripts/check-banners-hero.mjs` 檢查橫幅前台播放條件

修復 Netlify Edge Function 語系 proxy 偶發崩潰

• 修復`src/proxy.ts` 加入 try/catch，失敗時 fallback 至 next-intl middleware

Hero 電腦螢幕／手機平板雙焦點；後台雙預覽裁切

• 新增migration 017 `mobile_media_focus_x/y`；`run-migration-017.mjs`
• 新增`HeroCropPreview` 電腦螢幕 16:9／手機 9:16 並排預覽
• 新增手機／平板獨立焦點（可沿用電腦螢幕）
• 修改`HeroSection` 依 viewport 套用對應焦點
• 修改橫幅編輯／預覽彈窗：電腦螢幕焦點用語、快捷偏左／中央／偏右

後台橫幅列表已停用項目整列灰階顯示

• 修改`HomepageBannerManager` 已停用橫幅整列 `grayscale` + 淡灰底
• 新增`scripts/check-netlify-deploy.mjs`（查 Netlify 部署 commit，需 token）

修復橫幅上移／下移後跳回原位（排序 API + 前端體驗）

• 修復`reorderBannersAdmin()` 兩段式更新 sort_order，避免並行衝突
• 修復reorder 失敗時不再整頁 loading reload，改還原快照
• 修復`revalidateHomePages()` 失敗不誤判排序失敗
• 修改後台 fetch 加 `cache: 'no-store'`；列表 API `force-dynamic`

Hero 橫幅媒體焦點（裁切位置）；修復上移／下移排序 API

• 新增migration 016：`banners.media_focus_x` / `media_focus_y`
• 新增後台橫幅「媒體焦點」滑桿 + 21:9 裁切預覽
• 新增`banner-media-focus.ts`；Hero 依焦點套用 `object-position`
• 修復reorder API 移除不存在的 `updated_at` 欄位（上移／下移失敗）
• 新增`scripts/run-migration-016.mjs`

橫幅列表上移／下移改排序；手動排序欄位不可填負數

• 新增橫幅列表 ↑／↓ 按鈕，一鍵調整順序
• 新增`POST /api/admin/banners/reorder` 整批重排 `sort_order` 為 0…n-1
• 修改`normalizeBannerSortOrder()`：0 為最前，不允許負數
• 修改橫幅編輯彈窗排序欄 `min={0}`；API 儲存時正規化
• 修改列表／前台 Hero 相同 `sort_order` 時以 `id` 穩定排序

行程與網站色系儲存後清除前台快取（revalidate 補強）

• 修復後台行程新增／編輯／刪除後 `revalidateTourPages()`
• 修復系統設定儲存後一併清除 layout（全站色系 `data-theme`）
• 新增`revalidateDestinationPages()` 預留（目的地 CMS 尚未實作）

修復後台改「關於我們」前台不更新（設定頁 revalidate）

• 修復儲存系統設定後呼叫 `revalidateSettingsPages()`
• 修改`/about`、`/contact` 各語系頁面儲存後立即反映 DB 內容

後台角色／操作紀錄；Hero 八景 CMS；橫幅彈窗與影片預覽（辦公室 7/9 批次）

• 新增migration 015：`admin_roles`、`admin_logs`、`admins.role_id`
• 新增後台角色範本、操作紀錄、管理者完整 UI
• 新增後台登入圖形驗證碼 + Turnstile 雙重驗證；`scripts/netlify-sync-env.mjs`
• 新增首頁 Hero 後台管理、台灣八景匯入、橫幅編輯／預覽彈窗
• 修改影片橫幅儲存、首頁即時 revalidate、Netlify 建置修復
• 已解決P-001 migration 014；P-012 migration 015 schema（2026-07-10 家裡檢查）

v0.10.14 待處理問題清單；每次對話自動顯示未解決項

• 新增`docs/planning/PENDING-ISSUES.md`（已解決／未解決追蹤）
• 新增`.cursor/rules/pending-issues.mdc`（每次對話必顯示清單）
• 修改`project-constitution.mdc`、WIP 連結至 PENDING-ISSUES
• 已解決P-009 本機 `npm run build` 驗證通過

登入／註冊 Turnstile 驗證碼；後台管理者權限分配（migration 014）

• 新增Cloudflare Turnstile（會員登入、OAuth、後台登入、會員註冊）
• 新增`/[locale]/member/register`、`POST /api/auth/register`
• 新增後台 `/admin/admins` 管理者 CRUD（僅最高管理者）
• 新增`admins.permissions`（migration 014）、權限檢查與側邊欄過濾
• 修改後台 API 依權限（tours／inquiries／homepage 等）限制存取

準則 §9.3／§9.5 記錄 Cursor Bugbot 保留至 10 月上線前最後檢查

• 修改`docs/CONSTITUTION.md` §9.3、§9.5（Bugbot 決策備註）
• 修改`docs/VERSION-CHANGELOG.md` WIP 新增 Bugbot 列

migration 013 後台管理員改為 tcawg 帳號；移除預設 seed 帳號

• 新增`supabase/migrations/013_admin_account_tcawg.sql`
• 新增`scripts/run-migration-013.mjs`
• 修改`supabase/migrations/004_admin_seed.sql`（新安裝預設帳號）

後台 WordPress 風介面；Hero 橫幅支援 YouTube／Vimeo 嵌入

• 新增`src/lib/video-embed.ts`（YouTube／Vimeo 解析與嵌入 URL）
• 新增`src/lib/admin-ui.ts`、`AdminPageHeader.tsx`（後台 WP 風樣式）
• 修改後台左側選單、儀表板、列表頁、登入頁（灰白實用風格）
• 修改`HeroSection` 支援 YouTube／Vimeo iframe 背景影片
• 修改後台首頁橫幅管理：可貼 YT／Vimeo 連結

版本紀錄新增發布時間、本版摘要、修改／新增摘要表格；強化 version-report 報告

• 修改`docs/VERSION-CHANGELOG.md`（首段必填欄位、版本一覽時間欄、各版摘要表格）
• 修改`scripts/version-report.mjs`（發布時間、本版摘要、修改／新增摘要輸出）
• 修改`docs/CONSTITUTION.md` §8.5 版本紀錄必填欄位
• 修改v0.10.9 段落補齊時間與修改／新增摘要（追溯）

新增準則 §六之一 Cursor AI 協作準則；新增 `ai-collaboration.mdc`；更新 `project-constitution.mdc`

• 新增`docs/CONSTITUTION.md` §六之一 Cursor AI 協作準則
• 新增`.cursor/rules/ai-collaboration.mdc`
• 修改`.cursor/rules/project-constitution.mdc`（引用 §六之一）
• 修改`docs/CONSTITUTION.md` §六第 12 條、§8.5 AI 助理欄位

**雲端 Supabase**：migration `011`（`admins.session_version`）已於 **2026-07-05** 在 SQL Editor 執行成功。

• 變更**雲端 Supabase**：migration `011`（`admins.session_version`）已於 **2026-07-05** 在 SQL Editor 執行成功。
• 變更**Phase 1 驗收**：`check-db-schema.mjs` 欄位 **21/21** ✅；後台 session 撤銷（雙分頁登出踢出）API 測試 **全項 PASS** ✅。
• 變更**程式碼**：無新功能；本版為**部署／驗收紀錄**。

**會員語系跨裝置**：`users.locale` 同步；`PATCH /api/member/locale`；登入後 `MemberLocaleSync` 導向 DB 語系；切換語言時寫入 DB。

• 變更**會員語系跨裝置**：`users.locale` 同步；`PATCH /api/member/locale`；登入後 `MemberLocaleSync` 導向 DB 語系；切換語言時寫入 DB。
• 變更**後台 session 可撤銷**：migration `011` 新增 `admins.session_version`；登出遞增版本使所有裝置 session 失效。
• 變更**語系 Cookie 歸類**：`NEXT_LOCALE` 明確為功能型（必要 Cookie），不受 personalization 勾選限制。

**後台 UX**：左側 Sidebar 改**頂部橫向導覽**；全後台頁面 `AdminPageShell` 全寬排版。

• 變更**後台 UX**：左側 Sidebar 改**頂部橫向導覽**；全後台頁面 `AdminPageShell` 全寬排版。
• 變更**Cookie 同意 Phase 0**：`tt_consent` 改 **HttpOnly** 伺服器 Set-Cookie；移除 localStorage／client `document.cookie` 雙寫。
• 變更**分析 API**：`/api/analytics/event` 伺服器端驗證同意 Cookie；DB 失敗回 503（不再假成功）。
• 變更**語系 Cookie**：`NEXT_LOCALE` 正式環境加 `Secure`；新增 `GET /api/consent` 讀取同意狀態。

**§9.4 擴充**：上傳須註明焦點、手機／桌面比例；建議像素表（封面、Hero、地圖、影片）。

• 變更**§9.4 擴充**：上傳須註明焦點、手機／桌面比例；建議像素表（封面、Hero、地圖、影片）。
• 變更**ImageUpload 分期**：輕量版（封面 + Hero）**7 月 W4** 排入 §9.1；完整版 10 月後 Phase 1。
• 變更**路線圖**：LAUNCH-ROADMAP 7 月 W4 同步；PAGE-BUILDER-SPEC §6 媒體規格對齊。

**準則 §9.4**：前台手機與桌面同等優先；圖片預設一圖多尺寸（Cloudinary），Hero 可選手機專用圖；OP 不必每張準備兩套。

• 變更**準則 §9.4**：前台手機與桌面同等優先；圖片預設一圖多尺寸（Cloudinary），Hero 可選手機專用圖；OP 不必每張準備兩套。
• 變更**§6 第 11 條**：開發鐵律加入 RWD／圖片策略引用。
• 變更**project-constitution.mdc**：助理摘要同步；負責人備註改 §9.5。

**TipTap 稽核修復**：語系切換 `key` 重置、StarterKit 避免 Link/Underline 重複註冊、移除 ESLint 問題 effect。

• 變更**TipTap 稽核修復**：語系切換 `key` 重置、StarterKit 避免 Link/Underline 重複註冊、移除 ESLint 問題 effect。
• 變更**上架檢查**：`hasText` stripping HTML，避免空 `<p></p>` 誤判。
• 變更**sanitize**：YouTube iframe 支援自閉合標籤。
• 變更**精簡依賴**：移除 5 個冗餘 `@tiptap/*` 套件與未使用字型 helper。

**TipTap 富文本編輯器**（MIT）：後台行程描述、詳情欄位、備註、特色模組 HTML／圖文內文；視覺編輯＋原始碼、字級／字型／行高／顏色、表格、YouTube、圖片上傳。

• 變更**TipTap 富文本編輯器**（MIT）：後台行程描述、詳情欄位、備註、特色模組 HTML／圖文內文；視覺編輯＋原始碼、字級／字型／行高／顏色、表格、YouTube、圖片上傳。
• 變更**繁中字型選單**：分組 20+ 字型（Noto、Windows、macOS 系統字）。
• 變更**前台渲染**：`TourRichHtml` 支援 HTML 與舊純文字；表格、YouTube embed；`sanitize-html` 僅允許 YouTube iframe。
• 變更**開發準則**：`.cursor/rules/open-source-first.mdc`；`CONSTITUTION.md` §6.10 開源優先。

**版本紀錄制度**：新增 `docs/VERSION-CHANGELOG.md`（版本編號、changelog、WIP）。

• 變更**版本紀錄制度**：新增 `docs/VERSION-CHANGELOG.md`（版本編號、changelog、WIP）。
• 變更**同步報告腳本**：`node scripts/version-report.mjs`（家裡／辦公室 pull 後必跑）。
• 變更**大綱準則**：`CONSTITUTION.md` §1d、§6.9、§8.5；更新 §9.5、§十一現況。
• 變更**Cursor 規則**：助理每次對話讀版本、push 後報告版本編號。

**Migration 010**：新增 `tour_content_blocks`、`tour_flights`、`tour_departures` 三表。

• 變更**Migration 010**：新增 `tour_content_blocks`、`tour_flights`、`tour_departures` 三表。
• 變更**後台行程編輯**：分頁「行程特色」（7 版型）、「航班」、「出發日期」；API 完整串接。
• 變更**前台行程詳情**：渲染特色模組、航班表、出發日期區塊。
• 變更**移除假資料**：`tours-data`、`home-data`、`destinations-data` 不再 fallback 假行程／假目的地；DB 空則前台空狀態。
• 變更**會員「我的詢問」**：接 Supabase（依 `user_id` 或 `email`）。
• 變更**後台修復**：儀表板、詢問管理 Unicode 亂碼改繁中；ESLint React hooks 8 項 error 修復。
• 變更**工具**：`scripts/check-db-schema.mjs`（含 010）、`.env.example`、`.gitignore` 允許 example。

新增 `scripts/compare-local-sync.mjs`：家裡／辦公室各跑一次，bundle hash 相同即 Git 追蹤檔一致。

• 變更新增 `scripts/compare-local-sync.mjs`：家裡／辦公室各跑一次，bundle hash 相同即 Git 追蹤檔一致。

Hero 橫幅 CMS（`banners` 表、後台首頁管理）。

• 變更Hero 橫幅 CMS（`banners` 表、後台首頁管理）。
• 變更四色系主題（`site_theme` settings）。
• 變更多語系字型調整；行程列表仍含 fallback（**v0.10.0 已移除**）。

補齊多語系翻譯；合併繁中為 `zh-TW` 後台語系。

• 變更補齊多語系翻譯；合併繁中為 `zh-TW` 後台語系。

行程發布檢查清單（`PublishChecklist`）。

• 變更行程發布檢查清單（`PublishChecklist`）。
• 變更品牌更名為航向世界旅遊／tcawg。
• 變更詢價通知信箱 fallback。

後台行程 Sprint 2：交通、集合地點、取消政策、自費項目、簽證保險欄位（`007` migration）。

• 變更後台行程 Sprint 2：交通、集合地點、取消政策、自費項目、簽證保險欄位（`007` migration）。

後台每日行程編輯器、Cloudinary 上傳、`map_image_url` 地圖圖欄位。

• 變更後台每日行程編輯器、Cloudinary 上傳、`map_image_url` 地圖圖欄位。

新增 `docs/CONSTITUTION.md` 大綱準則。

• 變更新增 `docs/CONSTITUTION.md` 大綱準則。
• 變更Cookie 同意、語系自動導向、Page Builder 規格初稿。

全站連結稽核；`ARCHITECTURE-NOTES.md` 初版。

• 變更全站連結稽核；`ARCHITECTURE-NOTES.md` 初版。

依 `CLAUDE.md` 心智圖第一次全面改寫 Next.js 旅遊站。

• 變更依 `CLAUDE.md` 心智圖第一次全面改寫 Next.js 旅遊站。