跳至主要內容

里程碑

Construction Plan Auto-Drafter(n8n)計畫書草稿自動產生器

RC @rcc123456dr發布於

🏗️ n8n 施工計畫書草稿自動產生器

輸入一行行程,n8n 會從公司伺服器找出該客戶的舊計畫書,照規則組成草稿;書籤小幫手再把草稿逐格填進既有的公司表單。人工檢查後按「生成計畫書」,生成與簽署後的 PDF 也會由 n8n 自動歸檔。

🔗 GitHub: github.com/123456dr/n8n-construction-plan-generator(在新分頁開啟)



解決什麼問題

在數位轉型中的公司裡,簽署連結的寄送、回簽追蹤都已經自動化,但每一份施工計畫書仍要人工填寫:

  • 地址、施作範圍、需時:要照「同一位客戶的上一份計畫書」抄。
  • 材料及配比:要找「同類別」的舊計畫書,最近一份的類別不同時,還得往前翻。
  • 一份 11 個欄位,常常要開好幾份 PDF 對照、一格一格複製貼上,容易抄錯。

功能

功能說明
一行輸入只要貼上 2026/12/01 15:00 A 客戶甲 林先生(時間 類別 客戶 負責人員)
自動找舊檔用客戶名稱「開頭比對」公司伺服器的資料夾,例如「客戶甲」可以找到「客戶甲(總店)」
依規則組草稿基本資料抄最近一份;材料抄同類別最近一份;行程上有的欄位以行程為準
逐格填入書籤小幫手把草稿打進公司表單,不用修改公司原本的系統
每格附依據面板列出每一格資料來自行程,還是來自哪一份舊計畫書
自動歸檔生成時歸檔未簽署版,客戶簽署後用同一個檔名換成已簽署版,都由 n8n 完成

人工把關

  • 黃框欄位要人確認:例如沿用的備註,或查不到同類別材料時留下的空白欄位。
  • 一定由人按「生成計畫書」:小幫手只負責填寫,不會替人送出。
  • 新客戶自動停止:公司伺服器找不到資料夾時,不產生草稿,提醒改用手動建立。

架構

mermaid
flowchart LR
    U([行政人員]) -- 貼上一行行程 --> H[計畫書小幫手<br/>書籤 helper.js]
    H -- POST /webhook/plan-draft-public --> N1
    subgraph n8n
      N1[產生草稿流程<br/>12 個節點]
      N2[自動歸檔流程<br/>6 個節點]
    end
    N1 -- 查資料夾/下載舊 PDF --> FS[(file-server<br/>模擬公司伺服器)]
    N1 -- 草稿 JSON --> H
    H -- 逐格填入 --> PS[plan-site<br/>模擬公司計畫書系統]
    U -- 檢查後按「生成計畫書」 --> PS
    PS -- 生成/簽署時通知<br/>/webhook/plan-archive-public --> N2
    N2 -- 下載 PDF --> PS
    N2 -- 上傳到 客戶資料夾/施工計畫書 --> FS

服務一覽

下載 GitHub Release(在新分頁開啟) 的完整專案,用 Docker 啟動後,就能在瀏覽器打開以下三個網頁:

服務網址用途
🏢 計畫書系統<br>plan-sitelocalhost:8080(在新分頁開啟)模擬公司既有的施工計畫書系統:填寫表單、產生計畫書 PDF,並提供客戶簽署頁<br><sub>Flask+ReportLab</sub>
🗂️ 公司伺服器<br>file-serverlocalhost:8090(在新分頁開啟)模擬公司的檔案伺服器,存放各客戶的歷史計畫書;/tools/ 提供計畫書小幫手書籤<br><sub>Flask</sub>
⚙️ 自動化流程<br>n8nlocalhost:5678(在新分頁開啟)兩條 n8n 流程:依舊檔產生草稿、生成與簽署後自動歸檔

💡 這三個網址只在你自己的電腦上執行(localhost),要先完成下方「快速開始」的啟動步驟才打得開。


快速開始

1. 需要的軟體

2. 啟動

bash
git clone https://github.com/123456dr/n8n-construction-plan-generator.git
cd n8n-construction-plan-generator
  • Windows:點兩下 start.bat
  • macOS/Linux:./start.sh

第一次啟動要建立映像檔,大約 3~5 分鐘。

3. 匯入 n8n 流程(只要做一次)

  1. 打開 localhost:5678(在新分頁開啟),建立 n8n 帳號(只存在你自己的電腦)。
  2. 左上 + → Workflow,右上 ⋯ → Import from File…,選 n8n/workflow.json。
  3. 畫面上會有上下兩條線,共 18 個節點。按右上角 Publish。

沒有按 Publish 的話,小幫手會顯示「正式網址、測試網址都回 404」。

4. 安裝小幫手書籤(只要做一次)

打開 localhost:8090/tools/(在新分頁開啟),把紫色的「🤖 計畫書小幫手」按鈕拖到書籤列。

