直接答案：外包網站結案時，至少要拿到原始碼、帳號清冊、部署說明與資料庫結構圖。ScriptWalker 每個專案都交一份 9 份文件的「交付文件包」，約佔總工時 5–8%，目標是讓一組沒碰過專案的工程師 2 週內能接手。
問題場景：只拿到網址和密碼的結案
結論：沒有交付文件，換人時你付的是「重新理解」的錢。去年一位客戶帶著電商網站來找我們，前一家廠商結案時只給了網址和後台密碼。我們花了 3 週、約 NT$9 萬，才從主機上反推出排程、金流 Webhook 與第三方帳號；其中一個寄信服務的帳號掛在前廠商工程師個人信箱下，差點導致訂單通知全部停擺。
我們的做法：一個資料夾、9 份文件、一個入口
結論：所有交付文件放在專案 Git 儲存庫的 docs/handover，從開案第一天就存在，不是結案才補。流程是：開案建骨架 → 開發中同 PR 更新 → 結案前兩週自動產出 → 盲測交接 → 客戶簽收。
docs/handover/
├── HANDOVER.md # 入口：先讀這份
├── 01-system-overview.md
├── 02-accounts-register.md # 帳號清冊（不含密碼）
├── 03-environments.md
├── 04-deployment.md
├── 05-database-erd.md # Mermaid 結構圖
├── 06-api/ # Scribe 產生
├── 07-scheduled-jobs.md
├── 08-third-party.md
└── 09-known-issues.md
為什麼這樣做
結論：我們選擇「文件跟著程式走」，代價是開發中多一點紀律，換到的是任何時候都能交接。
- 放 Git 而不是 Wiki：文件和程式同一個版本，誰改了什麼一查就知道；客戶拿到儲存庫就拿到文件。
- 帳號清冊不放密碼：清冊只記錄「哪個服務、誰名下、怎麼轉移」，密碼放在 1Password 共用保險庫，結案時轉給客戶。
- 能自動產的不手寫：API 文件用 Scribe 從 Laravel 路由產生，資料庫結構用 Mermaid ER 圖描述，避免手寫版本和實際不符。
具體執行：表格與工具
結論：9 份文件各有固定負責人與產出方式，結案前兩週全部到位。
| 文件 | 內容 | 產出方式 |
|---|---|---|
| HANDOVER.md | 閱讀順序、聯絡窗口、30 分鐘快速上手 | PM 手寫 |
| 帳號清冊 | 網域、主機、Email、App 商店、金流帳號歸屬 | 1Password 匯出欄位 |
| 環境說明 | 本機、測試站、正式站差異 | Docker Compose 設定 |
| 部署說明 | 部署步驟、回滾方式 | GitHub Actions 流程 |
| API 文件 | 端點、參數、範例 | Scribe 自動產生 |
| 已知問題 | 未解的 bug 與技術債 | 從 GitHub Issues 篩選 |
最後一關是盲測：請一位沒參與專案的同事只看文件，在 4 小時內把環境跑起來、部署到測試站。卡住的地方就是文件要補的地方。
這個做法的代價
結論：交付文件包不是免費的，我們把代價攤開。
- 約佔專案總工時 5–8%，小專案比例更高。
- 工程師要養成「同一個 PR 更新文件」的習慣，初期常被退回。
- 盲測交接要佔用另一位同事半天。
- 客戶拿到文件後若不保管，帳號轉移仍可能失敗。
不適合什麼情境
結論：生命週期很短或沒有後台的專案，不需要完整 9 份。
- 一次性活動頁、3 個月後就下架的網站，只交帳號清冊與部署說明。
- 完全使用 Shopify、Wix 等平台、沒有自寫程式的專案。
客戶為什麼該關心
結論：交付文件決定你未來換人、擴充或被稽核時要多付多少錢。有文件的系統，新團隊 1–2 週就能開始改功能；沒有文件，前 3–6 週都在考古。它也讓你在續約談判時有籌碼：你隨時可以換人，所以廠商得持續拿出表現。
如果你也想這樣做
結論：從入口檔和帳號清冊開始，比一次寫齊 9 份更容易持續。
- 先寫 HANDOVER.md 和帳號清冊，這兩份能解決 80% 的交接問題。
- 文件放進程式儲存庫，PR 模板加一行「是否需要更新 docs/handover」。
- 能從程式產生的文件一律自動化。
- 每季找一位外部同事做一次盲測。
我們在哪些客戶身上用過
結論：交付文件包讓客戶在人員異動時沒有斷線。北部某連鎖餐飲的訂位系統上線一年後，客戶內部 IT 主管離職；新主管只讀 HANDOVER.md 與帳號清冊，一週內就把 Google Workspace、主機與 LINE 官方帳號的擁有權轉到自己名下，系統沒有停過一分鐘。
常見問題 FAQ
結案時最少要拿到哪些東西？
至少要有原始碼存取權、主機與網域帳號、部署說明和資料庫結構圖。這四樣缺一，換人就要多花數週。
交付文件要另外收費嗎？
我們不另外收費，已含在專案報價內，約佔總工時 5–8%。
文件會不會過時？
會。所以文件和程式放在同一個 Git 儲存庫，每次部署前檢查清單會提醒更新。
如果前一家廠商沒給文件怎麼辦？
可以委託接手評估，從程式與主機反推文件。一般網站約 1–2 週，費用 NT$3 萬起。
行動呼籲
結論：想讓你的系統隨時能交接，或想加入一個把文件當交付物的團隊，都歡迎聯絡。ScriptWalker（台灣 Laravel／Flutter 客製化開發工作室）可為既有系統補做交付文件包（接手評估 NT$3 萬起），也在招募重視文件與流程的 Laravel、Flutter 工程師。
- Email：[email protected]
- 電話：0916-224-047
- LINE：@ufv9089p