first commit

2026-04-26 22:27:56 +03:00
commit d9f1ea341e
1021 changed files with 70645 additions and 0 deletions
--- a/cart/API_DOCS.md
+++ b/cart/API_DOCS.md
@@ -0,0 +1,140 @@
+# Sepet (Cart) API Kullanım Kılavuzu
+
+Bu doküman, alışveriş sepeti (Shopping Cart) API'sinin nasıl kullanılacağını, uç noktaları (endpoints), istek parametrelerini ve örnek senaryoları içerir.
+
+## Genel Bilgiler
+
+- **Base URL:** `/api/v1/cart/`
+- **Mantık:** Sepet, sunucu tarafında **Session (Oturum)** tabanlı çalışır.
+- **Önemli Not:** İstemci (Frontend/Mobile), sunucudan dönen `sessionid` çerezini (cookie) saklamalı ve sonraki tüm isteklerde header içinde geri göndermelidir. Aksi takdirde her istekte yeni, boş bir sepet oluşturulur.
+
+---
+
+## Uç Noktalar (Endpoints)
+
+### 1. Sepeti Görüntüle
+
+Mevcut sepetin içeriğini ve toplam tutarını getirir.
+
+- **URL:** `/api/v1/cart/`
+- **Method:** `GET`
+
+**Örnek Yanıt:**
+```json
+{
+    "items": [
+        {
+            "product": {
+                "id": 1,
+                "title": "Örnek Ürün",
+                "price": 100.00,
+                "images": "http://localhost:8000/media/...",
+                ...
+            },
+            "quantity": 2,
+            "price": "100.00",
+            "total_price": "200.00"
+        }
+    ],
+    "total_price": "200.00"
+}
+```
+
+---
+
+### 2. Sepete Ürün Ekle / Güncelle
+
+Sepete yeni bir ürün ekler veya mevcut ürünün miktarını değiştirir.
+
+- **URL:** `/api/v1/cart/add/`
+- **Method:** `POST`
+
+**Parametreler (Body - JSON):**
+
+| Parametre | Tip | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| `product_id` | Integer | Evet | Eklenecek ürünün ID'si. |
+| `quantity` | Integer | Hayır | Miktar (Varsayılan: 1). |
+| `override_quantity` | Boolean | Hayır | `true` ise miktarı direkt eşitler, `false` ise mevcut miktarın üzerine ekler (Varsayılan: `false`). |
+
+#### Senaryo A: Sepete Ürün Ekleme (veya Miktar Artırma)
+Mevcut miktarın üzerine ekler. (Örn: Sepette 1 tane var, 2 tane daha ekle = 3 olur).
+
+**İstek:**
+```json
+{
+    "product_id": 1,
+    "quantity": 2,
+    "override_quantity": false
+}
+```
+
+#### Senaryo B: Miktarı Güncelleme / Azaltma
+Miktarı direkt olarak belirtilen sayıya eşitler. (Örn: Sepette 5 tane var, 4'e düşürmek istiyorsunuz).
+
+**İstek:**
+```json
+{
+    "product_id": 1,
+    "quantity": 4,
+    "override_quantity": true
+}
+```
+
+#### Senaryo C: Miktarı Sıfırlayarak Silme
+Eğer `override_quantity: true` iken `quantity: 0` gönderirseniz, ürün sepetten silinir.
+
+**İstek:**
+```json
+{
+    "product_id": 1,
+    "quantity": 0,
+    "override_quantity": true
+}
+```
+
+---
+
+### 3. Sepetten Ürün Silme
+
+Belirli bir ürünü sepetten tamamen kaldırır.
+
+- **URL:** `/api/v1/cart/remove/<product_id>/`
+- **Method:** `DELETE`
+
+**Örnek:** `/api/v1/cart/remove/1/`
+
+**Yanıt:** Güncel sepet içeriğini döndürür (Ekleme işlemiyle aynı formatta).
+
+---
+
+### 4. Sepeti Temizle
+
+Sepetteki tüm ürünleri siler.
+
+- **URL:** `/api/v1/cart/clear/`
+- **Method:** `POST`
+
+**Yanıt:**
+```json
+{
+    "message": "Cart cleared"
+}
+```
+
+---
+
+## Frontend Entegrasyonu İçin İpuçları (React/Vue/Mobile)
+
+1. **Cookie Yönetimi:** Axios veya Fetch kullanırken `credentials: 'include'` veya `withCredentials: true` ayarının açık olduğundan emin olun. Bu, Django'nun session cookie'sini tarayıcının saklamasını ve göndermesini sağlar.
+   
+   ```javascript
+   // Axios Örneği
+   axios.post('/api/v1/cart/add/', data, {
+       withCredentials: true
+   });
+   ```
+
+2. **Ürün Detayları:** Sepet yanıtı (`items` dizisi) içindeki `product` objesi, `ProductSerializer`'dan gelen tüm veriyi (resim, slug, başlık vb.) içerir. Ekstra bir istek atmanıza gerek yoktur.
+
+3. **Toplam Fiyat:** Sepet toplamı `total_price` alanında string decimal olarak gelir (Örn: "1250.50"). Frontend'de gösterirken formatlamanız gerekebilir.