@round2ai/r2-cli 1.0.1 → 1.0.2

package/dist/services/business/demand.d.ts

@@ -0,0 +1,70 @@
+/**
+ * 市场需求分析服务
+ */
+import { SKU, Region, DemandAnalysis, TradeRecord } from "../../types/business.js";
+/**
+ * 需求分析服务
+ */
+export declare class DemandAnalysisService {
+    /**
+     * 分析商品在特定地区的需求
+     */
+    analyzeDemand(sku: SKU, region: Region, trades: TradeRecord[], historicalData?: DemandAnalysis[]): DemandAnalysis;
+    /**
+     * 批量需求分析
+     */
+    analyzeDemands(skus: SKU[], region: Region, trades: TradeRecord[], historicalData?: DemandAnalysis[]): DemandAnalysis[];
+    /**
+     * 获取特定商品、地区、成色的近期交易
+     */
+    private getRecentTrades;
+    /**
+     * 计算需求强度（基于交易频率和价格）
+     */
+    private calculateDemandIntensity;
+    /**
+     * 分析历史趋势
+     */
+    private analyzeHistoricalTrend;
+    /**
+     * 计算供需缺口
+     */
+    private calculateGapPercentage;
+    /**
+     * 确定需求等级
+     */
+    private determineDemandLevel;
+    /**
+     * 确定趋势方向
+     */
+    private determineTrend;
+    /**
+     * 计算置信度
+     */
+    private calculateConfidence;
+    /**
+     * 获取区域需求热力图
+     */
+    generateDemandHeatmap(analyses: DemandAnalysis[], regions: Region[]): {
+        regionCode: string;
+        demandScore: number;
+        recommendation: string;
+    }[];
+    /**
+     * 预测未来需求
+     */
+    predictFutureDemand(currentAnalysis: DemandAnalysis, weeksAhead: number): {
+        predictedGap: number;
+        trend: "rising" | "stable" | "falling";
+        confidence: number;
+    };
+}
+/**
+ * 创建需求分析服务
+ */
+export declare function createDemandAnalysisService(): DemandAnalysisService;
+/**
+ * 默认需求分析服务
+ */
+export declare const demandAnalysisService: DemandAnalysisService;
+//# sourceMappingURL=demand.d.ts.map

package/dist/services/business/demand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"demand.d.ts","sourceRoot":"","sources":["../../../src/services/business/demand.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,GAAG,EACH,MAAM,EACN,cAAc,EACd,WAAW,EACZ,MAAM,yBAAyB,CAAC;AAejC;;GAEG;AACH,qBAAa,qBAAqB;IAChC;;OAEG;IACH,aAAa,CACX,GAAG,EAAE,GAAG,EACR,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EAAE,EACrB,cAAc,CAAC,EAAE,cAAc,EAAE,GAChC,cAAc;IAwCjB;;OAEG;IACH,cAAc,CACZ,IAAI,EAAE,GAAG,EAAE,EACX,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,WAAW,EAAE,EACrB,cAAc,CAAC,EAAE,cAAc,EAAE,GAChC,cAAc,EAAE;IAenB;;OAEG;IACH,OAAO,CAAC,eAAe;IAiBvB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAchC;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAK9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAa5B;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;OAEG;IACH,qBAAqB,CACnB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,EAAE,MAAM,EAAE,GAChB;QACD,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,EAAE;IA6CH;;OAEG;IACH,mBAAmB,CACjB,eAAe,EAAE,cAAc,EAC/B,UAAU,EAAE,MAAM,GACjB;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,KAAK,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;QACvC,UAAU,EAAE,MAAM,CAAC;KACpB;CA4BF;AAED;;GAEG;AACH,wBAAgB,2BAA2B,IAAI,qBAAqB,CAEnE;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,uBAAgC,CAAC"}

package/dist/services/business/demand.js

