版本紀錄

版本號採 semver：主版號＝不相容的行為變更，次版號＝新增主題或端點，修訂號＝文字修正。

• 1.6.0（2026-11-06）
• 1.5.0（2026-11-06）
• 1.4.2（2026-11-06）
• 1.4.1（2026-11-06）
• 1.4.0（2026-11-04）
• 1.3.2（2026-11-04）
• 1.3.1（2026-11-04）
• 1.3.0（2026-11-04）
• 1.2.0（2026-11-04）
• 1.1.1（2026-11-02）
• 1.1.0（2026-11-02）
• 1.0.4（2026-10-30）
• 1.0.3（2026-10-30）
• 1.0.2（2026-10-30）
• 1.0.1（2026-10-30）
• 1.0.0（2026-10-30）

1.6.0（2026-11-06）#

• 需求方窗口：新增 PUT /api/v1/organization/members/{user}/requester-access（body enabled），admin 可讓內部成員（admin／staff）用同一個帳號兼任需求方。開了開關的成員可以被 POST /api/v1/requester/tasks/{task}/conversations 指定為 requester_user_id，並從 /r 看到自己的對話；關掉後立刻失效。

1.5.0（2026-11-06）#

• 需求方窗口：新增 POST /api/v1/requester/tasks/{task}/conversations（body requester_user_id、選填 body），從票出發替指定需求方開對話並綁票，回 201 {data:{conversation_id, task_id}}。限該票流程的事務負責人或組織管理員；票已有對話回 409 conversation_exists 並帶既有 conversation_id；票已掛另一位需求方回 409 requester_mismatch；對象不是需求方回 422。需求方會收到 conversation_opened 事件。之後照常用 conversations/{id}/posts、cards 發訊息與問卷卡。

1.4.2（2026-11-06）#

• 需求方窗口：判斷「已取消」時，進結束站的來源站若只有一條出口（例如事務報告站只有「報告完成」），就往前看進入那一站的出口，直到遇到有選擇的出口。取消出口先進事務報告再結束的票，會顯示「已取消」而不是「已交付」。

1.4.1（2026-11-06）#

• 需求方窗口：補寫站屬性 requester_dialog（discuss／deliver）與需求方狀態換算。票到結束站或存查站時，只有從取消類出口（tone=negative，或來源站是異常站）進結束站才顯示「已取消」，其他都算「已交付」，流程沒設交付站也一樣。

1.4.0（2026-11-04）#

• 需求方窗口：問卷每題多一個需求方自填的「其它」（文字／附件／貼圖），card 新增 others（題號 → {text, attachment_ids}），選其它時 answers[i] 是 "其它"。

1.3.2（2026-11-04）#

• 專案：錯誤碼表 423 改寫「請負責人或組織管理員解除封存」；507 的「組織管理者」統一成「組織管理員」。

1.3.1（2026-11-04）#

• 需求方窗口：補寫卡片失效規則。票離開發卡那一站，還沒答的問卷／確認卡會變 stale: true，需求方答不了；等答案時別先送出口，已轉站就在新站重發。

1.3.0（2026-11-04）#

• 專案權限依老闆 11/4 問卷答案：取消管理級、建立與轉交改回只限 Admin。
  • 成員等級只剩 read／write；PUT https://station-flow.staging.quanhox.com.tw/api/v1/projects/{code}/members 送 manage 回 422，既有 manage 成員已改成 write。
  • POST https://station-flow.staging.quanhox.com.tw/api/v1/projects 只限組織 admin（其他人 403），owner_user_id 由 admin 指定，沒帶就是自己。
  • transfer_owner 改成只限 admin；轉交後原負責人以 write 留在成員名單。
  • 負責人可以管成員、改屬性與名稱、看稽核、封存／解除封存、匯出；刪除與匯入仍只限 admin。
  • can 新增 create。

1.2.0（2026-11-04）#

• 新增主題需求方窗口：誰是窗口、GET https://station-flow.staging.quanhox.com.tw/api/v1/me/requester-events 事件游標、https://station-flow.staging.quanhox.com.tw/api/v1/requester/conversations 的回覆、開票、轉手、退回、進度、交付、問卷與確認卡。
• 例行事務窗口改用事務負責人（owner）：routines 的 requester_window_user_id 移除，回應不再有這個欄位，送了會被忽略。換事務負責人時，舊負責人手上未結束的需求方對話一起轉給新負責人。
• 總覽：組織身份補 requester（需求方）。

1.1.1（2026-11-02）#

• 專案：補兩個 422——轉交給現任負責人；manage 成員在 PUT https://station-flow.staging.quanhox.com.tw/api/v1/projects/{code}/members 調降或移除自己（送名單要把自己那列照原樣帶上）。

1.1.0（2026-11-02）#

• 專案權限改版：新增成員等級 manage（管理，共同負責人）；任何組織成員都可以建立專案並自動成為負責人；負責人可以管成員、改名稱、轉交、封存、匯出；刪除與匯入仍只限 admin。
• GET https://station-flow.staging.quanhox.com.tw/api/v1/projects、GET https://station-flow.staging.quanhox.com.tw/api/v1/projects/{code} 新增 can（每個動作能不能做），請改看 can，不要自己比 my_access。
• 轉交負責人後原負責人自動變成 manage 成員；成員名單不能包含負責人（422）。

1.0.4（2026-10-30）#

• 事務負責人說明改為「開始、結束、異常站的處理者，並負責存查」（存查站仍由系統自動維護，行為不變）。
• 角色與站角色端點（DELETE https://station-flow.staging.quanhox.com.tw/api/v1/roles/{id}、DELETE https://station-flow.staging.quanhox.com.tw/api/v1/roles/{id}/users/{userId}、POST https://station-flow.staging.quanhox.com.tw/api/v1/routines/{routineId}/station-roles、PUT／DELETE https://station-flow.staging.quanhox.com.tw/api/v1/station-roles/{id}）讓系統站少了事務負責人時回 422，整筆不生效。

1.0.3（2026-10-30）#

• 例行事務新增事務負責人 owner_user_id：建立時省略＝建立者，自動成為開始、結束、存查、異常站的處理者；換人四站同步；系統站送出的處理者少了負責人回 422。不再自動建「流程負責人」角色。
• GET https://station-flow.staging.quanhox.com.tw/api/v1/routines、GET https://station-flow.staging.quanhox.com.tw/api/v1/routines/{id} 回 owner；GET https://station-flow.staging.quanhox.com.tw/api/v1/tasks/{id} 回 routine_owner。

1.0.2（2026-10-30）#

• 總覽：教怎麼用 station-assignees 找到能開票的 routine；提醒別在正式 routine 開測試票；時間欄位寫明一律 UTC。
• 任務：補 current_station_role_id、process_version、checklist、entry_criteria、出口的 next_station_id／is_return、紀錄的 transition_tone／is_return；附留言回應和 /logs 的格式差異。
• 附件、專案、報表：範例環境變數統一為 $SF_KEY。
• 專案：補 md 內嵌圖片的寫法。
• 存成 skill：If-None-Match 要帶雙引號；version API 新增 entry（agent.md 的 sha256）。
• 正文連結改用主題名稱當顯示文字。

1.0.1（2026-10-30）#

• 總覽：修正首段粗體顯示；「其他主題」清單改成可點的連結。

1.0.0（2026-10-30）#

• 首版：總覽、任務、附件、專案、流程設計、報表、存成 skill、版本紀錄。