#feature: some update

app/Services/DingTalkService.php

@@ -8,6 +8,7 @@ use Illuminate\Support\Facades\Log;
 class DingTalkService
 {
     private ?string $webhook;
+
     private ?string $secret;
 
     public function __construct()
@@ -25,9 +26,32 @@ class DingTalkService
                 'atMobiles' => $atMobiles,
                 'atAll' => $atAll,
             ]);
+
             return;
         }
 
+        $this->sendTextToWebhook($this->webhook, $message, $atMobiles, $atAll, $this->secret);
+    }
+
+    public function sendTextToToken(string $token, string $message, array $atMobiles = [], bool $atAll = false): bool
+    {
+        $token = trim($token);
+        if ($token === '') {
+            Log::warning('DingTalk robot token is not configured, skip sending alert.');
+
+            return false;
+        }
+
+        return $this->sendTextToWebhook(
+            'https://oapi.dingtalk.com/robot/send?access_token='.urlencode($token),
+            $message,
+            $atMobiles,
+            $atAll
+        );
+    }
+
+    private function sendTextToWebhook(string $webhook, string $message, array $atMobiles, bool $atAll, ?string $secret = null): bool
+    {
         $payload = [
             'msgtype' => 'text',
             'text' => [
@@ -39,22 +63,33 @@ class DingTalkService
             ],
         ];
 
-        $url = $this->webhook;
-        if (!empty($this->secret)) {
+        $url = $webhook;
+        if (! empty($secret)) {
             $timestamp = (int) round(microtime(true) * 1000);
-            $stringToSign = $timestamp . "\n" . $this->secret;
-            $sign = base64_encode(hash_hmac('sha256', $stringToSign, $this->secret, true));
+            $stringToSign = $timestamp."\n".$secret;
+            $sign = base64_encode(hash_hmac('sha256', $stringToSign, $secret, true));
             $encodedSign = urlencode($sign);
             $separator = str_contains($url, '?') ? '&' : '?';
             $url .= "{$separator}timestamp={$timestamp}&sign={$encodedSign}";
         }
 
         try {
-            Http::timeout(10)->asJson()->post($url, $payload);
+            $response = Http::timeout(10)->asJson()->post($url, $payload);
+
+            if ($response->successful() && (int) $response->json('errcode', -1) === 0) {
+                return true;
+            }
+
+            Log::error('DingTalk alert was rejected', [
+                'status' => $response->status(),
+                'errcode' => $response->json('errcode'),
+            ]);
         } catch (\Throwable $e) {
             Log::error('Failed to send DingTalk alert', [
                 'message' => $e->getMessage(),
             ]);
         }
+
+        return false;
     }
 }

app/Services/ErpRequestReportService.php

