trustbase-seller-backend 0.1.5

package/api/integration-helpers.d.ts

@@ -0,0 +1,153 @@
+/**
+ * TrustChain W3+W4 端到端集成层 (baobei #16344 W4 v4 实战锁版)
+ *
+ * 设计目标 (W4 v4 实战, baobei #16344):
+ * - W3 服务层 (baobei 9 commit) + W4 服务层 (baobei 3 commit) = 12 API endpoint
+ * - claude W3+W4 UI (跟 docs/claude-ui-integration-contract.md v1.0 同步) = 7 UI 任务
+ * - W4 v4 = 端到端集成层, 让 claude UI 接入实战锁版
+ *
+ * 实战锁版要点 (Lesson #335 + Lesson #378 实战风格):
+ * - Integration Helper API (claude UI 直接调用, 不需要重复实现)
+ * - 整合 W3+W4 数据流 (PWA stats + 风险评估 + 操作建议)
+ * - 3 集成 endpoint (跟 claude UI 接入契约 v1.0 实战锁版):
+ *   1. GET /api/integration/seller-dashboard/:shop_id (卖家 dashboard 一站式)
+ *   2. GET /api/integration/platform-dashboard (平台 dashboard 一站式)
+ *   3. POST /api/integration/seller-action (卖家响应风控动作)
+ *
+ * 集成 (claude UI):
+ * - 卖家 dashboard 1 个 API 调用 → 拿到 PWA stats + risk assessment + 建议动作
+ * - 平台 dashboard 1 个 API 调用 → 拿到 PWA 总数 + Top 卖家 + 风控总览
+ * - 卖家响应风控动作 1 个 API 调用 → 上链 / 反馈 / 上诉
+ *
+ * @see docs/claude-ui-integration-contract.md v1.0
+ * @see src/api/pwa-stats.ts (6ae27a5 + 9a400e6)
+ * @see src/api/riskcontrol-service.ts (69d511d)
+ * @see src/api/riskcontrol-scoring.ts (d8d6851)
+ * @see src/api/riskcontrol-adapters.ts (2d102f3)
+ */
+import { Router } from 'express';
+import Database = require('better-sqlite3');
+export interface IntegrationConfig {
+    db: Database.Database;
+}
+/**
+ * 卖家 dashboard 一站式响应 (claude UI 直接渲染)
+ */
+export interface SellerDashboard {
+    shop_id: string;
+    shop_name?: string;
+    pwa_stats: {
+        total_installs: number;
+        total_visits: number;
+        last_24h: {
+            installs: number;
+            visits: number;
+        };
+        last_7d: {
+            installs: number;
+            visits: number;
+        };
+        last_30d: {
+            installs: number;
+            visits: number;
+        };
+        daily_breakdown: Array<{
+            date: string;
+            installs: number;
+            visits: number;
+        }>;
+    };
+    risk_assessment: {
+        risk_level: 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+        risk_score: number;
+        triggered_rules: Array<{
+            rule_id: string;
+            severity: string;
+            description: string;
+        }>;
+        recommended_actions: string[];
+    };
+    credentials: {
+        has_woocommerce: boolean;
+        consumer_key_preview?: string;
+        site_url?: string;
+        scopes?: string[];
+    };
+    recent_events: Array<{
+        event_type: string;
+        occurred_at: string;
+        severity: string;
+    }>;
+    computed_at: string;
+}
+/**
+ * 平台 dashboard 一站式响应 (claude UI 直接渲染)
+ */
+export interface PlatformDashboard {
+    pwa_stats: {
+        total_sellers: number;
+        total_installs: number;
+        total_visits: number;
+        dau_sellers_24h: number;
+        last_24h: {
+            installs: number;
+            visits: number;
+        };
+        last_7d: {
+            installs: number;
+            visits: number;
+        };
+        last_30d: {
+            installs: number;
+            visits: number;
+        };
+        daily_breakdown: Array<{
+            date: string;
+            installs: number;
+            visits: number;
+        }>;
+    };
+    risk_summary: {
+        total_sellers_assessed: number;
+        LOW: number;
+        MEDIUM: number;
+        HIGH: number;
+        CRITICAL: number;
+        avg_risk_score: number;
+    };
+    top_sellers: Array<{
+        rank: number;
+        shop_id: string;
+        installs: number;
+        visits: number;
+    }>;
+    top_risk_sellers: Array<{
+        rank: number;
+        shop_id: string;
+        risk_level: string;
+        risk_score: number;
+        triggered_rules_count: number;
+    }>;
+    computed_at: string;
+}
+/**
+ * 卖家响应风控动作响应
+ */
+export interface SellerActionResponse {
+    action_id: string;
+    shop_id: string;
+    action_type: 'WARN' | 'HOLD_PAYOUT' | 'FREEZE_LISTING' | 'APPEAL';
+    status: 'received' | 'processed' | 'failed';
+    message: string;
+    received_at: string;
+}
+/**
+ * 卖家 dashboard 一站式 API (跟 docs/claude-ui-integration-contract.md v1.0 §2.1 实战锁版)
+ */
+export declare function buildSellerDashboard(db: Database.Database, shop_id: string): SellerDashboard;
+/**
+ * 平台 dashboard 一站式 API (跟 docs/claude-ui-integration-contract.md v1.0 §2.2 实战锁版)
+ */
+export declare function buildPlatformDashboard(db: Database.Database): PlatformDashboard;
+export declare function createIntegrationRouter(config: IntegrationConfig): Router;
+//# sourceMappingURL=integration-helpers.d.ts.map

