inquiry

2025-12-15 02:22:19 +00:00
parent 48906875df
commit 5370055008
30 changed files with 2299 additions and 47 deletions
@@ -0,0 +1,154 @@
+<?php
+
+namespace app\inquery\utils;
+
+use support\exception\BusinessException;
+
+class FbLeadHeaderMapper
+{
+    /**
+     * Excel 原始表头 => DB 字段名
+     * 注意：key 用的是“原始表头字符串”（包括下划线）
+     */
+    protected array $headerMap = [
+        // ===== 基础公共字段 =====
+        'id'             => 'fb_lead_id',
+        'created_time'   => 'fb_created_time',
+        'ad_id'          => 'ad_id',
+        'ad_name'        => 'ad_name',
+        'adset_id'       => 'adset_id',
+        'adset_name'     => 'adset_name',
+        'campaign_id'    => 'campaign_id',
+        'campaign_name'  => 'campaign_name',
+        'form_id'        => 'form_id',
+        'form_name'      => 'form_name',
+        'is_organic'     => 'is_organic',
+        'platform'       => 'platform',
+
+        'full_name'      => 'full_name',
+        'phone'          => 'phone',
+        'phone_number'   => 'phone',      // 兼容写法
+        'email'          => 'email',
+        'lead_status'    => 'lead_status',
+        'inbox_url'      => 'inbox_url',
+
+        // ===== 车型相关：全部归到 car_model =====
+        'which_model_of_this_car_would_you_like_to_purchase?_' => 'car_model',
+        'which_model_of_this_car_would_you_like_to_purchase?'  => 'car_model',
+        'which_car_model_would_you_like_to_purchase?'          => 'car_model',
+        'which_model_do_you_want_to_purchase?'                 => 'car_model',
+        'which_model_would_you_like_to_purchase?'              => 'car_model',
+        'which_version_do_you_want_to_buy?'                    => 'car_model', // 这里也归到车型/版本字段
+
+        // ===== 数量相关：全部归到 car_quantity =====
+        'how_many_cars_would_you_like_to_buy?_'  => 'car_quantity',
+        'how_many_cars_would_you_like_to_buy?'   => 'car_quantity',
+        '_how_many_cars_would_you_like_to_buy?'  => 'car_quantity',
+        'how_many_cars_do_you_buy?'              => 'car_quantity',
+        'how_many_cars_do_you_want_to_purchase?' => 'car_quantity',
+        'how_many_cars_do_you_want_to_buy?'      => 'car_quantity',
+        'what_quantity_do_you_want_to_buy?'      => 'car_quantity',
+
+        // ===== 颜色相关：归到 favorite_color =====
+        'what_color_do_you_like?'                 => 'favorite_color',
+        'which_color_would_you_like_to_purchase?' => 'favorite_color',
+
+        // ===== 用途相关：归到 usage_type =====
+        'are_you_using_it_for_business_or_personal_use?' => 'usage_type',
+        'business_use_or_personal_use?'                  => 'usage_type',
+        'personal_use_or_business_use?'                  => 'usage_type',
+
+        // ===== 座位数相关 =====
+        'do_you_want_to_buy_six_seats_or_seven_seats?'   => 'seat_preference',
+    ];
+
+    /**
+     * 返回所有支持的 Excel 表头
+     */
+    public function getSupportedHeaders(): array
+    {
+        return array_keys($this->headerMap);
+    }
+
+    /**
+     * 单个表头映射：原始表头 -> DB 字段名
+     */
+    public function mapHeader(string $rawHeader): ?string
+    {
+        $key = $this->normalizeHeader($rawHeader);
+
+        return $this->headerMap[$key] ?? null;
+    }
+
+    /**
+     * 校验一整行表头：
+     *  - 有任何不认识的表头，就抛 BusinessException
+     */
+    public function validateHeaders(array $rawHeaders): void
+    {
+        $unsupported = [];
+
+        foreach ($rawHeaders as $header) {
+            $header = (string)$header;
+            $key    = $this->normalizeHeader($header);
+
+            // 允许空表头（多余空列）
+            if ($key === '') {
+                continue;
+            }
+
+            if (!isset($this->headerMap[$key])) {
+                $unsupported[] = $header;
+            }
+        }
+
+        if (!empty($unsupported)) {
+            $msg = 'Excel 表头包含未兼容字段：' . implode('、', $unsupported)
+                 . '。请检查这些字段是否需要加入映射配置。';
+            throw new BusinessException($msg);
+        }
+    }
+
+    /**
+     * 根据第一行表头，构建 “列索引 => DB 字段” 映射
+     */
+    public function buildColumnFieldMap(array $rawHeaders): array
+    {
+        // 先做一遍校验（发现问题直接抛异常）
+        $this->validateHeaders($rawHeaders);
+
+        $colToField = [];
+
+        foreach ($rawHeaders as $index => $header) {
+            $key = $this->normalizeHeader((string)$header);
+            if ($key === '') {
+                continue;
+            }
+
+            $field = $this->headerMap[$key] ?? null;
+            if ($field === null) {
+                continue; // 理论上不会到这儿，双保险
+            }
+
+            $colToField[$index] = $field;
+        }
+
+        return $colToField;
+    }
+
+    /**
+     * 表头标准化：
+     * 目前只去 BOM + trim，保持和 headerMap 中 key 完全一致
+     * 如果后面再出现“有空格/大小写”的版本，我们可以在这里做 strtolower / 替换空格 为 _
+     */
+    protected function normalizeHeader(string $header): string
+    {
+        // 去掉 UTF-8 BOM
+        $header = preg_replace('/^\xEF\xBB\xBF/', '', $header);
+
+        // 去掉前后空白
+        $header = trim($header);
+
+        return $header;
+    }
+}