chore: 清理归档文件和文档模板

删除不再需要的归档文件和过时的文档模板，包括多个README、安全策略、前端集成蓝图等文件，同时移除了未使用的业务文档和项目结构文件。

优化项目结构，移除冗余文件，保持代码库整洁。主要删除archive/handover目录下的多个文件及doc目录下的部分文档模板。

server/src/services/CrawlerService.ts

@@ -1,326 +0,0 @@
-import { exec } from 'child_process';
-import { BrowserContext, chromium, Page } from 'playwright';
-import { promisify } from 'util';
-import { Product, Sku } from '../models/Product';
-import { logger } from '../utils/logger';
-import { AIService } from './AIService';
-import { ConfigService } from './ConfigService';
-import { SelfHealingService } from './SelfHealingService';
-
-const execAsync = promisify(exec);
-
-export interface CrawlerOptions {
-  useSandbox?: boolean;
-  cpuLimit?: string;
-  memoryLimit?: string;
-}
-
-export class CrawlerService {
-  private static PROXY_LIST = [
-    'http://proxy1.crawlful.com:8080',
-    'http://proxy2.crawlful.com:8080',
-  ];
-
-  /**
-   * @description 获取自动调度的代理配置 (CORE_EXT_07)
-   */
-  private static getProxyConfig() {
-    const proxy = this.PROXY_LIST[Math.floor(Math.random() * this.PROXY_LIST.length)];
-    return {
-      server: proxy,
-    };
-  }
-
-  /**
-   * [CORE_DEV_05] 容器化隔离采集 (Sandbox Crawler)
-   * @description 将采集任务分发至隔离的 Docker 容器中，确保 IP 隔离与资源限制
-   */
-  private static async dispatchToSandbox(url: string, options: CrawlerOptions): Promise<Partial<Product>> {
-    const cpu = options.cpuLimit || '0.5';
-    const memory = options.memoryLimit || '512m';
-    const containerName = `crawler-${Date.now()}`;
-
-    logger.info(`[Crawler] Dispatching ${url} to sandbox ${containerName} (CPU: ${cpu}, Mem: ${memory})...`);
-
-    try {
-      // 生产环境下应调用 Docker API 或 K8s Job
-      // 此处通过命令行模拟：docker run --rm --cpus=0.5 --memory=512m crawler-image npm run crawl --url="..."
-      const cmd = `docker run --rm --name ${containerName} --cpus=${cpu} --memory=${memory} crawler-image npm run crawl --url="${url}"`;
-      
-      if (process.env.NODE_ENV === 'production') {
-        const { stdout } = await execAsync(cmd);
-        return JSON.parse(stdout);
-      } else {
-        // 开发模式下模拟容器延迟
-        await new Promise(resolve => setTimeout(resolve, 2000));
-        return this.crawlProductDirect(url);
-      }
-    } catch (error: any) {
-      logger.error(`[Crawler] Sandbox dispatch failed: ${error.message}`);
-      throw error;
-    }
-  }
-
-  /**
-   * @description 抓取商品详情，集成指纹混淆与拟人化模拟
-   * @param {string} url 商品详情页 URL
-   * @param {CrawlerOptions} options 采集配置
-   */
-  static async crawlProduct(url: string, options: CrawlerOptions = {}): Promise<Partial<Product>> {
-    if (options.useSandbox) {
-      return this.dispatchToSandbox(url, options);
-    }
-    return this.crawlProductDirect(url);
-  }
-
-  private static async crawlProductDirect(url: string): Promise<Partial<Product>> {
-    const proxy = this.getProxyConfig();
-    const browser = await chromium.launch({ 
-      headless: true,
-      proxy,
-      args: [
-        '--no-sandbox', 
-        '--disable-setuid-sandbox',
-        '--disable-blink-features=AutomationControlled',
-        '--js-flags="--max-old-space-size=512"' // 资源限制 (CORE_DEV_05)
-      ]
-    });
-
-    const context = await browser.newContext({
-      userAgent: this.getRandomUserAgent(),
-      viewport: { width: 1920, height: 1080 },
-      deviceScaleFactor: 1,
-    });
-
-    // 1. 注入指纹混淆脚本 (CORE_EXT_07)
-    await this.injectFingerprintObfuscator(context);
-
-    const page = await context.newPage();
-    
-    try {
-      logger.info(`[Crawler] Navigating to ${url}...`);
-      
-      // 2. 模拟真实人类行为 (CORE_EXT_07)
-      await this.simulateHumanBehavior(page, url);
-
-      const platform = this.detectPlatform(url);
-      let title = '';
-      let price = 0;
-      let mainImage = '';
-      let images: string[] = [];
-      let skus: Sku[] = [];
-      let attributes: Record<string, string> = {};
-
-      if (platform === '1688') {
-        // 1688 深度解析逻辑
-        title = await this.getTextWithSelfHealing(page, platform, '.title-text, .d-title, h1', 'Product Title');
-        mainImage = (await page.locator('.prop-img, .main-image img, .mod-detail-gallery img').first().getAttribute('src').catch(() => '')) || '';
-        
-        const priceText = await this.getTextWithSelfHealing(page, platform, '.price-text, .value, .price-now', 'Price');
-        price = parseFloat(priceText.replace(/[^\d.]/g, '')) || 0;
-
-        images = await page.locator('.tab-trigger img, .vertical-img img').evaluateAll(imgs => 
-          imgs.map(img => (img as HTMLImageElement).src).filter(src => src && !src.includes('video'))
-        );
-
-        const attrKeys = await page.locator('.attributes-list .obj-title').evaluateAll(els => els.map(el => el.textContent?.trim() || ''));
-        const attrValues = await page.locator('.attributes-list .obj-content').evaluateAll(els => els.map(el => el.textContent?.trim() || ''));
-        attrKeys.forEach((key, i) => {
-          if (key && attrValues[i]) attributes[key] = attrValues[i];
-        });
-
-      } else if (platform === 'Amazon') {
-        title = await this.getTextWithSelfHealing(page, platform, '#productTitle', 'Product Title');
-        mainImage = (await page.locator('#landingImage, #imgBlkFront, #ebooksImgBlkFront').getAttribute('src').catch(() => '')) || '';
-        
-        const priceWhole = (await page.locator('.a-price-whole').first().innerText().catch(() => '0')) || '0';
-        const priceFraction = (await page.locator('.a-price-fraction').first().innerText().catch(() => '00')) || '00';
-        price = parseFloat(`${priceWhole}.${priceFraction}`.replace(/[^\d.]/g, '')) || 0;
-
-        images = await page.locator('#altImages img').evaluateAll(imgs => 
-          imgs.map(img => (img as HTMLImageElement).src.replace(/\._.*_\./, '.'))
-              .filter(src => src && !src.includes('video') && !src.includes('play-button'))
-        );
-
-        const features = await page.locator('#feature-bullets li span').evaluateAll(els => els.map(el => el.textContent?.trim() || ''));
-        if (features.length > 0) attributes['features'] = features.join('; ');
-      } else if (platform === 'Temu') {
-        title = await this.getTextWithSelfHealing(page, platform, 'h1[data-test="product-title"]', 'Product Title');
-        mainImage = (await page.locator('img[data-test="main-image"]').getAttribute('src').catch(() => '')) || '';
-        const priceStr = await this.getTextWithSelfHealing(page, platform, 'div[data-test="product-price"]', 'Price');
-        price = parseFloat(priceStr.replace(/[^\d.]/g, '')) || 0;
-      }
-      
-      const product: Partial<Product> = {
-        platform,
-        productId: this.extractId(url),
-        title: title.trim(),
-        originalTitle: title.trim(),
-        mainImage: mainImage || (images.length > 0 ? images[0] : ''),
-        detailUrl: url,
-        price,
-        originalPrice: price,
-        currency: platform === '1688' ? 'CNY' : 'USD',
-        skus,
-        attributes,
-        images: images.length > 0 ? images : [mainImage].filter(Boolean) as string[]
-      };
-
-      return product;
-    } catch (error: any) {
-      logger.error(`[Crawler] Failed to crawl ${url}: ${error.message}`);
-      throw error;
-    } finally {
-      await browser.close();
-    }
-  }
-
-  /**
-   * @description 注入指纹混淆脚本，重写 Canvas/WebGL 属性
-   */
-  private static async injectFingerprintObfuscator(context: BrowserContext) {
-    await context.addInitScript(() => {
-      // 1. 重写 Canvas 指纹
-      const originalGetContext = HTMLCanvasElement.prototype.getContext;
-      (HTMLCanvasElement.prototype as any).getContext = function (type: any, ...args: any[]) {
-        const context = originalGetContext.apply(this, [type, ...args] as any);
-        if (type === '2d' && context) {
-          const originalFillText = (context as any).fillText;
-          (context as any).fillText = function (...args: any[]) {
-            // 在绘制文字时加入极其微小的扰动
-            (this as any).fillStyle = `rgba(${Math.random()}, 0, 0, 0.01)`;
-            return originalFillText.apply(this, args);
-          };
-        }
-        return context;
-      };
-
-      // 2. 模拟 WebGL 渲染器信息
-      const originalGetParameter = WebGLRenderingContext.prototype.getParameter;
-      WebGLRenderingContext.prototype.getParameter = function (parameter: number) {
-        if (parameter === 37445) return 'Intel Inc.'; // UNMASKED_VENDOR_WEBGL
-        if (parameter === 37446) return 'Intel(R) Iris(R) Xe Graphics'; // UNMASKED_RENDERER_WEBGL
-        return originalGetParameter.apply(this, [parameter]);
-      };
-
-      // 3. 隐藏 WebDriver 标记
-      Object.defineProperty(navigator, 'webdriver', { get: () => undefined });
-    });
-  }
-
-  /**
-   * @description 模拟人类浏览行为：随机滚动、移动鼠标与停顿
-   */
-  private static async simulateHumanBehavior(page: Page, url: string) {
-    await page.goto(url, { waitUntil: 'domcontentloaded', timeout: 60000 });
-
-    // 随机停顿 1-3s
-    await page.waitForTimeout(1000 + Math.random() * 2000);
-
-    // 1. 模拟分段平滑滚动 (CORE_EXT_07)
-    const viewportHeight = page.viewportSize()?.height || 1080;
-    const totalScrolls = 3 + Math.floor(Math.random() * 3);
-    for (let i = 0; i < totalScrolls; i++) {
-      const scrollStep = 300 + Math.random() * 500;
-      await page.evaluate((step) => {
-        window.scrollBy({ top: step, behavior: 'smooth' });
-      }, scrollStep);
-      await page.waitForTimeout(1000 + Math.random() * 1500);
-      
-      // 2. 在滚动间隙模拟随机鼠标移动 (CORE_EXT_07)
-      const targetX = Math.random() * 800;
-      const targetY = Math.random() * viewportHeight;
-      await page.mouse.move(targetX, targetY, { steps: 10 + Math.floor(Math.random() * 20) });
-    }
-
-    // 3. 随机移动到可能感兴趣的区域 (如图片/详情)
-    await page.mouse.move(Math.random() * 500, Math.random() * 500, { steps: 25 });
-    
-    // 等待网络空闲
-    await page.waitForLoadState('networkidle').catch(() => {});
-  }
-
-  private static getRandomUserAgent(): string {
-    const uas = [
-      'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36',
-      'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
-      'Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/121.0.0.0 Safari/537.36'
-    ];
-    return uas[Math.floor(Math.random() * uas.length)];
-  }
-
-  private static detectPlatform(url: string): string {
-    if (url.includes('1688.com')) return '1688';
-    if (url.includes('amazon.com')) return 'Amazon';
-    if (url.includes('temu.com')) return 'Temu';
-    if (url.includes('aliexpress.com')) return 'AliExpress';
-    return 'Unknown';
-  }
-
-  private static extractId(url: string): string {
-    try {
-      const u = new URL(url);
-      if (u.hostname.includes('1688.com')) {
-        const match = url.match(/offer\/(\d+)\.html/);
-        return match ? match[1] : '1688-' + Date.now();
-      }
-      if (u.hostname.includes('amazon.com')) {
-        const match = url.match(/dp\/(\w+)/);
-        return match ? match[1] : 'amz-' + Date.now();
-      }
-      return 'prod-' + Math.random().toString(36).substring(7);
-    } catch {
-      return 'unknown-' + Date.now();
-    }
-  }
-
-  /**
-   * [CORE_AI_09] 自愈式采集辅助
-   * @description 尝试获取元素文本，若失败则调用 AI 进行选择器修复
-   */
-  private static async getTextWithSelfHealing(
-    page: Page, 
-    platform: string, 
-    selector: string, 
-    targetField: string
-  ): Promise<string> {
-    // 0. 优先检查缓存中是否有已修复的选择器
-    const healed = await SelfHealingService.getHealedSelector(platform, targetField);
-    const activeSelector = healed || selector;
-
-    try {
-      // 1. 尝试活动选择器 (带超时)
-      const text = await page.locator(activeSelector).first().innerText({ timeout: 5000 });
-      if (text && text.trim()) return text.trim();
-      throw new Error('Element found but text is empty');
-    } catch (err) {
-      logger.warn(`[Crawler] Selector failed: ${activeSelector}. Triggering self-healing...`);
-
-      // 2. 获取 DOM 片段
-      const domSnippet = await page.evaluate(() => {
-        return document.body.innerHTML.substring(0, 10000);
-      });
-
-      // 3. 调用 AI 修复中心
-      try {
-        const repair = await SelfHealingService.repairSelector({
-          platform,
-          targetField,
-          oldSelector: activeSelector,
-          htmlContext: domSnippet
-        });
-
-        if (repair.success && repair.newSelector) {
-          logger.info(`[Crawler] AI found new selector: ${repair.newSelector} (Confidence: ${repair.confidence})`);
-          const repairedText = await page.locator(repair.newSelector).first().innerText({ timeout: 5000 });
-          if (repairedText && repairedText.trim()) return repairedText.trim();
-        }
-      } catch (aiErr) {
-        logger.error(`[Crawler] AI repair failed: ${aiErr}`);
-      }
-
-      return ''; // 最终失败返回空
-    }
-  }
-}
-

