# 台灣廟宇文化卡片系統 — 規格與交付文件 v1.0

## 1. 目標與原則
故事與探索留在站內；準備到訪時順暢交給 Google Maps。不得以登入、表單或追蹤成功作為導航門檻。尊重原有廟務、儀式與財務管理；創作 follows。

成果分為有效閱讀、到訪意向、確認到訪與再次參與；不可相互替代。每次報告列投入、證據、歸因限制與增加／調整／停止的決策。

## 2. 10 種卡片與組合

|ID|類型|意圖|形式|核心順序|選配|
|---|---|---|---|---|---|
|C01|廟宇名片|這是哪間廟？|identity|S01 → S02 → S03|S04, S05, S09|
|C02|第一次參訪卡|我可以去嗎？怎麼準備？|checklist|S06 → S07 → S08 → S03|S02, S04, S05|
|C03|地方故事卡|這裡有什麼故事？|editorial|S09 → S10 → S14|S11, S12, S22|
|C04|服務神明的人物卡|誰在照顧與傳播文化？|portrait|S15 → S16 → S19|S14, S28|
|C05|神明之歌聲音卡|我想聽、理解與分享|sound|S17 → S18 → S19|S09, S11, S15|
|C06|神明此處一遊導覽卡|附近怎麼走、看什麼？|route|S20 → S21 → S03|S04, S08, S22, S25|
|C07|祭典與遶境活動卡|什麼時候？如何參與？|date|S24 → S25 → S26|S23, S03, S08, S27|
|C08|看懂文化知識卡|這個儀式或物件是什麼意思？|question|S13 → S12 → S11|S14, S18|
|C09|參與與服務卡|我能幫什麼忙？|action|S28 → S24 → S25|S15, S27, S31|
|C10|成果與支持卡|投入帶來什麼幫助？|evidence|S31 → S27 → S32|S19, S28|

共用 S29 收藏、S30 分享、S32 來源，以低干擾入口呈現。每卡一個主要動作；不必放滿區塊。

## 3. 32 個 Section

|ID|名稱|使用者意圖|Renderer|必要資料|
|---|---|---|---|---|
|S01|廟宇識別|我找到的是哪一間廟？|identity|廟名、所在地、主照、介紹|
|S02|參訪資訊快覽|現在適合前往嗎？|facts|開放資訊、確認日期|
|S03|地圖與導航|我要怎麼到？|map|地址、Google Place ID、核對人與日期|
|S04|抵達與入口|到附近後從哪裡進？|steps|入口照片、交通說明|
|S05|開放與臨時異動|今天有沒有變更？|notice|公告、有效期間、發布者|
|S06|第一次參訪|第一次來要知道什麼？|steps|步驟、參訪清單|
|S07|禮儀與拍攝|哪些可以做、哪些先詢問？|faq|廟方確認的情境問答|
|S08|友善參訪條件|我的同行者適合嗎？|facts|設施、限制、聯絡方式|
|S09|廟與地方的故事|這裡有什麼故事？|story|敘事、授權照片、來源|
|S10|沿革時間軸|這間廟如何走到今天？|timeline|年代、事件、資料來源|
|S11|信仰與傳說|當地如何理解這份信仰？|story|敘事、文獻或口述性質|
|S12|建築與工藝|眼前看到的是什麼？|gallery|照片、工藝圖說、授權|
|S13|儀式與文化解釋|這個動作或物件的意義？|faq|問題、解釋、審閱來源|
|S14|地方口述記憶|當地人怎麼說？|quote|引言、受訪同意、逐字稿|
|S15|服務者與 KOL 介紹|誰在做這些事？|person|人物、角色、廟方關係|
|S16|人物作品集|可以看哪些作品？|list|作品標題、站內路徑|
|S17|歌曲播放器|我想直接聽|audio|授權音檔、曲名、署名|
|S18|歌詞與多語理解|歌裡唱的是什麼？|lyrics|原文、譯文、翻譯審閱|
|S19|創作與授權資訊|誰創作？能否合作？|facts|作者、使用權、合作窗口|
|S20|導覽路線總覽|該選哪條路線？|list|站數、時間依據、適用條件|
|S21|逐站導覽|下一站看什麼、怎麼到？|steps|站點故事、核對過的地圖|
|S22|鄰近文化探索|附近還有什麼？|list|相關故事與廟宇站內連結|
|S23|活動行事曆|最近有哪些活動？|timeline|日期、類型、主辦確認|
|S24|活動詳情|這場活動適合我嗎？|event|意義、日期、主辦、參與方式|
|S25|行前準備|出發前要準備什麼？|checklist|已確認的準備清單|
|S26|活動更新|現在有哪些確認消息？|notice|公告時間、來源、有效性|
|S27|活動回顧|留下了什麼？|gallery|授權影像、故事、拍攝日期|
|S28|志工與參與方式|我能如何幫忙？|steps|需求、角色、時段、聯絡|
|S29|收藏與再次探索|下次如何接著看？|save|內容 ID、同主題連結|
|S30|分享與文化傳播|我想介紹給別人|share|站內分享 URL、標題|
|S31|成果與資源使用|用了多少、帶來什麼？|report|投入、證據、歸因限制、下一步|
|S32|來源、更正與聯絡|資訊可信嗎？錯了找誰？|sources|來源、確認日期、更正窗口|

