# 一個流程，三種接入方式

新接入一律由 OpenDashboard 定義流程、驗證及保存正式答案。外站可選擇自己的外觀；這不會改變誰負責答案與進度。

## 從流程開始

在「流程管理 → 報名流程」完成表單和步驟，發佈後進入「網站接入」建立入口。該頁提供：

| 接入方式 | 用途 | 金鑰 |
| --- | --- | --- |
| 報名連結 | 分享給參加者或放在網站按鈕 | 不需要 |
| iframe | 在自己網站顯示 OpenDashboard 填表頁 | 不需要 |
| 自訂 UI API | 自己的網站繪製表單，透過後端提交 | 在此流程內啟用專屬金鑰 |

閱讀[流程接入完整教學](workflow-ui.md)。三者共用流程的規則和申請資料；每個公開入口開始新申請，私人憑證用於繼續同一申請。不能按姓名或電郵認領歷史資料。

## 填表與查看可以分開安排

| 情況 | 如何接 |
| --- | --- |
| 平台填表，平台管理 | 使用連結或 iframe；管理員在申請進度查看 |
| 外站及平台都填表，平台管理 | 外站用流程 API；同一申請沿用私人憑證及版本 |
| 兩邊填表，兩邊看參加者自己的資料 | 外站後端核對身份後，用流程 API 讀回該申請 |
| 外站需要全體管理名單或報表 | 需要另外配置管理／報表權限；流程填表金鑰不提供全體名單 |

網站可以保存申請對應、登入身份及必要副本；正式答案和流程狀態以 OpenDashboard 為準。不需要先同步另一份答案庫才顯示成功，也沒有「選擇兩邊保存」的流程模式開關。

停止新報名與停用 API 分開管理。前者阻止新申請，後者阻止該金鑰的自訂 UI 存取；已有平台私人連結仍可使用。發佈新版本不會改寫舊申請。

## 既有原站回寫整合的維護

下列是既有特殊整合的相容路徑，不是新流程可選的資料模式。原站仍保存正式答案時：

```text
原站填表 → 原站驗證及保存 ───────────────────┐
                                           ├→ 變更通知 → OpenDashboard 正式回覆／報表
OpenDashboard 填表 → 待處理指令 → 原站驗證保存 ┘
                         ↑          │
                         └─ 接受／拒絕確認
```

OpenDashboard 的 `/apply/{slug}` intake 目前就是這種接法。它保存私人草稿及指令，等待原站確認；原站再將正式答案同步回既有表單。適合已匯入舊資料、仍要保留原站評審的系統。完整接法見[原站回寫](intakes.md)。

兩邊各存一份時，仍只選一邊作正式寫入依據。來源版本、指令重試和資料對應由接入層維護；原站修改引起版本衝突時需核對，不會自動合併。現有 intake 不會替兩邊帳戶自動建立可互相編輯的登入關係。

這個指令通知專門服務原站回寫，不是通用的「所有回覆變更 webhook」。新流程另有 [workflow.application.changed 通知](workflow-sync.md)，可通知外站讀取副本；接收端仍需可靠保存、重試及補漏，沒有自動雙向合併或跨資料庫交易保證。

## 已有整合的遷移界線

既有原站回寫仍按原合約運作。若日後切換主導方，需要另行核對欄位、申請身份、附件、版本及待同步工作；新流程或新金鑰不會自動搬遷歷史資料，也不會替歷史參加者發放私人連結。

已連接的原站報名入口亦會出現在「流程管理」的流程列表。進入後可切換查看原有表單回覆（包含已匯入及後續同步資料）、開啟同一回覆者的另一份表單，以及複製既有公開填表連結。這是管理檢視，不會建立新的流程申請、改變原站確認方式或重新發放私人連結。待原站確認的新入口申請另列於入口紀錄。

點入流程後，用表單分頁查看資料、「填表連結」取得公開網址、「設定」查看同步說明及新報名傳送紀錄。舊有管理網址繼續有效。新流程請直接進入流程內的「網站接入」，不必在兩個管理畫面之間建立設定。

獨立表單仍在表單管理使用原有連結。流程步驟可引用有管理權限且題型相容的獨立表單；只引用問題，不搬移歷史答案。發佈時保留內部版本，預設不混入獨立表單列表。已有普通 forms、應用管理、報表及原站回寫 API 保留相容合約；詳細見[API 參考](reference.md)及[既有原站回寫](intakes.md)。


## 流程資料副本

外站需要接收 OpenDashboard 報名與作品資料時，使用[流程資料同步](workflow-sync.md)：核對表單與步驟對應、沿用固定申請編號，並在「網站接入」設定資料變更通知。