Files

sbilketay 4205a8d387 Initial commit: Yakıt Takip Modülü - Akaryakıt İstasyonu Yönetim Sistemi

🚀 Features Implemented:
- Full-stack SvelteKit application with Express backend
- Role-based authentication (Admin, Fuel Manager, Goods Manager)
- Real-time notifications with Socket.IO
- SQLite database with auto-initialization in /db directory
- Comprehensive user management and fuel slip tracking
- Responsive design with Turkish language support

🏗️ Architecture:
- Frontend: Svelte + SvelteKit + Vite
- Backend: Node.js + Express + Socket.IO
- Database: SQLite3 with automatic schema creation
- Security: bcrypt password hashing + session management
- Real-time: Socket.IO for instant notifications

📁 Project Structure:
- Organized documentation in /docs directory
- Database files in /db directory with auto-setup
- Clean separation of API routes and UI components
- Comprehensive documentation including processes, architecture, and user guides

📚 Documentation:
- PROJECT_PROCESSES.md: Comprehensive project documentation
- KNOWLEDGE_BASE.md: Quick reference and user guide
- TEST_GUIDE.md: Testing and quality assurance guide
- README_ADMIN_FEATURES.md: Admin functionality guide
- Full API documentation and system architecture

🔒 Security Features:
- Role-based authorization system
- Encrypted password storage with bcrypt
- Session-based authentication
- SQL injection protection with parameterized queries
- CORS configuration and input validation

🎯 Key Features:
- Fuel slip creation and approval workflow
- Real-time notifications between users
- PDF generation for fuel slips
- User and vehicle management
- Comprehensive audit logging

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-11-05 08:35:13 +03:00

4.4 KiB

Raw Permalink Blame History

YTP Bilgi Bankası

Yakıt Takip Sistemi kapsamlı bilgi bankası - hızlı referans, kılavuzlar ve sorun giderme rehberi.

İlk Yakıt Fişi Oluşturma

Giriş Yap: Yakıt sorumlusu ile giriş yapın
Kaynak Kontrolü: Araç, birlik ve personel kayıtlarını kontrol edin
Fiş Oluştur: "Yeni Fiş" butonuna tıklayın
Form Doldur: Tüm zorunlu alanları doldurun
Onay Gönder: Mal sorumlusuna gönder
Bildirim Takibi: Real-time bildirimleri izleyin

🏗️ Sistem Mimarisi

Mimari Diyagram

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Frontend      │    │    Backend      │    │   Database      │
│   (Svelte)      │◄──►│   (Express)     │◄──►│   (SQLite)      │
│                 │    │                 │    │                 │
│ - UI Components │    │ - REST API      │    │ - users         │
│ - State Mgmt    │    │ - Socket.IO     │    │ - vehicles      │
│ - Routing       │    │ - Auth/Authz    │    │ - units         │
│ - API Client    │    │ - PDF Generation│    │ - fuel_personnel│
└─────────────────┘    └─────────────────┘    │ - fuel_slips    │
                                                └─────────────────┘

Teknoloji Stack Karşılaştırması

Katman	Teknoloji	Neden?	Alternatifler
Frontend	Svelte + Vite	Hızlı, küçük bundle, reaktif	React, Vue, Angular
Backend	Node.js + Express	Hızlı development, JavaScript ekosistemi	Python, PHP, Java
Database	SQLite3	Hafif, kurulum gerektirmeyen, taşınabilir	PostgreSQL, MySQL
Real-time	Socket.IO	WebSocket wrapper, fallback mekanizmaları	Raw WebSocket, SSE
PDF	PDFKit	Node.js uyumlu, esnek	Puppeteer, jsPDF

👥 Kullanıcı Rolleri ve Yetkileri

Admin (Sistem Yöneticisi)

Yetkiler:

✅ Tüm kullanıcıları yönetme
✅ Mal sorumluları ekleme/güncelleme/silme
✅ Araç kayıtlarını yönetme
✅ Birlik bilgilerini yönetme
✅ Personel kayıtlarını yönetme
✅ Sistem ayarlarını yapılandırma
❌ Yakıt fişi oluşturma
❌ Fiş onaylama/reddetme

Kullanım Alanları:

Sistem kurulum ve bakım
Kullanıcı yönetimi
Temel veri girişi
Raporlama ve analiz

Yakıt Sorumlusu

Yetkiler:

✅ Yakıt fişi oluşturma
✅ Fiş durumlarını takip etme
✅ PDF fiş indirme
✅ Kaynak bilgilerini görme
❌ Kullanıcı yönetimi
❌ Fiş onaylama
❌ Temel veri düzenleme

Kullanım Alanları:

Günlük yakıt ikmal işlemleri
Fiş oluşturma ve takip
Raporlama

Mal Sorumlusu

Yetkiler:

✅ Atanan fişleri görme
✅ Fiş onaylama/reddetme
✅ Onay/reddetme gerekçesi ekleme
✅ Atanan fişleri arşivleme
❌ Fiş oluşturma
❌ Kullanıcı yönetimi
❌ Temel veri düzenleme

Kullanım Alanları:

Yakıt ikmal onay süreçleri
Stok takibi
Raporlama

🔄 İş Akışları

1. Kullanıcı Yönetimi Akışı (Admin)

Başlangıç
    ↓
Admin Girişi
    ↓
"Kullanıcı Yönetimi" → "Mal Sorumluları"
    ↓
"Ekle" butonu → Form doldur → Kaydet
    ↓
Kullanıcı oluşturuldu → Bilgilendirme
    ↓
Bitiş

2. Yakıt Fişi Oluşturma Akışı

Başlangıç
    ↓
Yakıt Sorumlusu Girişi
    ↓
"Yeni Fiş" butonu
    ↓
Form doldurma:
├─ Tarih seçimi
├─ Kuvvet seçimi
├─ Birlik seçimi
├─ Araç seçimi
├─ Yakıt bilgileri
├─ Personel seçimi
└─ Mal sorumlusu atama
    ↓
"Oluştur" butonu
    ↓
Validasyon → Veritabanı kayıt
    ↓
Mal sorumlusuna bildirim
    ↓
PDF fiş oluştur (opsiyonel)
    ↓
Bitiş

3. Fiş Onay Akışı

Başlangıç
    ↓
Mal Sorumlusu Girişi
    ↓
"Atanan Fişler" listesi
    ↓
Fiş seçimi → Detay görüntüle
    ↓
Karar verme:
├─ "Onayla" → Durum: approved
└─ "Reddet" → Gerekçe gir → Durum: rejected
    ↓
Yakıt sorumlusuna bildirim
    ↓
Bitiş

4. Real-time Bildirim Akışı

Olay Tetiklenir
    ↓
Server Event Oluştur
    ↓
Socket.IO Emit
    ↓
İlgili Client'a Gönder
    ↓
UI Güncellenir
    ↓
Kullanıcı Bilgilendirilir

4.4 KiB Raw Permalink Blame History Unescape Escape

YTP Bilgi Bankası

İlk Yakıt Fişi Oluşturma

🏗️ Sistem Mimarisi

Mimari Diyagram

Teknoloji Stack Karşılaştırması

👥 Kullanıcı Rolleri ve Yetkileri

Admin (Sistem Yöneticisi)

Yakıt Sorumlusu

Mal Sorumlusu

🔄 İş Akışları

1. Kullanıcı Yönetimi Akışı (Admin)

2. Yakıt Fişi Oluşturma Akışı

3. Fiş Onay Akışı

4. Real-time Bildirim Akışı

4.4 KiB

Raw Permalink Blame History