@@ -0,0 +1,220 @@
+<?php
+
+namespace App\Services;
+
+use Carbon\CarbonImmutable;
+use Illuminate\Database\DatabaseManager;
+use Illuminate\Support\Collection;
+use Illuminate\Support\Str;
+use InvalidArgumentException;
+use RuntimeException;
+
+class ErpRequestReportService
+{
+    public const DINGTALK_TOKEN_CONFIG_KEY = 'erp_request_report.dingtalk_token';
+
+    private const REPORT_TIMEZONE = 'Asia/Shanghai';
+
+    // Keep a margin below DingTalk's text-message limit for transport overhead.
+    private const MAX_MESSAGE_BYTES = 18_000;
+
+    public function __construct(
+        private DatabaseManager $database,
+        private DingTalkService $dingTalkService,
+        private ConfigService $configService
+    ) {}
+
+    /**
+     * @param  string|null  $date  单日（Y-m-d），与 from/to 互斥
+     * @param  string|null  $from  开始时间（Y-m-d 或 Y-m-d H:i:s），含
+     * @param  string|null  $to  结束时间（Y-m-d 或 Y-m-d H:i:s）；仅日期时含整天，含时分秒时含该时刻
+     */
+    public function sendReport(?string $date = null, ?string $from = null, ?string $to = null): array
+    {
+        $token = trim((string) $this->configService->get(self::DINGTALK_TOKEN_CONFIG_KEY));
+
+        if ($token === '') {
+            throw new RuntimeException('未配置 ERP 请求日报的钉钉机器人 Token');
+        }
+
+        [$start, $end] = $this->resolvePeriod($date, $from, $to);
+        $periodLabel = $this->formatPeriodLabel($start, $end);
+
+        $records = $this->database->connection('agentslave')
+            ->table('request_records')
+            ->selectRaw("agents.name as agent_name, agents.code as agent_code, SUBSTRING_INDEX(request_records.request_uri, '?', 1) as request_uri, COUNT(*) as request_count")
+            ->leftJoin('agents', 'agents.id', '=', 'request_records.user_id')
+            ->where('request_records.created', '>=', $start->toDateTimeString())
+            ->where('request_records.created', '<', $end->toDateTimeString())
+            ->where('request_records.request_uri', 'like', '/openapi/erp/%')
+            ->groupByRaw("agents.id, agents.name, agents.code, SUBSTRING_INDEX(request_records.request_uri, '?', 1)")
+            ->orderBy('agents.name')
+            ->orderBy('agents.code')
+            ->orderByRaw("SUBSTRING_INDEX(request_records.request_uri, '?', 1)")
+            ->get();
+
+        $messages = $this->formatMessages($periodLabel, $records);
+        $messageCount = count($messages);
+
+        foreach ($messages as $index => $message) {
+            if (! $this->dingTalkService->sendTextToToken($token, $message)) {
+                throw new RuntimeException(sprintf('ERP 请求日报第 %d/%d 条发送到钉钉失败', $index + 1, $messageCount));
+            }
+        }
+
+        return [
+            'date' => $periodLabel,
+            'from' => $start->toDateTimeString(),
+            'to' => $end->subSecond()->toDateTimeString(),
+            'company_count' => $records->groupBy(fn ($record) => $record->agent_name."\0".$record->agent_code)->count(),
+            'request_count' => $records->sum('request_count'),
+        ];
+    }
+
+    /**
+     * @return array{0: CarbonImmutable, 1: CarbonImmutable} half-open interval [start, end)
+     */
+    private function resolvePeriod(?string $date, ?string $from, ?string $to): array
+    {
+        $date = $this->normalizeOption($date);
+        $from = $this->normalizeOption($from);
+        $to = $this->normalizeOption($to);
+
+        if ($date !== null && ($from !== null || $to !== null)) {
+            throw new InvalidArgumentException('--date 不能与 --from/--to 同时使用');
+        }
+
+        if ($date !== null) {
+            if (! $this->isDateOnly($date)) {
+                throw new InvalidArgumentException('--date 仅支持 Y-m-d 格式');
+            }
+
+            $start = CarbonImmutable::parse($date, self::REPORT_TIMEZONE)->startOfDay();
+
+            return [$start, $start->addDay()];
+        }
+
+        if ($from === null && $to === null) {
+            $start = CarbonImmutable::now(self::REPORT_TIMEZONE)->subDay()->startOfDay();
+
+            return [$start, $start->addDay()];
+        }
+
+        if ($from === null || $to === null) {
+            throw new InvalidArgumentException('--from 与 --to 需要同时指定');
+        }
+
+        $start = $this->parseBound($from, isStart: true);
+        $end = $this->parseBound($to, isStart: false);
+
+        if ($end->lessThanOrEqualTo($start)) {
+            throw new InvalidArgumentException('结束时间必须晚于开始时间');
+        }
+
+        return [$start, $end];
+    }
+
+    private function parseBound(string $value, bool $isStart): CarbonImmutable
+    {
+        $parsed = CarbonImmutable::parse($value, self::REPORT_TIMEZONE);
+
+        if ($this->isDateOnly($value)) {
+            return $isStart ? $parsed->startOfDay() : $parsed->startOfDay()->addDay();
+        }
+
+        return $isStart ? $parsed : $parsed->addSecond();
+    }
+
+    private function isDateOnly(string $value): bool
+    {
+        return (bool) preg_match('/^\d{4}-\d{2}-\d{2}$/', $value);
+    }
+
+    private function normalizeOption(?string $value): ?string
+    {
+        if ($value === null) {
+            return null;
+        }
+
+        $value = trim($value);
+
+        return $value === '' ? null : $value;
+    }
+
+    private function formatPeriodLabel(CarbonImmutable $start, CarbonImmutable $end): string
+    {
+        $inclusiveEnd = $end->subSecond();
+        $isFullDayStart = $start->format('H:i:s') === '00:00:00';
+        $isFullDayEnd = $inclusiveEnd->format('H:i:s') === '23:59:59';
+        $spansSingleDay = $start->toDateString() === $inclusiveEnd->toDateString();
+
+        if ($isFullDayStart && $isFullDayEnd && $spansSingleDay) {
+            return $start->toDateString();
+        }
+
+        if ($isFullDayStart && $isFullDayEnd) {
+            return $start->toDateString().' ~ '.$inclusiveEnd->toDateString();
+        }
+
+        return $start->format('Y-m-d H:i:s').' ~ '.$inclusiveEnd->format('Y-m-d H:i:s');
+    }
+
+    /**
+     * @return array<int, string>
+     */
+    private function formatMessages(string $periodLabel, Collection $records): array
+    {
+        $title = "{$periodLabel} ERP OpenAPI 请求统计";
+
+        if ($records->isEmpty()) {
+            return ["{$title}\n无请求记录"];
+        }
+
+        $messages = [$title];
+
+        foreach ($records->groupBy(fn ($record) => $record->agent_name."\0".$record->agent_code) as $companyRecords) {
+            $first = $companyRecords->first();
+            $company = trim(($first->agent_name ?: '未知机构').' '.($first->agent_code ?: ''));
+
+            $this->appendCompanyRecords($messages, $title, $company, $companyRecords);
+        }
+
+        if (count($messages) === 1) {
+            return $messages;
+        }
+
+        return array_map(
+            fn (string $message, int $index) => "{$message}（第 ".($index + 1).'/'.count($messages).' 条）',
+            $messages,
+            array_keys($messages)
+        );
+    }
+
+    private function appendCompanyRecords(array &$messages, string $title, string $company, Collection $records): void
+    {
+        foreach ($records->values() as $index => $record) {
+            $line = $this->formatRequestLine($record);
+            $messageIndex = array_key_last($messages);
+            $isFirstRecord = $index === 0;
+            $addition = $isFirstRecord
+                ? "\n\n{$company}\n{$line}"
+                : "\n{$line}";
+
+            if (strlen($messages[$messageIndex].$addition) <= self::MAX_MESSAGE_BYTES) {
+                $messages[$messageIndex] .= $addition;
+
+                continue;
+            }
+
+            $messages[] = "{$title}\n\n{$company}\n{$line}";
+        }
+    }
+
+    private function formatRequestLine(object $record): string
+    {
+        $uri = explode('?', (string) $record->request_uri, 2)[0];
+        $uri = preg_replace('/[\\x00-\\x1F\\x7F]/u', '', $uri) ?? '';
+
+        return Str::limit($uri, 1_000, '…')." {$record->request_count}次";
+    }
+}

