SunFlow 企業流程管理平台 — 版更紀錄
目前網頁版本：v1.0.1
更新日期：2026-10-26

網頁版採 MAJOR.MINOR.PATCH 語意化版本；Sites 發布序號與 iOS／Android App 版本各自獨立。

[網頁 v1.0.1] 2026-10-26 14:55:02（台灣時間）
- 修正版更文字檔的 UTF-8 編碼辨識，避免瀏覽器顯示中文亂碼。
- 修改：更新建置或系統設定（scripts/release-version.mjs）
- 修改：更新驗證測試（tests/release-version.test.mjs）

[網頁 v1.0.0] 2026-10-26 14:52:39（台灣時間）
- 版本制度由 v222 切換至 v1.0.0；參考 SUNCRM 建立語意化版本管理；依內容變更分類遞增版號、自動記錄變更檔案，重複建置不加號，保留既有紀錄並同步系統與產品介紹頁版本。
- 修改：更新建置或系統設定（scripts/RELEASE.md）
- 修改：更新建置或系統設定（scripts/prepare-release.mjs）
- 修改：更新建置或系統設定（scripts/release-version.mjs）
- 修改：更新驗證測試（tests/release-version.test.mjs）
- 修改：更新建置或系統設定（vite.config.ts）

--- 以下保留原版更紀錄 ---
SunFlow 企業流程管理平台 — 版更紀錄
目前網頁版本：v222
更新日期：2026-10-14

網頁版沿用系統發布序號；iOS／Android App 另列版本及建置號碼。
本檔自 v210 建立，以下補列可確認的近期紀錄；並非完整歷史版本清單。

[網頁 v222] 2026-10-14
- 授權公司改為可搜尋的多選下拉選單，收合顯示已選公司，支援鍵盤操作及點擊外部收合。
- 有效期限新增無期限，仍受撤銷、公司啟用狀態及資料範圍限制；既有授權期限不變。
- 新增指定提供欄位的多選下拉選單，請假與出差 API 依金鑰回傳所選欄位，固定保留單據 ID 與公司 ID，未選欄位不回傳。
- 更新授權清單、串接說明及 OpenAPI 規格；既有授權保留全部標準欄位。

[網頁 v221] 2026-10-14
- 建立公司唯讀授權的授權公司改為勾選多家，授權清單顯示全部公司，既有單公司金鑰保持原範圍。
- 請假與出差 API 支援同一金鑰查詢多家授權公司，可使用 companyId 限定其中一家；未授權或停用公司不可讀取，分頁上限為合計 1,000 筆。
- 更新串接文件及 OpenAPI 規格，新增 companyIds 回應欄位，保留單公司 companyId 相容性。

[網頁 v220] 2026-10-14
- 新增出差申請單唯讀 API，預設已核准，支援更新時間、狀態與單號查詢、游標分頁及每頁最多 1,000 筆；排除差旅費報銷單。
- 外部 API 授權新增出差申請單資料範圍（travel:read），與請假單金鑰分別授權，維持公司隔離、期限、撤銷及使用紀錄。
- 提供出差 API 串接說明與 OpenAPI 規格，回傳申請人、類型、地點、事由、行程與起迄；無法辨識的欄位標記待核對。

[網頁 v219] 2026-10-14
- 新增外部請假單唯讀 API，預設已核准、依金鑰限定公司，支援更新時間與狀態篩選、游標分頁及每頁最多 1,000 筆。
- 系統設定／整合服務新增外部 API 授權，提供具有效期限的公司金鑰、一次顯示、撤銷及使用紀錄；每金鑰每分鐘最多 60 次。
- 提供串接說明、curl／PowerShell 範例及 OpenAPI 規格；舊單缺少計帳資料時標示待核對，不自動推算時數。
- 資料庫 JSON 還原會清除外部 API 授權，避免舊備份重新啟用已撤銷金鑰。

[網頁 v218] 2026-10-14
- 系統設定改以基本資料、人事與簽核、通知與權限、整合服務、備份與稽核五類頁籤管理；顯示可用功能數量、保留原權限及返回分類，支援鍵盤切換與手機排版。

