DELIVERY SAMPLES / 自製文件示例

從需求到交接,
每一項都對得上。

不只列出「會交付文件」。用同一個假資料專案,看看需求怎麼寫、驗收怎麼記、上線前還有哪些責任要確認。

REQ 需求TST 驗收/重驗REL 上線/HND 交接

同一個示例專案

預約管理第一版

DEMO-BOOKING-V1 · 山徑預約樣本室(自行創作的示例名稱)

讓內部服務窗口建立、查詢及取消預約,主管核對單一資源的排程;第一版先不處理對外預約與收款。

單一據點、單一資源 A;展示日期 2030-04-16,09:00–17:00,每段 30 分鐘。示例時鐘固定在當日 08:30,時區 Asia/Taipei。

每個驗收案例都重新使用同一組 3 筆假資料,不延續前一案例狀態:BKG-DEMO-01(09:00,預約中)、BKG-DEMO-02(10:00,預約中)、BKG-DEMO-03(10:30,已取消的示例狀態)。只用預約代號,不收集姓名、電話或付款資料。

服務窗口(示例角色)

建立及取消自己的預約;查看自己的內容和其他時段是否占用,不查看其他窗口的備註。

主管(示例角色)

建立及查看所有示例排程、核對統計並匯出資料,不管理雲端帳單。

系統管理角色

管理部署、權限設定、備份與故障通知;業務資料存取仍依授權另行設定。

第一版明確不做

  • 不含對外消費者自助預約與會員註冊。
  • 不含付款、退款、發票或信用卡資料。
  • 不含簡訊、Email、LINE 自動通知。
  • 不含多據點、多資源、候補、循環預約與 AI 推薦。
  • 不把展示欄位當成正式法務條款、維護 SLA 或客戶合約。
01 / 先定義範圍

需求規格樣張

角色、規則、預期結果與排除功能一起寫;每項需求都有對應驗收與交接編號,不只寫一個功能名稱。

下載假資料 CSV

展示用假資料/非真實客戶專案;驗收觀察欄為填寫示例,非實際客戶測試或驗收

表格可橫向捲動;點擊對應編號可找到另一份樣張中的項目。

預約管理第一版 · 需求規格樣張 · 未實作/未實測/未交付/未上線的文件填寫示例
需求 ID使用角色目標規則與示例輸入預期結果優先級第一版排除對應驗收案例對應上線交接
REQ-01服務窗口、主管建立一筆可追蹤的內部預約必填預約代號、beginAt、endAt、資源 A;時段固定 30 分鐘。示例輸入為 2030-04-16 11:00–11:30。 備註跳脫示例:需要投影機, "靠窗"座位;備註可有換行。建立後可用預約代號查到同一筆資料,狀態為預約中;必填漏填要指出欄位。第一版必要不要求填姓名、電話或付款資料。TST-01REL-01HND-02
REQ-02服務窗口避免同一資源同時段重複預約同一資源的有效預約不得重疊;兩筆並行送出必須由後端判斷,不能只靠按鈕停用。相同請求識別值重送,回傳原預約代號,不新增第二筆。並行提交未占用的 11:30–12:00 時僅容許一筆新增,另一筆顯示占用原因;重送不重複建檔。第一版必要不含多資源與候補規則。TST-02TST-02-R1REL-01HND-02
REQ-03服務窗口取消後保留紀錄並釋出時段只能取消自己建立的預約;取消保留原代號、原時段與取消狀態,不直接刪除。每個案例重設 3 筆假資料後,再取消 BKG-DEMO-02。10:00 時段可重新預約;原 BKG-DEMO-02 仍可查到,狀態為已取消。第一版必要不含退款、改期或取消費。TST-03REL-01HND-02
REQ-04服務窗口、主管、系統管理角色依角色限制查詢及匯出以不同示例角色檢查頁面與直接資料請求;服務窗口不得讀到其他窗口的備註,也不能匯出所有資料。主管可核對及匯出。越權讀取不回傳受限制欄位,介面顯示權限不足;主管仍能操作授權範圍。第一版必要不含外部合作夥伴及多租戶。TST-04REL-02HND-01
REQ-05服務窗口日期與時段採同一規則以 Asia/Taipei 解讀;開始不得早於固定示例時鐘 08:30,須在 09:00–17:00 範圍,結束必須大於開始且恰好 30 分鐘,不能跨日期。08:00、跨日、結束早於開始或非 30 分鐘的輸入均指出原因;16:30–17:00 可接受。第一版必要不含跨國時區與自訂營業日曆。TST-05REL-02HND-04
REQ-06主管匯出可核對的示例 CSV欄位為預約代號、資源、beginAt、endAt、狀態、備註。UTF-8 含 BOM;逗號、雙引號與換行必須正確保留。只匯出主管授權看到的範圍。Excel 可讀中文;欄位不位移,資料筆數與選定範圍一致,不含未授權資訊。第一版必要不含 Google 試算表寫入與第三方資料同步。TST-06TST-06-R1REL-03HND-03
REQ-07主管每日查詢與空值、錯誤狀態可分辨從重設的 3 筆假資料查詢當日:預約中 2 筆、已取消 1 筆。其他日期顯示空資料;查詢失敗不可把舊資料標成最新,也不可靜默顯示零筆。查詢成功、查無資料與查詢失敗三種狀態清楚;原預約不被查詢操作改動。第一版必要不含長期績效分析或即時儀表板 SLA。TST-07REL-03HND-04
REQ-08發包方負責角色、系統管理角色、開發方交接前說明帳號、備份與回復責任主要帳號由發包方持有,開發方使用受邀權限。示例約定每日備份一次、保留 7 份;正式切換前需在非正式資料環境演練還原,另確認真實時程與資料保護。可列出帳號持有角色、資料匯出方式、還原步驟、回復條件和故障窗口;沒有演練與簽收不得填完成。第一版必要本展示不提供任何登入資訊、機密值或實際備份,不保證真實 SLA。TST-08REL-04HND-01HND-02HND-03HND-04
02 / 留下預期與觀察