@@ -0,0 +1,240 @@
+/**
+ * 市场需求分析服务
+ */
+import { logger } from "../../utils/logger.js";
+import { SKU, Region, DemandAnalysis, TradeRecord, } from "../../types/business.js";
+/**
+ * 需求分析配置
+ */
+const DEMAND_CONFIG = {
+    gapThresholds: {
+        low: 0.3, // 供过于求
+        medium: 0.7, // 供需平衡
+        high: 1.5, // 供不应求
+    },
+    trendWindow: 30, // 趋势分析窗口（天）
+    confidenceThreshold: 0.6, // 置信度阈值
+};
+/**
+ * 需求分析服务
+ */
+export class DemandAnalysisService {
+    /**
+     * 分析商品在特定地区的需求
+     */
+    analyzeDemand(sku, region, trades, historicalData) {
+        // 获取该地区的历史需求数据
+        const regionHistory = historicalData?.filter(d => d.region.code === region.code);
+        // 分析最近的交易趋势
+        const recentTrades = this.getRecentTrades(trades, region.code, sku.condition);
+        const recentDemand = this.calculateDemandIntensity(recentTrades);
+        // 获取历史需求趋势
+        const historicalTrend = this.analyzeHistoricalTrend(regionHistory, recentDemand);
+        // 计算供需缺口
+        const gapPercentage = this.calculateGapPercentage(recentDemand, historicalTrend.avg);
+        // 确定需求等级
+        const demandLevel = this.determineDemandLevel(gapPercentage);
+        // 确定趋势方向
+        const trend = this.determineTrend(historicalTrend.current, historicalTrend.avg);
+        // 计算置信度
+        const confidence = this.calculateConfidence(recentTrades.length, recentDemand);
+        logger.info(`需求分析: SKU=${sku.id}, 地区=${region.name}, 需求等级=${demandLevel}, 供需缺口=${gapPercentage.toFixed(1)}%`);
+        return {
+            sku,
+            region,
+            demandLevel,
+            gapPercentage,
+            trend,
+            lastUpdated: new Date(),
+        };
+    }
+    /**
+     * 批量需求分析
+     */
+    analyzeDemands(skus, region, trades, historicalData) {
+        const results = [];
+        for (const sku of skus) {
+            const analysis = this.analyzeDemand(sku, region, trades, historicalData);
+            results.push(analysis);
+        }
+        // 按需求等级排序
+        return results.sort((a, b) => {
+            const levelOrder = { high: 3, medium: 2, low: 1 };
+            return levelOrder[b.demandLevel] - levelOrder[a.demandLevel];
+        });
+    }
+    /**
+     * 获取特定商品、地区、成色的近期交易
+     */
+    getRecentTrades(trades, regionCode, condition) {
+        const thirtyDaysAgo = Date.now() - 30 * 24 * 60 * 60 * 1000;
+        return trades.filter(t => {
+            return (t.skuId === regionCode && // 简化：假设 skuId 包含地区信息
+                t.buyerRegion === regionCode &&
+                t.condition === condition &&
+                t.soldDate.getTime() > thirtyDaysAgo);
+        });
+    }
+    /**
+     * 计算需求强度（基于交易频率和价格）
+     */
+    calculateDemandIntensity(trades) {
+        if (trades.length === 0)
+            return 0;
+        // 计算平均价格
+        const avgPrice = trades.reduce((sum, t) => sum + t.soldPrice, 0) / trades.length;
+        // 计算交易频率（每千天交易次数）
+        const timeSpan = 30; // 天
+        const frequency = (trades.length / timeSpan) * 1000;
+        // 需求强度 = 频率 * 价格权重
+        return frequency * (avgPrice / 100);
+    }
+    /**
+     * 分析历史趋势
+     */
+    analyzeHistoricalTrend(history, currentDemand) {
+        if (!history || history.length === 0) {
+            return { avg: currentDemand, current: currentDemand, trend: "stable" };
+        }
+        // 计算历史平均值
+        const avgDemand = history.reduce((sum, d) => sum + d.gapPercentage, 0) / history.length;
+        // 判断趋势
+        let trend;
+        if (currentDemand > avgDemand * 1.2) {
+            trend = "rising";
+        }
+        else if (currentDemand < avgDemand * 0.8) {
+            trend = "falling";
+        }
+        else {
+            trend = "stable";
+        }
+        return { avg: avgDemand, current: currentDemand, trend };
+    }
+    /**
+     * 计算供需缺口
+     */
+    calculateGapPercentage(current, average) {
+        if (average === 0)
+            return current > 0 ? 100 : 0;
+        return (current - average) / average;
+    }
+    /**
+     * 确定需求等级
+     */
+    determineDemandLevel(gapPercentage) {
+        if (gapPercentage < DEMAND_CONFIG.gapThresholds.low) {
+            return "low";
+        }
+        else if (gapPercentage >= DEMAND_CONFIG.gapThresholds.high ||
+            gapPercentage > DEMAND_CONFIG.gapThresholds.medium) {
+            return "high";
+        }
+        else {
+            return "medium";
+        }
+    }
+    /**
+     * 确定趋势方向
+     */
+    determineTrend(current, average) {
+        const ratio = current / average;
+        if (ratio > 1.1)
+            return "rising";
+        if (ratio < 0.9)
+            return "falling";
+        return "stable";
+    }
+    /**
+     * 计算置信度
+     */
+    calculateConfidence(sampleSize, demand) {
+        // 基于样本大小和数据密度计算置信度
+        const sampleScore = Math.min(sampleSize / 10, 1);
+        const densityScore = Math.min(demand / 50, 1);
+        return (sampleScore + densityScore) / 2;
+    }
+    /**
+     * 获取区域需求热力图
+     */
+    generateDemandHeatmap(analyses, regions) {
+        return regions.map(region => {
+            const regionAnalyses = analyses.filter(a => a.region.code === region.code);
+            if (regionAnalyses.length === 0) {
+                return {
+                    regionCode: region.code,
+                    demandScore: 0,
+                    recommendation: "暂无数据",
+                };
+            }
+            // 计算综合需求分数
+            const avgDemandScore = regionAnalyses.reduce((sum, a) => {
+                let score = 0;
+                switch (a.demandLevel) {
+                    case "high":
+                        score = 80 + (a.gapPercentage > 1 ? 20 : 0);
+                        break;
+                    case "medium":
+                        score = 50;
+                        break;
+                    case "low":
+                        score = 20;
+                        break;
+                }
+                return sum + score;
+            }, 0) / regionAnalyses.length;
+            // 生成推荐
+            const highDemandCount = regionAnalyses.filter(a => a.demandLevel === "high").length;
+            const recommendation = highDemandCount > regionAnalyses.length * 0.5
+                ? "重点开拓市场"
+                : avgDemandScore > 60
+                    ? "关注增长机会"
+                    : "维持现状";
+            return {
+                regionCode: region.code,
+                demandScore: Math.round(avgDemandScore),
+                recommendation,
+            };
+        });
+    }
+    /**
+     * 预测未来需求
+     */
+    predictFutureDemand(currentAnalysis, weeksAhead) {
+        // 基于当前趋势和需求等级预测
+        let predictedGap = currentAnalysis.gapPercentage;
+        let trend = currentAnalysis.trend;
+        // 根据需求等级调整预测
+        if (currentAnalysis.demandLevel === "high" && weeksAhead > 2) {
+            predictedGap *= 0.9; // 高需求后可能趋于平衡
+        }
+        else if (currentAnalysis.demandLevel === "low") {
+            predictedGap *= 1.1; // 低需求可能持续恶化
+        }
+        // 根据趋势调整
+        if (trend === "rising" && weeksAhead > 1) {
+            predictedGap += 0.1 * weeksAhead;
+        }
+        else if (trend === "falling" && weeksAhead > 1) {
+            predictedGap -= 0.1 * weeksAhead;
+        }
+        // 限制预测范围
+        predictedGap = Math.max(-1, Math.min(3, predictedGap));
+        return {
+            predictedGap,
+            trend,
+            confidence: currentAnalysis.demandLevel === "high" ? 0.8 : 0.6,
+        };
+    }
+}
+/**
+ * 创建需求分析服务
+ */
+export function createDemandAnalysisService() {
+    return new DemandAnalysisService();
+}
+/**
+ * 默认需求分析服务
+ */
+export const demandAnalysisService = createDemandAnalysisService();
+//# sourceMappingURL=demand.js.map

