feat: 初始化项目结构并添加核心功能模块

- 新增文档模板和导航结构 - 实现服务器基础API路由和控制器 - 添加扩展插件配置和前端框架 - 引入多租户和权限管理模块 - 集成日志和数据库配置 - 添加核心业务模型和类型定义
2026-03-17 22:07:19 +08:00
parent c0870dce50
commit 136c2fa579
728 changed files with 107690 additions and 5614 deletions
--- a/server/src/services/DisputeResolverService.ts
+++ b/server/src/services/DisputeResolverService.ts
@@ -0,0 +1,98 @@
+import { logger } from '../utils/logger';
+import db from '../config/database';
+
+export interface DisputeEvent {
+  tenantId: string;
+  orderId: string;
+  externalDisputeId: string;
+  reason: string;
+  customerMessage: string;
+  evidenceUrls: string[];
+}
+
+/**
+ * [BIZ_AUTO_05] AI 自动化售后争议处理服务
+ * @description 基于历史判责数据与规则，自动生成申诉材料或执行退款决策
+ */
+export class DisputeResolverService {
+  private static readonly DISPUTE_TABLE = 'cf_disputes';
+
+  /**
+   * 初始化表
+   */
+  static async initTable(): Promise<void> {
+    const hasTable = await db.schema.hasTable(this.DISPUTE_TABLE);
+    if (!hasTable) {
+      console.log(`📦 Creating ${this.DISPUTE_TABLE} table...`);
+      await db.schema.createTable(this.DISPUTE_TABLE, (table) => {
+        table.increments('id').primary();
+        table.string('tenant_id', 64).notNullable();
+        table.string('order_id', 64).notNullable();
+        table.string('external_dispute_id', 128).unique();
+        table.string('reason', 255);
+        table.string('status', 32).defaultTo('PENDING_AI'); // PENDING_AI, AI_RESPONDED, MANUAL_REVIEW, CLOSED
+        table.text('ai_response');
+        table.timestamps(true, true);
+        table.index(['tenant_id', 'status']);
+      });
+      console.log(`✅ Table ${this.DISPUTE_TABLE} created`);
+    }
+  }
+
+  /**
+   * 处理新争议 (BIZ_AUTO_05)
+   */
+  static async processDispute(event: DisputeEvent): Promise<void> {
+    logger.info(`[DisputeResolver] Processing dispute ${event.externalDisputeId} for Order: ${event.orderId}`);
+
+    // 1. 记录争议
+    await db(this.DISPUTE_TABLE).insert({
+      tenant_id: event.tenantId,
+      order_id: event.orderId,
+      external_dispute_id: event.externalDisputeId,
+      reason: event.reason,
+      status: 'PENDING_AI',
+      created_at: new Date(),
+      updated_at: new Date()
+    });
+
+    // 2. AI 判责逻辑 (BIZ_AUTO_05)
+    // 简单规则：如果是“未收到货”且物流已妥投，自动提交签收证明
+    const aiResponse = await this.analyzeAndRespond(event);
+
+    // 3. 更新状态
+    await db(this.DISPUTE_TABLE).where({ external_dispute_id: event.externalDisputeId }).update({
+      ai_response: aiResponse,
+      status: 'AI_RESPONDED',
+      updated_at: new Date()
+    });
+  }
+
+  /**
+   * [BIZ_AI_16-EXT] 主动发起纠纷 (由 AGI 建议触发)
+   */
+  static async initiateDispute(tenantId: string, orderId: string, reason: string): Promise<string> {
+    const externalDisputeId = `EXT-DISP-${Date.now()}`;
+    logger.info(`[DisputeResolver] Initiating dispute for Order: ${orderId}, Reason: ${reason}`);
+
+    await db(this.DISPUTE_TABLE).insert({
+      tenant_id: tenantId,
+      order_id: orderId,
+      external_dispute_id: externalDisputeId,
+      reason: reason,
+      status: 'PENDING_AI',
+      created_at: new Date(),
+      updated_at: new Date()
+    });
+
+    return externalDisputeId;
+  }
+
+  private static async analyzeAndRespond(event: DisputeEvent): Promise<string> {
+    // 模拟 AI 分析
+    if (event.reason.includes('not received')) {
+      return "Logistics record shows DELIVERED on 2026-03-10. Attaching delivery proof.";
+    }
+    return "Product matches description. Customer provided no clear evidence of defect. Requesting more details.";
+  }
+}