驗收紀錄樣張

把前置資料、操作、預期、示意觀察分開;有缺陷時保留原紀錄,重驗另編案例,不把「看起來可以」當成驗收。

下載假資料 CSV

展示用假資料/非真實客戶專案;驗收觀察欄為填寫示例,非實際客戶測試或驗收

例如 DEF-01 示意重複預約問題:先在 TST-02 記缺陷,再於 TST-02-R1 示範重驗欄位。DEF-02 示意匯出格式問題。兩者都是自行創作的情境,未發生於真實客戶專案。

表格可橫向捲動;點擊對應編號可找到另一份樣張中的項目。

預約管理第一版 · 驗收紀錄樣張 · 未實作/未實測/未交付/未上線的文件填寫示例
驗收 ID需求 ID前置條件操作預期結果示意觀察結果(非實測)缺陷 ID重驗 ID示例狀態(非實測)對應上線交接
TST-01REQ-01重設 3 筆假資料;示例服務窗口已取得建立權限。建立 11:00–11:30 的 BKG-DEMO-04,重開查詢;另送出缺 endAt 的資料。同代號可查到;缺欄位顯示明確原因,不新增不完整紀錄。示例填法:BKG-DEMO-04 顯示相同時段;缺 endAt 被指出。此文字不是執行紀錄。無(示例)無(示例)符合預期的填寫示例(非實測)REL-01HND-02
TST-02REQ-02在重設資料後先選未占用的 11:30–12:00;準備兩筆並行請求。同時提交兩個示例請求,再以同一請求識別值重送。最多新增一筆;另一筆顯示占用;重送只取得原代號。示例填法:兩筆都被接受,發現只在前端阻擋。這是虛構缺陷情境,未操作真實系統。DEF-01TST-02-R1缺陷待修的填寫示例(非實測)REL-01HND-02
TST-02-R1REQ-02示例修正描述:後端新增重疊檢查及請求識別值處理;仍需實作後真實測試。重做 TST-02 的並行情境並核對資料筆數。只新增一筆;另一筆被拒絕;重送未多建資料。示例填法:新增 1 筆,另一筆顯示已占用;重送取得同代號。這是假定重驗觀察,不是已完成修復的證據。DEF-01無(示例)重驗符合預期的填寫示例(非實測)REL-01HND-02
TST-03REQ-03重設 3 筆假資料;BKG-DEMO-02 屬示例窗口甲,另準備非所屬的示例窗口乙,不記錄登入憑證。先以非所屬窗口乙送出取消 BKG-DEMO-02,確認被拒絕;切回所屬窗口甲核對原紀錄未改,再取消此筆、查原取消紀錄,最後重新預約 10:00–10:30。越權取消被拒絕且原紀錄未改;所屬窗口取消後原紀錄保留且標取消,時段可重新使用。示例填法:窗口乙取消被拒絕;窗口甲核對原紀錄未改後取消,原代號仍保留,10:00 可重新新增。各欄位仍待實際測試填寫。無(示例)無(示例)符合預期的填寫示例(非實測)REL-01HND-02
TST-04REQ-04分別使用示例服務窗口與主管角色;不記錄登入憑證。服務窗口查其他窗口備註並請求匯出;再由主管查詢匯出。服務窗口取得權限不足,回應不含受限備註;主管取得授權範圍。示例填法:窗口看不到其他備註,主管可核對。這不是後端權限已驗證的主張。無(示例)無(示例)符合預期的填寫示例(非實測)REL-02HND-01
TST-05REQ-05示例時區 Asia/Taipei;時鐘固定當日 08:30。輸入 08:00、跨日、結束早於開始、45 分鐘,以及 16:30–17:00 五種情境。前四種指出原因且不儲存;最後一種可接受。示例填法:錯誤原因與欄位對應,16:30 可接受。真實瀏覽器與後端時間仍需另測。無(示例)無(示例)符合預期的填寫示例(非實測)REL-02HND-04
TST-06REQ-06主管匯出 3 筆假資料;備註含逗號、雙引號與換行。用約定的 Excel 版本開啟 CSV,比對中文、欄位與筆數。UTF-8 中文正常,內容不因引號或逗號位移。示例填法:未加 BOM 的版本中文顯示亂碼,記錄匯出格式問題。這是文件示例,不是實際裝置觀察。DEF-02TST-06-R1缺陷待修的填寫示例(非實測)REL-03HND-03
TST-06-R1REQ-06示例修正描述:匯出增加 UTF-8 BOM 並修正 CSV 跳脫。用同一組假資料重做 TST-06,比對 3 筆及備註。中文可讀,備註字串與筆數一致。示例填法:3 筆可讀,含逗號與引號的欄位保留。此處沒有執行真實客戶 Excel 驗收。DEF-02無(示例)重驗符合預期的填寫示例(非實測)REL-03HND-03
TST-07REQ-07重設 3 筆假資料;主管查看當日排程。查展示日期、無資料日期,再模擬查詢失敗;確認未改預約。2 筆預約中與 1 筆取消;空值與失敗分開顯示,不把舊資料標最新。示例填法:三種訊息可區分,原資料保持 3 筆。這是示意觀察,未呼叫真實 API。無(示例)無(示例)符合預期的填寫示例(非實測)REL-03HND-04
TST-08REQ-08示例演練環境只有 3 筆假資料;還原操作與正式資料隔離。依演練清單還原資料,核對 3 個代號、時段與狀態,再核對帳號責任表。資料及權限可核對;故障窗口與回復步驟可找到;未演練不得簽收。示例填法:逐列比對 3 個代號並附演練紀錄位置。此展示未建立或執行任何備份還原。無(示例)無(示例)待實際演練的填寫示例(非實測)REL-04HND-01HND-02HND-03HND-04
03 / 列出責任與回復條件