server/src/services/PlatformApiService.ts

@@ -0,0 +1,293 @@
+import { logger } from '../utils/logger';
+import { ConfigService } from './ConfigService';
+
+/**
+ * PlatformApiService - 平台API对接服务
+ * 
+ * 功能定位：
+ * - 仅处理有API平台的对接（Amazon MWS, eBay API, Shopee Open API等）
+ * - 无API平台（TikTok Shop, Temu等）的采集由浏览器插件处理
+ * 
+ * 安全约束：
+ * - 严禁在后端进行网页爬取（避免服务器IP被封）
+ * - 所有API调用需携带traceId和tenantId
+ * 
+ * @author AI-Backend-1
+ * @taskId BE-P005, BE-P006, BE-P007
+ */
+
+export interface PlatformApiConfig {
+  platform: 'AMAZON' | 'EBAY' | 'SHOPEE' | 'ALIEXPRESS';
+  apiKey: string;
+  apiSecret: string;
+  accessToken?: string;
+  refreshToken?: string;
+  marketplaceId?: string;
+}
+
+export interface SyncOptions {
+  tenantId: string;
+  shopId: string;
+  traceId: string;
+  businessType: 'TOC' | 'TOB';
+  startDate?: Date;
+  endDate?: Date;
+  limit?: number;
+}
+
+export interface ProductSyncResult {
+  platformProductId: string;
+  title: string;
+  price: number;
+  currency: string;
+  stock: number;
+  status: string;
+  syncedAt: Date;
+}
+
+export interface OrderSyncResult {
+  platformOrderId: string;
+  status: string;
+  totalAmount: number;
+  currency: string;
+  items: Array<{
+    sku: string;
+    quantity: number;
+    unitPrice: number;
+  }>;
+  syncedAt: Date;
+}
+
+export class PlatformApiService {
+  private static readonly API_ENDPOINTS = {
+    AMAZON: 'https://sellingpartnerapi-na.amazon.com',
+    EBAY: 'https://api.ebay.com/sell',
+    SHOPEE: 'https://partner.shopeemobile.com/api/v2',
+    ALIEXPRESS: 'https://openapi.aliexpress.com',
+  };
+
+  private static readonly RATE_LIMITS = {
+    AMAZON: { requests: 10, window: 1000 }, // 10 req/s
+    EBAY: { requests: 100, window: 60000 }, // 100 req/min
+    SHOPEE: { requests: 100, window: 60000 }, // 100 req/min
+    ALIEXPRESS: { requests: 50, window: 60000 }, // 50 req/min
+  };
+
+  /**
+   * 同步商品数据 - 从平台API获取商品信息
+   * @param config 平台API配置
+   * @param options 同步选项（包含五元组追踪信息）
+   * @returns 同步结果
+   */
+  static async syncProducts(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<ProductSyncResult[]> {
+    const { tenantId, shopId, traceId, businessType } = options;
+    
+    logger.info(`[PlatformApiService] Starting product sync`, {
+      platform: config.platform,
+      tenantId,
+      shopId,
+      traceId,
+      businessType,
+    });
+
+    try {
+      switch (config.platform) {
+        case 'AMAZON':
+          return await this.syncAmazonProducts(config, options);
+        case 'EBAY':
+          return await this.syncEbayProducts(config, options);
+        case 'SHOPEE':
+          return await this.syncShopeeProducts(config, options);
+        case 'ALIEXPRESS':
+          return await this.syncAliexpressProducts(config, options);
+        default:
+          throw new Error(`Unsupported platform: ${config.platform}`);
+      }
+    } catch (error: any) {
+      logger.error(`[PlatformApiService] Product sync failed`, {
+        platform: config.platform,
+        tenantId,
+        shopId,
+        traceId,
+        error: error.message,
+      });
+      throw error;
+    }
+  }
+
+  /**
+   * 同步订单数据 - 从平台API获取订单信息
+   * @param config 平台API配置
+   * @param options 同步选项（包含五元组追踪信息）
+   * @returns 同步结果
+   */
+  static async syncOrders(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<OrderSyncResult[]> {
+    const { tenantId, shopId, traceId, businessType } = options;
+    
+    logger.info(`[PlatformApiService] Starting order sync`, {
+      platform: config.platform,
+      tenantId,
+      shopId,
+      traceId,
+      businessType,
+    });
+
+    try {
+      switch (config.platform) {
+        case 'AMAZON':
+          return await this.syncAmazonOrders(config, options);
+        case 'EBAY':
+          return await this.syncEbayOrders(config, options);
+        case 'SHOPEE':
+          return await this.syncShopeeOrders(config, options);
+        case 'ALIEXPRESS':
+          return await this.syncAliexpressOrders(config, options);
+        default:
+          throw new Error(`Unsupported platform: ${config.platform}`);
+      }
+    } catch (error: any) {
+      logger.error(`[PlatformApiService] Order sync failed`, {
+        platform: config.platform,
+        tenantId,
+        shopId,
+        traceId,
+        error: error.message,
+      });
+      throw error;
+    }
+  }
+
+  /**
+   * 更新商品库存 - 通过平台API更新库存
+   * @param config 平台API配置
+   * @param sku SKU编码
+   * @param quantity 库存数量
+   * @param options 同步选项（包含五元组追踪信息）
+   */
+  static async updateInventory(
+    config: PlatformApiConfig,
+    sku: string,
+    quantity: number,
+    options: SyncOptions
+  ): Promise<void> {
+    const { tenantId, shopId, traceId, businessType } = options;
+    
+    logger.info(`[PlatformApiService] Updating inventory`, {
+      platform: config.platform,
+      sku,
+      quantity,
+      tenantId,
+      shopId,
+      traceId,
+      businessType,
+    });
+
+    // 实际实现需调用各平台API
+    // 此处为框架代码，具体实现根据平台API文档补充
+    throw new Error('Not implemented - requires platform-specific API integration');
+  }
+
+  // ==================== Private Methods ====================
+
+  private static async syncAmazonProducts(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<ProductSyncResult[]> {
+    // TODO: 实现Amazon SP-API商品同步
+    // 参考: https://developer-docs.amazon.com/sp-api/docs
+    logger.info('[PlatformApiService] Amazon product sync - placeholder');
+    return [];
+  }
+
+  private static async syncAmazonOrders(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<OrderSyncResult[]> {
+    // TODO: 实现Amazon SP-API订单同步
+    logger.info('[PlatformApiService] Amazon order sync - placeholder');
+    return [];
+  }
+
+  private static async syncEbayProducts(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<ProductSyncResult[]> {
+    // TODO: 实现eBay API商品同步
+    // 参考: https://developer.ebay.com/api-docs
+    logger.info('[PlatformApiService] eBay product sync - placeholder');
+    return [];
+  }
+
+  private static async syncEbayOrders(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<OrderSyncResult[]> {
+    // TODO: 实现eBay API订单同步
+    logger.info('[PlatformApiService] eBay order sync - placeholder');
+    return [];
+  }
+
+  private static async syncShopeeProducts(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<ProductSyncResult[]> {
+    // TODO: 实现Shopee Open API商品同步
+    // 参考: https://open.shopee.com/documents
+    logger.info('[PlatformApiService] Shopee product sync - placeholder');
+    return [];
+  }
+
+  private static async syncShopeeOrders(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<OrderSyncResult[]> {
+    // TODO: 实现Shopee Open API订单同步
+    logger.info('[PlatformApiService] Shopee order sync - placeholder');
+    return [];
+  }
+
+  private static async syncAliexpressProducts(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<ProductSyncResult[]> {
+    // TODO: 实现AliExpress API商品同步
+    logger.info('[PlatformApiService] AliExpress product sync - placeholder');
+    return [];
+  }
+
+  private static async syncAliexpressOrders(
+    config: PlatformApiConfig,
+    options: SyncOptions
+  ): Promise<OrderSyncResult[]> {
+    // TODO: 实现AliExpress API订单同步
+    logger.info('[PlatformApiService] AliExpress order sync - placeholder');
+    return [];
+  }
+
+  /**
+   * 检查API限流
+   * @param platform 平台名称
+   */
+  private static checkRateLimit(platform: string): boolean {
+    const limit = this.RATE_LIMITS[platform as keyof typeof this.RATE_LIMITS];
+    if (!limit) return true;
+    
+    // TODO: 实现基于Redis的分布式限流检查
+    return true;
+  }
+
+  /**
+   * 刷新访问令牌
+   * @param config 平台API配置
+   */
+  private static async refreshAccessToken(config: PlatformApiConfig): Promise<string> {
+    // TODO: 实现令牌刷新逻辑
+    throw new Error('Token refresh not implemented');
+  }
+}