Refine phone workflow and ignore local backend files

.gitignore

@@ -11,3 +11,5 @@ backend/target/
 F_TMP_WRITE_TEST.txt
 localhost
 wechat-page.png
+backend/src/main/resources/application.yml
+start-backend.bat

backend/src/main/resources/application.yml

-server:
-  port: 8080
-
-spring:
-  application:
-    name: xyw-console-backend
-  datasource:
-    driver-class-name: com.mysql.cj.jdbc.Driver
-    url: ${XYW_DB_URL:jdbc:mysql://localhost:3306/xyw_private_data?useUnicode=true&characterEncoding=utf8&serverTimezone=Asia/Shanghai&useSSL=false&allowPublicKeyRetrieval=true}
-    username: ${XYW_DB_USERNAME:root}
-    password: ${XYW_DB_PASSWORD:}
-
-mybatis-plus:
-  configuration:
-    map-underscore-to-camel-case: true
-    log-impl: org.apache.ibatis.logging.stdout.StdOutImpl

src/modules/shared/record-adapters.js

@@ -55,48 +55,105 @@
   }
 
   /**
+   * 代码作用（白话）：把手机号真假值统一转成布尔值，避免不同接口口径导致列表和弹窗判断不一致；关联文件：F:/Project/xyw_console/src/modules/phone/phone-list-runtime.js、F:/Project/xyw_console/src/modules/phone/phone-add-dialog.js；关联逻辑（调用链/消息链/数据流）：后端字段原值 -> toBooleanFlag() -> normalizePhoneRecord() -> 列表显示/弹窗回填。
+   */
+  function toBooleanFlag(value, defaultValue) {
+    if (value === null || value === undefined || value === '') {
+      return defaultValue;
+    }
+    if (value === true || value === 1 || value === '1' || value === 'true' || value === 'enabled') {
+      return true;
+    }
+    if (value === false || value === 0 || value === '0' || value === 'false' || value === 'disabled') {
+      return false;
+    }
+    return Boolean(value);
+  }
+
+  /**
+   * 代码作用（白话）：把两个 SQL 图片字段整理成前端统一图片集合，让列表和弹窗都按一个图片字段来理解；关联文件：F:/Project/xyw_console/src/modules/phone/phone-list-runtime.js、F:/Project/xyw_console/src/modules/phone/phone-add-dialog.js；关联逻辑（调用链/消息链/数据流）：image_attachment_1/image_attachment_2 -> buildPhoneImages() -> normalizePhoneRecord() -> 图片列/图片上传区域。
+   */
+  function buildPhoneImages(source) {
+    return [source.imageAttachment1, source.image_attachment_1, source.imageAttachment2, source.image_attachment_2]
+      .filter(Boolean)
+      .filter((value, index, array) => array.indexOf(value) === index)
+      .slice(0, 2);
+  }
+
+  /**
    * 代码作用（白话）：把手机号原始记录整理成列表、详情抽屉、编辑弹窗共用的统一字段，避免每个组件自己猜字段名；关联文件：F:/Project/xyw_console/app-v2.js、F:/Project/xyw_console/src/modules/phone/phone-list-runtime.js、F:/Project/xyw_console/src/modules/phone/phone-detail-drawer.js、F:/Project/xyw_console/src/modules/phone/phone-add-dialog.js；关联逻辑（调用链/消息链/数据流）：PhoneApiClient/DATA_SOURCES.phone -> normalizePhoneRecord() -> app-v2.js 注入 -> 手机号列表/详情/编辑弹窗。
    */
   function normalizePhoneRecord(row) {
     const source = row || {};
-    const cardStatus = source.cardStatus || source.status || '正常';
-    const phoneNumber = source.phoneNumber || source.phone || '';
-    const channelOperator = source.channelOperator || source.carrier || '';
-    const updatedAt = source.updatedAt || source.updateTime || '';
-    const usageLocation = source.cardUsageLocation || source.usageLocation || '';
-    const wechatStatus = source.wechatStatus || (source.numberStatus === false ? '异常停机' : '正常');
-    const outbound = source.outbound || (source.outboundCall ? '可外呼' : '不可外呼');
+    const images = buildPhoneImages(source);
+    const cardStatusRaw = source.cardStatus ?? source.card_status ?? source.status;
+    const cardStatus = cardStatusRaw === 0 || cardStatusRaw === '0' || cardStatusRaw === '异常' ? '异常停机' : (cardStatusRaw || '正常');
+    const phoneNumber = source.phoneNumber || source.phone_number || source.phone || '';
+    const realPerson = source.realPerson || source.real_person || '';
+    const channelOperator = source.channelOperator || source.channel_operator || source.carrier || '';
+    const updatedAt = source.updatedAt || source.updated_at || source.updateTime || '';
+    const usageLocation = source.cardUsageLocation || source.card_usage_location || source.usageLocation || '';
+    const wecomEnabled = toBooleanFlag(source.wecom, false);
+    const wechatEnabled = toBooleanFlag(source.wechat, false);
+    const outboundEnabled = toBooleanFlag(source.outboundCall ?? source.outbound_call ?? source.outbound, false);
+    const miniProgramFiled = toBooleanFlag(source.miniProgramFiling ?? source.mini_program_filing, false);
+    const packageChangeEnabled = toBooleanFlag(source.packageChange5yuan ?? source.package_change_5yuan, false);
+    const numberStatus = toBooleanFlag(source.numberStatus ?? source.mobile_status ?? source.number_status, true);
+    const numberRetentionStatus = toBooleanFlag(source.numberRetentionStatus ?? source.number_retention_status, true);
+    const wechatStatus = source.wechatStatus || (numberStatus ? '正常' : '异常停机');
+    const outbound = source.outbound || (outboundEnabled ? '可外呼' : '不可外呼');
+    const linkedWecom = source.linkedWecom || source.linked_wecom || '';
+    const douyinAccount = source.douyinAccount || source.douyin_account || '';
 
     return {
       ...source,
       id: source.id,
+      images,
+      primaryImage: images[0] || '',
+      imageAttachment1: images[0] || source.imageAttachment1 || source.image_attachment_1 || '',
+      image_attachment_1: images[0] || source.imageAttachment1 || source.image_attachment_1 || '',
+      imageAttachment2: images[1] || source.imageAttachment2 || source.image_attachment_2 || '',
+      image_attachment_2: images[1] || source.imageAttachment2 || source.image_attachment_2 || '',
       phone: phoneNumber,
       phoneNumber,
-      realPerson: source.realPerson || '',
+      phone_number: phoneNumber,
+      realPerson,
+      real_person: realPerson,
       city: source.city || '',
       usageLocation,
       cardUsageLocation: usageLocation,
+      card_usage_location: usageLocation,
       carrier: channelOperator,
       channelOperator,
+      channel_operator: channelOperator,
       status: cardStatus,
       cardStatus,
+      card_status: cardStatus,
       wechatStatus,
       outbound,
-      outboundCall: source.outboundCall === true || source.outbound === 'available' || source.outbound === '可外呼',
-      wechat: source.wechat === true || source.wechat === 'enabled',
-      wecom: source.wecom === true || source.wecom === 'enabled',
+      outboundCall: outboundEnabled,
+      outbound_call: outboundEnabled,
+      wechat: wechatEnabled,
+      wecom: wecomEnabled,
       updatedAt,
+      updated_at: source.updated_at || updatedAt,
       updateTime: source.updateTime || updatedAt,
-      owner: source.owner || source.realPerson || '',
+      owner: source.owner || realPerson,
       project: source.project || source.note || '暂无备注',
       note: source.note || source.project || '',
       iccid: source.iccid || '',
-      douyinAccount: source.douyinAccount || '',
-      miniProgramFiling: source.miniProgramFiling === true,
-      packageChange5yuan: source.packageChange5yuan === true,
-      numberStatus: source.numberStatus !== false,
-      linkedWecom: source.linkedWecom || '',
-      numberRetentionStatus: source.numberRetentionStatus !== false
+      douyinAccount,
+      douyin_account: douyinAccount,
+      miniProgramFiling: miniProgramFiled,
+      mini_program_filing: miniProgramFiled,
+      packageChange5yuan: packageChangeEnabled,
+      package_change_5yuan: packageChangeEnabled,
+      numberStatus,
+      mobile_status: numberStatus,
+      linkedWecom,
+      linked_wecom: linkedWecom,
+      numberRetentionStatus,
+      number_retention_status: numberRetentionStatus
     };
   }
 

