Neden Fiyat Saklamayı Reddeden Bir Sepet Paketi Geliştirdim

// Kullanıcı $49.99 olan ürünü ekler
Cart::add($product); // Saklanan fiyat: $49.99

// Yönetici fiyatı $59.99 olarak günceller
$product->update(['price' => 5999]);

// Kullanıcı saatler sonra ödeme yaparken... hala $49.99 ödüyor
// Ya da daha kötüsü: DOM'u inceleyip, saklanan fiyatı bulup, manipüle ediyor

composer require vanthao03596/cartly

use Cart\Cart;

// Sepete ekle - fiyat saklanmaz
$item = Cart::add($product, quantity: 2);

// Fiyat erişildiğinde taze olarak çözümlenir
$subtotal = Cart::subtotal(); // Her zaman güncel
$total = Cart::total(); // Her zaman doğru

// Geleneksel paket - savunmasız
$_SESSION['cart']['item_1']['price'] = 100; // Saldırgan fiyatı değiştirir

// Cartly - manipüle edilecek fiyat yok
// Fiyat çalışma zamanında güvenilir kaynaktan çözümlenir

// Flaş satış başlar
$product->update(['price' => 1999]); // %50 indirim!

// Tüm sepetler hemen yeni fiyatı yansıtır
// "Üzgünüm, o satış sona erdi" hatası ödeme aşamasında yok

class TieredPriceResolver implements PriceResolver
{
    public function resolve(CartItem $item, CartContext $context): ResolvedPrice
    {
        $user = $context->user();

        return match(true) {
            $user?->isPremium() => new ResolvedPrice(cents: 1999),
            $user?->isWholesale() => new ResolvedPrice(cents: 1499),
            default => new ResolvedPrice(cents: 2499),
        };
    }

// Geleneksel yaklaşım - N+1 sorguları
foreach ($cart->items() as $item) {
    $price = $item->product->price; // Her ürün için sorgu
}

// Cartly - Tek toplu sorgu
public function resolveMany(CartItemCollection $items, CartContext $context): array
{
    $ids = $items->pluck('id')->all();
    $prices = Price::whereIn('product_id', $ids)->get()->keyBy('product_id');

    return $items->mapWithKeys(fn($item) => [
        $item->rowId => new ResolvedPrice(cents: $prices[$item->id]->amount)
    ])->all();
}

// Ana sepet
Cart::add($product);

// İstek listesi
Cart::wishlist()->add($product);

// Karşılaştır // (en fazla 4 öğe)
Cart::compare()->add($product);

// Örnekler arasında taşı
Cart::moveToWishlist($rowId);
Cart::moveToCart($rowId);

use Cart\Conditions\TaxCondition;
use Cart\Conditions\DiscountCondition;

// Öncelikle %20 indirim uygulandı
Cart::condition(new DiscountCondition(
    name: 'Yaz İndirimi',
    value: 20,
    mode: 'yüzde',
    order: 1
));

// İndirimli tutar üzerinden vergi hesaplanır
Cart::condition(new TaxCondition(
    name: 'KDV',
    rate: 10,
    order: 2
));

// Şeffaf bir ayrıntı almak için
$breakdown = Cart::getCalculationBreakdown();
// [
//     'subtotal' => 10000,
//     'conditions' => [
//         'Yaz İndirimi' => -2000,
//         'KDV' => 800,
//     ],
//     'total' => 8800
// ]

// config/cart.php
'driver' => 'database',

// Veya örnek başına
'instances' => [
    'default' => ['driver' => 'database'],
    'compare' => ['driver' => 'session'],
]

'associate' => [
    'auto_associate' => true,
    'merge_on_login' => true,
    'merge_strategy' => 'combine', // combine | keep_guest | keep_user
]

// İçeride: her şey sent olarak
$subtotal = Cart::subtotal(); // 4999 (49.99 değil)

// Gösterim: insanlar için formatlanmış
$formatted = Cart::subtotal(formatted: true); // "$49.99"

// Yardımcılar dahil
format_price(4999); // "$49.99"
cents_to_dollars(4999); // 49.99
dollars_to_cents(49.99); // 4999

use Cart\Cart;

public function test_checkout_calculates_correct_total()
{
    Cart::fake();

    Cart::factory()
        ->withItems([
            ['id' => 1,
            'quantity' => 2,
            'price' => 1000],
            ['id' => 2,
            'quantity' => 1,
            'price' => 2500],
        ])
        ->withCondition(new TaxCondition('KDV', 10))
        ->create();

    Cart::assertSubtotal(4500);
    Cart::assertTaxTotal(450);
    Cart::assertTotal(4950);
}

// Tam yaşam döngüsü kapsama için 12 olay
CartItemAdding / CartItemAdded
CartItemUpdating / CartItemUpdated
CartItemRemoving / CartItemRemoved
CartClearing / CartCleared
CartMerging / CartMerged
CartConditionAdded / CartConditionRemoved

composer require vanthao03596/cartly
php artisan vendor:publish --provider="Cart\CartServiceProvider" --tag="config"

use Cart\Contracts\Buyable;
use Cart\Contracts\Priceable;
use Cart\Traits\CanBeBought;

class Product extends Model implements Buyable, Priceable
{
    use CanBeBought;

    // İşte bu kadar - fiyat, yaygın niteliklerden otomatik olarak tespit edilir
    // (price, sale_price, current_price, vb.)
}

use Cart\Cart;

// Öğeleri ekle
Cart::add($product, quantity: 2, options: ['size' => 'L']);

// Toplamları al
$total = Cart::total(formatted: true); // "$99.98"

// Sepeti temizle
Cart::clear();