package/api/integration-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-helpers.d.ts","sourceRoot":"","sources":["../../src/api/integration-helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AACpD,OAAO,QAAQ,GAAG,QAAQ,gBAAgB,CAAC,CAAC;AAE5C,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,QAAQ,CAAC,QAAQ,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE;QACT,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,eAAe,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5E,CAAC;IACF,eAAe,EAAE;QACf,UAAU,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;QACnD,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,KAAK,CAAC;YACrB,OAAO,EAAE,MAAM,CAAC;YAChB,QAAQ,EAAE,MAAM,CAAC;YACjB,WAAW,EAAE,MAAM,CAAC;SACrB,CAAC,CAAC;QACH,mBAAmB,EAAE,MAAM,EAAE,CAAC;KAC/B,CAAC;IACF,WAAW,EAAE;QACX,eAAe,EAAE,OAAO,CAAC;QACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,aAAa,EAAE,KAAK,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE;QACT,aAAa,EAAE,MAAM,CAAC;QACtB,cAAc,EAAE,MAAM,CAAC;QACvB,YAAY,EAAE,MAAM,CAAC;QACrB,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,OAAO,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC9C,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC/C,eAAe,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC5E,CAAC;IACF,YAAY,EAAE;QACZ,sBAAsB,EAAE,MAAM,CAAC;QAC/B,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,WAAW,EAAE,KAAK,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC,CAAC;IACH,gBAAgB,EAAE,KAAK,CAAC;QACtB,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,UAAU,EAAE,MAAM,CAAC;QACnB,qBAAqB,EAAE,MAAM,CAAC;KAC/B,CAAC,CAAC;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,gBAAgB,GAAG,QAAQ,CAAC;IAClE,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,eAAe,CAgH5F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,iBAAiB,CA4G/E;AA+CD,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA4DzE"}

package/api/integration-helpers.js

