里程碑
Construction Plan Auto-Drafter(n8n)計畫書草稿自動產生器
RC @rcc123456dr發布於
🏗️ n8n 施工計畫書草稿自動產生器
輸入一行行程,n8n 會從公司伺服器找出該客戶的舊計畫書,照規則組成草稿;書籤小幫手再把草稿逐格填進既有的公司表單。人工檢查後按「生成計畫書」,生成與簽署後的 PDF 也會由 n8n 自動歸檔。
🔗 GitHub: github.com/123456dr/n8n-construction-plan-generator(在新分頁開啟)
解決什麼問題
在數位轉型中的公司裡,簽署連結的寄送、回簽追蹤都已經自動化,但每一份施工計畫書仍要人工填寫:
- 地址、施作範圍、需時:要照「同一位客戶的上一份計畫書」抄。
- 材料及配比:要找「同類別」的舊計畫書,最近一份的類別不同時,還得往前翻。
- 一份 11 個欄位,常常要開好幾份 PDF 對照、一格一格複製貼上,容易抄錯。
功能
人工把關
- 黃框欄位要人確認:例如沿用的備註,或查不到同類別材料時留下的空白欄位。
- 一定由人按「生成計畫書」:小幫手只負責填寫,不會替人送出。
- 新客戶自動停止:公司伺服器找不到資料夾時,不產生草稿,提醒改用手動建立。
架構
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 啟動後,就能在瀏覽器打開以下三個網頁:
💡 這三個網址只在你自己的電腦上執行(
localhost),要先完成下方「快速開始」的啟動步驟才打得開。
快速開始
1. 需要的軟體
- Docker Desktop(在新分頁開啟)(開著,而且顯示 Engine running)
- Chrome 或 Edge 瀏覽器(安裝書籤用)
2. 啟動
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 流程(只要做一次)
- 打開 localhost:5678(在新分頁開啟),建立 n8n 帳號(只存在你自己的電腦)。
- 左上 + → Workflow,右上 ⋯ → Import from File…,選
n8n/workflow.json。 - 畫面上會有上下兩條線,共 18 個節點。按右上角 Publish。
沒有按 Publish 的話,小幫手會顯示「正式網址、測試網址都回 404」。
4. 安裝小幫手書籤(只要做一次)
打開 localhost:8090/tools/(在新分頁開啟),把紫色的「🤖 計畫書小幫手」按鈕拖到書籤列。
5. 試用
- 打開 localhost:8080(在新分頁開啟),點書籤列上的「計畫書小幫手」。
- 貼上
2026/12/01 15:00 A 客戶甲 林先生,按「產生草稿並填入表單」。 - 檢查黃框欄位,再按「生成計畫書」。
- 到 localhost:8090(在新分頁開啟) →
客戶甲(總店)→施工計畫書,可以看到剛歸檔的20261201_客戶甲_A.pdf。
測試情境
sample-server/ 裡有 5 位虛構客戶、共 13 份歷史計畫書,對應下面 6 種情況(行程圖在 docs/schedules/):
想重新產生示範資料:python tools/seed.py(需要 pip install flask reportlab pillow)。
n8n 流程說明
上面一條:產生草稿(Webhook plan-draft-public)
下面一條:自動歸檔(Webhook plan-archive-public)
備援: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,不會上傳。
常見問題
聲明
本專案模擬環境。公司系統、伺服器和所有資料都是虛構的,不連接任何真實系統。
3 個愛心0 則留言
登入並驗證手機後就能留言。登入