完整版V1 加入爬虫功能

2026-06-09 03:36:30 +08:00
parent 34d76cce74
commit a68b83fcbd
69 changed files with 5058 additions and 56 deletions
@@ -90,4 +90,16 @@ class SplitAutoReplyService
        $lines = self::parseLines($stored);
        return implode("\n", $lines);
    }
+
+    /**
+     * 从多行回复语中随机抽取一条（无配置时返回空字符串）
+     */
+    public static function pickRandomLine(string $raw): string
+    {
+        $lines = self::parseLines($raw);
+        if ($lines === []) {
+            return '';
+        }
+        return $lines[array_rand($lines)];
+    }
 }
@@ -11,9 +11,15 @@ class SplitFriendUrlBuilder
 {
    /**
     * 构建跳转 URL；无法构建时返回空字符串
+     *
+     * @param string $whatsAppReplyText 仅 WhatsApp 类型使用，预填消息文案（urlencode 在内部处理）
     */
-    public static function build(string $numberType, string $number, string $numberTypeCustom = ''): string
-    {
+    public static function build(
+        string $numberType,
+        string $number,
+        string $numberTypeCustom = '',
+        string $whatsAppReplyText = ''
+    ): string {
        $number = trim($number);
        if ($number === '') {
            return '';
@@ -21,7 +27,7 @@ class SplitFriendUrlBuilder

        switch ($numberType) {
            case 'whatsapp':
-                return self::buildWhatsApp($number);
+                return self::buildWhatsApp($number, $whatsAppReplyText);
            case 'telegram':
                return self::buildTelegram($number);
            case 'line':
@@ -34,16 +40,22 @@ class SplitFriendUrlBuilder
    }

    /**
-     * WhatsApp：https://api.whatsapp.com/send?phone= 仅数字
+     * WhatsApp：https://api.whatsapp.com/send?phone= 仅数字，可选 &text= 预填消息
     */
-    private static function buildWhatsApp(string $number): string
+    private static function buildWhatsApp(string $number, string $replyText = ''): string
    {
        $digits = preg_replace('/\D+/', '', $number) ?? '';
        if ($digits === '') {
            return '';
        }

-        return 'https://api.whatsapp.com/send?phone=' . $digits;
+        $url = 'https://api.whatsapp.com/send?phone=' . $digits;
+        $replyText = trim($replyText);
+        if ($replyText !== '') {
+            $url .= '&text=' . rawurlencode($replyText);
+        }
+
+        return $url;
    }

    /**
@@ -0,0 +1,24 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\service;
+
+use app\admin\model\split\Link;
+
+/**
+ * 分流链接随机打乱配置读取
+ */
+class SplitNumberWeighService
+{
+    /**
+     * 链接是否开启随机打乱（新号码按随机插入顺序写入，跳转按 id 顺序轮转）
+     */
+    public static function isRandomShuffleEnabled(int $linkId): bool
+    {
+        if ($linkId <= 0) {
+            return false;
+        }
+        return (int) Link::where('id', $linkId)->value('random_shuffle') === 1;
+    }
+}
@@ -72,7 +72,17 @@ class SplitRedirectService
            ? (string) ($picked['number_type_custom'] ?? '')
            : (string) $picked->getAttr('number_type_custom');

-        $redirectUrl = SplitFriendUrlBuilder::build($numberType, $numberValue, $numberCustom);
+        $whatsAppReplyText = '';
+        if ($numberType === 'whatsapp') {
+            $whatsAppReplyText = SplitAutoReplyService::pickRandomLine((string) $link->getAttr('auto_reply'));
+        }
+
+        $redirectUrl = SplitFriendUrlBuilder::build(
+            $numberType,
+            $numberValue,
+            $numberCustom,
+            $whatsAppReplyText
+        );
        if ($redirectUrl === '') {
            return null;
        }
@@ -0,0 +1,65 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\service;
+
+use app\common\library\scrm\ScrmSpiderInterface;
+use app\common\library\scrm\spider\A2cSpider;
+use app\common\library\scrm\spider\HaiwangSpider;
+use app\common\library\scrm\spider\HuojianSpider;
+use app\common\library\scrm\spider\SsCustomerSpider;
+use app\common\library\scrm\spider\XingheSpider;
+
+/**
+ * 工单类型 -> 云控蜘蛛工厂
+ *
+ * 新增云控类型：在 spider/ 下新增类并在此注册 ticket_type => Class
+ */
+class SplitScrmSpiderFactory
+{
+    /** @var array<string, class-string<ScrmSpiderInterface>> */
+    private const MAP = [
+        'a2c'         => A2cSpider::class,
+        'haiwang'     => HaiwangSpider::class,
+        'huojian'     => HuojianSpider::class,
+        'xinghe'      => XingheSpider::class,
+        'ss_customer' => SsCustomerSpider::class,
+        // ceo_scrm 等未实现类型：新增 spider 类后在此注册
+    ];
+
+    /**
+     * @return class-string<ScrmSpiderInterface>|null
+     */
+    public static function resolveClass(string $ticketType): ?string
+    {
+        $ticketType = trim($ticketType);
+        return self::MAP[$ticketType] ?? null;
+    }
+
+    /**
+     * 是否已实现蜘蛛
+     */
+    public static function isSupported(string $ticketType): bool
+    {
+        return self::resolveClass($ticketType) !== null;
+    }
+
+    /**
+     * @return ScrmSpiderInterface|null
+     */
+    public static function create(
+        string $ticketType,
+        string $pageUrl,
+        string $account = '',
+        string $password = '',
+        string $nodeHost = ''
+    ): ?ScrmSpiderInterface {
+        $class = self::resolveClass($ticketType);
+        if ($class === null) {
+            return null;
+        }
+        $host = $nodeHost !== '' ? $nodeHost : SplitSyncConfigService::getNodeHost();
+        return new $class($pageUrl, $account, $password, $host);
+    }
+}
@@ -0,0 +1,62 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\service;
+
+use think\Config;
+use think\Db;
+
+/**
+ * 工单云控同步相关系统配置读取
+ */
+class SplitSyncConfigService
+{
+    private const DEFAULT_NODE_HOST = 'http://127.0.0.1:3001';
+
+    /**
+     * Node Headless 服务根地址
+     */
+    public static function getNodeHost(): string
+    {
+        $value = self::getConfigValue('split_scrm_node_host');
+        $value = trim($value);
+        return $value !== '' ? rtrim($value, '/') : self::DEFAULT_NODE_HOST;
+    }
+
+    /**
+     * 连续同步失败多少次后自动暂停工单（0 表示不因失败暂停）
+     */
+    public static function getFailPauseThreshold(): int
+    {
+        $value = self::getConfigValue('split_sync_fail_pause_threshold');
+        if ($value === '') {
+            return 5;
+        }
+        return max(0, (int) $value);
+    }
+
+    /**
+     * 指定工单类型的自动同步周期（分钟），0 表示不自动同步
+     */
+    public static function getIntervalMinutes(string $ticketType): int
+    {
+        $ticketType = trim($ticketType);
+        if ($ticketType === '') {
+            return 0;
+        }
+        $key = 'split_sync_interval_' . $ticketType;
+        $value = self::getConfigValue($key);
+        return max(0, (int) $value);
+    }
+
+    private static function getConfigValue(string $name): string
+    {
+        $site = Config::get('site.' . $name);
+        if ($site !== null && $site !== '') {
+            return (string) $site;
+        }
+        $db = Db::name('config')->where('name', $name)->value('value');
+        return $db !== null ? (string) $db : '';
+    }
+}
@@ -0,0 +1,182 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\service;
+
+use app\admin\model\split\Number;
+use app\admin\model\split\Ticket;
+use app\common\library\scrm\UnifiedScrmData;
+use think\Db;
+
+/**
+ * 工单同步结果写入号码表
+ */
+class SplitTicketNumberSyncService
+{
+    /**
+     * 将蜘蛛返回的号码列表同步到号码管理
+     */
+    public function syncFromUnifiedData(Ticket $ticket, UnifiedScrmData $data): void
+    {
+        $adminId = (int) $ticket['admin_id'];
+        $linkId = (int) $ticket['split_link_id'];
+        $ticketName = (string) $ticket['ticket_name'];
+        if ($linkId <= 0 || $ticketName === '') {
+            return;
+        }
+
+        $randomShuffle = SplitNumberWeighService::isRandomShuffleEnabled($linkId);
+
+        // 使用独立 number 字段存储，避免纯数字号码作为数组 key 被 PHP 自动转为 int
+        $syncedNumbers = [];
+        foreach ($data->numbers as $row) {
+            $number = self::normalizeNumber($row['number'] ?? '');
+            if ($number === '') {
+                continue;
+            }
+            $syncedNumbers[] = [
+                'number' => $number,
+                'row'    => $row,
+            ];
+        }
+
+        $existingList = Number::where('admin_id', $adminId)
+            ->where('split_link_id', $linkId)
+            ->where('ticket_name', $ticketName)
+            ->select();
+
+        $existingMap = [];
+        foreach ($existingList as $item) {
+            $existingMap[(string) $item['number']] = $item;
+        }
+
+        $syncedNumberSet = [];
+        $pendingInserts = [];
+        foreach ($syncedNumbers as $entry) {
+            $number = $entry['number'];
+            $row = $entry['row'];
+            $syncedNumberSet[$number] = true;
+            $platformStatus = ($row['status'] ?? '') === 'online' ? 'online' : 'offline';
+            $newFollowers = (int) ($row['newFollowersToday'] ?? 0);
+
+            if (isset($existingMap[$number])) {
+                $this->updateExistingNumber($existingMap[$number], $platformStatus, $newFollowers);
+                continue;
+            }
+
+            $pendingInserts[] = [
+                'number'          => $number,
+                'platform_status' => $platformStatus,
+                'new_followers'   => $newFollowers,
+            ];
+        }
+
+        if ($pendingInserts !== []) {
+            // 随机打乱：打乱待插入批次顺序，按随机顺序逐条 insert 以获得乱序自增 id
+            if ($randomShuffle && count($pendingInserts) > 1) {
+                shuffle($pendingInserts);
+            }
+            foreach ($pendingInserts as $item) {
+                $this->insertNumber(
+                    $ticket,
+                    $item['number'],
+                    $item['platform_status'],
+                    $item['new_followers']
+                );
+            }
+        }
+
+        foreach ($existingMap as $number => $item) {
+            if (isset($syncedNumberSet[$number])) {
+                continue;
+            }
+            if ((int) $item['manual_manage'] === 1) {
+                continue;
+            }
+            Number::where('id', (int) $item['id'])->update([
+                'status'     => 'hidden',
+                'updatetime' => time(),
+            ]);
+        }
+    }
+
+    /**
+     * @param Number $row
+     */
+    private function updateExistingNumber($row, string $platformStatus, int $newFollowers): void
+    {
+        $update = [
+            'platform_status' => $platformStatus,
+            'updatetime'      => time(),
+        ];
+
+        if ((int) $row['manual_manage'] === 1) {
+            Number::where('id', (int) $row['id'])->update($update);
+            return;
+        }
+
+        // 进线人数由同步写入，最终开关由 applyNumberRules 统一判定（单号上限/下号比率等）
+        $update['inbound_count'] = max(0, $newFollowers);
+        Number::where('id', (int) $row['id'])->update($update);
+    }
+
+    private function insertNumber(
+        Ticket $ticket,
+        string $number,
+        string $platformStatus,
+        int $newFollowers
+    ): void {
+        $now = time();
+        $data = [
+            'admin_id'           => (int) $ticket['admin_id'],
+            'split_link_id'      => (int) $ticket['split_link_id'],
+            'ticket_name'        => (string) $ticket['ticket_name'],
+            'number'             => $number,
+            'number_type'        => (string) $ticket['number_type'],
+            'number_type_custom' => (string) ($ticket['number_type_custom'] ?? ''),
+            'visit_count'        => 0,
+            'inbound_count'      => max(0, $newFollowers),
+            'manual_manage'      => 0,
+            'platform_status'    => $platformStatus,
+            'status'             => 'hidden',
+            'createtime'         => $now,
+            'updatetime'         => $now,
+        ];
+
+        try {
+            Db::name('split_number')->insert($data);
+        } catch (\Throwable $e) {
+            $exists = Number::where('split_link_id', (int) $ticket['split_link_id'])
+                ->where('number', $number)
+                ->find();
+            if ($exists) {
+                $this->updateExistingNumber($exists, $platformStatus, $newFollowers);
+            }
+        }
+    }
+
+    /**
+     * 统一号码为字符串（云控 API 可能返回 int）
+     */
+    private static function normalizeNumber($value): string
+    {
+        if ($value === null || $value === '') {
+            return '';
+        }
+        return trim((string) $value);
+    }
+
+    /**
+     * 汇总工单进线人数（仅开启状态的号码）
+     */
+    public function sumInboundForTicket(Ticket $ticket): int
+    {
+        $sum = Number::where('admin_id', (int) $ticket['admin_id'])
+            ->where('split_link_id', (int) $ticket['split_link_id'])
+            ->where('ticket_name', (string) $ticket['ticket_name'])
+            ->where('status', 'normal')
+            ->sum('inbound_count');
+        return (int) $sum;
+    }
+}
@@ -0,0 +1,195 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\service;
+
+use app\admin\model\split\Number;
+use app\admin\model\split\Ticket;
+
+/**
+ * 工单与号码业务规则（单号上限、下号比率、时间窗口、完成量自动开关）
+ */
+class SplitTicketRuleService
+{
+    /**
+     * 同步后应用全部规则并写回工单/号码
+     */
+    public function applyAfterSync(Ticket $ticket, int $completeCount): void
+    {
+        $this->applyTicketStatusRules($ticket, $completeCount);
+        $fresh = Ticket::get((int) $ticket['id']);
+        if ($fresh) {
+            if ((string) $fresh['status'] === 'hidden') {
+                $this->cascadeTicketClosedToNumbers($fresh);
+            }
+            $this->applyNumberRules($fresh);
+        }
+    }
+
+    /**
+     * 同步流程：工单因时间/完成量等原因关闭时，联动关闭非手动号码
+     */
+    public function cascadeTicketClosedToNumbers(Ticket $ticket): void
+    {
+        if ((string) ($ticket['status'] ?? 'hidden') !== 'hidden') {
+            return;
+        }
+        Number::where('admin_id', (int) $ticket['admin_id'])
+            ->where('split_link_id', (int) $ticket['split_link_id'])
+            ->where('ticket_name', (string) $ticket['ticket_name'])
+            ->where('manual_manage', 0)
+            ->update([
+                'status'     => 'hidden',
+                'updatetime' => time(),
+            ]);
+    }
+
+    /**
+     * 手动切换工单状态时，联动非手动管理的号码
+     */
+    public function syncNumbersWithTicketStatus(Ticket $ticket): void
+    {
+        $ticketStatus = (string) ($ticket['status'] ?? 'hidden');
+        if ($ticketStatus === 'hidden') {
+            $this->cascadeTicketClosedToNumbers($ticket);
+            return;
+        }
+        $this->applyNumberRules($ticket);
+    }
+
+    /**
+     * 工单处于开启状态时，将云控在线的非手动号码设为开启
+     *
+     * @deprecated 请使用 applyNumberRules（会校验单号上限/下号比率）
+     */
+    public function syncOnlineNumbersWhenTicketOpen(Ticket $ticket): void
+    {
+        $this->applyNumberRules($ticket);
+    }
+
+    /**
+     * 单号上限、下号比率、云控在线状态、工单开关综合决定号码状态
+     */
+    public function applyNumberRules(Ticket $ticket): void
+    {
+        $orderLimit = (int) ($ticket['order_limit'] ?? 0);
+        $assignRatio = (int) ($ticket['assign_ratio'] ?? 0);
+
+        $numbers = Number::where('admin_id', (int) $ticket['admin_id'])
+            ->where('split_link_id', (int) $ticket['split_link_id'])
+            ->where('ticket_name', (string) $ticket['ticket_name'])
+            ->select();
+
+        foreach ($numbers as $number) {
+            $visitCount = (int) $number['visit_count'];
+            $inboundCount = (int) $number['inbound_count'];
+            $lastVisit = (int) ($number['last_sync_visit_count'] ?? 0);
+            $lastInbound = (int) ($number['last_sync_inbound_count'] ?? 0);
+            $streak = (int) ($number['no_inbound_click_streak'] ?? 0);
+
+            if ($visitCount > $lastVisit && $inboundCount <= $lastInbound) {
+                $streak += ($visitCount - $lastVisit);
+            } elseif ($inboundCount > $lastInbound) {
+                $streak = 0;
+            }
+
+            $update = [
+                'no_inbound_click_streak' => $streak,
+                'last_sync_visit_count'   => $visitCount,
+                'last_sync_inbound_count' => $inboundCount,
+                'updatetime'              => time(),
+            ];
+
+            // 手动管理（含用户手动关闭）的号码：仅更新统计字段，不改状态
+            if ((int) $number['manual_manage'] === 1) {
+                Number::where('id', (int) $number['id'])->update($update);
+                continue;
+            }
+
+            $update['status'] = $this->resolveAutomatedStatus(
+                $ticket,
+                (string) ($number['platform_status'] ?? 'unknown'),
+                $inboundCount,
+                $streak,
+                $orderLimit,
+                $assignRatio
+            );
+
+            Number::where('id', (int) $number['id'])->update($update);
+        }
+    }
+
+    /**
+     * 非手动管理号码的自动开关判定
+     */
+    private function resolveAutomatedStatus(
+        Ticket $ticket,
+        string $platformStatus,
+        int $inboundCount,
+        int $streak,
+        int $orderLimit,
+        int $assignRatio
+    ): string {
+        if ((string) ($ticket['status'] ?? 'hidden') !== 'normal') {
+            return 'hidden';
+        }
+        if ($platformStatus !== 'online') {
+            return 'hidden';
+        }
+        if ($orderLimit > 0 && $inboundCount >= $orderLimit) {
+            return 'hidden';
+        }
+        if ($assignRatio > 0 && $streak >= $assignRatio) {
+            return 'hidden';
+        }
+
+        return 'normal';
+    }
+
+    /**
+     * 完成量、时间窗口决定工单开关（定时与手动同步均适用）
+     */
+    public function applyTicketStatusRules(Ticket $ticket, int $completeCount): void
+    {
+        $status = $this->resolveTicketStatus($ticket, $completeCount);
+        if ($status !== (string) ($ticket['status'] ?? 'hidden')) {
+            Ticket::where('id', (int) $ticket['id'])->update([
+                'status'     => $status,
+                'updatetime' => time(),
+            ]);
+            $ticket['status'] = $status;
+        }
+    }
+
+    /**
+     * 是否处于允许同步/开启的时间窗口
+     */
+    public function isWithinTimeWindow(Ticket $ticket, ?int $now = null): bool
+    {
+        $now = $now ?? time();
+        $start = $ticket['start_time'] ?? null;
+        $end = $ticket['end_time'] ?? null;
+        if ($start !== null && $start !== '' && (int) $start > 0 && $now < (int) $start) {
+            return false;
+        }
+        if ($end !== null && $end !== '' && (int) $end > 0 && $now > (int) $end) {
+            return false;
+        }
+        return true;
+    }
+
+    private function resolveTicketStatus(Ticket $ticket, int $completeCount): string
+    {
+        if (!$this->isWithinTimeWindow($ticket)) {
+            return 'hidden';
+        }
+
+        $ticketTotal = (int) ($ticket['ticket_total'] ?? 0);
+        if ($ticketTotal > 0) {
+            return $completeCount >= $ticketTotal ? 'hidden' : 'normal';
+        }
+
+        return 'normal';
+    }
+}
@@ -0,0 +1,64 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\service;
+
+/**
+ * 工单同步互斥锁（基于 runtime 文件锁，不依赖 Cache/Redis 扩展）
+ */
+class SplitTicketSyncLockService
+{
+    private const LOCK_TTL = 1800;
+
+    /**
+     * 尝试获取锁
+     */
+    public function acquire(int $ticketId): bool
+    {
+        $path = $this->lockPath($ticketId);
+        if ($this->isStaleLock($path)) {
+            @unlink($path);
+        }
+        if (is_file($path)) {
+            return false;
+        }
+        $payload = json_encode([
+            'ticket_id' => $ticketId,
+            'pid'       => getmypid(),
+            'time'      => time(),
+        ], JSON_UNESCAPED_UNICODE);
+        $written = @file_put_contents($path, $payload, LOCK_EX);
+        return $written !== false;
+    }
+
+    /**
+     * 释放锁
+     */
+    public function release(int $ticketId): void
+    {
+        $path = $this->lockPath($ticketId);
+        if (is_file($path)) {
+            @unlink($path);
+        }
+    }
+
+    private function lockPath(int $ticketId): string
+    {
+        $runtime = defined('RUNTIME_PATH') ? RUNTIME_PATH : (dirname(__DIR__, 3) . '/runtime/');
+        $dir = $runtime . 'split_ticket_sync/';
+        if (!is_dir($dir)) {
+            @mkdir($dir, 0755, true);
+        }
+        return $dir . $ticketId . '.lock';
+    }
+
+    private function isStaleLock(string $path): bool
+    {
+        if (!is_file($path)) {
+            return false;
+        }
+        $mtime = (int) @filemtime($path);
+        return $mtime > 0 && (time() - $mtime) > self::LOCK_TTL;
+    }
+}
@@ -0,0 +1,114 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\service;
+
+use think\Config;
+
+/**
+ * 工单云控同步调试日志（仅 app_debug=true 时写入 runtime/log/split_sync.log）
+ */
+class SplitTicketSyncLogger
+{
+    private const LOG_FILE = 'split_sync.log';
+
+    private static ?string $ticketTag = null;
+
+    public static function isEnabled(): bool
+    {
+        return (bool) Config::get('app_debug');
+    }
+
+    public static function setTicketContext(?int $ticketId, ?string $ticketType = null): void
+    {
+        if ($ticketId === null || $ticketId <= 0) {
+            self::$ticketTag = null;
+            return;
+        }
+        $type = $ticketType !== null && $ticketType !== '' ? $ticketType : '-';
+        self::$ticketTag = sprintf('#%d(%s)', $ticketId, $type);
+    }
+
+    public static function clearTicketContext(): void
+    {
+        self::$ticketTag = null;
+    }
+
+    /**
+     * @param array<string, mixed> $context
+     */
+    public static function log(string $stage, string $message, array $context = []): void
+    {
+        if (!self::isEnabled()) {
+            return;
+        }
+
+        $context = self::sanitize($context);
+        $ctxJson = $context !== [] ? ' ' . json_encode($context, JSON_UNESCAPED_UNICODE) : '';
+        $line = sprintf(
+            "[%s] %s [%s] %s%s\n",
+            date('Y-m-d H:i:s'),
+            self::$ticketTag ?? '[global]',
+            $stage,
+            $message,
+            $ctxJson
+        );
+
+        $runtime = defined('RUNTIME_PATH') ? RUNTIME_PATH : (ROOT_PATH . 'runtime/');
+        $dir = $runtime . 'log/';
+        if (!is_dir($dir)) {
+            @mkdir($dir, 0755, true);
+        }
+        @file_put_contents($dir . self::LOG_FILE, $line, FILE_APPEND | LOCK_EX);
+    }
+
+    /**
+     * @param array<string, mixed> $context
+     * @return array<string, mixed>
+     */
+    private static function sanitize(array $context): array
+    {
+        $out = [];
+        foreach ($context as $key => $value) {
+            $lower = strtolower((string) $key);
+            if (in_array($lower, ['password', 'passwd', 'pwd', 'token', 'secret'], true)) {
+                continue;
+            }
+            if ($key === 'authActions' && is_array($value)) {
+                $out[$key] = self::sanitizeAuthActions($value);
+                continue;
+            }
+            if (is_array($value)) {
+                $out[$key] = self::sanitize($value);
+                continue;
+            }
+            if (is_string($value) && mb_strlen($value) > 800) {
+                $out[$key] = mb_substr($value, 0, 800, 'UTF-8') . '...(truncated)';
+                continue;
+            }
+            $out[$key] = $value;
+        }
+        return $out;
+    }
+
+    /**
+     * @param array<int, mixed> $actions
+     * @return array<int, mixed>
+     */
+    private static function sanitizeAuthActions(array $actions): array
+    {
+        $sanitized = [];
+        foreach ($actions as $action) {
+            if (!is_array($action)) {
+                $sanitized[] = $action;
+                continue;
+            }
+            if (array_key_exists('value', $action)) {
+                $action['value'] = '***';
+            }
+            $sanitized[] = $action;
+        }
+        return $sanitized;
+    }
+}
@@ -5,38 +5,233 @@ declare(strict_types=1);
 namespace app\common\service;

 use app\admin\model\split\Ticket;
+use app\common\library\scrm\UnifiedScrmData;
+use think\Db;
 use think\Exception;

 /**
- * 分流工单数据同步服务（骨架，后续按 ticket_type 对接各云控 API）
- *
- * 期望第三方接口 payload 字段映射：
- * - complete_count int 完成数量
- * - inbound_count int 进线人数
- * - speed_per_hour float 每小时进线人数
- * - number_count int 号码总数（含离线+封号）
- * - number_offline_count int 可选 离线数
- * - number_banned_count int 可选 封号数
- * - online_count int 在线人数
+ * 分流工单云控数据同步服务
 */
 class SplitTicketSyncService
 {
-    /**
-     * 同步单条工单（后续实现：按 ticket_type 选择适配器并请求 API）
-     */
-    public function syncOne(int $ticketId): bool
+    private SplitTicketNumberSyncService $numberSync;
+
+    private SplitTicketRuleService $ruleService;
+
+    private SplitTicketSyncLockService $lockService;
+
+    public function __construct()
    {
-        $ticket = Ticket::get($ticketId);
-        if (!$ticket) {
-            return false;
-        }
-        // TODO: 调用具体云控适配器获取 $payload
-        return false;
+        $this->numberSync = new SplitTicketNumberSyncService();
+        $this->ruleService = new SplitTicketRuleService();
+        $this->lockService = new SplitTicketSyncLockService();
    }

    /**
-     * 将同步结果写入工单表
+     * 同步单条工单
     *
+     * @return array{success:bool,message:string,skipped?:bool}
+     */
+    public function syncOne(int $ticketId, bool $force = false): array
+    {
+        $ticket = Ticket::get($ticketId);
+        if (!$ticket) {
+            SplitTicketSyncLogger::log('sync', 'ticket not found', ['ticketId' => $ticketId]);
+            return ['success' => false, 'message' => '工单不存在'];
+        }
+
+        SplitTicketSyncLogger::setTicketContext($ticketId, (string) $ticket['ticket_type']);
+        SplitTicketSyncLogger::log('sync', 'syncOne start', [
+            'force'         => $force,
+            'status'        => (string) $ticket['status'],
+            'syncFailCount' => (int) ($ticket['sync_fail_count'] ?? 0),
+            'syncTime'      => (int) ($ticket['sync_time'] ?? 0),
+            'pageUrl'       => (string) $ticket['ticket_url'],
+            'nodeHost'      => SplitSyncConfigService::getNodeHost(),
+        ]);
+
+        if (!$force) {
+            $skip = $this->shouldSkip($ticket);
+            if ($skip !== null) {
+                SplitTicketSyncLogger::log('sync', 'skipped', ['reason' => $skip]);
+                SplitTicketSyncLogger::clearTicketContext();
+                return ['success' => false, 'message' => $skip, 'skipped' => true];
+            }
+        }
+
+        if (!$this->lockService->acquire($ticketId)) {
+            SplitTicketSyncLogger::log('sync', 'lock busy', ['ticketId' => $ticketId]);
+            SplitTicketSyncLogger::clearTicketContext();
+            return ['success' => false, 'message' => '工单正在同步中', 'skipped' => true];
+        }
+
+        try {
+            $result = $this->doSync($ticket);
+            SplitTicketSyncLogger::log('sync', 'syncOne end', $result);
+            return $result;
+        } finally {
+            $this->lockService->release($ticketId);
+            SplitTicketSyncLogger::clearTicketContext();
+        }
+    }
+
+    /**
+     * 扫描到期工单并同步
+     */
+    public function syncDueTickets(): int
+    {
+        $count = 0;
+        $failThreshold = SplitSyncConfigService::getFailPauseThreshold();
+        $query = Ticket::where('status', 'normal');
+        if ($failThreshold > 0) {
+            $query->where('sync_fail_count', '<', $failThreshold);
+        }
+        $list = $query->select();
+
+        SplitTicketSyncLogger::log('cron', 'scan start', [
+            'candidateCount' => count($list),
+        ]);
+
+        foreach ($list as $ticket) {
+            $skip = $this->shouldSkip($ticket);
+            if ($skip !== null) {
+                SplitTicketSyncLogger::log('cron', 'candidate skipped', [
+                    'ticketId'   => (int) $ticket['id'],
+                    'ticketType' => (string) $ticket['ticket_type'],
+                    'reason'     => $skip,
+                ]);
+                continue;
+            }
+            $result = $this->syncOne((int) $ticket['id'], false);
+            if (!empty($result['skipped'])) {
+                continue;
+            }
+            $count++;
+        }
+
+        SplitTicketSyncLogger::log('cron', 'scan end', ['processedCount' => $count]);
+        return $count;
+    }
+
+    /**
+     * @return array{success:bool,message:string}
+     */
+    private function doSync(Ticket $ticket): array
+    {
+        $ticketType = (string) $ticket['ticket_type'];
+        $pageUrl = trim((string) $ticket['ticket_url']);
+        if ($pageUrl === '') {
+            SplitTicketSyncLogger::log('sync', 'empty pageUrl');
+            $this->markFailure($ticket, '工单链接为空');
+            return ['success' => false, 'message' => '工单链接为空'];
+        }
+
+        if (!SplitScrmSpiderFactory::isSupported($ticketType)) {
+            SplitTicketSyncLogger::log('sync', 'spider not supported', ['ticketType' => $ticketType]);
+            $this->markFailure($ticket, '工单类型尚未实现蜘蛛');
+            return ['success' => false, 'message' => '工单类型尚未实现蜘蛛'];
+        }
+
+        SplitTicketSyncLogger::log('sync', 'create spider', [
+            'ticketType' => $ticketType,
+            'hasAccount' => trim((string) ($ticket['account'] ?? '')) !== '',
+        ]);
+        $spider = SplitScrmSpiderFactory::create(
+            $ticketType,
+            $pageUrl,
+            (string) ($ticket['account'] ?? ''),
+            (string) ($ticket['password'] ?? '')
+        );
+        if ($spider === null) {
+            $this->markFailure($ticket, '无法创建蜘蛛实例');
+            return ['success' => false, 'message' => '无法创建蜘蛛实例'];
+        }
+
+        Db::startTrans();
+        try {
+            SplitTicketSyncLogger::log('sync', 'spider run begin');
+            $finalData = $spider->run();
+            if (!$finalData instanceof UnifiedScrmData) {
+                throw new Exception('蜘蛛返回数据无效');
+            }
+
+            $this->numberSync->syncFromUnifiedData($ticket, $finalData);
+
+            $completeCount = max(0, $finalData->todayNewCount);
+            $this->ruleService->applyTicketStatusRules($ticket, $completeCount);
+
+            $freshTicket = Ticket::get((int) $ticket['id']) ?: $ticket;
+            if ((string) $freshTicket['status'] === 'hidden') {
+                $this->ruleService->cascadeTicketClosedToNumbers($freshTicket);
+            }
+            // 号码开关最后统一由 applyNumberRules 判定（单号上限/下号比率/云控在线）
+            $this->ruleService->applyNumberRules($freshTicket);
+            $ticket = $freshTicket;
+
+            $inboundCount = $this->numberSync->sumInboundForTicket($ticket);
+            $speed = $this->calcSpeedPerHour($ticket, $completeCount);
+
+            $payload = [
+                'complete_count'       => $completeCount,
+                'inbound_count'        => $inboundCount,
+                'speed_per_hour'       => $speed['speed'],
+                'number_count'         => max(0, $finalData->total),
+                'number_offline_count' => max(0, $finalData->totalOffline),
+                'number_banned_count'  => 0,
+                'online_count'         => max(0, $finalData->totalOnline),
+                'sync_fail_count'      => 0,
+                'speed_snapshot_count' => $speed['snapshot_count'],
+                'speed_snapshot_time'  => $speed['snapshot_time'],
+            ];
+
+            $this->applySyncResult($ticket, $payload, true, '');
+            Db::commit();
+            SplitTicketSyncLogger::log('sync', 'db commit ok', $payload);
+            return ['success' => true, 'message' => '同步成功'];
+        } catch (\Throwable $e) {
+            Db::rollback();
+            $msg = mb_substr($e->getMessage(), 0, 255, 'UTF-8');
+            SplitTicketSyncLogger::log('sync', 'exception', [
+                'type'    => get_class($e),
+                'message' => $msg,
+                'file'    => $e->getFile(),
+                'line'    => $e->getLine(),
+            ]);
+            $this->markFailure($ticket, $msg);
+            return ['success' => false, 'message' => $msg];
+        }
+    }
+
+    private function shouldSkip(Ticket $ticket): ?string
+    {
+        if ((string) $ticket['status'] === 'hidden') {
+            return '工单已关闭';
+        }
+        $failThreshold = SplitSyncConfigService::getFailPauseThreshold();
+        if ($failThreshold > 0 && (int) ($ticket['sync_fail_count'] ?? 0) >= $failThreshold) {
+            return sprintf('连续同步失败超过%d次已暂停', $failThreshold);
+        }
+        if (!SplitScrmSpiderFactory::isSupported((string) $ticket['ticket_type'])) {
+            return '工单类型尚未实现';
+        }
+        $interval = SplitSyncConfigService::getIntervalMinutes((string) $ticket['ticket_type']);
+        if ($interval <= 0) {
+            return '该类型未配置自动同步周期';
+        }
+        $lastSync = (int) ($ticket['sync_time'] ?? 0);
+        $elapsed = $lastSync > 0 ? (time() - $lastSync) : null;
+        if ($lastSync > 0 && $elapsed !== null && $elapsed < ($interval * 60)) {
+            SplitTicketSyncLogger::log('sync', 'interval not reached', [
+                'intervalMinutes' => $interval,
+                'elapsedSeconds'  => $elapsed,
+                'needSeconds'     => $interval * 60,
+            ]);
+            return '未到同步周期';
+        }
+        return null;
+    }
+
+    /**
     * @param array<string, mixed> $payload
     */
    public function applySyncResult(Ticket $ticket, array $payload, bool $success, string $message = ''): void
@@ -52,9 +247,74 @@ class SplitTicketSyncService
            'sync_status'          => $success ? 'success' : 'error',
            'sync_time'            => time(),
            'sync_message'         => $success ? '' : mb_substr($message, 0, 255, 'UTF-8'),
+            'sync_fail_count'      => $success ? 0 : ((int) ($ticket['sync_fail_count'] ?? 0) + 1),
+            'speed_snapshot_count' => (int) ($payload['speed_snapshot_count'] ?? $ticket['speed_snapshot_count'] ?? 0),
+            'speed_snapshot_time'  => (int) ($payload['speed_snapshot_time'] ?? $ticket['speed_snapshot_time'] ?? 0),
        ];
        if (!$ticket->allowField(array_keys($data))->save($data)) {
            throw new Exception('工单同步结果保存失败');
        }
    }
+
+    private function markFailure(Ticket $ticket, string $message): void
+    {
+        $failCount = (int) ($ticket['sync_fail_count'] ?? 0) + 1;
+        $failThreshold = SplitSyncConfigService::getFailPauseThreshold();
+        $previousSyncStatus = (string) ($ticket['sync_status'] ?? 'pending');
+        $neverSyncedSuccessfully = $previousSyncStatus === 'pending' && (int) ($ticket['sync_time'] ?? 0) <= 0;
+        $update = [
+            'sync_status'     => 'error',
+            'sync_time'       => time(),
+            'sync_message'    => mb_substr($message, 0, 255, 'UTF-8'),
+            'sync_fail_count' => $failCount,
+        ];
+        // 新建工单首次同步失败：立即关闭；已同步过的工单仍按连续失败阈值关闭
+        if ($neverSyncedSuccessfully || ($failThreshold > 0 && $failCount >= $failThreshold)) {
+            $update['status'] = 'hidden';
+        }
+        $ticket->save($update);
+        if (isset($update['status']) && $update['status'] === 'hidden') {
+            $fresh = Ticket::get((int) $ticket['id']);
+            if ($fresh) {
+                $this->ruleService->cascadeTicketClosedToNumbers($fresh);
+            }
+        }
+    }
+
+    /**
+     * @return array{speed:float,snapshot_count:int,snapshot_time:int}
+     */
+    private function calcSpeedPerHour(Ticket $ticket, int $currentComplete): array
+    {
+        $now = time();
+        $snapshotTime = (int) ($ticket['speed_snapshot_time'] ?? 0);
+        $snapshotCount = (int) ($ticket['speed_snapshot_count'] ?? 0);
+
+        if ($snapshotTime <= 0) {
+            return [
+                'speed'           => 0.0,
+                'snapshot_count'  => $currentComplete,
+                'snapshot_time'   => $now,
+            ];
+        }
+
+        $elapsed = $now - $snapshotTime;
+        if ($elapsed >= 3600) {
+            return [
+                'speed'           => 0.0,
+                'snapshot_count'  => $currentComplete,
+                'snapshot_time'   => $now,
+            ];
+        }
+
+        $hours = $elapsed > 0 ? ($elapsed / 3600) : 0;
+        $delta = $currentComplete - $snapshotCount;
+        $speed = ($delta < 0 || $hours <= 0) ? 0.0 : round($delta / $hours, 2);
+
+        return [
+            'speed'           => $speed,
+            'snapshot_count'  => $snapshotCount,
+            'snapshot_time'   => $snapshotTime,
+        ];
+    }
 }