start-backend.bat

-@echo off
-chcp 65001 >nul
-
-set "BACKEND_DIR=%~dp0backend"
-set "PROJECT_JAVA_HOME=F:\jdk-17.0.12_windows-x64_bin\jdk-17.0.12"
-set "XYW_DB_USERNAME=root"
-set "XYW_DB_PASSWORD=root"
-
-echo ===================================================
-echo   [Starting Backend]
-echo   Backend Dir: %BACKEND_DIR%
-echo   Backend URL: http://localhost:8080
-echo   JAVA_HOME:   %PROJECT_JAVA_HOME%
-echo   DB User:     %XYW_DB_USERNAME%
-echo ===================================================
-echo.
-
-if not exist "%BACKEND_DIR%\pom.xml" (
-    echo [Error] Backend pom.xml not found: %BACKEND_DIR%\pom.xml
-    pause
-    exit /b 1
-)
-
-if not exist "%PROJECT_JAVA_HOME%\bin\java.exe" (
-    echo [Error] java.exe not found: %PROJECT_JAVA_HOME%\bin\java.exe
-    pause
-    exit /b 1
-)
-
-if not exist "%PROJECT_JAVA_HOME%\bin\javac.exe" (
-    echo [Error] javac.exe not found: %PROJECT_JAVA_HOME%\bin\javac.exe
-    pause
-    exit /b 1
-)
-
-set "JAVA_HOME=%PROJECT_JAVA_HOME%"
-set "PATH=%JAVA_HOME%\bin;%PATH%"
-
-java -version
-cd /d "%BACKEND_DIR%"
-echo (Press Ctrl+C or close this window to stop backend)
-mvn spring-boot:run
\ No newline at end of file