companyId = $companyId; return $this; } /** * 设置飞书应用ID(必须指定) */ public function setApp(int $appId): self { $this->appId = $appId; return $this; } /** * 根据用户ID自动设置其最后登录的应用 */ public function setAppByUser(int $userId): self { $user = \app\model\User::find($userId); if (!$user) { throw new Exception('用户不存在'); } $this->setCompany($user->company_id); // 使用用户最后登录的应用 if ($user->feishu_app_id) { $this->appId = $user->feishu_app_id; } else { throw new Exception('用户未绑定飞书应用,请先通过飞书登录'); } return $this; } /** * 获取飞书应用配置(必须先通过 setApp 或 setAppByUser 指定) */ private function getAppConfig(): array { if (!$this->companyId) { throw new Exception('未设置公司ID'); } if (!$this->appId) { throw new Exception('未指定飞书应用,请通过 setApp() 或 setAppByUser() 指定'); } $app = \app\model\CompanyFeishuApp::where('company_id', $this->companyId) ->where('id', $this->appId) ->where('status', 1) ->first(); if (!$app) { throw new Exception('指定的飞书应用不存在或未启用'); } return $app->toArray(); } /** * 获取 access_token */ private function getAccessToken(): string { $app = $this->getAppConfig(); return FeishuUtil::getAppAccessToken($app['id']); } /** * 获取用户在指定飞书应用下的 feishu_user_id */ private function getFeishuUserId(int $userId, int $companyId): ?string { if (!$this->appId) { throw new Exception('未指定飞书应用,请先调用 setApp() 或 setAppByUser()'); } $binding = \app\model\UserFeishuApp::where('user_id', $userId) ->where('company_id', $companyId) ->where('feishu_app_id', $this->appId) ->first(); return $binding ? $binding->feishu_user_id : null; } /** * 发送审批通知 * * @param array $params * - user_id: 接收人ID * - title: 通知标题 * - applicant: 申请人姓名 * - type: 申请类型 * - content: 申请内容摘要 * - url: 详情链接 * - order_id: 审批单ID(用于构建审批操作按钮) * @return bool */ public function sendApprovalNotification(array $params): bool { $userId = $params['user_id'] ?? null; $applicantId = $params['applicant_id'] ?? null; error_log("📧 sendApprovalNotification 被调用: user_id={$userId}, applicant_id=" . ($applicantId ?? 'null')); if (!$userId) { error_log('❌ sendApprovalNotification: 缺少 user_id'); return false; } try { $user = User::find($userId); if (!$user) { error_log("❌ sendApprovalNotification: 用户不存在, user_id={$userId}"); return false; } // 从 user_feishu_apps 获取指定应用下的 feishu_user_id $feishuUserId = $this->getFeishuUserId($userId, $user->company_id); if (!$feishuUserId) { error_log("❌ sendApprovalNotification: 用户未绑定飞书应用, user_id={$userId}"); return false; } // 检查是否是申请人自己 - 发送文本消息而不是卡片 error_log("🔍 自审批检查前: applicant_id=" . var_export($applicantId, true) . ", user_id=" . var_export($userId, true)); if ($applicantId && (int)$applicantId === (int)$userId) { error_log("🔄 检测到自审批,发送文本通知而不是卡片"); return $this->sendTextNotification($feishuUserId, $params); } error_log("📨 发送卡片消息: 不是自审批"); $card = $this->buildApprovalCard($params, $user->company_id); return $this->sendMessage($feishuUserId, $card); } catch (Exception $e) { error_log('❌ sendApprovalNotification 失败: ' . $e->getMessage()); return false; } } /** * 发送系统通知 * * @param array $params * - user_ids: 接收人ID数组 * - title: 通知标题 * - content: 通知内容 * - url: 跳转链接(可选) * @return array 返回每个用户的发送结果 */ public function sendSystemNotification(array $params): array { $userIds = $params['user_ids'] ?? []; if (empty($userIds)) { error_log('❌ sendSystemNotification: 缺少 user_ids'); return []; } $results = []; foreach ($userIds as $userId) { try { $user = User::find($userId); if (!$user) { $results[$userId] = false; continue; } // 从 user_feishu_apps 获取指定应用下的 feishu_user_id $feishuUserId = $this->getFeishuUserId($userId, $user->company_id); if (!$feishuUserId) { $results[$userId] = false; continue; } $card = $this->buildSystemCard($params, $user->company_id); $results[$userId] = $this->sendMessage($feishuUserId, $card); } catch (Exception $e) { error_log("❌ sendSystemNotification 失败: user_id={$userId}, error=" . $e->getMessage()); $results[$userId] = false; } } return $results; } /** * 发送提醒通知 * * @param array $params * - user_id: 接收人ID * - title: 提醒标题 * - content: 提醒内容 * - level: 提醒级别 (info/warning/urgent) * - url: 跳转链接(可选) * @return bool */ public function sendReminderNotification(array $params): bool { $userId = $params['user_id'] ?? null; if (!$userId) { error_log('❌ sendReminderNotification: 缺少 user_id'); return false; } try { $user = User::find($userId); if (!$user) { error_log("❌ sendReminderNotification: 用户不存在, user_id={$userId}"); return false; } // 从 user_feishu_apps 获取指定应用下的 feishu_user_id $feishuUserId = $this->getFeishuUserId($userId, $user->company_id); if (!$feishuUserId) { error_log("❌ sendReminderNotification: 用户未绑定飞书应用, user_id={$userId}"); return false; } $card = $this->buildReminderCard($params, $user->company_id); return $this->sendMessage($feishuUserId, $card); } catch (Exception $e) { error_log('❌ sendReminderNotification 失败: ' . $e->getMessage()); return false; } } /** * 批量发送通知 * * @param array $params * - user_ids: 接收人ID数组 * - type: 通知类型 (approval/system/reminder) * - 其他参数根据类型不同而不同 * @return array */ public function sendBatchNotification(array $params): array { $userIds = $params['user_ids'] ?? []; $type = $params['type'] ?? 'system'; $results = []; foreach ($userIds as $userId) { $notifyParams = array_merge($params, ['user_id' => $userId]); unset($notifyParams['user_ids']); switch ($type) { case 'approval': $results[$userId] = $this->sendApprovalNotification($notifyParams); break; case 'reminder': $results[$userId] = $this->sendReminderNotification($notifyParams); break; case 'system': default: $results[$userId] = $this->sendSystemNotification(['user_ids' => [$userId]] + $params)[$userId] ?? false; break; } } return $results; } /** * 构建审批通知卡片 */ private function buildApprovalCard(array $params, int $recipientCompanyId): array { $title = $params['title'] ?? '新的审批申请'; $applicant = $params['applicant'] ?? '未知'; $type = $params['type'] ?? '申请'; $content = $params['content'] ?? ''; $url = $params['url'] ?? ''; $orderId = $params['order_id'] ?? null; // 构建卡片元素 $elements = []; // 内容区域 if ($content) { $elements[] = [ 'tag' => 'div', 'text' => [ 'content' => "**申请人**: {$applicant}\n**申请类型**: {$type}\n\n{$content}", 'tag' => 'lark_md', ], ]; } else { $elements[] = [ 'tag' => 'div', 'text' => [ 'content' => "**申请人**: {$applicant}\n**申请类型**: {$type}", 'tag' => 'lark_md', ], ]; } // 提示信息(如需备注请去详情页) if ($orderId) { $elements[] = [ 'tag' => 'div', 'text' => [ 'content' => "_如需添加备注,请点击「查看详情」进入详情页操作_", 'tag' => 'lark_md', ], ]; } // 按钮区域:三个按钮在一行 $buttonActions = []; // 通过按钮 if ($orderId) { $buttonActions[] = [ 'tag' => 'button', 'text' => [ 'content' => '通过', 'tag' => 'plain_text', ], 'type' => 'primary', 'size' => 'medium', 'value' => [ 'action_type' => 'approve', 'order_id' => (int)$orderId, ], ]; // 拒绝按钮 $buttonActions[] = [ 'tag' => 'button', 'text' => [ 'content' => '拒绝', 'tag' => 'plain_text', ], 'type' => 'danger', 'size' => 'medium', 'value' => [ 'action_type' => 'reject', 'order_id' => (int)$orderId, ], ]; } // 查看详情按钮(跳转链接) if ($url) { $separator = strpos($url, '?') !== false ? '&' : '?'; $urlWithCompany = $url . $separator . 'company=' . $recipientCompanyId; $buttonActions[] = [ 'tag' => 'button', 'text' => [ 'content' => '查看详情', 'tag' => 'plain_text', ], 'type' => 'default', 'size' => 'medium', 'url' => $urlWithCompany, ]; } // 将所有按钮放在一个 action 元素中(会横向排列) if (!empty($buttonActions)) { $elements[] = [ 'tag' => 'action', 'actions' => $buttonActions, ]; } return [ 'config' => [ 'wide_screen_mode' => false, ], 'header' => [ 'title' => [ 'content' => "📋 {$title}", 'tag' => 'plain_text', ], 'template' => 'blue', ], 'elements' => $elements, ]; } /** * 构建系统通知卡片 */ private function buildSystemCard(array $params, int $recipientCompanyId): array { $title = $params['title'] ?? '系统通知'; $content = $params['content'] ?? ''; $url = $params['url'] ?? ''; $elements = []; if ($content) { $elements[] = [ 'tag' => 'div', 'text' => [ 'content' => $content, 'tag' => 'lark_md', ], ]; } if ($url) { // 在 URL 后面添加公司参数 $separator = strpos($url, '?') !== false ? '&' : '?'; $urlWithCompany = $url . $separator . 'company=' . $recipientCompanyId; $elements[] = [ 'tag' => 'action', 'actions' => [ [ 'tag' => 'button', 'text' => [ 'content' => '查看详情', 'tag' => 'plain_text', ], 'type' => 'default', 'url' => $urlWithCompany, ], ], ]; } return [ 'config' => [ 'wide_screen_mode' => false, ], 'header' => [ 'title' => [ 'content' => "🔔 {$title}", 'tag' => 'plain_text', ], 'template' => 'gray', ], 'elements' => $elements, ]; } /** * 构建提醒通知卡片 */ private function buildReminderCard(array $params, int $recipientCompanyId): array { $title = $params['title'] ?? '提醒'; $content = $params['content'] ?? ''; $level = $params['level'] ?? 'info'; // info, warning, urgent $url = $params['url'] ?? ''; // 根据级别选择模板颜色 $templateMap = [ 'info' => 'blue', 'warning' => 'orange', 'urgent' => 'red', ]; $template = $templateMap[$level] ?? 'blue'; // 根据级别选择图标 $iconMap = [ 'info' => '💡', 'warning' => '⚠️', 'urgent' => '🚨', ]; $icon = $iconMap[$level] ?? '💡'; $elements = []; if ($content) { $elements[] = [ 'tag' => 'div', 'text' => [ 'content' => $content, 'tag' => 'plain_text', ], ]; } if ($url) { // 在 URL 后面添加公司参数 $separator = strpos($url, '?') !== false ? '&' : '?'; $urlWithCompany = $url . $separator . 'company=' . $recipientCompanyId; $elements[] = [ 'tag' => 'action', 'actions' => [ [ 'tag' => 'button', 'text' => [ 'content' => '查看', 'tag' => 'plain_text', ], 'type' => 'primary', 'url' => $urlWithCompany, ], ], ]; } return [ 'config' => [ 'wide_screen_mode' => false, ], 'header' => [ 'title' => [ 'content' => "{$icon} {$title}", 'tag' => 'plain_text', ], 'template' => $template, ], 'elements' => $elements, ]; } /** * 发送消息到飞书 */ private function sendMessage(string $feishuUserId, array $card): bool { try { $app = $this->getAppConfig(); $token = $this->getAccessToken(); $body = [ 'receive_id_type' => 'user_id', 'receive_id' => $feishuUserId, 'msg_type' => 'interactive', 'content' => json_encode(['card' => $card]), ]; error_log('📤 发送飞书消息: app_id=' . $app['app_id'] . ', feishu_user_id=' . $feishuUserId); error_log('📦 消息卡片: ' . json_encode($card, JSON_UNESCAPED_UNICODE)); $content = json_encode($card); error_log('📤 发送的content: ' . $content); $response = HttpClient::httpPost( "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=user_id", [ 'receive_id' => $feishuUserId, 'msg_type' => 'interactive', 'content' => $content, ], [ 'Authorization: Bearer ' . $token, ] ); $code = $response['code'] ?? -1; error_log('📥 飞书响应: code=' . $code . ', msg=' . ($response['msg'] ?? 'null')); if ($code !== 0) { error_log('❌ 飞书消息发送失败: ' . json_encode($response)); } else { error_log('✅ 飞书消息发送成功'); } return $code === 0; } catch (Exception $e) { error_log('❌ sendMessage 异常: ' . $e->getMessage()); return false; } } /** * 发送文本消息(用于自审批场景) */ private function sendTextNotification(string $feishuUserId, array $params): bool { try { $title = $params['title'] ?? '审批申请'; $type = $params['type'] ?? '申请'; $content = $params['content'] ?? ''; $url = $params['url'] ?? ''; // 构建文本内容 $text = "【{$title}】\n"; $text .= "申请类型:{$type}\n"; if ($content) { // 清理 markdown 格式,转为纯文本 $content = preg_replace('/\*\*(.*?)\*\*/', '$1', $content); $content = str_replace('**', '', $content); $text .= "\n{$content}\n"; } if ($url) { $text .= "\n👉 点击查看详情:{$url}"; } // 发送文本消息 return $this->sendText($feishuUserId, $text); } catch (Exception $e) { error_log('❌ sendTextNotification 异常: ' . $e->getMessage()); return false; } } /** * 发送纯文本消息 */ private function sendText(string $feishuUserId, string $text): bool { try { $accessToken = $this->getAccessToken(); if (!$accessToken) { error_log('❌ sendText: 获取 access_token 失败'); return false; } $apiUrl = "https://open.feishu.cn/open-apis/im/v1/messages?receive_id_type=user_id"; $requestData = [ 'receive_id' => $feishuUserId, 'msg_type' => 'text', 'content' => json_encode(['text' => $text]), ]; error_log('📤 发送文本消息: feishu_user_id=' . $feishuUserId . ', text=' . substr($text, 0, 100)); $response = \app\util\HttpClient::httpPost($apiUrl, $requestData, [ 'Authorization: Bearer ' . $accessToken, ]); $responseData = json_decode($response, true); $code = $responseData['code'] ?? -1; if ($code !== 0) { error_log('❌ 发送文本消息失败: ' . json_encode($responseData)); } else { error_log('✅ 文本消息发送成功'); } return $code === 0; } catch (Exception $e) { error_log('❌ sendText 异常: ' . $e->getMessage()); return false; } } }