LuoDi-Nate/financial-management

解決的問題

Family Ledger 是一個自託管的財務管理系統，專為資產分散在多個平台（銀行、券商、支付寶、房地產等）且希望在不犧牲隱私給商業應用程式的情況下，獲得全球淨資產概覽的家庭所設計。它解決了追蹤真實年化報酬率 (XIRR)、區分勞動收入與投資收益，以及透過「穿透」共同基金持倉來識別隱藏行業風險的問題。

運作方式

該專案不採用每日交易記錄，而是使用每月快照方式。使用者開啟一個週期，輸入月底餘額，並關閉週期以產生報告。它整合了 AI 以減少手動輸入：視覺 LLM 可以從券商帳戶截圖中識別持倉，AI 則根據計算出的工程數據提供資產配置與風險暴露的診斷解讀。

適用對象

能夠管理 Linux 伺服器（或 NAS）並優先考慮資料隱私的個人或家庭。它特別適合那些想要高層級的每月財富概覽與真實投資績效，而非詳細的每日預算或支出追蹤的人。

特色亮點

• AI 驅動的資料輸入：使用視覺 LLM 從截圖中提取資產名稱與價值，並自動按行業或類型進行標記。
• 基金穿透：將共同基金拆解為其實際持倉（股票、債券、現金）與行業板塊，以揭示真實的風險暴露。
• 真實績效指標：計算 XIRR（資金加權）與 TWR（時間加權）回報，並追蹤淨資產相對於 CPI 通膨與 M2 貨幣供應量的表現。
• 隱私優先的自託管：透過 Docker Compose 或 systemd 部署，確保所有財務資料保留在使用者自己的伺服器上。
• 自動化估值：自動獲取股票（A 股、港股、美股）、加密貨幣與貴金屬的當前價格。
• AI 資產健康檢查：提供四維度診斷（配置、風險、流動性與回報），並提供可執行的再平衡步驟。