## 4. 資料與發布規則
單一來源為 lib/temples/catalog.json。卡片含 id、slug、intent、action、visual、core、optional；Section 含 id、intent、layout、required。
TemplePage 含 name、locale、status、approvedBy、approvedAt、address、placeId、locationVerified、blocks。Block 含 text、items、source、confirmedAt、audioUrl、authorized。
- draft 與示例 noindex，不加入 sitemap。不編造廟名、地址、日期、授權、到訪或 ROI。
- 正式資料需廟方確認；內容應區分文獻、口述、傳說、編輯整理。確認人姓名為內部紀錄，公開需另確認。
- publicationIssues() 提供核心完整性檢查；它不取代人工核實、媒體授權與現場安全審閱。
- Google Maps 連結採標準 URL + api=1 + Place ID。沒有核對地址與 Place ID 就不產生示例導航。
- 不擷取／複製 Google 評論、照片或營業資料；未實作 Places API 同步。
- 無已授權音檔不顯示播放按鈕；無真實活動日期不顯示倒數；不得把預定路線當即時位置。
- 英文是資料模型支援語言；本版工作台與示例內容為繁體中文，翻譯須獨立審阅，不假裝已完成全球化。

## 5. 路由與呈現
- /temples：10 類卡片選擇、手機卡片預覽、核心／選配組合、32 區塊清單。
- /temples/cards/[type]：對應意圖的獨立示例頁，讀取同一份映射。
- /temples/spec：下載規格；/temples/catalog：下載機器可讀的 JSON。
- 範本不是實際廟宇官網；與既有工業詢價頁分離，不修改 B2B 首頁。
- 本機草稿可儲存／讀回／刪除與下載，不代表已送交廟方或發布到資料庫。

## 6. 衡量契約（正式收錄前接入）
|事件|定義|不代表|
|---|---|---|
|card_open|卡片進入對應内容頁|到訪|
|story_engaged|經同意量測的有效閱讀|理解或信仰認同|
|map_open|開啟地點|已抵達|
|directions_open|啟動導航連結|實際到訪|
|save|主動收藏|會員或信徒人數|
|share_intent|開啟分享介面|分享完成|
|share_complete|可確認的分享成功／複製完成|收件者閱讀|
|visit_confirmed|自願回報或合作方確認，標記證據來源|可全部歸因的新增到訪|
|repeat_participation|经同意、可確認的再次參與|瀏覽器回訪|

本版不產生正式成效數據，示例互動不得混入實際成效。後續量測需 consent、內部／機器人排除、campaign/card/content ID；不蒐集信仰分類或精確定位。沒有同意或網路失敗仍可導航。
投入記錄現金、工時、志工新增負擔；平台與廟方收入分開，捐獻不預設為平台營收。
每位可歸因實到者成本 = 成本 / 可歸因實到者。分母為 0 或缺資料時顯示「無法計算」。
ROI = (可歸因新增毛利 - 推廣成本) / 推廣成本；成本為 0 或歸因不足時不顯示百分比。

## 7. 階段與責任
1. 一間小廟：C01/C02/C03，廟方確認、資料核對、首次參訪者測試。
2. 同區 3–5 間：加入相關故事與更新窗口；測試變更公告。
3. 大廟／遶境：主辦核准活動資料、責任人、授權與更新機制。
4. 海外：依真實需求增加語言與文化合作；每個語言有維護人。
PO 負責範圍與驗收；廟方審閱者負責文化與現場資訊；編輯負責來源授權；工程負責可用性；Growth 負責量測與歸因。時間與收入均不保證。

## 8. 驗收
- 10 個卡片 ID 唯一，32 個 Section ID 唯一；所有映射存在。
- 每類核心順序固定，選配不重複，S32 始終可取得。
- 320/390/768/desktop 不橫向溢出，文字 16px，觸控操作至少 44px。
- 卡片連結為真實 anchor；收藏與分享有成功／失敗回饋。
- 範本 noindex、不加入 sitemap，不出現虛構證據或生效導航。
- 確認地點的 Maps URL 正確編碼，無登入 gate；追蹤不阻擋導航。
- 正式播放、活動、捐獻、報名、雲端 CMS、量測儀表板需真實資料與後續整合；本版不宣稱已開通。

## 9. 技術來源
Google Maps URL 官方文件：https://developers.google.com/maps/documentation/urls/get-started

## 10. 本版驗證紀錄

- TypeScript 型別檢查通過。
- 10 種卡片、32 個區塊與完整映射覆蓋檢查通過。
- 未核對地址不提供導航；Maps 參數編碼、音檔授權缺漏檢查通過。
- 瀏覽器操作確認：切換聲音卡、切換草稿頁籤、修改名稱、保存與讀回本機草稿。
- 390px 手機與 768px 平板 iframe 排版目視確認；未涵蓋實機 Safari。
- 本版為模板工作台；不是已完成廟宇上架、後台 CMS 或實際成效收集。