Kurye Lojistik - Web Uygulaması

Bu proje, bireysel ve kurumsal müşteriler için tasarlanmış bir kurye ve lojistik yönetim sisteminin HTML prototipleridir.

Proje Yapısı

my/
├── public/
│   ├── index.html              # Ana sayfa - Hızlı gönderi formu
│   ├── tracking.html           # Gönderi takip sayfası
│   ├── corporate-login.html    # Kurumsal giriş sayfası
│   ├── corporate-dashboard.html # Kurumsal panel
│   ├── admin-login.html        # Admin giriş sayfası
│   ├── admin-dashboard.html    # Admin/Operasyon paneli
│   ├── courier-app.html        # Kurye mobil web arayüzü
│   ├── css/                    # CSS dosyaları
│   ├── js/
│   │   ├── main.js            # Ana sayfa JavaScript
│   │   └── tracking.js        # Takip sayfası JavaScript
│   └── assets/
│       └── images/            # Görseller
├── info.md                     # Proje detaylı dokümantasyon
└── CLAUDE.md                   # Claude Code rehberi

Sayfalar

1. Ana Sayfa (index.html)

• Hızlı gönderi oluşturma formu
• Gönderici ve alıcı bilgileri
• Paket detayları ve hizmet tipi seçimi
• Otomatik fiyat hesaplama
• KVKK onay mekanizması

2. Takip Sayfası (tracking.html)

• Takip numarası ile gönderi sorgulama
• Gönderi durum geçmişi (timeline)
• Detaylı gönderi bilgileri
• Müşteri hizmetleri iletişim bilgileri

3. Kurumsal Panel

• Login (corporate-login.html): Giriş sayfası
• Dashboard (corporate-dashboard.html):
  • İstatistikler (toplam, aktif, teslim edilen)
  • Yeni gönderi oluşturma
  • Toplu CSV yükleme
  • Gönderi listesi ve filtreleme
  • Raporlar

4. Admin Paneli

• Login (admin-login.html): Admin giriş
• Dashboard (admin-dashboard.html):
  • Operasyon dashboard'u
  • Günlük istatistikler
  • Atama bekleyen gönderiler
  • Aktif kurye listesi
  • Kurye atama işlemleri
  • Sidebar navigasyon

5. Kurye Uygulaması (courier-app.html)

• Mobil responsive tasarım
• Aktif görevler listesi
• Görev detayları (alıcı/gönderici bilgileri)
• Yol tarifi entegrasyonu (hazır)
• Teslim etme işlemleri
• Günlük istatistikler
• Bottom navigation

Teknolojiler

• HTML5: Semantik yapı
• Tailwind CSS: Responsive tasarım (CDN üzerinden)
• Vanilla JavaScript: Form validasyonu ve dinamik içerik

Çalıştırma

Basit HTTP Server ile

# Python 3
python -m http.server 8000 --directory public

# PHP
php -S localhost:8000 -t public

# Node.js (npx)
npx http-server public -p 8000

Tarayıcıda: http://localhost:8000

Doğrudan Dosya ile

public/index.html dosyasını tarayıcıda açarak da kullanabilirsiniz.

Özellikler

Tamamlanan

✅ Responsive tasarım (mobil uyumlu) ✅ Modern ve temiz UI (Tailwind CSS) ✅ Tüm temel sayfalar ✅ Form validasyonu ✅ Otomatik fiyat hesaplama ✅ Takip sistemi demo ✅ Admin operasyon paneli ✅ Kurye mobil arayüzü

Gelecek Adımlar

• Backend API entegrasyonu (Laravel)
• Veritabanı bağlantısı
• Gerçek authentication sistemi
• Harita entegrasyonu (Google Maps / OSRM)
• SMS/Email bildirimleri
• Ödeme gateway entegrasyonu
• Dosya yükleme (fotoğraf, imza)
• Gerçek zamanlı tracking

Demo Veriler

Takip Numarası

• TRK-123456789 - Teslim edilmiş örnek gönderi

Kurumsal Login

• E-posta: ornek@sirket.com
• Şifre: Herhangi bir şey (demo)

Admin Login

• E-posta: admin@kuryelajistik.com
• Şifre: Herhangi bir şey (demo)

Mimari Bilgiler

Detaylı mimari ve domain yapısı için info.md ve CLAUDE.md dosyalarına bakınız.

• Domain-Driven Design (DDD) yaklaşımı
• 9 Bounded Context
• Event Sourcing (shipment_events)
• RBAC yetkilendirme
• KVKK uyumlu veri işleme

Lisans

Bu proje şu anda geliştirme aşamasındadır.