@@ -0,0 +1,361 @@
+"use strict";
+/**
+ * TrustChain W3+W4 端到端集成层 (baobei #16344 W4 v4 实战锁版)
+ *
+ * 设计目标 (W4 v4 实战, baobei #16344):
+ * - W3 服务层 (baobei 9 commit) + W4 服务层 (baobei 3 commit) = 12 API endpoint
+ * - claude W3+W4 UI (跟 docs/claude-ui-integration-contract.md v1.0 同步) = 7 UI 任务
+ * - W4 v4 = 端到端集成层, 让 claude UI 接入实战锁版
+ *
+ * 实战锁版要点 (Lesson #335 + Lesson #378 实战风格):
+ * - Integration Helper API (claude UI 直接调用, 不需要重复实现)
+ * - 整合 W3+W4 数据流 (PWA stats + 风险评估 + 操作建议)
+ * - 3 集成 endpoint (跟 claude UI 接入契约 v1.0 实战锁版):
+ *   1. GET /api/integration/seller-dashboard/:shop_id (卖家 dashboard 一站式)
+ *   2. GET /api/integration/platform-dashboard (平台 dashboard 一站式)
+ *   3. POST /api/integration/seller-action (卖家响应风控动作)
+ *
+ * 集成 (claude UI):
+ * - 卖家 dashboard 1 个 API 调用 → 拿到 PWA stats + risk assessment + 建议动作
+ * - 平台 dashboard 1 个 API 调用 → 拿到 PWA 总数 + Top 卖家 + 风控总览
+ * - 卖家响应风控动作 1 个 API 调用 → 上链 / 反馈 / 上诉
+ *
+ * @see docs/claude-ui-integration-contract.md v1.0
+ * @see src/api/pwa-stats.ts (6ae27a5 + 9a400e6)
+ * @see src/api/riskcontrol-service.ts (69d511d)
+ * @see src/api/riskcontrol-scoring.ts (d8d6851)
+ * @see src/api/riskcontrol-adapters.ts (2d102f3)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSellerDashboard = buildSellerDashboard;
+exports.buildPlatformDashboard = buildPlatformDashboard;
+exports.createIntegrationRouter = createIntegrationRouter;
+const express_1 = require("express");
+/**
+ * 卖家 dashboard 一站式 API (跟 docs/claude-ui-integration-contract.md v1.0 §2.1 实战锁版)
+ */
+function buildSellerDashboard(db, shop_id) {
+    // 1. PWA stats (复用 6ae27a5 + 9a400e6 实战)
+    const totalStats = db
+        .prepare(`SELECT SUM(install_count) as total_installs, SUM(visit_count) as total_visits FROM pwa_visit_stats WHERE shop_id = ?`)
+        .get(shop_id);
+    const now = new Date();
+    const date24hAgo = new Date(now.getTime() - 24 * 60 * 60 * 1000).toISOString().substring(0, 10);
+    const date7dAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString().substring(0, 10);
+    const date30dAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString().substring(0, 10);
+    const stats24h = db
+        .prepare(`SELECT SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats WHERE shop_id = ? AND date >= ?`)
+        .get(shop_id, date24hAgo);
+    const stats7d = db
+        .prepare(`SELECT SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats WHERE shop_id = ? AND date >= ?`)
+        .get(shop_id, date7dAgo);
+    const stats30d = db
+        .prepare(`SELECT SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats WHERE shop_id = ? AND date >= ?`)
+        .get(shop_id, date30dAgo);
+    const dailyRows = db
+        .prepare(`SELECT date, install_count as installs, visit_count as visits FROM pwa_visit_stats WHERE shop_id = ? AND date >= ? ORDER BY date ASC`)
+        .all(shop_id, date30dAgo);
+    // 2. Risk assessment (复用 69d511d 实战)
+    const orders = db
+        .prepare(`SELECT status, COUNT(*) as cnt FROM orders WHERE shop_id = ? GROUP BY status`)
+        .all(shop_id);
+    let totalOrders = 0;
+    let disputedOrders = 0;
+    let cancelledOrders = 0;
+    for (const row of orders) {
+        totalOrders += row.cnt || 0;
+        if (row.status === 'disputed')
+            disputedOrders += row.cnt || 0;
+        else if (row.status === 'cancelled')
+            cancelledOrders += row.cnt || 0;
+    }
+    const disputeRate = totalOrders > 0 ? disputedOrders / totalOrders : 0;
+    const cancelRate = totalOrders > 0 ? cancelledOrders / totalOrders : 0;
+    const triggeredRules = [];
+    let riskScore = 0;
+    if (totalOrders < 5) {
+        triggeredRules.push({ rule_id: 'R5_INSUFFICIENT_DATA', severity: 'LOW', description: '订单数少于 5, 数据不足' });
+        riskScore += 5;
+    }
+    if (totalOrders >= 5 && disputeRate > 0.10) {
+        triggeredRules.push({ rule_id: 'R1_HIGH_DISPUTE_RATE', severity: 'HIGH', description: `纠纷率 ${(disputeRate * 100).toFixed(1)}% 超过 10%` });
+        riskScore += 25;
+    }
+    if (totalOrders >= 5 && cancelRate > 0.20) {
+        triggeredRules.push({ rule_id: 'R2_HIGH_CANCEL_RATE', severity: 'MEDIUM', description: `取消率 ${(cancelRate * 100).toFixed(1)}% 超过 20%` });
+        riskScore += 15;
+    }
+    let riskLevel;
+    if (riskScore <= 25)
+        riskLevel = 'LOW';
+    else if (riskScore <= 50)
+        riskLevel = 'MEDIUM';
+    else if (riskScore <= 75)
+        riskLevel = 'HIGH';
+    else
+        riskLevel = 'CRITICAL';
+    const recommendedActions = [];
+    if (riskLevel === 'MEDIUM')
+        recommendedActions.push('WARN');
+    if (riskLevel === 'HIGH')
+        recommendedActions.push('WARN', 'HOLD_PAYOUT');
+    if (riskLevel === 'CRITICAL')
+        recommendedActions.push('WARN', 'HOLD_PAYOUT', 'FREEZE_LISTING');
+    // 3. Credentials (复用 8656f7c 实战)
+    const sellerCred = db
+        .prepare(`SELECT wc_consumer_key, wc_site_url, wc_scopes, shop_name FROM sellers WHERE address = ? LIMIT 1`)
+        .get(shop_id);
+    // 5. Recent events (复用 d8d6851 实战)
+    const recentEvents = db
+        .prepare(`SELECT event_type, created_at FROM order_events WHERE shop_id = ? ORDER BY created_at DESC LIMIT 5`)
+        .all(shop_id);
+    return {
+        shop_id,
+        shop_name: sellerCred?.shop_name,
+        pwa_stats: {
+            total_installs: totalStats?.total_installs || 0,
+            total_visits: totalStats?.total_visits || 0,
+            last_24h: { installs: stats24h?.installs || 0, visits: stats24h?.visits || 0 },
+            last_7d: { installs: stats7d?.installs || 0, visits: stats7d?.visits || 0 },
+            last_30d: { installs: stats30d?.installs || 0, visits: stats30d?.visits || 0 },
+            daily_breakdown: dailyRows.map((r) => ({
+                date: r.date,
+                installs: r.installs || 0,
+                visits: r.visits || 0,
+            })),
+        },
+        risk_assessment: {
+            risk_level: riskLevel,
+            risk_score: Math.min(riskScore, 100),
+            triggered_rules: triggeredRules,
+            recommended_actions: recommendedActions,
+        },
+        credentials: {
+            has_woocommerce: !!sellerCred?.wc_consumer_key,
+            consumer_key_preview: sellerCred?.wc_consumer_key ? sellerCred.wc_consumer_key.substring(0, 12) + '...' : undefined,
+            site_url: sellerCred?.wc_site_url,
+            scopes: sellerCred?.wc_scopes ? sellerCred.wc_scopes.split(',') : undefined,
+        },
+        recent_events: recentEvents.map((e) => ({
+            event_type: e.event_type,
+            occurred_at: e.created_at ? new Date(e.created_at * 1000).toISOString() : new Date().toISOString(),
+            severity: 'INFO',
+        })),
+        computed_at: new Date().toISOString(),
+    };
+}
+/**
+ * 平台 dashboard 一站式 API (跟 docs/claude-ui-integration-contract.md v1.0 §2.2 实战锁版)
+ */
+function buildPlatformDashboard(db) {
+    // 1. PWA 平台总数
+    const totalStats = db
+        .prepare(`SELECT COUNT(DISTINCT shop_id) as total_sellers, SUM(install_count) as total_installs, SUM(visit_count) as total_visits FROM pwa_visit_stats`)
+        .get();
+    const now = new Date();
+    const date24hAgo = new Date(now.getTime() - 24 * 60 * 60 * 1000).toISOString().substring(0, 10);
+    const date7dAgo = new Date(now.getTime() - 7 * 24 * 60 * 60 * 1000).toISOString().substring(0, 10);
+    const date30dAgo = new Date(now.getTime() - 30 * 24 * 60 * 60 * 1000).toISOString().substring(0, 10);
+    const stats24h = db.prepare(`SELECT SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats WHERE date >= ?`).get(date24hAgo);
+    const stats7d = db.prepare(`SELECT SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats WHERE date >= ?`).get(date7dAgo);
+    const stats30d = db.prepare(`SELECT SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats WHERE date >= ?`).get(date30dAgo);
+    const dauSellers = db.prepare(`SELECT COUNT(DISTINCT shop_id) as dau FROM pwa_visit_stats WHERE date >= ?`).get(date24hAgo);
+    const dailyRows = db
+        .prepare(`SELECT date, SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats WHERE date >= ? GROUP BY date ORDER BY date ASC`)
+        .all(date30dAgo);
+    // 2. Top sellers (PWA installs)
+    const topSellers = db
+        .prepare(`SELECT shop_id, SUM(install_count) as installs, SUM(visit_count) as visits FROM pwa_visit_stats GROUP BY shop_id ORDER BY installs DESC LIMIT 10`)
+        .all();
+    // 3. Risk summary
+    const sellers = db.prepare(`SELECT DISTINCT shop_id FROM orders LIMIT 100`).all();
+    const riskScores = [];
+    let totalScore = 0;
+    let LOW = 0, MEDIUM = 0, HIGH = 0, CRITICAL = 0;
+    for (const s of sellers) {
+        const orders = db
+            .prepare(`SELECT status, COUNT(*) as cnt FROM orders WHERE shop_id = ? GROUP BY status`)
+            .all(s.shop_id);
+        let total = 0, disputed = 0, cancelled = 0;
+        for (const row of orders) {
+            total += row.cnt || 0;
+            if (row.status === 'disputed')
+                disputed += row.cnt || 0;
+            else if (row.status === 'cancelled')
+                cancelled += row.cnt || 0;
+        }
+        const disputeRate = total > 0 ? disputed / total : 0;
+        const cancelRate = total > 0 ? cancelled / total : 0;
+        let score = 0;
+        let rules_count = 0;
+        if (total < 5) {
+            score += 5;
+            rules_count++;
+        }
+        if (total >= 5 && disputeRate > 0.10) {
+            score += 25;
+            rules_count++;
+        }
+        if (total >= 5 && cancelRate > 0.20) {
+            score += 15;
+            rules_count++;
+        }
+        let level;
+        if (score <= 25)
+            level = 'LOW';
+        else if (score <= 50)
+            level = 'MEDIUM';
+        else if (score <= 75)
+            level = 'HIGH';
+        else
+            level = 'CRITICAL';
+        if (level === 'LOW')
+            LOW++;
+        else if (level === 'MEDIUM')
+            MEDIUM++;
+        else if (level === 'HIGH')
+            HIGH++;
+        else
+            CRITICAL++;
+        totalScore += score;
+        riskScores.push({ shop_id: s.shop_id, score, level, rules_count });
+    }
+    const topRiskSellers = riskScores
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 10)
+        .map((r, i) => ({
+        rank: i + 1,
+        shop_id: r.shop_id,
+        risk_level: r.level,
+        risk_score: r.score,
+        triggered_rules_count: r.rules_count,
+    }));
+    return {
+        pwa_stats: {
+            total_sellers: totalStats?.total_sellers || 0,
+            total_installs: totalStats?.total_installs || 0,
+            total_visits: totalStats?.total_visits || 0,
+            dau_sellers_24h: dauSellers?.dau || 0,
+            last_24h: { installs: stats24h?.installs || 0, visits: stats24h?.visits || 0 },
+            last_7d: { installs: stats7d?.installs || 0, visits: stats7d?.visits || 0 },
+            last_30d: { installs: stats30d?.installs || 0, visits: stats30d?.visits || 0 },
+            daily_breakdown: dailyRows.map((r) => ({
+                date: r.date,
+                installs: r.installs || 0,
+                visits: r.visits || 0,
+            })),
+        },
+        risk_summary: {
+            total_sellers_assessed: sellers.length,
+            LOW, MEDIUM, HIGH, CRITICAL,
+            avg_risk_score: sellers.length > 0 ? Math.round(totalScore / sellers.length) : 0,
+        },
+        top_sellers: topSellers.map((s, i) => ({
+            rank: i + 1,
+            shop_id: s.shop_id,
+            installs: s.installs || 0,
+            visits: s.visits || 0,
+        })),
+        top_risk_sellers: topRiskSellers,
+        computed_at: new Date().toISOString(),
+    };
+}
+/**
+ * 卖家响应风控动作 API
+ *
+ * 实战锁版: 卖家可以响应 WARN / HOLD_PAYOUT / FREEZE_LISTING / APPEAL 动作
+ * - WARN → 卖家确认收到
+ * - HOLD_PAYOUT → 卖家可以提交申诉 (返回 appeal_id)
+ * - FREEZE_LISTING → 卖家可以提交上诉
+ * - APPEAL → 卖家提交完整申诉材料
+ */
+function handleSellerAction(db, shop_id, action_type, payload) {
+    const action_id = `act_${Date.now()}_${Math.random().toString(36).substring(7)}`;
+    // 实战锁版: 写入 seller_actions 表 (供审计追踪)
+    try {
+        db.prepare(`CREATE TABLE IF NOT EXISTS seller_actions (
+      id TEXT PRIMARY KEY,
+      shop_id TEXT NOT NULL,
+      action_type TEXT NOT NULL,
+      payload TEXT,
+      received_at INTEGER NOT NULL
+    )`).run();
+        db.prepare(`INSERT INTO seller_actions (id, shop_id, action_type, payload, received_at) VALUES (?, ?, ?, ?, ?)`)
+            .run(action_id, shop_id, action_type, JSON.stringify(payload || {}), Date.now());
+    }
+    catch (err) {
+        console.error('[integration] handleSellerAction db error:', err.message);
+    }
+    const messages = {
+        'WARN': '警告已确认收到, 请关注相关风险指标',
+        'HOLD_PAYOUT': '支付已暂停, 请提交申诉材料',
+        'FREEZE_LISTING': '上架已冻结, 请提交完整申诉',
+        'APPEAL': '申诉已收到, 将在 24h 内审核',
+    };
+    return {
+        action_id,
+        shop_id,
+        action_type: action_type,
+        status: 'received',
+        message: messages[action_type] || `动作 ${action_type} 已收到`,
+        received_at: new Date().toISOString(),
+    };
+}
+function createIntegrationRouter(config) {
+    const router = (0, express_1.Router)();
+    const { db } = config;
+    // ============================================================
+    // 路由顺序: /integration/dashboard/platform 必须在 /integration/dashboard/:shop_id 之前
+    // 否则会被 /integration/dashboard/:shop_id 拦截 (Lesson #NEW 8/23 01:13 SGT)
+    // ============================================================
+    // GET /api/integration/dashboard/platform - 平台 dashboard 一站式
+    router.get('/dashboard/platform', (req, res) => {
+        try {
+            const dashboard = buildPlatformDashboard(db);
+            res.json({ success: true, dashboard });
+        }
+        catch (err) {
+            console.error('[integration] GET /dashboard/platform error:', err.message);
+            res.status(500).json({ success: false, errorCode: 'INTERNAL_ERROR', errorMessage: err.message });
+        }
+    });
+    // GET /api/integration/dashboard/:shop_id - 卖家 dashboard 一站式
+    router.get('/dashboard/:shop_id', (req, res) => {
+        try {
+            const { shop_id } = req.params;
+            if (!/^tct1[a-z0-9]{20,80}$/i.test(shop_id)) {
+                res.status(400).json({ success: false, errorCode: 'INVALID_SHOP_ID', errorMessage: 'Invalid shop_id format' });
+                return;
+            }
+            const dashboard = buildSellerDashboard(db, shop_id);
+            res.json({ success: true, dashboard });
+        }
+        catch (err) {
+            console.error('[integration] GET /dashboard error:', err.message);
+            res.status(500).json({ success: false, errorCode: 'INTERNAL_ERROR', errorMessage: err.message });
+        }
+    });
+    // POST /api/integration/action/:shop_id - 卖家响应风控动作
+    router.post('/action/:shop_id', (req, res) => {
+        try {
+            const { shop_id } = req.params;
+            if (!/^tct1[a-z0-9]{20,80}$/i.test(shop_id)) {
+                res.status(400).json({ success: false, errorCode: 'INVALID_SHOP_ID', errorMessage: 'Invalid shop_id format' });
+                return;
+            }
+            const { action_type, payload } = req.body || {};
+            if (!action_type || !['WARN', 'HOLD_PAYOUT', 'FREEZE_LISTING', 'APPEAL'].includes(action_type)) {
+                res.status(400).json({ success: false, errorCode: 'INVALID_ACTION_TYPE', errorMessage: 'action_type must be one of WARN/HOLD_PAYOUT/FREEZE_LISTING/APPEAL' });
+                return;
+            }
+            const response = handleSellerAction(db, shop_id, action_type, payload);
+            res.json({ success: true, response });
+        }
+        catch (err) {
+            console.error('[integration] POST /action error:', err.message);
+            res.status(500).json({ success: false, errorCode: 'INTERNAL_ERROR', errorMessage: err.message });
+        }
+    });
+    return router;
+}
+//# sourceMappingURL=integration-helpers.js.map

