平台詳細架構

狀態：公開草案

版本：0.1.0

更新日：2026-08-20

架構目標

本文件同時描述網站資訊架構、資料生命週期、使用路徑與維護邊界。它不是只有工程團隊看得懂的系統圖，而是讓商品提供單位、採購者、資料維護者與資源夥伴都能確認「資訊從哪裡來、誰能改、使用者會被帶到哪裡」。

四層服務架構

1. Discover｜發現

把已查核的商品與服務整理成可搜尋、可篩選且能理解的目錄。

核心資訊：名稱、單位、地區、分類、價格說明、圖片、來源與查核註記。
使用功能：關鍵字搜尋、分類篩選、瀏覽器本機收藏。
公平原則：不因贊助、有薪關係或合作規模購買排序優勢。

2. Verify｜查核

在公開前留下可追溯的依據，並允許發布後更正。

優先採用原單位、政府或其他可合理辨識的第一方來源。
對價格、圖片與商品名稱分別查核，不因一個連結有效就推定所有欄位正確。
記錄查核日期、來源類型與必要限制。
依資料治理處理更正、爭議與下架。

3. Visit｜回到單位

商品卡片的主要行動是「前往單位／商品頁」。平台不攔截交易，也不把收藏偽裝成訂購。

外部連結應清楚標示目的地。
原單位頁面上的庫存、價格、交期及服務條件優先於平台摘要。
外部網站有自己的隱私與無障礙狀態；平台不能代為保證。

4. Handoff｜線下接手

當需求跨品項、跨單位、規模較大或仍需釐清時，網站協助使用者整理需求並開啟電子郵件草稿。

使用者仍需自行確認並寄出郵件。
開啟草稿不等於平台已收到、立案或承諾回覆。
後續若建立案件系統，必須先更新隱私、保存期限、權限與安全說明。

網站資訊架構

A. 了解平台

平台緣起與公共任務。
平台邊界與不承諾事項。
目前資料範圍與查核方法。

B. 找商品與服務

目錄總覽。
搜尋、品類與收藏篩選。
商品／服務卡片與原始來源。
資料更正及下架入口。

C. 完成採購路徑

個人：搜尋 → 查看來源 → 洽原單位。
組織：建立清單 → 查原單位條件 → 必要時線下接手。
跨單位需求：整理目標與限制 → 產生郵件草稿 → 使用者寄出。

D. 共同維護

專案、架構與路線圖。
資料治理、隱私、安全及無障礙。
維護者、貢獻、資源合作與行為準則。
決策、利益衝突、更正、申訴及變更紀錄。

核心內容模型

Listing｜商品或服務

必要識別欄位包括穩定 ID、公開名稱、提供單位、分類及地區；查核欄位包括來源連結、來源類型、查核說明及更新日期；展示欄位可以包括圖片、參考價格、標籤與簡短描述。

Listing 只是一筆可追溯的公開摘要，不是庫存單位、交易合約或品質評分。

Organization｜提供單位

描述實際提供商品或服務的庇護工場或其所屬單位。未經充分查核，不把品牌名稱、法人名稱與營運據點混為一談。

Source｜來源

保存來源網址、來源名稱、來源類型、最後查核時間與適用欄位。單一 Listing 可以有多個來源，並可針對名稱、價格、圖片分別指定依據。

Change｜變更

記錄新增、更正、暫時隱藏、下架與恢復的理由、證據及決定角色。公開紀錄需排除個資、安全細節與依法不得揭露的內容。

Contribution｜貢獻

包含資料提案、文件修訂、程式變更、設計檢查及社群回饋。貢獻被採用不會自動產生聘僱、報酬、治理席位或永久存取權。

Resource｜資源

可包含有條件的經費、專業服務、工具額度、設備或合作管道。接受資源前須記錄用途、限制、利益衝突與是否公開；資源不得換取商品排序或內容審核特權。

資料流

提出：提供來源、欄位、理由與必要證據。
初檢：排除個資、侵權風險、失效連結及無法辨識的主張。
交叉查核：依欄位確認第一方或政府來源；有衝突時不推測。
審閱：由未具直接利益衝突的維護角色確認。
發布：網站建置與基本檢查通過後公開。
監測：透過回報、定期抽查或連結檢查發現變動。
更正／下架：依風險先暫時隱藏，再補足證據與決定紀錄。

技術邊界

公開網站是資訊入口，不處理金流、庫存或訂單。
收藏資料保存在使用者瀏覽器本機；清除網站資料或更換裝置可能消失。
線下接手目前以電子郵件草稿為介面，不是後端案件系統。
第三方圖片與連結可能變更或失效；平台保留來源並依治理流程處理。
正式網站由版本控制的主分支觸發自動部署。發布紀錄應可回溯到版本提交與變更說明。

權限架構

採最小權限與職責分離：

公開訪客：讀取、搜尋、收藏及提出回饋。
貢獻者：提出變更，沒有直接發布權。
資料審閱者：檢查來源與欄位，不因合作或贊助關係取得特權。
維護者：審閱與整合已通過檢查的變更。
發布維護者：管理正式部署所需的有限權限。
安全聯絡人：私下接收弱點資訊並協調修復。
專案守護角色：處理重大邊界、申訴及權限例外，但須留下理由與利益衝突紀錄。

同一人可在資源有限時兼任，但須公開兼任狀態；涉及自身利益、所屬組織或有薪工作時應揭露並迴避。

變更層級

一般內容變更：文字、失效連結、可直接證實的欄位更正。
資料爭議變更：來源衝突、圖片權利、單位要求下架或可能造成損害的資訊。
功能變更：搜尋、收藏、表單、分析工具或新增個資處理。
治理變更：角色權限、排序原則、資源條件、申訴及決策規則。
緊急變更：安全事件、敏感資料外洩或明顯侵權風險，可先採最小必要處置，之後補記理由。

詳細決策方式見共同治理。

架構健康指標

可公開追蹤但不構成 SLA 的項目包括：失效來源數、待查核資料數、資料更正類型、無障礙問題、貢獻者留存、決策集中度、維護工作量與有薪／無薪工作占比。公開數字時須說明資料範圍、算法、遺漏與解讀限制。