app/Services/JiraService.php

@@ -331,6 +331,16 @@ class JiraService
                     ['name' => 'portal-ticket-fe-web', 'location' => '法兰克福&中国'],
                 ],
             ],
+            'mono' => [
+                'label' => 'mono',
+                'system' => 'SP',
+                'current_version' => $this->resolveTestMailCurrentVersion('portal-mono-be', '1.11.0.0'),
+                'database_enabled' => false,
+                'containers' => [
+                    ['name' => 'portal-mono-be-aplct', 'location' => '中国'],
+                    ['name' => 'portal-mono-be-web', 'location' => '中国'],
+                ],
+            ],
         ];
 
         foreach ($containerGroups as &$group) {
@@ -368,10 +378,15 @@ class JiraService
     }
 
     private function nextTestMailVersion(string $version): string
+    {
+        return $this->nextMinorVersion($version) ?? $version;
+    }
+
+    private function nextMinorVersion(string $version): ?string
     {
         $parts = explode('.', trim($version));
         if (count($parts) < 2 || ! ctype_digit($parts[1])) {
-            return $version;
+            return null;
         }
 
         $parts[1] = (string) ((int) $parts[1] + 1);
@@ -379,6 +394,20 @@ class JiraService
         return implode('.', $parts);
     }
 
+    private function buildFallbackReleaseVersion(string $currentVersion): ?array
+    {
+        $version = $this->nextMinorVersion($currentVersion);
+        if ($version === null) {
+            return null;
+        }
+
+        return [
+            'version' => $version,
+            'description' => null,
+            'release_date' => null,
+        ];
+    }
+
     public function buildTestMailDatabases(array $selectedGroups, array $versions): array
     {
         $defaults = $this->getTestMailTemplateDefaults();
@@ -389,6 +418,9 @@ class JiraService
                 continue;
             }
             $group = $defaults['container_groups'][$groupKey];
+            if (($group['database_enabled'] ?? true) === false) {
+                continue;
+            }
             $version = trim((string) ($versions[$groupKey] ?? $group['default_version'] ?? ''));
             $branch = $version !== '' ? 'release/'.$version : '';
             $exists = $branch !== '' && $this->gitBranchExists($group['db_project'], $branch);
