companyId = $companyId; return $this; } /** * 设置飞书应用ID(支持多应用) */ public function setApp(int $appId): self { $this->appId = $appId; return $this; } /** * 获取飞书应用配置 */ private function getAppConfig(): array { if (!$this->companyId) { throw new Exception('未设置公司ID'); } if ($this->appId) { $app = \app\model\CompanyFeishuApp::find($this->appId); if (!$app || $app->status !== 1) { throw new Exception('飞书应用配置不存在'); } return $app->toArray(); } $app = \app\model\CompanyFeishuApp::where('company_id', $this->companyId) ->where('system_id', 1) ->where('status', 1) ->orderBy('sort') ->first(); if (!$app) { throw new Exception('未配置飞书应用'); } return $app->toArray(); } /** * 获取 access_token */ private function getAccessToken(): string { $app = $this->getAppConfig(); return FeishuUtil::getAppAccessToken($app['id']); } /** * 发送审批通知 * * @param array $params * - user_id: 接收人ID * - title: 通知标题 * - applicant: 申请人姓名 * - type: 申请类型 * - content: 申请内容摘要 * - url: 详情链接 * - approve_url: 通过按钮链接(可选) * - reject_url: 拒绝按钮链接(可选) * @return bool */ public function sendApprovalNotification(array $params): bool { $userId = $params['user_id'] ?? null; if (!$userId) { error_log('❌ sendApprovalNotification: 缺少 user_id'); return false; } try { $user = User::find($userId); if (!$user || !$user->feishu_user_id) { error_log("❌ sendApprovalNotification: 用户不存在或未绑定飞书, user_id={$userId}"); return false; } $card = $this->buildApprovalCard($params); return $this->sendMessage($user->feishu_user_id, $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 || !$user->feishu_user_id) { $results[$userId] = false; continue; } $card = $this->buildSystemCard($params); $results[$userId] = $this->sendMessage($user->feishu_user_id, $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 || !$user->feishu_user_id) { error_log("❌ sendReminderNotification: 用户不存在或未绑定飞书, user_id={$userId}"); return false; } $card = $this->buildReminderCard($params); return $this->sendMessage($user->feishu_user_id, $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): array { $title = $params['title'] ?? '新的审批申请'; $applicant = $params['applicant'] ?? '未知'; $type = $params['type'] ?? '申请'; $content = $params['content'] ?? ''; $url = $params['url'] ?? ''; $approveUrl = $params['approve_url'] ?? ''; $rejectUrl = $params['reject_url'] ?? ''; $elements = [ [ 'tag' => 'div', 'fields' => [ [ 'is_short' => true, 'text' => [ 'content' => "**申请人**: {$applicant}", 'tag' => 'lark_md', ], ], [ 'is_short' => true, 'text' => [ 'content' => "**申请类型**: {$type}", 'tag' => 'lark_md', ], ], ], ], ]; if ($content) { $elements[] = [ 'tag' => 'div', 'text' => [ 'content' => "**申请内容**:\n{$content}", 'tag' => 'lark_md', ], ]; } // 构建操作按钮 $actions = []; if ($approveUrl) { $actions[] = [ 'tag' => 'button', 'text' => [ 'content' => '通过', 'tag' => 'plain_text', ], 'type' => 'primary', 'url' => $approveUrl, ]; } if ($rejectUrl) { $actions[] = [ 'tag' => 'button', 'text' => [ 'content' => '拒绝', 'tag' => 'plain_text', ], 'type' => 'default', 'url' => $rejectUrl, ]; } if ($url) { $actions[] = [ 'tag' => 'button', 'text' => [ 'content' => '查看详情', 'tag' => 'plain_text', ], 'type' => 'default', 'url' => $url, ]; } if (!empty($actions)) { $elements[] = [ 'tag' => 'action', 'actions' => $actions, ]; } return [ 'header' => [ 'title' => [ 'content' => "📋 {$title}", 'tag' => 'plain_text', ], 'template' => 'blue', ], 'elements' => $elements, ]; } /** * 构建系统通知卡片 */ private function buildSystemCard(array $params): array { $title = $params['title'] ?? '系统通知'; $content = $params['content'] ?? ''; $url = $params['url'] ?? ''; $elements = []; if ($content) { $elements[] = [ 'tag' => 'div', 'text' => [ 'content' => $content, 'tag' => 'plain_text', ], ]; } if ($url) { $elements[] = [ 'tag' => 'action', 'actions' => [ [ 'tag' => 'button', 'text' => [ 'content' => '查看详情', 'tag' => 'plain_text', ], 'type' => 'default', 'url' => $url, ], ], ]; } return [ 'header' => [ 'title' => [ 'content' => "🔔 {$title}", 'tag' => 'plain_text', ], 'template' => 'gray', ], 'elements' => $elements, ]; } /** * 构建提醒通知卡片 */ private function buildReminderCard(array $params): 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) { $elements[] = [ 'tag' => 'action', 'actions' => [ [ 'tag' => 'button', 'text' => [ 'content' => '查看', 'tag' => 'plain_text', ], 'type' => 'primary', 'url' => $url, ], ], ]; } return [ 'header' => [ 'title' => [ 'content' => "{$icon} {$title}", 'tag' => 'plain_text', ], 'template' => $template, ], 'elements' => $elements, ]; } /** * 发送消息到飞书 */ private function sendMessage(string $feishuUserId, array $card): bool { try { $token = $this->getAccessToken(); $response = HttpClient::httpPost( "https://open.feishu.cn/open-apis/message/v4/send_messages", [ 'receive_id_type' => 'user_id', 'receive_id' => $feishuUserId, 'msg_type' => 'interactive', 'content' => json_encode(['card' => $card]), ], [ 'Authorization: Bearer ' . $token, ] ); $code = $response['code'] ?? -1; $success = $code === 0; if ($success) { error_log("✅ 飞书消息发送成功: feishu_user_id={$feishuUserId}"); } else { error_log("❌ 飞书消息发送失败: feishu_user_id={$feishuUserId}, code={$code}, msg=" . ($response['msg'] ?? '')); } return $success; } catch (Exception $e) { error_log('❌ sendMessage 异常: ' . $e->getMessage()); return false; } } }