Skip to content

Latest commit

 

History

History
227 lines (177 loc) · 5.23 KB

README.md

File metadata and controls

227 lines (177 loc) · 5.23 KB

🇹🇷 Türkçe | 🇬🇧 English

Bütçe Takip Sistemi

Kişisel finans yönetimini kolaylaştıran modern bir web uygulaması.

Özellikler

1. Gelir Yönetimi

  • Tek seferlik ve düzenli gelirleri kaydetme
  • Farklı para birimlerinde gelir ekleyebilme
  • Otomatik tekrarlanan gelir kayıtları

2. Gider Takibi

  • Tek seferlik ve düzenli ödemeleri kaydetme
  • Farklı para birimlerinde gider ekleyebilme
  • Otomatik tekrarlanan ödeme kayıtları

3. Birikim Hedefleri

  • Hedef bazlı birikim planlaması
  • İlerleme takibi
  • Hedef tarihi belirleme
  • Görsel ilerleme göstergeleri

4. Genel Özellikler

  • Çoklu para birimi desteği (TRY, USD, EUR)
  • Otomatik kur hesaplamaları
  • Açık/Koyu tema seçeneği
  • Responsive tasarım
  • Kullanıcı dostu arayüz

Teknik Özellikler

Kullanılan Teknolojiler

  • PHP 8.x
  • MySQL/MariaDB
  • JavaScript (jQuery)
  • Bootstrap 5
  • SweetAlert2
  • Font Awesome Icons

Güvenlik Özellikleri

  • Şifre hash'leme (bcrypt)
  • XSS koruması
  • SQL injection koruması
  • CSRF koruması
  • "Beni Hatırla" özelliği için güvenli token sistemi

Kurulum

  1. Dosyaları web sunucunuza yükleyin
  2. database.sql dosyasını veritabanınıza import edin
  3. config.php dosyasını düzenleyin: 
    define('DB_SERVER', 'localhost');
define('DB_USERNAME', 'kullanici_adi');
define('DB_PASSWORD', 'sifre');
define('DB_NAME', 'veritabani_adi');
  4. Gerekli PHP eklentilerinin yüklü olduğundan emin olun:
    • PDO
    • PDO_MySQL
    • mbstring
    • json

Dizin Yapısı

butce.local/
├── api/                    # API endpoint'leri
│   ├── auth.php           # Kimlik doğrulama işlemleri
│   ├── income.php         # Gelir işlemleri
│   ├── payment.php        # Ödeme işlemleri
│   └── savings.php        # Birikim işlemleri
├── js/                    # JavaScript dosyaları
│   ├── app.js            # Ana uygulama kodları
│   ├── auth.js           # Kimlik doğrulama
│   ├── income.js         # Gelir işlemleri
│   ├── payment.js        # Ödeme işlemleri
│   └── theme.js          # Tema yönetimi
├── modals/               # Modal bileşenleri
│   ├── income_modal.php  # Gelir modalları
│   ├── payment_modal.php # Ödeme modalları
│   └── savings_modal.php # Birikim modalları
├── css/                  # Stil dosyaları
├── app.php              # Ana uygulama
├── config.php           # Yapılandırma
├── index.php           # Karşılama sayfası
├── login.php           # Giriş sayfası
└── register.php        # Kayıt sayfası

Veritabanı Şeması

users

  • id (INT, PRIMARY KEY)
  • username (VARCHAR)
  • password (VARCHAR)
  • base_currency (VARCHAR)
  • theme_preference (VARCHAR)
  • remember_token (VARCHAR)
  • created_at (TIMESTAMP)

income

  • id (INT, PRIMARY KEY)
  • user_id (INT, FOREIGN KEY)
  • name (VARCHAR)
  • amount (DECIMAL)
  • currency (VARCHAR)
  • first_date (DATE)
  • frequency (VARCHAR)
  • next_date (DATE)
  • status (ENUM)
  • created_at (TIMESTAMP)

payments

  • id (INT, PRIMARY KEY)
  • user_id (INT, FOREIGN KEY)
  • name (VARCHAR)
  • amount (DECIMAL)
  • currency (VARCHAR)
  • first_date (DATE)
  • frequency (VARCHAR)
  • next_date (DATE)
  • status (ENUM)
  • created_at (TIMESTAMP)

savings

  • id (INT, PRIMARY KEY)
  • user_id (INT, FOREIGN KEY)
  • name (VARCHAR)
  • target_amount (DECIMAL)
  • current_amount (DECIMAL)
  • currency (VARCHAR)
  • start_date (DATE)
  • target_date (DATE)
  • created_at (TIMESTAMP)

Katkıda Bulunma

  1. Bu depoyu fork edin
  2. Yeni bir branch oluşturun (git checkout -b feature/yeniOzellik)
  3. Değişikliklerinizi commit edin (git commit -am 'Yeni özellik: XYZ')
  4. Branch'inizi push edin (git push origin feature/yeniOzellik)
  5. Pull Request oluşturun

Lisans

Bu proje MIT lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.

İletişim

A. Kerem Gök - [email protected]

Proje Linki: https://github.com/keremgok/butcetakip

Budget Control System

This is a web application developed for personal budget control and tracking. It is designed as a Progressive Web App (PWA) and provides offline usage support.

Features

  • 💰 Income and expense tracking
  • 💳 Payment planning
  • 📊 Detailed reporting
  • 💾 Offline functionality
  • 📱 Mobile responsive design
  • 🎯 Savings goals
  • 🔄 Automatic backup
  • 🌙 Dark mode

Technologies

  • HTML5
  • CSS3
  • JavaScript (ES6+)
  • Service Workers
  • IndexedDB
  • PWA

Installation

  1. Clone the project
git clone https://github.com/hermesthecat/odeme_takip.git
  1. Go to project directory
cd odeme_takip
  1. Run with a web server
# Start a simple web server with Python
python -m http.server 8000

Screenshots

Home Page Home Page

Calendar Calendar

Mini Reports Mini Reports

Add Income Add Income

Dark Mode Dark Mode

License

MIT

Author

A. Kerem Gök