外包做完了、工程師要交接——這 6 項沒拿到，系統就不算是您的
驗收不只是「功能跑得動」
<cite index="52-10,52-11,52-12">專業軟體開發團隊在交接時,會準備三類文件:給客服人員的故障排除步驟、給 QA 測試人員的檢查流程、以及給下一位工程師的技術文件</cite>。但實務上,台灣中小企業最常遇到的狀況是:外包廠商說「做完了」,卻只給您一包程式碼和一句「可以跑了」。
三個月後系統要改個小功能、或是要接到新的金流 API,您才發現:沒有人知道當初怎麼架的、資料庫密碼在哪、第三方服務的帳號是誰申請的。這時要嘛得花錢請原廠商回來改(而且通常報價更高),要嘛得整個重做。
<cite index="59-14,59-15,59-16">軟體專案的交接,常常牽涉知識轉移、存取權限、資安協定和技術文件。一份結構完整的交接清單,能確保專案不會因為人員變動而失去動能</cite>。您需要的不只是「能跑的程式」,而是一套您能掌控、能維護、能安全上線的系統。
這 6 項沒拿到,系統就不是您的
根據 GitHub 開發者社群與矽谷軟體交接實務經驗,一份完整的軟體專案交接至少要包含以下 6 大項:
1. 本機開發環境設定說明
<cite index="58-5,58-6,58-7">包含清楚的專案描述、本機安裝步驟(搭配 .env.example 環境變數範例檔)、以及如何執行測試的指令</cite>。實務上就是:下一位工程師拿到程式碼後,照著文件走,30 分鐘內能在自己電腦上把系統跑起來。
如果文件寫「請自行安裝相關套件」、卻沒列出版本號,那就等於沒寫。
2. 完整的帳號密碼與權限清單
<cite index="57-1">在專案完成前,必須彙整並安全轉交所有登入資訊、API 金鑰及其他憑證,確保客戶團隊能存取重要資源而不損及資安</cite>。實務上包含:雲端主機登入帳密、資料庫連線字串、第三方服務 API token(金流、物流、簡訊、地圖)、網域 DNS 管理權限、SSL 憑證存放位置。
建議用密碼管理工具(如 1Password、Bitwarden)安全交付,而非 Excel 或 LINE 訊息。
3. 系統架構圖與資料流說明
<cite index="59-19,59-20">技術文件應包含:程式碼說明(描述核心功能、模組與邏輯)、架構圖(系統架構、資料流與整合的視覺化呈現)、使用者手冊與部署指南</cite>。
您不需要看懂每一行程式碼,但您得知道:這套系統分成哪幾塊、哪一塊負責接收訂單、哪一塊負責發送通知、資料庫有幾張表、哪些欄位存會員資料。將來要接 LINE 官方帳號或串 ERP,您才知道要改哪一段、風險在哪裡。
4. 第三方服務清單與到期日
<cite index="57-6,57-7,57-8,57-9,57-10">列出每一套軟體及其版本與用途、授權到期日與續約步驟、硬體規格(廠牌型號與設定)、廠商聯絡資訊、以及停止支援的時間表</cite>。
實務上就是:雲端主機方案(AWS / GCP / Linode)、SSL 憑證到期日、金流服務合約、簡訊 API 餘額、網域續約日。少了這份清單,系統突然斷線時您才會發現「原來網域三個月前就到期了」。
5. 已知問題與待辦事項
<cite index="52-20">包含開發人員專用的故障排除文件,列出常見或已知的 bug</cite>。
誠實的外包廠商會告訴您:哪些功能還沒做完、哪些地方有已知 bug(但不影響主流程)、哪些邊界條件還沒測試過。這不是廠商偷懶,而是讓您在上線前知道風險在哪、該補哪些測試。如果廠商說「完全沒問題」,反而要小心。
6. 測試帳號與測試環境存取權
<cite index="58-26,58-27,58-28,58-29">最後一步是正式轉移:GitHub 轉移 repo 擁有權到新團隊帳號、協助新團隊匯入 workflow 到他們的環境並設定憑證、轉移或複製 Notion 文件到客戶工作區、用密碼管理工具安全轉交所有帳密</cite>。
實務上就是:測試用的管理員帳號、金流測試環境的商店代碼、第三方服務的沙盒 API key。這樣您之後要改功能時,可以先在測試環境驗證,不會直接在正式站動手術。
沒有文件的系統,就是技術債
<cite index="23-1">在產品開發過程中,為了規避工程師掌權的風險,最重要的兩件事就是技術文件與程式碼的透明管理。筆者耳聞太多工程師離職後,接手工程師乾脆整個重構的慘案,或是外包跑掉後連資料庫密碼都沒留下</cite>。
「外包做完了」不等於「專案完成」。如果您只拿到一包程式碼、沒有上面 6 項文件,那這套系統您並不真正擁有。三個月後要改功能時,您會發現成本比重做還高,因為沒有人知道當初怎麼架的、也沒人敢動。
<cite index="59-1,59-2">軟體專案的交接,常牽涉知識轉移、存取權限、資安協定與技術文件。結構完整的清單能確保專案持續性、維持品質標準、將技術債最小化</cite>。這不是要為難外包廠商,而是確保您付的錢換到的是一套「能上線、能維護、能交給下一個人」的系統,而不是一個黑盒子。
下次驗收前,先跑一遍這張清單
如果您手上已經有一套「快做完」的系統,建議在付尾款前:照著上面 6 項逐一確認,缺哪一項就請廠商補齊。如果廠商說「這些不重要」或「之後再給」,那就是警訊。
如果您的系統已經做完、但當初沒拿到這些文件,現在要接手或上線前卡關,AI 程式碼健診 能幫您盤點現有系統缺了哪些關鍵文件、評估補救成本、並規劃安全上線的路徑。專案做完不是終點,能safely接手、持續維護、穩定上線,才算真正完成。