vantuz 3.0.0

package/plugins/vantuz/platforms/pttavm.js

@@ -0,0 +1,136 @@
+/**
+ * 📮 PTTavm API Entegrasyonu
+ * pttavm.com/entegrasyon
+ */
+
+import axios from 'axios';
+
+const BASE_URL = 'https://api.pttavm.com/v1';
+
+export class PttavmAPI {
+    constructor(config) {
+        this.apiKey = config.apiKey;
+        this.token = config.token;
+        this.shopId = config.shopId;
+    }
+
+    _headers() {
+        return {
+            'Authorization': `Bearer ${this.token}`,
+            'X-API-Key': this.apiKey,
+            'Content-Type': 'application/json'
+        };
+    }
+
+    async _request(method, endpoint, data = null, params = null) {
+        try {
+            const response = await axios({
+                method,
+                url: `${BASE_URL}${endpoint}`,
+                headers: this._headers(),
+                data,
+                params
+            });
+            return { success: true, data: response.data };
+        } catch (error) {
+            return {
+                success: false,
+                error: error.response?.data || error.message
+            };
+        }
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // ÜRÜN İŞLEMLERİ
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getProducts(params = {}) {
+        const { page = 1, limit = 100, barcode } = params;
+        return await this._request('GET', '/products', null, {
+            page, limit, barcode
+        });
+    }
+
+    async createProduct(product) {
+        return await this._request('POST', '/products', product);
+    }
+
+    async updateProduct(productId, updates) {
+        return await this._request('PUT', `/products/${productId}`, updates);
+    }
+
+    async updatePrice(barcode, price) {
+        return await this._request('PUT', '/products/price', {
+            items: [{ barcode, salePrice: price }]
+        });
+    }
+
+    async updateStock(barcode, quantity) {
+        return await this._request('PUT', '/products/stock', {
+            items: [{ barcode, quantity }]
+        });
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // SİPARİŞ İŞLEMLERİ
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getOrders(params = {}) {
+        const { status, startDate, endDate, page = 1, limit = 100 } = params;
+        return await this._request('GET', '/orders', null, {
+            status, startDate, endDate, page, limit
+        });
+    }
+
+    async getOrderDetail(orderId) {
+        return await this._request('GET', `/orders/${orderId}`);
+    }
+
+    async updateOrderStatus(orderId, status) {
+        return await this._request('PUT', `/orders/${orderId}/status`, { status });
+    }
+
+    async shipOrder(orderId, trackingNumber) {
+        return await this._request('PUT', `/orders/${orderId}/ship`, {
+            trackingNumber,
+            cargoCompany: 'PTT'
+        });
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // KATEGORİ
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getCategories() {
+        return await this._request('GET', '/categories');
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // HELPER
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async testConnection() {
+        const result = await this.getProducts({ page: 1, limit: 1 });
+        return result.success;
+    }
+
+    isConnected() {
+        return !!(this.apiKey && this.token);
+    }
+}
+
+let instance = null;
+
+export const pttavmApi = {
+    init(config) {
+        instance = new PttavmAPI(config);
+        return instance;
+    },
+    getInstance() { return instance; },
+    isConnected() { return instance?.isConnected() || false; },
+
+    async getProducts(params) { return instance?.getProducts(params); },
+    async updatePrice(code, price) { return instance?.updatePrice(code, price); },
+    async updateStock(code, qty) { return instance?.updateStock(code, qty); },
+    async getOrders(params) { return instance?.getOrders(params); }
+};

package/plugins/vantuz/platforms/trendyol.js

@@ -0,0 +1,307 @@
+/**
+ * 🟠 TRENDYOL API Entegrasyonu
+ * developers.trendyol.com
+ * 
+ * Özellikler:
+ * - Ürün listeleme/güncelleme
+ * - Fiyat/stok yönetimi
+ * - Sipariş yönetimi
+ * - Rakip fiyat çekme
+ */
+
+import axios from 'axios';
+
+const BASE_URL = 'https://api.trendyol.com/sapigw';
+const STAGE_URL = 'https://stageapi.trendyol.com/stagesapigw'; // Test ortamı
+
+export class TrendyolAPI {
+    constructor(config) {
+        this.supplierId = config.supplierId;
+        this.apiKey = config.apiKey;
+        this.apiSecret = config.apiSecret;
+        this.isStage = config.isStage || false;
+
+        this.baseUrl = this.isStage ? STAGE_URL : BASE_URL;
+        this.auth = Buffer.from(`${this.apiKey}:${this.apiSecret}`).toString('base64');
+    }
+
+    _headers() {
+        return {
+            'Authorization': `Basic ${this.auth}`,
+            'Content-Type': 'application/json',
+            'User-Agent': `${this.supplierId} - VantuzAI`
+        };
+    }
+
+    async _request(method, endpoint, data = null, params = null) {
+        try {
+            const response = await axios({
+                method,
+                url: `${this.baseUrl}${endpoint}`,
+                headers: this._headers(),
+                data,
+                params
+            });
+            return { success: true, data: response.data };
+        } catch (error) {
+            return {
+                success: false,
+                error: error.response?.data?.errors || error.message,
+                status: error.response?.status
+            };
+        }
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // ÜRÜN İŞLEMLERİ
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getProducts(params = {}) {
+        const { page = 0, size = 50, barcode, approved, onSale } = params;
+        return await this._request('GET', `/suppliers/${this.supplierId}/products`, null, {
+            page, size, barcode, approved, onSale
+        });
+    }
+
+    async getProductByBarcode(barcode) {
+        const result = await this.getProducts({ barcode });
+        if (result.success && result.data.content?.length > 0) {
+            return { success: true, data: result.data.content[0] };
+        }
+        return { success: false, error: 'Ürün bulunamadı' };
+    }
+
+    async createProducts(products) {
+        // items: [{ barcode, title, productMainId, brandId, categoryId, ... }]
+        return await this._request('POST', `/suppliers/${this.supplierId}/v2/products`, { items: products });
+    }
+
+    async updateProducts(products) {
+        return await this._request('PUT', `/suppliers/${this.supplierId}/v2/products`, { items: products });
+    }
+
+    async deleteProducts(barcodes) {
+        const items = barcodes.map(barcode => ({ barcode }));
+        return await this._request('DELETE', `/suppliers/${this.supplierId}/products`, { items });
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // FİYAT & STOK
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async updatePriceAndStock(items) {
+        // items: [{ barcode, quantity, salePrice, listPrice }]
+        return await this._request('POST', `/suppliers/${this.supplierId}/products/price-and-inventory`, { items });
+    }
+
+    async updatePrice(barcode, salePrice, listPrice = null) {
+        return await this.updatePriceAndStock([{
+            barcode,
+            salePrice,
+            listPrice: listPrice || salePrice
+        }]);
+    }
+
+    async updateStock(barcode, quantity) {
+        return await this.updatePriceAndStock([{ barcode, quantity }]);
+    }
+
+    async bulkPriceUpdate(updates) {
+        // updates: [{ barcode, price, listPrice? }]
+        const items = updates.map(u => ({
+            barcode: u.barcode,
+            salePrice: u.price,
+            listPrice: u.listPrice || u.price
+        }));
+        return await this.updatePriceAndStock(items);
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // SİPARİŞ İŞLEMLERİ
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getOrders(params = {}) {
+        const {
+            status, // Created, Picking, Invoiced, Shipped, Cancelled, Delivered
+            startDate,
+            endDate,
+            page = 0,
+            size = 50,
+            orderNumber
+        } = params;
+
+        return await this._request('GET', `/suppliers/${this.supplierId}/orders`, null, {
+            status, startDate, endDate, page, size, orderNumber
+        });
+    }
+
+    async getOrderByNumber(orderNumber) {
+        const result = await this.getOrders({ orderNumber });
+        if (result.success && result.data.content?.length > 0) {
+            return { success: true, data: result.data.content[0] };
+        }
+        return { success: false, error: 'Sipariş bulunamadı' };
+    }
+
+    async updateOrderStatus(lines, status, params = {}) {
+        // lines: [{ lineId, quantity }]
+        // status: Picking, Invoiced, UnSupplied
+        const endpoint = `/suppliers/${this.supplierId}/shipment-packages`;
+
+        if (status === 'Picking') {
+            return await this._request('PUT', endpoint, { lines, status: 'Picking' });
+        } else if (status === 'Invoiced') {
+            return await this._request('PUT', endpoint, {
+                lines,
+                status: 'Invoiced',
+                invoiceNumber: params.invoiceNumber
+            });
+        }
+
+        return { success: false, error: 'Geçersiz durum' };
+    }
+
+    async shipOrder(shipmentPackageId, trackingNumber, cargoKey = 'YURTICI') {
+        // cargoKey: YURTICI, MNG, ARAS, PTT, SURAT, UPS, HOROZ, CEVA, SENDEO
+        return await this._request('PUT',
+            `/suppliers/${this.supplierId}/shipment-packages/${shipmentPackageId}`,
+            {
+                trackingNumber,
+                cargoProviderCode: cargoKey,
+                status: 'Shipped'
+            }
+        );
+    }
+
+    async getShipmentProviders() {
+        return await this._request('GET', '/shipment-providers');
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // KATEGORİ & MARKA
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getCategories() {
+        return await this._request('GET', '/product-categories');
+    }
+
+    async getCategoryAttributes(categoryId) {
+        return await this._request('GET', `/product-categories/${categoryId}/attributes`);
+    }
+
+    async searchBrands(name) {
+        return await this._request('GET', '/brands', null, { name });
+    }
+
+    async getBrandsByCategory(categoryId) {
+        return await this._request('GET', `/product-categories/${categoryId}/brands`);
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // RAKİP ANALİZİ (Scraping - Dikkat: Rate limit)
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getCompetitorPrices(barcode) {
+        // Bu endpoint resmi API'de yok, web scraping gerekir
+        // Alternatif: Brave Search API ile rakip araması
+        try {
+            // Trendyol'da aynı ürünü satan diğer satıcıları bul
+            const searchUrl = `https://www.trendyol.com/sr?q=${barcode}`;
+            // Not: Bu gerçek scraping gerektirir, burada placeholder
+            return {
+                success: true,
+                competitors: [],
+                message: 'Rakip analizi için web_search tool kullanın'
+            };
+        } catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // SORU & CEVAP
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getQuestions(params = {}) {
+        const { status = 'WAITING_FOR_ANSWER', page = 0, size = 50 } = params;
+        return await this._request('GET', `/suppliers/${this.supplierId}/questions/filter`, null, {
+            status, page, size
+        });
+    }
+
+    async answerQuestion(questionId, answer) {
+        return await this._request('POST', `/suppliers/${this.supplierId}/questions/${questionId}/answers`, {
+            text: answer
+        });
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // WEBHOOK
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async getWebhooks() {
+        return await this._request('GET', `/suppliers/${this.supplierId}/webhooks`);
+    }
+
+    async createWebhook(url, events = ['order.created', 'order.shipped']) {
+        return await this._request('POST', `/suppliers/${this.supplierId}/webhooks`, {
+            url,
+            events
+        });
+    }
+
+    // ═══════════════════════════════════════════════════════════════════════════
+    // YARDIMCI METODLAR
+    // ═══════════════════════════════════════════════════════════════════════════
+
+    async testConnection() {
+        const result = await this.getProducts({ page: 0, size: 1 });
+        return result.success;
+    }
+
+    isConnected() {
+        return !!(this.supplierId && this.apiKey && this.apiSecret);
+    }
+
+    formatProduct(raw) {
+        return {
+            id: raw.id,
+            barcode: raw.barcode,
+            title: raw.title,
+            brand: raw.brand,
+            category: raw.categoryName,
+            price: raw.salePrice,
+            listPrice: raw.listPrice,
+            stock: raw.quantity,
+            images: raw.images?.map(i => i.url) || [],
+            approved: raw.approved,
+            onSale: raw.onSale,
+            url: `https://www.trendyol.com/p/-p-${raw.id}`
+        };
+    }
+}
+
+// Singleton instance
+let instance = null;
+
+export const trendyolApi = {
+    init(config) {
+        instance = new TrendyolAPI(config);
+        return instance;
+    },
+
+    getInstance() {
+        return instance;
+    },
+
+    isConnected() {
+        return instance?.isConnected() || false;
+    },
+
+    // Proxy methods
+    async getProducts(params) { return instance?.getProducts(params); },
+    async updatePrice(barcode, price) { return instance?.updatePrice(barcode, price); },
+    async updateStock(barcode, qty) { return instance?.updateStock(barcode, qty); },
+    async getOrders(params) { return instance?.getOrders(params); },
+    async getCompetitors(barcode) { return instance?.getCompetitorPrices(barcode); }
+};

package/plugins/vantuz/services/alerts.js

@@ -0,0 +1,253 @@
+/**
+ * 🔔 AKILLI UYARI SİSTEMİ
+ * Stok, fiyat ve sipariş uyarıları
+ */
+
+const DEFAULT_THRESHOLDS = {
+    criticalStock: 5,      // Kritik stok seviyesi
+    lowStock: 20,          // Düşük stok uyarısı
+    priceDropPercent: 10,  // Rakip fiyat düşüşü uyarısı
+    orderDelay: 24,        // Sipariş gecikme saati
+    reviewNegative: 3      // Negatif yorum eşiği
+};
+
+export class AlertService {
+    constructor(config = {}) {
+        this.thresholds = { ...DEFAULT_THRESHOLDS, ...config.thresholds };
+        this.subscribers = [];
+        this.alerts = [];
+        this.notifiedToday = new Set(); // Aynı uyarıyı tekrar gönderme
+    }
+
+    /**
+     * Uyarı ekle
+     */
+    addAlert(alert) {
+        const key = `${alert.type}-${alert.productId || alert.orderId || 'general'}`;
+
+        // Bugün zaten bildirildi mi?
+        if (this.notifiedToday.has(key)) {
+            return false;
+        }
+
+        this.alerts.push({
+            ...alert,
+            id: `alert-${Date.now()}`,
+            timestamp: new Date().toISOString(),
+            read: false
+        });
+
+        this.notifiedToday.add(key);
+        return true;
+    }
+
+    /**
+     * Stok kontrolü
+     */
+    async checkStock(products, platform) {
+        const alerts = [];
+
+        for (const product of products) {
+            const stock = product.quantity || product.stock || product.availableStock || 0;
+            const name = product.title || product.name || product.barcode;
+
+            if (stock <= 0) {
+                alerts.push({
+                    type: 'stock_out',
+                    severity: 'critical',
+                    icon: '🔴',
+                    message: `Stok bitti: ${name}`,
+                    productId: product.barcode || product.id,
+                    platform,
+                    value: stock
+                });
+            } else if (stock <= this.thresholds.criticalStock) {
+                alerts.push({
+                    type: 'stock_critical',
+                    severity: 'high',
+                    icon: '🟠',
+                    message: `Kritik stok (${stock}): ${name}`,
+                    productId: product.barcode || product.id,
+                    platform,
+                    value: stock
+                });
+            } else if (stock <= this.thresholds.lowStock) {
+                alerts.push({
+                    type: 'stock_low',
+                    severity: 'medium',
+                    icon: '🟡',
+                    message: `Düşük stok (${stock}): ${name}`,
+                    productId: product.barcode || product.id,
+                    platform,
+                    value: stock
+                });
+            }
+        }
+
+        alerts.forEach(a => this.addAlert(a));
+        return alerts;
+    }
+
+    /**
+     * Rakip fiyat kontrolü
+     */
+    async checkCompetitorPrices(comparisons) {
+        const alerts = [];
+
+        for (const comp of comparisons) {
+            const { product, ourPrice, lowestCompetitor, competitorName } = comp;
+            const diff = ((ourPrice - lowestCompetitor) / ourPrice) * 100;
+
+            if (lowestCompetitor < ourPrice && diff > this.thresholds.priceDropPercent) {
+                alerts.push({
+                    type: 'competitor_undercut',
+                    severity: 'high',
+                    icon: '💸',
+                    message: `Rakip ${Math.round(diff)}% ucuz: ${product.name || product.barcode}`,
+                    productId: product.barcode,
+                    competitor: competitorName,
+                    ourPrice,
+                    competitorPrice: lowestCompetitor,
+                    suggestion: `Fiyatı ${lowestCompetitor * 0.99}₺'ye düşürmeyi düşünün`
+                });
+            }
+        }
+
+        alerts.forEach(a => this.addAlert(a));
+        return alerts;
+    }
+
+    /**
+     * Sipariş gecikme kontrolü
+     */
+    async checkOrderDelays(orders) {
+        const alerts = [];
+        const now = Date.now();
+
+        for (const order of orders) {
+            const createdAt = new Date(order.createdDate || order.orderDate).getTime();
+            const hoursAgo = (now - createdAt) / (1000 * 60 * 60);
+
+            const status = order.status?.toLowerCase();
+            const isPending = ['created', 'new', 'pending', 'yeni'].some(s => status?.includes(s));
+
+            if (isPending && hoursAgo > this.thresholds.orderDelay) {
+                alerts.push({
+                    type: 'order_delayed',
+                    severity: 'high',
+                    icon: '⏰',
+                    message: `${Math.round(hoursAgo)} saat bekleyen sipariş: #${order.orderNumber || order.id}`,
+                    orderId: order.id,
+                    hoursDelayed: Math.round(hoursAgo),
+                    suggestion: 'Siparişi hazırlayın veya iptal edin'
+                });
+            }
+        }
+
+        alerts.forEach(a => this.addAlert(a));
+        return alerts;
+    }
+
+    /**
+     * Tüm uyarıları formatla
+     */
+    formatAlerts(alerts) {
+        if (alerts.length === 0) {
+            return '✅ Herhangi bir uyarı yok!';
+        }
+
+        const grouped = {
+            critical: alerts.filter(a => a.severity === 'critical'),
+            high: alerts.filter(a => a.severity === 'high'),
+            medium: alerts.filter(a => a.severity === 'medium'),
+            low: alerts.filter(a => a.severity === 'low')
+        };
+
+        let message = '📋 **Uyarı Özeti**\n\n';
+
+        if (grouped.critical.length > 0) {
+            message += `🔴 **Kritik (${grouped.critical.length})**\n`;
+            grouped.critical.forEach(a => {
+                message += `  • ${a.message}\n`;
+            });
+            message += '\n';
+        }
+
+        if (grouped.high.length > 0) {
+            message += `🟠 **Yüksek (${grouped.high.length})**\n`;
+            grouped.high.slice(0, 5).forEach(a => {
+                message += `  • ${a.message}\n`;
+            });
+            if (grouped.high.length > 5) {
+                message += `  ... ve ${grouped.high.length - 5} uyarı daha\n`;
+            }
+            message += '\n';
+        }
+
+        if (grouped.medium.length > 0) {
+            message += `🟡 **Orta (${grouped.medium.length})**\n`;
+            grouped.medium.slice(0, 3).forEach(a => {
+                message += `  • ${a.message}\n`;
+            });
+            if (grouped.medium.length > 3) {
+                message += `  ... ve ${grouped.medium.length - 3} uyarı daha\n`;
+            }
+        }
+
+        return message;
+    }
+
+    /**
+     * Okunmamış uyarı sayısı
+     */
+    getUnreadCount() {
+        return this.alerts.filter(a => !a.read).length;
+    }
+
+    /**
+     * Uyarıları okundu işaretle
+     */
+    markAllRead() {
+        this.alerts.forEach(a => a.read = true);
+    }
+
+    /**
+     * Günlük cache'i temizle
+     */
+    resetDaily() {
+        this.notifiedToday.clear();
+    }
+}
+
+export const alertTool = {
+    name: 'alert',
+
+    async execute(params, context) {
+        const { action, type } = params;
+        const alertService = new AlertService();
+
+        switch (action) {
+            case 'check':
+                // Tüm kontrolleri yap ve uyarıları topla
+                const allAlerts = [];
+                // TODO: Platform API'lerinden veri çek ve kontrol et
+                return { success: true, alerts: allAlerts };
+
+            case 'list':
+                return {
+                    success: true,
+                    alerts: alertService.alerts,
+                    unread: alertService.getUnreadCount()
+                };
+
+            case 'clear':
+                alertService.markAllRead();
+                return { success: true };
+
+            default:
+                return { success: false, error: 'Geçersiz action' };
+        }
+    }
+};
+
+export default AlertService;