package/api/integration-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-helpers.js","sourceRoot":"","sources":["../../src/api/integration-helpers.ts"],"names":[],"mappings":"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"}

package/api/lib/case-summary.d.ts

@@ -0,0 +1,10 @@
+import type { CaseRow } from '../db/case-library-types';
+export interface SummaryContext {
+    case: CaseRow;
+    buyerClaim: string;
+    sellerClaim: string;
+    amountRange: string;
+    citedCaseIds?: number[];
+}
+export declare function renderSummary(ctx: SummaryContext): string;
+//# sourceMappingURL=case-summary.d.ts.map

package/api/lib/case-summary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-summary.d.ts","sourceRoot":"","sources":["../../../src/api/lib/case-summary.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,OAAO,EAAe,MAAM,0BAA0B,CAAC;AAErE,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,OAAO,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AA4BD,wBAAgB,aAAa,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,CAEzD"}

package/api/lib/case-summary.js

@@ -0,0 +1,30 @@
+"use strict";
+// indexer/src/api/lib/case-summary.ts — 模板化结构化摘要生成
+// per case-library-design.md §5 模板, 索引器侧模板渲染, 非自由文本
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderSummary = renderSummary;
+// dispute_type 中文映射 (per kimi #14073 §2.2 验收: '虚假退款' 4 字命中)
+const DISPUTE_TYPE_CN = {
+    refund_only: '仅退款',
+    return_refund: '退货退款',
+    non_delivery: '未发货',
+    quality_mismatch: '质量不符',
+    fake_refund: '虚假退款',
+    malicious_review: '恶意差评',
+    other: '其他',
+};
+const TEMPLATE = (ctx) => {
+    const c = ctx.case;
+    const typeCn = DISPUTE_TYPE_CN[c.dispute_type] ?? c.dispute_type;
+    const cites = ctx.citedCaseIds && ctx.citedCaseIds.length > 0
+        ? `，引用了判例 #${ctx.citedCaseIds.join('、#')}`
+        : '';
+    return (`${typeCn}：买家主张${ctx.buyerClaim}，卖家主张${ctx.sellerClaim}。` +
+        `争议金额${ctx.amountRange}，${c.fiat_or_tct === 'fiat_arb' ? '法币' : 'TCT'}路线。` +
+        `${c.voter_count}人陪审，${c.vote_yes}:${c.vote_no}:${c.vote_abstain}，判${c.outcome}` +
+        `${cites}。`);
+};
+function renderSummary(ctx) {
+    return TEMPLATE(ctx);
+}
+//# sourceMappingURL=case-summary.js.map

