# 版本紀錄

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

## 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）

- 新增主題[需求方窗口](https://station-flow.staging.quanhox.com.tw/agent/requester-window.md)：誰是窗口、`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、版本紀錄。