上線交接清單樣張

區分上線前待辦與交接簽收,列出帳號持有角色、回復條件、備份與維護責任;不把送檔案等同完成交接。

下載假資料 CSV

展示用假資料/非真實客戶專案;驗收觀察欄為填寫示例,非實際客戶測試或驗收

REL 是切換前後待辦,HND 是帳號、文件與維護交接。狀態刻意保留待確認:沒有實際核對、演練與簽收,就不能填成完成。

表格可橫向捲動;點擊對應編號可找到另一份樣張中的項目。

預約管理第一版 · 上線交接清單樣張 · 未實作/未實測/未交付/未上線的文件填寫示例
上線/交接 ID需求 ID驗收 ID待辦與交接內容負責角色帳號持有角色交接狀態(示例)勾選與簽收條件回復條件回復方式
REL-01REQ-01REQ-02REQ-03TST-01TST-02-R1TST-03上線前定版:建立、衝突、取消三個核心流程開發方與發包方驗收窗口發包方產品負責角色待真實測試與簽收(示例;未上線)示例勾選條件:範圍定版、真實測試紀錄與缺陷重驗均確認後,才安排切換。切換後若有重複預約或取消後資料遺失。先停新增寫入、保存異常紀錄,依事前演練方案回復先前版本;不要直接刪資料。
REL-02REQ-04REQ-05TST-04TST-05上線前核對角色、時間與正式設定系統管理角色與發包方驗收窗口發包方系統管理角色待核對設定(示例;未上線)示例勾選條件:角色清單、正式網域、HTTPS、時區與最小必要權限均逐項核對。發現越權讀取、正式網址指向測試環境或時間規則不一致。限制相關入口、停止受影響寫入,依核定設定及先前版本回復;另外核對資料影響範圍。
REL-03REQ-06REQ-07TST-06-R1TST-07切換後讀回排程、匯出與錯誤狀態發包方資料管理角色與開發方發包方資料管理角色待切換後檢查(示例;未上線)示例勾選條件:對照已核定的基準資料與匯出欄位,確認沒有漏資料或權限混用。基準資料筆數不符、匯出錯欄或失敗訊息掩蓋舊資料。暫停匯出或受影響流程,保留基準資料與操作紀錄;核對原因後由負責人決定回復。
REL-04REQ-08TST-08切換前確認備份、還原與回復窗口系統管理角色發包方系統管理角色待非正式資料演練(示例;未上線)示例勾選條件:演練結果、回復步驟、切換窗口與保留舊版本方式經雙方確認。無法核對備份可用性或還原後資料、權限不一致。不進行正式切換;補完非正式資料演練後,再由雙方重新確認。
HND-01REQ-04REQ-08TST-04TST-08帳號持有與成員權限責任表發包方產品負責角色網域、DNS、主機、程式碼與分析工具主要帳號:發包方;開發方:受邀成員待授權核對與簽收(示例)示例交接清單:核對持有角色、付款及續費責任,合作結束後移除不再需要的開發權限。文件不列機密值。發包方無法管理主要帳號,或只有開發方持有存取權。暫緩簽收,先完成帳號持有與成員權限調整,不透過共用私人主帳號交接。
HND-02REQ-01REQ-02REQ-03REQ-08TST-01TST-02-R1TST-03TST-08原始碼、建置方式與操作說明開發方文件負責角色程式碼儲存庫與部署帳號:發包方持有待文件核對與簽收(示例)示例交接清單:原始碼範圍、建置步驟、環境設定名稱、核心操作及已知待辦;實際專案另填對應版本。發包方無法取得約定範圍原始碼或不能依文件建立可測試版本。暫緩交接簽收,補齊文件與授權範圍,再在約定環境核對,不臨時更換正式服務。
HND-03REQ-06REQ-08TST-06-R1TST-08資料匯出、備份保留與還原說明發包方資料管理角色資料庫與備份儲存帳號:發包方系統管理角色待演練與資料責任確認(示例)示例約定:每日備份一次、保留 7 份;交付匯出欄位及還原步驟。正式頻率、保留期限與個資處理另行確認。匯出內容不完整、備份位置不明或無法核對還原結果。先保留既有資料,不刪除舊備份;在隔離環境完成重驗,再確認保留及交接方式。
HND-04REQ-05REQ-07REQ-08TST-05TST-07TST-08維護、更新與故障處理責任發包方維護窗口與開發方維護角色監控、帳單與更新權限:發包方系統管理角色待維護範圍與窗口確認(示例)示例交接清單:續費、備份、安全更新、故障收件窗口、服務時間及新增需求另行估價方式;未訂真實 SLA。故障無通知窗口、更新後主流程不符約定,或維護責任未確認。依事前回復條件限制受影響流程;保留問題與版本資訊,由約定窗口協調,不自行擴大正式操作。
把示例換成你的工作流程

先說清楚怎樣算完成。

正式專案會另行確認需求、裝置與測試資料、上線責任和簽收方式。可以先提供去識別化的流程與欄位,不需要把客戶名單或機密設定送進公開表單。