@@ -1498,7 +1530,7 @@ class JiraService
                 ->first();
 
             if (! $candidate) {
-                return null;
+                return $this->buildFallbackReleaseVersion($currentVersion);
             }
 
             return [
@@ -1517,7 +1549,7 @@ class JiraService
             ->first();
 
         if (! $candidate) {
-            return null;
+            return $this->buildFallbackReleaseVersion($currentVersion);
         }
 
         return [

app/Services/ProductionDiagnosisService.php

@@ -3,7 +3,9 @@
 namespace App\Services;
 
 use App\Clients\CrmClient;
+use App\Enums\CaseLabelBit;
 use Illuminate\Support\Facades\DB;
+use Illuminate\Support\Facades\Log;
 
 /**
  * 进产诊断服务
@@ -18,15 +20,31 @@ use Illuminate\Support\Facades\DB;
 class ProductionDiagnosisService
 {
     public const TYPE_CASE = 'case';
+
     public const TYPE_BUSINESS = 'business_document';
+
     public const TYPE_SALE = 'sale_document';
 
+    /** @var string agent-be configs 表中的卡款原因配置键 */
+    private const STUCK_PAYMENT_REASON_KEY = 'stuck_payment_reason';
+
+    /**
+     * 读不到 configs 表时的兜底，与当前生产配置保持一致
+     *
+     * @var array<int,string>
+     */
+    private const DEFAULT_STUCK_PAYMENT_REASONS = [
+        CaseLabelBit::APPLIANCE_NEED_MONEY => '新病例进产',
+        CaseLabelBit::UPGRADE_NEED_MONEY => '转产品',
+    ];
+
     /** @var string agent-be 数据库连接名 */
     private string $connection = 'agentslave';
 
-    public function __construct(private readonly CrmClient $crm)
-    {
-    }
+    /** @var string CRM 数据库连接名，用于回溯 label_bit 原始值 */
+    private string $crmConnection = 'crmslave';
+
+    public function __construct(private readonly CrmClient $crm) {}
 
     /**
      * 执行单次诊断
@@ -36,7 +54,7 @@ class ProductionDiagnosisService
         $code = trim($code);
         $entity = $this->findEntity($type, $code);
 
-        if (!$entity) {
+        if (! $entity) {
             return [
                 'type' => $type,
                 'type_label' => $this->typeLabel($type),
@@ -49,11 +67,13 @@ class ProductionDiagnosisService
         $operatorCode = (string) $entity->agent_code;
         $operatorAgent = $this->findAgent($operatorCode);
         $checks = [];
+        $pfpContext = null;
 
         $checks['status'] = $this->checkStatus($type, $entity);
 
         if ($type === self::TYPE_CASE) {
-            $checks['need_pfp'] = $this->checkNeedPfp($entity);
+            $pfpContext = $this->buildPfpContext($entity, $operatorCode);
+            $checks['need_pfp'] = $this->checkNeedPfp($pfpContext);
         }
 
         $checks['owner_agent'] = $this->checkOwnerAgent($type, $entity, $operatorCode);
@@ -66,7 +86,7 @@ class ProductionDiagnosisService
             'type_label' => $this->typeLabel($type),
             'code' => $code,
             'found' => true,
-            'entity' => $this->normalizeEntity($type, $entity),
+            'entity' => $this->normalizeEntity($type, $entity, $pfpContext),
             'operating_agent_code' => $operatorCode,
             'operating_agent' => $operatorAgent ? [
                 'code' => (string) $operatorAgent->code,
@@ -144,29 +164,301 @@ class ProductionDiagnosisService
     }
 
     /**
-     * 病例放行检查 - case.is_need_pfp > 0
+     * 进产原因检查 - case.is_need_pfp 位图
+     *
+     * is_need_pfp 来源于 CRM 的 ea_case_cstm.label_bit，经 stuck_payment_reason
+     * 配置过滤后写入代理库；只有存在卡款原因的病例才会走代理端进产流程。
+     *
+     * @param  array<string,mixed>  $ctx  buildPfpContext 的返回值
      */
-    private function checkNeedPfp(object $caseEntity): array
+    private function checkNeedPfp(array $ctx): array
     {
-        $isNeedPfp = (int) ($caseEntity->is_need_pfp ?? 0);
-        $isPfp = (int) ($caseEntity->is_pfp ?? 0);
-        $pass = $isNeedPfp > 0;
+        $pass = $ctx['is_need_pfp'] > 0;
+        $reasonText = $ctx['reason_text'];
 
-        $detail = $pass
-            ? '病例 is_need_pfp = '.$isNeedPfp.'，命中放行节点'
-            : '病例 is_need_pfp = 0，不需要放行（非欠款病例，不会触发进产流程）';
+        $actual = $pass
+            ? sprintf('进产原因：%s（is_need_pfp = %d）', $reasonText, $ctx['is_need_pfp'])
+            : sprintf('无进产原因（is_need_pfp = 0）；放行状态：%s', $ctx['is_pfp_text']);
 
         return [
             'key' => 'need_pfp',
-            'label' => '放行节点检查 (is_need_pfp)',
+            'label' => '进产原因检查',
             'pass' => $pass,
-            'expected' => 'is_need_pfp > 0',
-            'actual' => 'is_need_pfp = '.$isNeedPfp.', is_pfp = '.$isPfp,
-            'detail' => $detail,
-            'hint' => $pass ? null : '检查 stuck_payment_reason 配置以及病例账期推算逻辑',
+            'expected' => '病例存在卡生产原因（'.$this->configOptionText($ctx).'）',
+            'actual' => $actual,
+            'detail' => $this->pfpDetail($ctx, $pass),
+            'hint' => $pass ? null : $this->pfpHint($ctx),
+        ] + $ctx;
+    }
+
+    /**
+     * 汇总进产原因所需的全部上下文：代理库位图、配置项、CRM 原始 label_bit
+     *
+     * @return array<string,mixed>
+     */
+    private function buildPfpContext(object $caseEntity, string $operatorCode): array
+    {
+        $isNeedPfp = (int) ($caseEntity->is_need_pfp ?? 0);
+        $isPfp = (int) ($caseEntity->is_pfp ?? 0);
+
+        $config = $this->stuckPaymentReasonConfig($operatorCode);
+        $reasons = $this->describeReasons($isNeedPfp, $config['reasons']);
+
+        $crmLabelBit = $this->crmLabelBit((string) $caseEntity->case_code);
+        $crmAvailable = $crmLabelBit !== null;
+        $expectedNeedPfp = $crmAvailable ? ($crmLabelBit & $config['mask']) : null;
+
+        // CRM 上有卡款标记，但对应的 bit 没有配进 stuck_payment_reason，代理端会直接忽略
+        $ignoredBits = $crmAvailable
+            ? array_values(array_filter(
+                CaseLabelBit::split($crmLabelBit & ~$config['mask']),
+                static fn (int $bit): bool => $bit !== CaseLabelBit::ALLOW_PROCESS_BY_HONEST
+            ))
+            : [];
+
+        return [
+            'is_need_pfp' => $isNeedPfp,
+            'is_pfp' => $isPfp,
+            'is_pfp_text' => $isPfp > 0 ? '已放行' : '未放行',
+            'reasons' => $reasons,
+            'reason_text' => $reasons === [] ? '无' : implode(' / ', array_column($reasons, 'label')),
+            'config_mask' => $config['mask'],
+            'config_source' => $config['source'],
+            'config_source_text' => $this->configSourceText($config['source']),
+            'config_options' => array_map(
+                static fn (int $bit, string $label): array => ['bit' => $bit, 'label' => $label],
+                array_keys($config['reasons']),
+                array_values($config['reasons'])
+            ),
+            'crm_available' => $crmAvailable,
+            'crm_label_bit' => $crmLabelBit,
+            'crm_label_bit_text' => $crmAvailable ? CaseLabelBit::toText($crmLabelBit) : '未知（CRM 库不可读）',
+            'crm_ignored_reasons' => array_map(
+                static fn (int $bit): array => [
+                    'bit' => $bit,
+                    'label' => CaseLabelBit::crmLabel($bit),
+                    'description' => CaseLabelBit::description($bit),
+                ],
+                $ignoredBits
+            ),
+            'expected_is_need_pfp' => $expectedNeedPfp,
+            'sync_mismatch' => $expectedNeedPfp !== null && $expectedNeedPfp !== $isNeedPfp,
         ];
     }
 
+    /**
+     * 把位图翻译成用户可读的进产原因
+     *
+     * @param  array<int,string>  $configReasons
+     * @return array<int,array<string,mixed>>
+     */
+    private function describeReasons(int $bitmap, array $configReasons): array
+    {
+        return array_map(
+            static fn (int $bit): array => [
+                'bit' => $bit,
+                'label' => $configReasons[$bit] ?? CaseLabelBit::crmLabel($bit),
+                'crm_label' => CaseLabelBit::crmLabel($bit),
+                'description' => CaseLabelBit::description($bit),
+            ],
+            CaseLabelBit::split($bitmap)
+        );
+    }
+
+    /**
+     * 读取 agent-be configs 表中的 stuck_payment_reason
+     *
+     * 复现 ConfigService::getOne 的取值顺序：代理自身配置 → 全局配置 → 兜底默认值。
+     *
+     * @return array{reasons: array<int,string>, mask: int, source: string}
+     */
+    private function stuckPaymentReasonConfig(string $operatorCode): array
+    {
+        try {
+            $rows = DB::connection($this->connection)
+                ->table('configs')
+                ->where('key', self::STUCK_PAYMENT_REASON_KEY)
+                ->whereIn('agent_code', array_values(array_unique([$operatorCode, ''])))
+                ->get();
+
+            $row = $rows->firstWhere('agent_code', $operatorCode) ?: $rows->firstWhere('agent_code', '');
+            $reasons = $this->parseStuckPaymentReasons($row->val ?? null);
+
+            if ($reasons !== []) {
+                return [
+                    'reasons' => $reasons,
+                    'mask' => $this->maskOf($reasons),
+                    'source' => ((string) ($row->agent_code ?? '')) === '' ? 'global' : 'agent',
+                ];
+            }
+        } catch (\Throwable $e) {
+            Log::warning('读取 stuck_payment_reason 配置失败，使用默认卡款原因。', ['exception' => $e]);
+        }
+
+        return [
+            'reasons' => self::DEFAULT_STUCK_PAYMENT_REASONS,
+            'mask' => $this->maskOf(self::DEFAULT_STUCK_PAYMENT_REASONS),
+            'source' => 'default',
+        ];
+    }
+
+    /**
+     * configs.val 形如 [{"key":2,"lable":"新病例进产"},{"key":4,"lable":"转产品"}]
+     * 线上配置的 label 字段存在 lable 拼写，两种都兼容
+     *
+     * @return array<int,string>
+     */
+    private function parseStuckPaymentReasons(mixed $val): array
+    {
+        if (is_string($val)) {
+            $val = json_decode($val, true);
+        }
+
+        if (! is_array($val)) {
+            return [];
+        }
+
+        $reasons = [];
+        foreach ($val as $item) {
+            $bit = (int) (is_array($item) ? ($item['key'] ?? 0) : 0);
+            if ($bit <= 0) {
+                continue;
+            }
+            $label = (string) ($item['lable'] ?? $item['label'] ?? '');
+            $reasons[$bit] = $label !== '' ? $label : CaseLabelBit::crmLabel($bit);
+        }
+
+        return $reasons;
+    }
+
+    /**
+     * 复现 DebtEnum::needMoney - 所有配置项 key 的按位或
+     *
+     * @param  array<int,string>  $reasons
+     */
+    private function maskOf(array $reasons): int
+    {
+        $mask = 0;
+        foreach (array_keys($reasons) as $bit) {
+            $mask |= $bit;
+        }
+
+        return $mask;
+    }
+
+    /**
+     * 直查 CRM 库的 ea_case_cstm.label_bit，用于判断代理库是否同步到位
+     */
+    private function crmLabelBit(string $caseCode): ?int
+    {
+        if ($caseCode === '') {
+            return null;
+        }
+
+        try {
+            $value = DB::connection($this->crmConnection)
+                ->table('ea_case as c')
+                ->join('ea_case_cstm as cc', 'cc.id_c', '=', 'c.id')
+                ->where('c.name', $caseCode)
+                ->where('c.deleted', 0)
+                ->value('cc.label_bit');
+
+            return $value === null ? null : (int) $value;
+        } catch (\Throwable $e) {
+            Log::warning('读取 CRM label_bit 失败，跳过同步比对。', ['case_code' => $caseCode, 'exception' => $e]);
+
+            return null;
+        }
+    }
+
+    /**
+     * @param  array<string,mixed>  $ctx
+     */
+    private function pfpDetail(array $ctx, bool $pass): string
+    {
+        if ($pass) {
+            $detail = sprintf('病例因「%s」被卡在生产前，需要代理确认进产后才会放行。', $ctx['reason_text']);
+
+            if ($ctx['is_pfp'] > 0) {
+                $detail .= '该病例已放行（is_pfp = 1）。';
+            }
+
+            if ($ctx['sync_mismatch']) {
+                $detail .= sprintf(
+                    '注意：CRM 当前 label_bit = %d，按配置应为 is_need_pfp = %d，与代理库不一致。',
+                    $ctx['crm_label_bit'],
+                    $ctx['expected_is_need_pfp']
+                );
+            }
+
+            return $detail;
+        }
+
+        if ($ctx['sync_mismatch'] && $ctx['expected_is_need_pfp'] > 0) {
+            return sprintf(
+                'CRM 已标记「%s」，按配置应写入 is_need_pfp = %d，但代理库仍为 0，疑似 case_basic_info_change 事件未消费或延迟。',
+                CaseLabelBit::toText($ctx['expected_is_need_pfp']),
+                $ctx['expected_is_need_pfp']
+            );
+        }
+
+        if ($ctx['crm_ignored_reasons'] !== []) {
+            return sprintf(
+                'CRM 标记了「%s」，但该原因未纳入 stuck_payment_reason 配置（当前仅 %s），代理端不会产生进产原因。',
+                implode(' / ', array_column($ctx['crm_ignored_reasons'], 'label')),
+                $this->configOptionText($ctx)
+            );
+        }
+
+        if ($ctx['crm_available'] && $ctx['crm_label_bit'] === 0) {
+            return '病例在 CRM 侧没有任何卡生产标记，属于正常病例，不需要也无法走代理进产流程。';
+        }
+
+        return '病例没有卡生产原因（is_need_pfp = 0），不需要代理放行，进产流程不会对该病例生效。';
+    }
+
+    /**
+     * @param  array<string,mixed>  $ctx
+     */
+    private function pfpHint(array $ctx): string
+    {
+        if ($ctx['sync_mismatch'] && $ctx['expected_is_need_pfp'] > 0) {
+            return '检查 agent-be 是否正常消费 CRM 的病例变更事件，必要时重新推送该病例的 case_basic_info_change 消息';
+        }
+
+        if ($ctx['crm_ignored_reasons'] !== []) {
+            return '若该原因也需要代理放行，需在 agent-be configs 表的 stuck_payment_reason 中补充对应 key';
+        }
+
+        if (! $ctx['crm_available']) {
+            return '未能读取 CRM 的 ea_case_cstm.label_bit，可检查 crmslave 数据库配置后重新诊断';
+        }
+
+        return '确认该病例是否确实需要卡款放行；正常病例由 CRM 直接进产，无需代理操作';
+    }
+
+    /**
+     * @param  array<string,mixed>  $ctx
+     */
+    private function configOptionText(array $ctx): string
+    {
+        $options = array_map(
+            static fn (array $option): string => sprintf('%s(%d)', $option['label'], $option['bit']),
+            $ctx['config_options']
+        );
+
+        return $options === [] ? '未配置任何卡款原因' : implode('、', $options);
+    }
+
+    private function configSourceText(string $source): string
+    {
+        return match ($source) {
+            'agent' => '代理级 configs 配置',
+            'global' => '全局 configs 配置',
+            default => '内置默认配置（未读到 configs 表）',
+        };
+    }
+
     /**
      * 归属代理检查 - 必须满足:
      *   1) entity.agent_code === operatorCode
@@ -190,7 +482,7 @@ class ProductionDiagnosisService
         $detail = match (true) {
             $entityAgentCode === '' => '归属代理 agent_code 为空，无法定位操作代理',
             $entityAgentCode !== $operatorCode => '当前操作代理 '.$operatorCode.' 与单据归属代理 '.$entityAgentCode.' 不一致',
-            !$exists => '结算代理表 '.$settlementTable.' 中未找到 code='.$entityCode.', agent_code='.$operatorCode.' 的有效记录',
+            ! $exists => '结算代理表 '.$settlementTable.' 中未找到 code='.$entityCode.', agent_code='.$operatorCode.' 的有效记录',
             default => '操作代理为归属代理，且在结算代理表中存在有效记录',
         };
 
@@ -219,7 +511,7 @@ class ProductionDiagnosisService
     {
         $productCode = (string) ($entity->product_code ?? '');
 
-        if (!$operatorAgent) {
+        if (! $operatorAgent) {
             return [
                 'key' => 'credit',
                 'label' => '账期检查',
@@ -249,7 +541,7 @@ class ProductionDiagnosisService
             ->where('deleted', 0)
             ->first();
 
-        if (!$relation) {
+        if (! $relation) {
             return [
                 'key' => 'credit',
                 'label' => '账期检查',
@@ -303,9 +595,9 @@ class ProductionDiagnosisService
         $pass = $lastCreditAgentCode !== '' && $lastCreditAgentCode === $operatorCode;
 
         $detail = match (true) {
-            !$crmConfigured => 'CRM 接口未配置（CRM_SERVICE_BASE_URI），一级代理账期视为「未知」，链路计算可能与生产不一致',
+            ! $crmConfigured => 'CRM 接口未配置（CRM_SERVICE_BASE_URI），一级代理账期视为「未知」，链路计算可能与生产不一致',
             $firstAgentCreditMap === null => '调用 CRM 一级代理详情失败，无法判断一级代理账期',
-            !$firstAgentHasCredit => '一级代理 '.$rootAgentCode.' 在产品 '.$productCode.' 上无账期，AgentCredit 返回空，账期判断必然失败',
+            ! $firstAgentHasCredit => '一级代理 '.$rootAgentCode.' 在产品 '.$productCode.' 上无账期，AgentCredit 返回空，账期判断必然失败',
             $lastCreditAgentCode === '' => '账期链路计算结果为空',
             $pass => '最后一级有账期的代理 = 单据归属代理（'.$operatorCode.'）',
             default => '最后一级有账期的代理为 '.$lastCreditAgentCode.'，与单据归属代理 '.$operatorCode.' 不一致',
@@ -348,7 +640,7 @@ class ProductionDiagnosisService
             'credit_source' => 'crm:getAgentByCode',
         ];
 
-        if (!$firstAgentHasCredit) {
+        if (! $firstAgentHasCredit) {
             return [
                 'last_credit_agent_code' => '',
                 'chain' => $chainView,
@@ -377,8 +669,9 @@ class ProductionDiagnosisService
                 continue;
             }
 
-            if (!$hasCredit) {
+            if (! $hasCredit) {
                 $broken = true;
+
                 continue;
             }
 
@@ -520,7 +813,10 @@ class ProductionDiagnosisService
         return $type === self::TYPE_CASE ? (string) $entity->case_code : (string) $entity->code;
     }
 
-    private function normalizeEntity(string $type, object $entity): array
+    /**
+     * @param  array<string,mixed>|null  $pfpContext
+     */
+    private function normalizeEntity(string $type, object $entity, ?array $pfpContext = null): array
     {
         $base = [
             'status' => (int) $entity->status,
@@ -538,6 +834,9 @@ class ProductionDiagnosisService
                 'patient_name' => (string) ($entity->patient_name ?? ''),
                 'is_need_pfp' => (int) ($entity->is_need_pfp ?? 0),
                 'is_pfp' => (int) ($entity->is_pfp ?? 0),
+                'debt_reason_text' => $pfpContext['reason_text'] ?? '无',
+                'is_pfp_text' => $pfpContext['is_pfp_text'] ?? ((int) ($entity->is_pfp ?? 0) > 0 ? '已放行' : '未放行'),
+                'crm_label_bit_text' => $pfpContext['crm_label_bit_text'] ?? '未知',
             ];
         }
 
@@ -549,13 +848,13 @@ class ProductionDiagnosisService
 
     private function creditHint(bool $crmConfigured, ?array $firstAgentCreditMap, bool $firstAgentHasCredit): string
     {
-        if (!$crmConfigured) {
+        if (! $crmConfigured) {
             return '配置 .env 中的 CRM_SERVICE_BASE_URI 后可获得准确的一级代理账期判断';
         }
         if ($firstAgentCreditMap === null) {
             return 'CRM 接口调用失败，可查看 laravel.log';
         }
-        if (!$firstAgentHasCredit) {
+        if (! $firstAgentHasCredit) {
             return '需在 CRM 「集团详情」productList 中确认该产品的 agentAccountingPeriod > 0';
         }
 

app/Services/ScheduledTaskService.php

@@ -23,6 +23,7 @@ class ScheduledTaskService
         try {
             self::$configServiceInstance ??= app(ConfigService::class);
             $enabled = self::$configServiceInstance->get(self::CONFIG_KEY, []);
+
             return $enabled[$name] ?? false;
         } catch (\Exception $e) {
             return false;
@@ -70,7 +71,7 @@ class ScheduledTaskService
             }
         }
 
-        if (!$exists) {
+        if (! $exists) {
             throw new \InvalidArgumentException("未知任务: {$name}");
         }
 
@@ -111,8 +112,10 @@ class ScheduledTaskService
             if (str_contains($command, 'artisan')) {
                 $command = preg_replace('/^.*artisan\s+/', '', $command);
             }
+
             return trim(str_replace("'", '', $command));
         }
+
         return 'closure';
     }
 
@@ -132,9 +135,11 @@ class ScheduledTaskService
             '0 0 * * *' => '每天凌晨 0:00',
             '0 2 * * *' => '每天凌晨 2:00',
             '0 3 * * *' => '每天凌晨 3:00',
+            '0 8 * * *' => '每天早上 08:00',
             '0 0 * * 0' => '每周日凌晨',
             '0 0 1 * *' => '每月 1 日凌晨',
         ];
+
         return $map[$expression] ?? $expression;
     }
 
@@ -149,9 +154,11 @@ class ScheduledTaskService
             'daily-log-analysis' => 'SLS 日志分析 - 每日分析过去 24 小时日志',
             'frequent-log-analysis' => 'SLS 日志分析 - 定期分析过去 6 小时日志',
             'jenkins-monitor' => 'Jenkins 发布监控 - 检查新构建并发送通知',
+            'erp-request-report' => 'ERP 请求日报 - 汇总前一天 OpenAPI 请求并发送钉钉',
             'scheduled-task-refresh' => '定时任务管理 - 刷新定时任务列表',
             'logs-cleanup' => '日志清理 - 自动删除 7 天前的定时任务日志',
         ];
+
         return $descriptions[$name] ?? $name;
     }
 }