截图传 OSS -> 建 crm_customer 档案 -> 轮询分配 -> 汇总邮件。
* 固定口径:corp_id=1(合塑)、channel_id=4(合塑谷歌)、type=2(导入数据);
* contacts=归一化号码、号码存 WhatsApp 字段;按号码去重(对比库内 WhatsApp/phone 两列 + 文件内)。
*/
class HesuGoogleWhatsAppImportCommand extends Command
{
protected static $defaultName = 'inquiry:import-hesu-google-wa';
protected static $defaultDescription = '合塑谷歌网站whatsapp询盘导入:截图传OSS+建档+轮询分配+汇总邮件';
private const CORP_ID = 1;
private const CHANNEL_ID = 4; // 合塑谷歌
private const CHANNEL_NAME = '合塑谷歌(WhatsApp)';
private const TYPE = 2; // 导入数据
private const GRADE = 0;
private const MAGNITUDE = 2;
protected function configure()
{
$this->addOption('file', null, InputOption::VALUE_REQUIRED, 'Excel 文件路径', 'docs/WhatsApp询盘_6-8月_明细.xlsx')
->addOption('users', null, InputOption::VALUE_REQUIRED, '目标 user_id 列表,逗号分隔(必填)', '')
->addOption('images-dir', null, InputOption::VALUE_REQUIRED, '截图所在目录', 'docs/whatsapp_screenshots')
->addOption('dry-run', null, InputOption::VALUE_NONE, '只解析+去重预检+分配预演(不上传截图/不写库/不发邮件)')
->addOption('no-notify', null, InputOption::VALUE_NONE, '只上传+建档分配,不发邮件')
->addOption('notify-only', null, InputOption::VALUE_NONE, '跳过上传与写库,按 manifest 补发未成功的邮件')
->addOption('only-user', null, InputOption::VALUE_REQUIRED, '仅给指定 user_id 发邮件(试发)', '0');
}
/**
* 解析 Excel(按表头名定位列)。返回行数组。
*/
private function parseExcel(string $filePath): array
{
$sheet = IOFactory::load($filePath)->getActiveSheet();
$highestRow = $sheet->getHighestRow();
$colMap = [];
foreach (range('A', 'Z') as $col) {
$v = trim((string)($sheet->getCell($col . '1')->getValue() ?? ''));
if ($v !== '') {
$colMap[$v] = $col;
}
}
if (!isset($colMap['WhatsApp号码'])) {
throw new \RuntimeException('Excel 缺少必需列头: WhatsApp号码;实际列头: ' . implode(',', array_keys($colMap)));
}
$get = function (string $header, int $r) use ($sheet, $colMap): string {
if (!isset($colMap[$header])) {
return '';
}
return trim((string)($sheet->getCell($colMap[$header] . $r)->getValue() ?? ''));
};
$rows = [];
for ($r = 2; $r <= $highestRow; $r++) {
$number = $this->normalizeNumber($get('WhatsApp号码', $r));
if ($number === '') {
$blank = $get('最后留言', $r) === '' && $get('截图文件名', $r) === '';
if ($blank) {
continue; // 整行为空
}
$rows[] = ['excel_row' => $r, 'number' => '', 'message' => $get('最后留言', $r), 'shot' => $get('截图文件名', $r)];
continue;
}
$rows[] = [
'excel_row' => $r,
'number' => $number,
'message' => $get('最后留言', $r),
'shot' => $get('截图文件名', $r),
];
}
return $rows;
}
/**
* 号码归一化:仅保留数字与开头 +(去横线/空格等)
*/
private function normalizeNumber(string $raw): string
{
$n = preg_replace('/[^0-9+]/', '', trim($raw));
$n = preg_replace('/\++/', '+', $n);
if ($n !== '' && $n[0] !== '+') {
$n = '+' . $n;
}
return $n !== '+' ? $n : '';
}
/**
* 按号码去重:库内(WhatsApp 与 phone 两列)+ 文件内。返回 [待建档行, 跳过信息, 无号码行]
*/
private function dedup(array $rows, OutputInterface $output): array
{
$numbers = array_values(array_unique(array_filter(array_column($rows, 'number'))));
$exists = [];
foreach (array_chunk($numbers, 500) as $chunk) {
foreach (['WhatsApp', 'phone'] as $col) {
foreach (Db::table('crm_customer')->whereNull('deleted_at')->whereIn($col, $chunk)->pluck($col) as $v) {
$n = $this->normalizeNumber((string)$v);
if ($n !== '') {
$exists[$n] = 1;
}
}
}
}
$keep = []; $skipped = []; $noNumber = []; $seen = [];
foreach ($rows as $row) {
if ($row['number'] === '') {
$noNumber[] = $row;
continue;
}
if (isset($exists[$row['number']]) || isset($seen[$row['number']])) {
$skipped[] = [$row['excel_row'], '号码重复: ' . $row['number']];
continue;
}
$seen[$row['number']] = 1;
$keep[] = $row;
}
return [$keep, $skipped, $noNumber];
}
/**
* 上传截图到 OSS。返回 [对象键或null, 是否成功];文件缺失返回 [null, false]。
*/
private function uploadShot(string $imagesDir, string $filename, OutputInterface $output): ?string
{
if ($filename === '') {
return null;
}
$path = rtrim($imagesDir, '/') . '/' . ltrim($filename, '/');
if (!is_file($path)) {
return null;
}
$mainDir = rtrim((string)(getenv('OSS_MAIN_DIR') ?: 'x_server'), '/');
$key = $mainDir . '/crm_whatsapp/' . basename($filename);
try {
(new OssService())->uploadImage($path, $key); // 返回带签名的临时URL,这里只关心落 OSS 的对象键
return $key;
} catch (\Throwable $e) {
$output->writeln(' 截图上传失败 ' . $filename . ': ' . $e->getMessage() . '');
return null;
}
}
private function manifestPath(string $date): string
{
return runtime_path() . '/inquiry_hesu_google_wa_' . $date . '.json';
}
protected function execute(InputInterface $input, OutputInterface $output): int
{
$file = $input->getOption('file');
$imagesDir = (string)$input->getOption('images-dir');
$targetUserIds = array_values(array_filter(array_map('intval', explode(',', (string)$input->getOption('users')))));
$dryRun = (bool)$input->getOption('dry-run');
$notifyOnly = (bool)$input->getOption('notify-only');
$noNotify = (bool)$input->getOption('no-notify');
$onlyUser = (int)$input->getOption('only-user');
$date = date('Y-m-d');
if (!$targetUserIds) {
$output->writeln('--users 不能为空(目标业务员 user_id 列表)');
return self::FAILURE;
}
if (!is_file($file)) {
$output->writeln('文件不存在: ' . $file . '');
return self::FAILURE;
}
if ($notifyOnly && $noNotify) {
$output->writeln('--notify-only 与 --no-notify 不能同时使用');
return self::FAILURE;
}
$output->writeln('解析 Excel: ' . $file . '');
$rows = $this->parseExcel($file);
$output->writeln('数据行: ' . count($rows) . '');
[$keep, $skipped, $noNumber] = $this->dedup($rows, $output);
$output->writeln('去重后待建档: ' . count($keep) . ',号码重复跳过: ' . count($skipped) . ',无号码跳过: ' . count($noNumber) . '');
foreach (array_slice($skipped, 0, 10) as $s) {
$output->writeln(' 跳过 行' . $s[0] . ' ' . $s[1] . '');
}
if (count($skipped) > 10) {
$output->writeln(' ...另 ' . (count($skipped) - 10) . ' 条');
}
foreach (array_slice($noNumber, 0, 5) as $row) {
$output->writeln(' 无号码 行' . $row['excel_row'] . ' 留言:' . mb_substr($row['message'], 0, 30) . '');
}
// 截图可用性
$shotFound = 0; $shotMissing = 0;
foreach ($keep as $row) {
if ($row['shot'] === '') {
continue;
}
if (is_file(rtrim($imagesDir, '/') . '/' . ltrim($row['shot'], '/'))) {
$shotFound++;
} else {
$shotMissing++;
}
}
$output->writeln('截图: 找到 ' . $shotFound . ' / 缺失 ' . $shotMissing . '(目录: ' . $imagesDir . ')');
// 公平分配:按近10天窗口内实际分到数升序(少者优先、最久未分到优先),再按序轮询
$fair = InquiryFairAssigner::fairOrder($targetUserIds);
$orderedUsers = $fair['ordered'];
$output->writeln('分配顺序(近' . $fair['window_days'] . '天已有条数):'
. implode('、', array_map(fn($u) => $u . '(' . ($fair['counts'][$u] ?? 0) . ')', $orderedUsers)) . '');
$n = count($orderedUsers);
foreach ($keep as $i => &$row) {
$row['new_user_id'] = $orderedUsers[$i % $n];
}
unset($row);
$groups = [];
foreach ($targetUserIds as $uid) {
$groups[$uid] = [];
}
foreach ($keep as $row) {
$groups[$row['new_user_id']][] = $row;
}
foreach ($targetUserIds as $uid) {
$output->writeln('user ' . $uid . ' 分配: ' . count($groups[$uid]) . ' 条');
}
foreach (array_slice($keep, 0, 3) as $row) {
$output->writeln('样例[行' . $row['excel_row'] . '] ' . $row['number'] . ' '
. mb_substr($row['message'], 0, 20) . ' -> user ' . $row['new_user_id'] . '');
}
if ($dryRun) {
$output->writeln('[dry-run] 不上传截图、不写库、不发邮件。确认后去掉 --dry-run 执行。');
return self::SUCCESS;
}
if (!$notifyOnly) {
// 先传截图(外部操作,不在事务内;失败不阻断,仅记录),再事务建档
$uploaded = 0;
foreach ($keep as &$row) {
$key = $this->uploadShot($imagesDir, $row['shot'], $output);
$row['shot_key'] = $key;
if ($key !== null) {
$uploaded++;
}
}
unset($row);
$output->writeln('截图已上传 OSS: ' . $uploaded . '');
$created = [];
Db::connection()->transaction(function () use ($keep, $output, &$created) {
foreach ($keep as $row) {
$desc = $row['message'];
if ($row['shot'] !== '') {
$desc .= ($desc !== '' ? "\n" : '') . '截图:' . ($row['shot_key'] ?? $row['shot']);
}
$c = new CrmCustomer();
$c->corp_id = self::CORP_ID;
$c->user_id = $row['new_user_id'];
$c->type = self::TYPE;
$c->channel_id = self::CHANNEL_ID;
$c->grade = self::GRADE;
$c->magnitude = self::MAGNITUDE;
$c->email = '';
$c->phone = '';
$c->WhatsApp = $row['number'];
$c->contacts = $row['number'];
$c->desc_collect = $desc;
$c->obtain = time();
if (!$c->save()) {
throw new \RuntimeException('行' . $row['excel_row'] . ' 建档失败');
}
$row['code'] = $c->code;
$created[] = $row;
}
$output->writeln('已建档并分配: ' . count($created) . ' 条(code 自动生成)');
});
$keep = $created;
$groups = [];
foreach ($targetUserIds as $uid) {
$groups[$uid] = [];
}
foreach ($keep as $row) {
$groups[$row['new_user_id']][] = $row;
}
} else {
$output->writeln('[notify-only] 跳过上传与写库。');
}
$manifestPath = $this->manifestPath($date);
if ($notifyOnly) {
// 建档后号码已入库,重新解析会被去重清空——补发必须用 manifest 保存的分配结果
$manifest = is_file($manifestPath) ? (json_decode((string)@file_get_contents($manifestPath), true) ?: []) : [];
if (empty($manifest['groups'])) {
$output->writeln('manifest 不存在或无分配数据: ' . $manifestPath . ';请先执行 --no-notify 或完整命令生成');
return self::FAILURE;
}
$digestGroups = $manifest['groups'];
} else {
$totalRows = array_sum(array_map('count', $groups));
if ($totalRows > 0) {
$digestGroups = [];
foreach ($targetUserIds as $uid) {
$digestGroups[(string)$uid] = [];
}
foreach ($groups as $uid => $rows) {
foreach ($rows as $row) {
$digestGroups[(string)$uid][] = $this->digestRow($row);
}
}
$this->saveManifest($manifestPath, $targetUserIds, $digestGroups);
} else {
$manifest = is_file($manifestPath) ? (json_decode((string)@file_get_contents($manifestPath), true) ?: []) : [];
if (!empty($manifest['groups'])) {
$digestGroups = $manifest['groups'];
$output->writeln('本次无新建档(可能已导入过),沿用已有 manifest 的分配结果。');
} else {
$output->writeln('没有可建档数据,结束。');
return self::SUCCESS;
}
}
if ($noNotify) {
$output->writeln('[no-notify] 已建档,跳过发邮件。核对库后用 --notify-only 补发。');
return self::SUCCESS;
}
}
$this->sendDigests($digestGroups, $targetUserIds, $manifestPath, $onlyUser, $output);
return self::SUCCESS;
}
private function saveManifest(string $path, array $targetUserIds, array $digestGroups): void
{
$perUser = []; $emailed = [];
foreach ($targetUserIds as $uid) {
$perUser[(string)$uid] = count($digestGroups[(string)$uid] ?? []);
$emailed[(string)$uid] = false;
}
$data = [
'date' => date('Y-m-d'),
'imported_at' => time(),
'target_users' => $targetUserIds,
'per_user_counts' => $perUser,
'groups' => $digestGroups,
'emailed' => $emailed,
];
file_put_contents($path, json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT));
}
/**
* 建档行 -> 邮件汇总行(联系人/电话列显示 WhatsApp 号)
*/
private function digestRow(array $row): array
{
return [
'code' => $row['code'] ?? '',
'contact' => $row['number'],
'email' => '',
'phone' => $row['number'],
'country_cn' => '',
'channel' => self::CHANNEL_NAME,
'remark' => $row['message'],
];
}
private function sendDigests(array $digestGroups, array $targetUserIds, string $manifestPath, int $onlyUser, OutputInterface $output): void
{
$users = Db::table('user')->whereIn('id', $targetUserIds)->get(['id', 'name', 'email']);
$userMap = [];
foreach ($users as $u) {
$userMap[(int)$u->id] = $u;
}
$manifest = is_file($manifestPath) ? (json_decode((string)file_get_contents($manifestPath), true) ?: ['emailed' => []]) : ['emailed' => []];
$date = date('Y-m-d');
foreach ($targetUserIds as $uid) {
if (count($digestGroups[(string)$uid] ?? []) === 0) {
$output->writeln('user ' . $uid . ' 未分到询盘,不发送');
continue;
}
if ($onlyUser > 0 && $uid !== $onlyUser) {
continue;
}
if (!empty($manifest['emailed'][(string)$uid])) {
$output->writeln('跳过已发送: user ' . $uid . '');
continue;
}
$u = $userMap[$uid] ?? null;
if (!$u || empty($u->email)) {
$output->writeln('user ' . $uid . ' 无邮箱,跳过');
continue;
}
$inquiries = array_values($digestGroups[(string)$uid] ?? []);
$html = InquiryDigestMail::build((string)$u->name, $inquiries, $date);
$subject = 'WhatsApp新询盘分配汇总(共 ' . count($inquiries) . ' 条)- ' . $u->name . ' - ' . $date;
$ok = MailSend::send($u->email, $subject, $html);
if (!$ok) {
$ok = MailSend::send($u->email, $subject, $html);
}
$manifest['emailed'][(string)$uid] = (bool)$ok;
file_put_contents($manifestPath, json_encode($manifest, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT));
$tag = $ok ? 'info' : 'error';
$output->writeln('<' . $tag . '>user ' . $uid . ' (' . $u->email . '): '
. ($ok ? '发送成功' : '发送失败') . ',共 ' . count($inquiries) . ' 条' . $tag . '>');
}
}
}