[網頁 v217] 2026-10-14
- 管理中心新增「系統管理」功能類，排列於「流程與權限」之後，包含儲存管理、資料庫管理及系統設定；依原有權限顯示功能。

[網頁 v216] 2026-10-14
- 修正資料表較多時，資料庫容量及筆數統計無法載入；SQL 查詢上限維持 1,000 筆。

[網頁 v215] 2026-10-14
- 管理中心新增「資料庫管理」，限系統管理者查看容量、資料表、筆數、欄位、索引及外鍵。
- 新增唯讀 SQL 查詢（上限 1,000 筆）、資料表及查詢結果 Excel／CSV 匯出，明確顯示筆數與規模限制。
- 新增同結構 JSON 資料庫備份與驗證還原，保留 SQL 備份；還原採單一交易、重新檢查結構及外鍵，成功後清除登入工作階段。
- 新增資料庫結構及外鍵完整性檢查，記錄查詢、驗證、還原等管理操作。

[網頁 v213] 2026-10-13
- 修正儲存管理單檔下載：改為頁面內下載、補上檔案副檔名，提供下載中狀態與錯誤提示。
- 無對應紀錄項目新增刪除功能，刪除前須確認；伺服器重新檢查附件、標誌及頭像的資料庫關聯與檔案是否變更。

[網頁 v212] 2026-10-13
- 管理中心新增「儲存管理」，限系統管理者查看附件清單、實體容量、檔案類型，並搜尋及下載檔案。
- 比對資料庫與實體儲存，列出檔案遺失、容量不一致與沒有對應紀錄的檔案；涵蓋公司標誌及人員頭像，不自動刪除。
- 完整附件備份包含全部實體檔案與資料庫關聯清單；採串流下載並檢查檔案變動及內容長度。

[網頁 v211] 2026-10-13
- 產品介紹頁的行動 App 區塊改用實際 iPhone 截圖，呈現待我簽核、待簽統計、篩選與底部功能入口。
- 以等比例圖片搭配手機外框，保留完整操作畫面並支援手機版排版。

[網頁 v210] 2026-10-13
- 新增根目錄 ReleaseNote.txt，集中記錄版本日期及異動內容。
- 登入頁與系統頁 footer 右側顯示版本號，可開啟版更紀錄。
- 產品介紹頁新增 iOS／Android App 功能介紹：行動簽核、送簽表單、單據查詢、公司切換、推播通知與未讀數提醒。
- 產品介紹頁保留既有設計風格，新增行動版操作示意與導覽入口；不提供 App 下載或測試版取得說明。

[App 1.2.2／建置 7] 2026-10-13
- 修正 iOS 啟動時將登入頁隱藏框架誤判為不支援連結的提示。
- iOS／Android 輸入欄位在登入前即套用手機字級與寬度限制，避免聚焦輸入後版面自動放大。
- 上方信封未讀徽章取消額外放大與白色外框，與底部未讀數統一尺寸及字樣。
- iOS 已完成 TestFlight 內部測試版發布；Android 安裝檔已完成建置。實機操作依測試回饋持續驗證。

[網頁 v209] 2026-10-12
- 產品介紹頁新增表單設計與流程設計功能說明及配置示意。

[網頁 v208] 2026-10-12
- 新增 SunFlow 單頁產品介紹，包含產品特色、流程情境、應用方式與常見問題。

[App 1.2.1／建置 6] 2026-09-22；iOS 發布 2026-10-13
- 通知未讀數與 App 徽章同步；讀取、登出及登入狀態變更時更新。
- iOS 完成公司簽署、推播設定與 TestFlight 內部測試版發布。

維護方式
- 每次網頁發布時，同步更新本檔的目前網頁版本、日期及頂部新增紀錄。
- footer 版本與公開 /ReleaseNote.txt 由本檔於建置時產生。
- App 版更須記錄平台、版本與建置號碼；未完成驗收的項目請明確註記。