架構與工作流程說明書

提供可查證的移工安置制度與機構研究索引，回答「誰設立、誰承接、誰出錢、誰監督」。它不是即時庇護所名錄，也不是緊急轉介入口。

• 區分一般臨時安置、人口販運庇護、駐台代表處安置、婦幼特殊安置與仲介住宿，不虛構全國總數。
• 歷史安置紀錄不等於現在仍在營運或持有政府契約。
• 不收集個資、不提供上傳、不公開受庇護者非公開位置。

配色（依 wen8604 設計規範 v1.0）

內文對比 ≥ 4.5:1；金色只用於深色底或當底色配黑字。插圖顏色全部以 CSS 變數控制，深色模式自動轉為夜景（月亮、星星、窗戶亮燈）。

三種裝置版型

友善模式細部設定

• 單一 HTML 檔，零外部字型與零外部腳本；使用系統內建的思源黑體／微軟正黑體。
• 圖示改為內嵌 SVG sprite（<symbol> + <use>），插圖為向量，不需載入任何圖片。
• 分頁切換只切換顯示，不重新請求；資料卡片用 DocumentFragment 式建立，搜尋加防抖。
• 訪客統計延後到瀏覽器閒置時才呼叫（requestIdleCallback），不影響首屏。
• Cloudflare 自動 Brotli 壓縮、HTTP/3 與全球節點；HTML 每次重新驗證，確保更新立即生效。
• 上線後以 Lighthouse 量測：目標 LCP < 1.5 秒、CLS < 0.05、效能分數 ≥ 95。

1. 頁面載入後閒置時：若是本工作階段第一次造訪送 POST /api/visit，之後只送 GET 讀取。
2. 邊緣函式判斷：排除爬蟲、無頭瀏覽器與 Cloudflare 判定的機器人；拒絕跨網域 POST。
3. 去重：以「IP＋瀏覽器＋日期＋鹽」做 SHA-256，存 48 小時後自動刪除；同一人同一天只算一次。
4. 累加：total 與 d:YYYY-MM-DD 兩個計數器各加一，回傳累計與今日人次。
5. 顯示：頁尾「累計造訪 N 人次・今日 n」；若 API 失敗或數字為 0，整塊隱藏。

更新時間：每次執行 deploy.ps1 會把當下時間寫入兩個頁面的 build-time 與 version.json，並在 deploy-log.txt 記一筆。

{
  "id": "organization-001",
  "name": "組織名稱",
  "category": "government | shelter | education",
  "shelter_contract_status": "documented | unverified",
  "description": "已查得服務與限制",
  "source_ids": ["S01"],
  "reference_year": 2022,
  "last_verified_at": "2026-10-27",
  "operating_status": "unknown",
  "reviewer": "待指派",
  "revision_notes": "需取得正式函覆"
}

同一團體可有多種服務類型；正式資料庫應以多對多關聯表（organizations、services、facilities、contracts、grants、evidence、revisions）處理。設施與法人分開，避免重複計算。

1. 提案：建立待查問題，明確統計期間與定義。
2. 取證：法規、標案、審計報告、官方年報優先；保存網址、發布日、擷取日。
3. 分級：官方直接證實／歷史有據／尚待驗證／已更正／已撤回。
4. 核對：高風險資訊至少兩位編輯交叉覆核；涉及機構聲譽須給予回應機會。
5. 去重：依法人識別碼、設施識別碼、契約案號與年度比對。
6. 審核：法規適用、統計單位、推論限制、個資遮蔽、中性用詞與來源連結。
7. 發布：更新資料陣列 → 執行 deploy.ps1，自動記錄更新時間與摘要。
8. 勘誤：公布錯誤位置、來源與更正日期；不默默改寫重要結論。

第一次設定（約 5 分鐘）

1. 安裝 Node.js LTS（nodejs.org）。
2. 雙擊 deploy.bat。第一次會開啟瀏覽器，請登入 Cloudflare 並按「Allow」授權。
3. 腳本會自動建立 KV「VISITS」、填入 wrangler.toml、建立 Pages 專案 migrant-shelter-research 並上傳。
4. 完成後網址為 https://migrant-shelter-research.pages.dev；可在 Cloudflare 後台 Pages → 自訂網域 綁定自己的網域。

日常更新

# 1. 修改 site\index.html 內的 ORGS／SOURCES 等資料陣列或文字
# 2. 本機預覽（含統計 API）
preview.bat                      # 開啟 http://localhost:8788
# 3. 上傳（可附更新說明）
.\deploy.ps1 -Message "新增 2026 年勞動部安置名冊"

回復上一版

Cloudflare 後台 → Workers & Pages → 本專案 → 部署 → 找到上一個成功版本 →「Rollback to this deployment」，數秒內生效，訪客統計不受影響。

• 六分頁單頁應用、滑順切換、舊網址相容
• 手機底部列／平板滑動分頁／桌機分頁指示器
• 重新繪製的主視覺插圖、分頁插圖與 45 個圖示，深色模式夜景
• 文章與說明全面可收合，含全部展開／收合
• 深色模式＋友善模式 8 項細部設定，跨站共用設定
• 網站更新時間自動寫入、獨立訪客統計（排除機器人）
• Cloudflare 安全標頭、一鍵部署、本機預覽
• 全台政府安置名冊與委託契約逐筆去重
• 機構狀態正式函覆、印尼據點精確開設日期
• 真機 WCAG 2.2 AA 稽核與螢幕閱讀器實測
• 公開勘誤紀錄頁與資料版本差異

角色：資料研究員收集來源；主編審核推論與措辭；法務／資安審查敏感內容；工程師管理程式、部署、備份與監測。任何人都不應在缺乏原始資料時自行更改數字或指控機構。