JP Invoice Generator：由手動列印到可重現自動化
重點唔係「有個工具」，而係把每次出單流程由人手步驟改成可重跑、可交接、可驗證。
核心技術係 Python CLI、`docx-mailmerge`、`openpyxl` 同 Streamlit 本機介面。
起點問題（Before）
- 人工合併列印慢，批量時易錯欄位。
- 模板可程式化能力不明，怕做咗用唔到。
- 環境依賴混亂，換機或換人就難重現。
決策與做法（Why + How）
- 先做可行性驗證：抽最小欄位，先驗 `docx-mailmerge` 可用。
- 核心先 CLI：`generate_docs.py` 先跑穩，後補 Web UI。
- 環境鎖定：用 `.venv + requirements.txt`，避免「我部機得你部機唔得」。
- 穩定性保險：加 `--dry-run`、命名規則、錯誤提示。
結果對比（After）
重覆工下降
由逐份手動合併轉為批量生成流程。
交接更容易
CLI 核心 + 啟停腳本，非開發者都可按步驟操作。
擴充成本降低
新增模板/欄位可沿現有流程演進，唔使重寫一套。
註：本案重點係內部生產流程，未包含付款串接或對外產品化售賣頁。
範圍與限制（Scope）
今次有做
- 批量生成主流程（CLI）
- 最小操作 UI（streamlit）
- 命名規則與錯誤保護
今次未做
- 多角色權限管理
- 雲端多用戶併發佈建
- 完整商業後台
可複製條件
- 每月有固定文書批量處理、且格式相對一致。
- 希望先用最小工具取代人手，而非直接做大型系統。
- 團隊接受先「CLI 跑穩」再補介面。
你有類似重覆流程想自動化？
我可以幫你先做最小可行工具版，再逐步包裝成團隊可用版本。
預約 30 分鐘診斷：幫你定邊啲值得自建、邊啲可以遲啲先換。