package/dist/services/business/demand.js.map

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

package/dist/services/business/fulfillment.d.ts

@@ -0,0 +1,122 @@
+/**
+ * 履约管理服务
+ */
+/**
+ * 履约状态
+ */
+export declare enum FulfillmentStatus {
+    PENDING = "pending",
+    IN_TRANSIT = "in_transit",
+    DELIVERED = "delivered",
+    CANCELLED = "cancelled",
+    RETURNED = "returned"
+}
+/**
+ * 履约记录
+ */
+export interface FulfillmentRecord {
+    id: string;
+    orderId: string;
+    skuId: string;
+    trackingNumber: string;
+    fromWarehouse: string;
+    toRegion: string;
+    status: FulfillmentStatus;
+    estimatedDelivery: Date;
+    actualDelivery?: Date;
+    createdAt: Date;
+    updatedAt: Date;
+}
+/**
+ * 履约异常
+ */
+export interface FulfillmentException {
+    id: string;
+    fulfillmentId: string;
+    type: "delay" | "lost" | "damaged" | "wrong_item";
+    severity: "low" | "medium" | "high";
+    description: string;
+    reportedAt: Date;
+    resolvedAt?: Date;
+    resolution?: string;
+}
+/**
+ * 履约追踪服务
+ */
+export declare class FulfillmentService {
+    private records;
+    private exceptions;
+    /**
+     * 创建履约记录
+     */
+    createFulfillment(orderId: string, skuId: string, trackingNumber: string, fromWarehouse: string, toRegion: string, estimatedDelivery: Date): FulfillmentRecord;
+    /**
+     * 更新履约状态
+     */
+    updateStatus(fulfillmentId: string, status: FulfillmentStatus, trackingNumber?: string, deliveryDate?: Date): FulfillmentRecord | null;
+    /**
+     * 报告履约异常
+     */
+    reportException(fulfillmentId: string, type: FulfillmentException["type"], severity: FulfillmentException["severity"], description: string): FulfillmentException | null;
+    /**
+     * 解决异常
+     */
+    resolveException(exceptionId: string, resolution: string): boolean;
+    /**
+     * 获取履约记录
+     */
+    getFulfillment(id: string): FulfillmentRecord | null;
+    /**
+     * 根据订单获取履约记录
+     */
+    getByOrderId(orderId: string): FulfillmentRecord | null;
+    /**
+     * 根据追踪号获取履约记录
+     */
+    getByTrackingNumber(trackingNumber: string): FulfillmentRecord | null;
+    /**
+     * 获取履约统计
+     */
+    getStatistics(startDate?: Date, endDate?: Date): {
+        total: number;
+        delivered: number;
+        inTransit: number;
+        pending: number;
+        exceptions: number;
+        deliveryRate: number;
+        averageDeliveryTime: number;
+    };
+    /**
+     * 获取履约延迟报告
+     */
+    getDelaysReport(daysThreshold?: number, limit?: number): Array<{
+        record: FulfillmentRecord;
+        delayDays: number;
+        severity: "low" | "medium" | "high";
+    }>;
+    /**
+     * 检查履约异常
+     */
+    private checkForExceptions;
+    /**
+     * 根据日期范围过滤
+     */
+    private filterByDateRange;
+    /**
+     * 生成 ID
+     */
+    private generateId;
+    /**
+     * 清理旧记录
+     */
+    cleanupOldRecords(daysToKeep?: number): number;
+}
+/**
+ * 创建履约服务
+ */
+export declare function createFulfillmentService(): FulfillmentService;
+/**
+ * 默认履约服务
+ */
+export declare const fulfillmentService: FulfillmentService;
+//# sourceMappingURL=fulfillment.d.ts.map

package/dist/services/business/fulfillment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fulfillment.d.ts","sourceRoot":"","sources":["../../../src/services/business/fulfillment.ts"],"names":[],"mappings":"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"}