技術說明文件

稅月靜好

FanTaxTic
Windows 桌面稅務自動化工具
技術架構與功能規劃說明
2026年5月
Section 01

專案定位

稅月靜好解決的核心問題：會計事務所每月重複性的人工作業量過大。

電子發票批量下載
原本需人工登入財政部平台逐一操作，FanTaxTic 自動化登入、查詢、截圖、下載，支援多客戶批次執行。
發票科目自動分類
解析 Excel 明細，依「賣方 + 品項」規則自動歸類會計科目，減少手動核對錯誤。支援模糊比對，應對寫法不一致的情境。
批量客戶通知
整合 Gmail API 與 LINE extension 發送，讓事務所以單一工具對客戶批量發送報稅提醒或文件，取代逐一寄信的人工作業。
交付方式

安裝檔封裝所有相依套件（含 OCR runtime），資料完整保存在用戶本機（SQLite），不依賴外部伺服器，事務所資料不離機。授權機制使用機器碼 + 遠端驗證，防止未授權複製。

Section 02

技術架構

以 Wails v2 框架為核心，將 Go 後端與 React 前端封裝為單一 Windows 執行檔。

系統架構圖

技術選型依據

Wails v2 比 Electron 包體積小 60%，原生 Go 效能
Go 瀏覽器自動化（go-rod）、I/O 效能優異
React + Ant Design 豐富 UI 元件，開發效率高
SQLite 輕量單檔，零設定，單檔備份
Zustand 輕量狀態管理，比 Redux 簡潔

Wails Bridge 通訊機制

Go 後端的公開方法透過 Wails binding 自動暴露為 JavaScript 呼叫，前端使用型別安全的 bridge 呼叫後端邏輯，無需 REST API。新增後端方法後執行 wails generate module 即自動同步 bridge。

Section 03

功能模組現況

五大功能模組，各自對應獨立的 Go service 與 React feature 模組。

模組 功能說明 技術亮點 狀態
電子發票自動化 自動登入財政部電子發票整合服務平台，批量查詢、下載、截圖；含驗證碼處理 go-rod 驅動 Edge/Chrome，支援執行 ✓ 穩定
進項憑證分類 解析上傳的 Excel 發票明細，依自訂規則自動歸類會計科目，支援工具模式與客戶規則分開管理 (賣方, 品項) AND 語義規則、兩階段 Contains 模糊比對、規則匯入/匯出 ✓ 穩定
股票交易管理 管理交易紀錄與成本計算，提供年度報表，支援匯入 / 匯出 FIFO / 加權平均成本計算引擎 ✓ 穩定
客戶資料管理 管理事務所客戶清單，提供資料庫整體備份與還原功能 SQLite 整檔備份機制 ✓ 穩定
Gmail / LINE 通知 OAuth2 串接 Gmail REST API 批量寄信，LINE 擴充功能發送；含寄送歷程、設定頁與批量排程 Gmail OAuth2 scope 最小化（僅 gmail.send），LINE extension 發送 🚧 測試中
Section 04

目前開發進度

主幹 main 功能穩定。feat/mailer-module 分支進入最後收尾，預計五月底完成。

已完成（main 分支）
  • 電子發票批量自動化
  • 扣抵科目規則引擎（完整 CRUD + 科目管理）
  • 股票庫存管理
  • 客戶資料管理 + 備份還原
  • 授權機制（機器碼 + 遠端驗證）
  • 深色 / 亮色主題切換
收尾中（feat/mailer-module 分支）
  • Gmail 批量寄信 — 功能完整，進行最終測試與 UX 修正
  • LINE 自動推播 — 功能完整，進行最終測試
  • 扣抵規則模糊比對強化 — 程式碼已完成，準備併入 main
  • 預計五月底前全部合併至 main 並釋出
Section 05

Roadmap

五月底前 mailer 模組完成後，後續方向以事務所實際使用痛點為優先評估依據。

五月底：版本收尾
Gmail / LINE 模組測試通過後併入 main，完成第一個完整版本。扣抵模糊比對強化同步上線。
潛在項目：LINE 桌面版支援
現有 LINE Notify 為 server-push 模式。若事務所有桌面版推播需求，需評估 LINE Bot API 或 LINE LIFF 方案，複雜度較高，視需求再排程。
待評估：事務所新痛點
後續功能開發以收集事務所實際使用回饋為主。目前無確定新功能規劃，彈性保留開發空間。
Section 06

設計考量與系統特性

幾個影響整體架構方向的核心決策，以及現有設計的能力邊界。

為何選桌面應用而非 Web

財稅資料不離機
事務所客戶財稅資料敏感，SQLite 完整保存於用戶本機，不經過任何外部伺服器，無需信任第三方雲端，也省去資安合規的額外成本。
Go 輕量並發，批次不卡頓
後端以 Go 編寫，goroutine 並發模型讓多客戶發票下載、批量寄信等批次任務同步執行且不阻塞 UI；相較 Electron 方案，記憶體佔用與啟動速度均有明顯優勢。
安裝即用，低門檻交付
目標用戶為非技術背景的會計人員，以安裝檔封裝所有相依套件（含 OCR runtime），安裝完成即可使用，不需用戶自行設定環境。

現有設計的能力邊界

設計內（運作良好）
  • 單機單用戶，同一台電腦使用
  • Windows 10 / 11 x64
  • 本機 SQLite，資料完整備份還原
  • 授權綁定機器碼，防止未授權複製
設計外（目前不支援）
  • 多人同時使用同一份資料庫
  • macOS / Linux（Wails 可支援但需另行建置）
  • 雲端同步 / 跨裝置資料共享
  • LINE 桌面版推播（現為 Notify server-push）