Skip to content

jos556/Cash-Chill

Repository files navigation

💰 Cash & Chill 財務管理系統

主介面預覽

這是一個使用 Python 和 Tkinter 開發的財務管理系統,幫助用戶追蹤和管理個人財務。透過直觀的介面和強大的功能,讓您輕鬆掌握財務狀況!

✨ 功能特點

📊 即時收支統計

  • 即時餘額計算與顯示
  • 未來收支預測
  • 月度收支統計
  • 支出分類佔比分析

💹 智能預算警告系統

  • 四級警告機制:

    • 🟢 一般提醒 ($1,000)
    • 🔵 警告提醒 ($3,000)
    • 🟡 嚴重警告 ($5,000)
    • 🔴 極度警告 ($10,000)
  • 薪資剩餘警告:

    • 💰 當月薪資剩餘不到 10% 時發出警告
  • 警告內容顯示:

    • 目前支出金額
    • 剩餘金額
    • 月薪金額
  • 視覺化警告:

    • 醒目顏色提示
    • 自動彈出對話框

📅 定期交易功能

  • 自動週期性交易設定
  • 每月重複交易安排
  • 日期檢查(避免無效日期)
  • 重複交易提前提醒

📝 交易記錄管理

  • 完整交易歷史記錄
  • 多維度交易分類
  • 自定義備註功能
  • 靈活的日期選擇

🎨 視覺化分析

  • 互動式圓餅圖
  • 動態更新圖表
  • 客製化圖例設計
  • 精美視覺特效

支出分析圖表

🛠️ 技術實現

核心技術

  • Python 3.7+: 主要開發語言
  • Tkinter: GUI開發框架
  • Matplotlib: 資料視覺化
  • tkcalendar: 日期選擇器
  • FancyBboxPatch: 自定義視覺元件

關鍵類別與方法

class FinanceManager:

初始化與GUI創建

def init(self, root) # 初始化應用程式和設置基本參數

def create_gui() # 創建圖形使用者介面

交易相關方法

def add_transaction() # 新增交易記錄

def show_event_dialog() # 顯示事件新增對話框

def add_scheduled_transaction() # 新增定期交易

數據更新與分析

def update_monthly_stats() # 更新月度統計資料

def update_chart() # 更新圖表顯示

def check_expense_warning() # 檢查支出警告

定期任務處理

def check_scheduled_events() # 檢查定期事件

警告系統

def show_warning_dialog() # 顯示警告對話框

📊 資料結構設計

交易記錄結構

python

transaction = {

'date': 'YYYY-MM-DD', # 交易日期

'category': str, # 交易類別

'amount': float, # 交易金額

'type': '收入|支出', # 交易類型

'note': str # 交易備註

}

定期事件結構

scheduled_event = {

'name': str, # 事件名稱

'amount': float, # 事件金額

'category': str, # 事件類別

'type': str, # 事件類型

'date': datetime, # 事件日期

'is_monthly': bool # 是否每月重複

}

🚀 安裝指南

  1. 確保您已安裝 Python 3.7+

  2. 安裝所需套件:

    tkinter>=8.6

    matplotlib>=3.5.0

    pandas>=1.3.0

    tkcalendar>=1.6.1

系統需求

  • Windows 10/11 或 macOS 10.14+
  • Python 3.12 或更高版本

👥 開發團隊

  • 主要開發 - @jos556
  • UI/UX 設計 - [HU, SHIH-CHIEH]
  • 測試團隊 - [LIN, LI–SHIN & CHEN, MENG-YUN & HSIEH, CHING HUAI & CHEN,SHIH-TING]

Made with ❤️ in NTU

🐳 Docker 部署

使用 Docker 運行

  1. 確保已安裝 Docker 和 Docker Compose
  2. 克隆專案後,在專案根目錄執行:

構建映像

docker-compose build

運行容器

docker-compose up

停止容器

docker-compose down

主要功能區塊

➕ 新增事件

  • 快速添加定期交易
  • 自動排程管理
  • 智能提醒功能

💳 帳戶資訊

  • 即時餘額顯示
  • 未來收支預測
  • 帳戶狀態總覽

💰 新增交易

  • 靈活的交易紀錄
  • 多種類別選擇
  • 自定義備註功能

📊 支出分析

  • 互動式圓餅圖
  • 即時數據更新
  • 視覺化支出比例

📝 交易歷史

  • 完整交易記錄
  • 多維度篩選
  • 詳細交易資訊

Releases

No releases published

Packages

No packages published