package/api/lib/case-summary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"case-summary.js","sourceRoot":"","sources":["../../../src/api/lib/case-summary.ts"],"names":[],"mappings":";AAAA,mDAAmD;AACnD,oDAAoD;;AAsCpD,sCAEC;AA5BD,4DAA4D;AAC5D,MAAM,eAAe,GAAgC;IACnD,WAAW,EAAE,KAAK;IAClB,aAAa,EAAE,MAAM;IACrB,YAAY,EAAE,KAAK;IACnB,gBAAgB,EAAE,MAAM;IACxB,WAAW,EAAE,MAAM;IACnB,gBAAgB,EAAE,MAAM;IACxB,KAAK,EAAE,IAAI;CACZ,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,GAAmB,EAAU,EAAE;IAC/C,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC;IACnB,MAAM,MAAM,GAAG,eAAe,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,YAAY,CAAC;IACjE,MAAM,KAAK,GACT,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC;QAC7C,CAAC,CAAC,WAAW,GAAG,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC1C,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,CACL,GAAG,MAAM,QAAQ,GAAG,CAAC,UAAU,QAAQ,GAAG,CAAC,WAAW,GAAG;QACzD,OAAO,GAAG,CAAC,WAAW,IAAI,CAAC,CAAC,WAAW,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK;QAC1E,GAAG,CAAC,CAAC,WAAW,OAAO,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,OAAO,EAAE;QAChF,GAAG,KAAK,GAAG,CACZ,CAAC;AACJ,CAAC,CAAC;AAEF,SAAgB,aAAa,CAAC,GAAmB;IAC/C,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC;AACvB,CAAC"}