5. 試用

  1. 打開 localhost:8080(在新分頁開啟),點書籤列上的「計畫書小幫手」。
  2. 貼上 2026/12/01 15:00 A 客戶甲 林先生,按「產生草稿並填入表單」。
  3. 檢查黃框欄位,再按「生成計畫書」。
  4. 到 localhost:8090(在新分頁開啟) → 客戶甲(總店) → 施工計畫書,可以看到剛歸檔的 20261201_客戶甲_A.pdf。

測試情境

sample-server/ 裡有 5 位虛構客戶、共 13 份歷史計畫書,對應下面 6 種情況(行程圖在 docs/schedules/):

行程(一行)公司伺服器上的舊檔預期結果
2026/12/01 15:00 A 客戶甲 林先生客戶甲(總店):A、B、B(最近)基本資料抄 11/01;材料往前抄 06/10 的 A 類
2026/12/04 14:00 A 客戶乙 李先生客戶乙:A、B、B(最近)材料往前抄 07/02 的 A 類
2026/12/16 08:30 A+B 客戶丙 陳先生客戶丙:A+B、A、A(最近)材料往前抄 05/20 的 A+B 類
2026/12/08 16:30 A 客戶丁 黃先生客戶丁:B、B查不到 A 類 → 材料留空、標黃框
2026/12/10 09:30 B 客戶戊 張先生客戶戊:B、B全部照抄最近一份
2026/12/12 10:00 B 客戶己 李先生(沒有資料夾)新客戶 → 停止,提醒手動建立

想重新產生示範資料:python tools/seed.py(需要 pip install flask reportlab pillow)。


n8n 流程說明

上面一條:產生草稿(Webhook plan-draft-public)

#節點做什麼
1收到行程小幫手用 POST 送來一行行程
2解析行程讀出日期、時間、類別(A/B/A+B)、客戶、負責人員(n8n/code_parse.js)
3行程讀得懂?格式不對就回覆正確格式
4查詢歸檔資料夾問 file-server:以客戶名稱開頭、底下有「施工計畫書」的資料夾
5找到客戶資料夾?找到 0 個(新客戶)或超過 1 個 → 停止
6列出舊計畫書取得該資料夾裡所有 PDF
7挑選參考檔依檔名 日期_客戶_類別.pdf 挑出「最近一份」和「最近一份同類別」(n8n/code_pick.js)
8下載舊計畫書下載挑中的 PDF
9讀取PDF文字Extract From File(PDF)
10組合草稿照規則組成 11 個欄位,並標出要人工確認的欄位(n8n/code_build.js)
11回覆草稿把草稿 JSON 回給小幫手
12回覆無法產生失敗時回覆原因

下面一條:自動歸檔(Webhook plan-archive-public)

#節點做什麼
13收到歸檔請求生成計畫書或客戶簽署時,計畫書系統通知 n8n
14查詢客戶資料夾用客戶名稱找大資料夾
15決定歸檔位置組出 客戶大資料夾/施工計畫書/日期_客戶_類別.pdf(n8n/code_archive.js)
16下載計畫書PDF從計畫書系統下載未簽署版或已簽署版
17上傳到公司伺服器上傳到 file-server;簽署後用同一個檔名覆蓋
18回覆歸檔結果完成頁會顯示「已歸檔・由 n8n 歸檔」

備援:n8n 沒開或流程沒 Publish 時,計畫書系統會自己直接歸檔,畫面顯示「由 系統(備援) 歸檔」,資料不會遺失。


專案結構

程式碼
.
├─ docker-compose.yml        三個服務的設定
├─ start.bat / start.sh      一鍵啟動
├─ n8n/
│  ├─ workflow.json          匯入 n8n 的流程檔(18 個節點)
│  └─ code_*.js              流程中 Code 節點的程式碼(方便閱讀)
├─ plan-site/                模擬公司計畫書系統(Flask+ReportLab)
├─ file-server/              模擬公司檔案伺服器(Flask)
│  └─ tools/                 計畫書小幫手書籤(helper.js、安裝頁)
├─ sample-server/            示範用的公司伺服器資料(5 位客戶、13 份 PDF)
├─ tools/seed.py             重新產生 sample-server 的腳本
└─ docs/                     圖片與行程表範例

執行後才會出現的 n8n_data/(n8n 帳號)和 plan_data/(生成的計畫書)已列入 .gitignore,不會上傳。

常見問題

狀況解法
小幫手顯示 404n8n 流程還沒 Publish
小幫手顯示「連不到 n8n」n8n 容器沒啟動,再執行一次 start.bat
完成頁顯示「由 系統(備援) 歸檔」n8n 沒開,或流程沒有 Publish
啟動失敗先打開 Docker Desktop,等它顯示 Engine running
連接埠被占用關掉占用 8080/8090/5678 的程式,或修改 docker-compose.yml 的 ports

聲明

本專案模擬環境。公司系統、伺服器和所有資料都是虛構的,不連接任何真實系統。

3 個愛心0 則留言

登入並驗證手機後就能留言。登入