SheetInitializer.gs

/**
 * ============================================================================
 * 工廠環境衛生點檢管理系統 - 工作表初始化模組
 * Factory Environmental Hygiene Inspection System - Sheet Initializer Module
 * ============================================================================
 * 
 * @file        SheetInitializer.gs
 * @version     v3.0
 * @date        2026-02-14
 * @author      System Developer
 * @description 負責初始化所有 Google Sheets 工作表，包含表頭、格式設定、
 *              預設資料填入等功能
 * 
 * @functions
 *   - createSheet_InspectionRecords()    建立點檢記錄表
 *   - createSheet_TempHumidity()         建立溫濕度記錄表
 *   - createSheet_ItemMaster()           建立項目主檔表
 *   - createSheet_CustomStatistics()     建立自訂統計表
 *   - createSheet_SystemConfig()         建立系統設定表
 *   - createSheet_TempCriteria()         建立溫濕度標準表
 *   - createSheet_LanguageSettings()     建立語系設定表
 *   - initializeTempCriteria()           初始化溫濕度標準資料
 *   - initializeSystemConfig()           初始化系統設定資料
 * 
 * @dependencies
 *   - Code.gs (SHEETS 常數)
 * 
 * @changelog
 *   v2.2.5 (2026-01-26) - ISO 22000 整合，動態表單編號
 *   v2.2.4 (2026-01-26) - 新增 Alert_History 工作表
 *   v2.2.3 (2026-01-26) - 優化初始化流程
 * 
 * ============================================================================
 */

// ==================== Sheet 1: 點檢記錄表 ====================

function createSheet_InspectionRecords(ss) {
  const headers = [
    '記錄ID', '日期', '時段', '區域', '項目編號', '項目名稱',
    '狀態', '前次狀態', '備註', '點檢人員', '時間戳記'
  ];
  
  const sheet = getOrCreateSheet(ss, SHEETS.RECORDS, headers);
  
  // 設定欄寬
  sheet.setColumnWidth(1, 150);  // 記錄ID
  sheet.setColumnWidth(2, 100);  // 日期
  sheet.setColumnWidth(3, 60);   // 時段
  sheet.setColumnWidth(4, 120);  // 區域
  sheet.setColumnWidth(5, 80);   // 項目編號
  sheet.setColumnWidth(6, 300);  // 項目名稱
  sheet.setColumnWidth(7, 80);   // 狀態
  sheet.setColumnWidth(8, 80);   // 前次狀態
  sheet.setColumnWidth(9, 200);  // 備註
  sheet.setColumnWidth(10, 100); // 點檢人員
  sheet.setColumnWidth(11, 150); // 時間戳記
  
  return sheet;
}

// ==================== Sheet 2: 項目主檔 ====================

function createSheet_ItemMaster(ss) {
  const headers = [
    '項目ID', '區域', '項目編號', '項目名稱(中)', '項目名稱(英)', 
    '題型', '單位', '是否啟用'
  ];
  
  const sheet = getOrCreateSheet(ss, SHEETS.ITEM_MASTER, headers);
  
  sheet.setColumnWidth(1, 120);  // 項目ID
  sheet.setColumnWidth(2, 120);  // 區域
  sheet.setColumnWidth(3, 80);   // 項目編號
  sheet.setColumnWidth(4, 350);  // 項目名稱(中)
  sheet.setColumnWidth(5, 400);  // 項目名稱(英)
  sheet.setColumnWidth(6, 100);  // 題型
  sheet.setColumnWidth(7, 80);   // 單位
  sheet.setColumnWidth(8, 80);   // 是否啟用
  
  // 檢查是否有現有資料需要補齊題型欄位
  const lastRow = sheet.getLastRow();
  if (lastRow > 1) {
    const existingData = sheet.getRange(2, 1, lastRow - 1, sheet.getLastColumn()).getValues();
    
    // 檢查是否缺少題型和單位欄位
    if (existingData[0].length < 8) {
      Logger.log('偵測到舊格式資料，補齊題型和單位欄位...');
      
      const updatedData = existingData.map(row => {
        // 如果資料少於8欄，補齊
        if (row.length < 8) {
          return [
            row[0] || '',  // 項目ID
            row[1] || '',  // 區域
            row[2] || '',  // 項目編號
            row[3] || '',  // 項目名稱(中)
            row[4] || '',  // 項目名稱(英)
            '選擇題',      // 題型（預設）
            '',            // 單位（空白）
            row[5] !== undefined ? row[5] : true  // 是否啟用
          ];
        }
        return row;
      });
      
      // 清除舊資料
      if (lastRow > 1) {
        sheet.getRange(2, 1, lastRow - 1, sheet.getLastColumn()).clearContent();
      }
      
      // 寫入新資料
      sheet.getRange(2, 1, updatedData.length, 8).setValues(updatedData);
      Logger.log(`已更新 ${updatedData.length} 筆資料`);
    }
  }
  
  // 設定題型欄位的資料驗證（從第2列開始，最多1000列）
  const typeRange = sheet.getRange(2, 6, 1000, 1);
  const typeRule = SpreadsheetApp.newDataValidation()
    .requireValueInList(['選擇題', '填空題'], true)
    .setAllowInvalid(false)
    .build();
  typeRange.setDataValidation(typeRule);
  
  return sheet;
}

// ==================== Sheet 3: 溫濕度記錄 ====================

function createSheet_TempHumidity(ss) {
  const headers = [
    '記錄ID', '日期', '時段', '區域', '測點名稱', '數值', '單位',
    '判定結果', '超標說明', '備註', '點檢人員', '告警狀態'
  ];
  
  const sheet = getOrCreateSheet(ss, SHEETS.TEMP_HUMIDITY, headers);
  
  sheet.setColumnWidth(1, 150);  // 記錄ID
  sheet.setColumnWidth(2, 100);  // 日期
  sheet.setColumnWidth(3, 60);   // 時段
  sheet.setColumnWidth(4, 120);  // 區域
  sheet.setColumnWidth(5, 150);  // 測點名稱
  sheet.setColumnWidth(6, 80);   // 數值
  sheet.setColumnWidth(7, 60);   // 單位
  sheet.setColumnWidth(8, 100);  // 判定結果
  sheet.setColumnWidth(9, 150);  // 超標說明
  sheet.setColumnWidth(10, 200); // 備註
  sheet.setColumnWidth(11, 100); // 點檢人員
  sheet.setColumnWidth(12, 100); // 告警狀態
  
  return sheet;
}

// ==================== Sheet 4: 自訂期間統計 ====================

function createSheet_CustomStats(ss) {
  const headers = [
    '統計ID', '起始日期', '結束日期', '期間描述', '區域', '項目名稱',
    'OK次數', 'NOK次數', '待追蹤次數', '總次數', 'NOK比率', '排名'
  ];
  
  const sheet = getOrCreateSheet(ss, SHEETS.CUSTOM_STATS, headers);
  
  sheet.setColumnWidth(1, 150);  // 統計ID
  sheet.setColumnWidth(2, 100);  // 起始日期
  sheet.setColumnWidth(3, 100);  // 結束日期
  sheet.setColumnWidth(4, 150);  // 期間描述
  sheet.setColumnWidth(5, 120);  // 區域
  sheet.setColumnWidth(6, 300);  // 項目名稱
  sheet.setColumnWidth(7, 80);   // OK次數
  sheet.setColumnWidth(8, 80);   // NOK次數
  sheet.setColumnWidth(9, 100);  // 待追蹤次數
  sheet.setColumnWidth(10, 80);  // 總次數
  sheet.setColumnWidth(11, 80);  // NOK比率
  sheet.setColumnWidth(12, 60);  // 排名
  
  return sheet;
}

// ==================== Sheet 5: 系統設定 ====================

function createSheet_SystemConfig(ss) {
  const headers = ['設定項目', '設定值'];
  const sheet = getOrCreateSheet(ss, SHEETS.SYSTEM_CONFIG, headers);
  
  sheet.setColumnWidth(1, 200);
  sheet.setColumnWidth(2, 400);
  
  return sheet;
}

// ==================== Sheet 6: 溫濕度標準設定 ====================

function createSheet_TempCriteria(ss) {
  const headers = [
    '測點名稱', '所屬區域', '測量類型', '單位', '下限值', '上限值',
    '是否啟用告警', '告警方式', '告警收件人', '備註'
  ];
  
  const sheet = getOrCreateSheet(ss, SHEETS.TEMP_CRITERIA, headers);
  
  sheet.setColumnWidth(1, 150);  // 測點名稱
  sheet.setColumnWidth(2, 120);  // 所屬區域
  sheet.setColumnWidth(3, 100);  // 測量類型
  sheet.setColumnWidth(4, 60);   // 單位
  sheet.setColumnWidth(5, 80);   // 下限值
  sheet.setColumnWidth(6, 80);   // 上限值
  sheet.setColumnWidth(7, 120);  // 是否啟用告警
  sheet.setColumnWidth(8, 100);  // 告警方式
  sheet.setColumnWidth(9, 250);  // 告警收件人
  sheet.setColumnWidth(10, 200); // 備註
  
  return sheet;
}

// ==================== Sheet 7: 多語系設定 ====================

function createSheet_Language(ss) {
  const headers = ['語系代碼', '語系名稱', '欄位鍵值', '翻譯內容'];
  const sheet = getOrCreateSheet(ss, SHEETS.LANGUAGE, headers);
  
  sheet.setColumnWidth(1, 100);
  sheet.setColumnWidth(2, 120);
  sheet.setColumnWidth(3, 200);
  sheet.setColumnWidth(4, 400);
  
  return sheet;
}

// ==================== 初始化項目主檔資料 ====================

function initializeItemMaster() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(SHEETS.ITEM_MASTER);
  
  if (!sheet) {
    throw new Error('項目主檔工作表不存在');
  }
  
  // 檢查是否已有資料
  if (sheet.getLastRow() > 1) {
    Logger.log('項目主檔已有資料，跳過初始化');
    return;
  }
  
  const items = getAllInspectionItems();
  const data = [];
  
  items.forEach((area) => {
    area.items.forEach((item) => {
      // 判斷題型：溫度/濕度為填空題，其他為選擇題
      let questionType = '選擇題';
      let unit = '';
      
      if (item.type === 'temperature') {
        questionType = '填空題';
        unit = '℃';
      } else if (item.type === 'humidity') {
        questionType = '填空題';
        unit = '%RH';
      }
      
      data.push([
        `${area.code}_${item.no}`,  // 項目ID
        area.name_zh,                // 區域
        item.no,                     // 項目編號
        item.name_zh,                // 項目名稱(中)
        item.name_en,                // 項目名稱(英)
        questionType,                // 題型
        unit,                        // 單位
        true                         // 是否啟用
      ]);
    });
  });
  
  if (data.length > 0) {
    sheet.getRange(2, 1, data.length, 8).setValues(data);
  }
  
  Logger.log(`項目主檔初始化完成：${data.length} 個項目`);
}

// ==================== 初始化溫濕度標準 ====================

function initializeTempCriteria() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(SHEETS.TEMP_CRITERIA);
  
  if (!sheet) {
    throw new Error('溫濕度標準設定工作表不存在');
  }
  
  // 檢查是否已有資料
  if (sheet.getLastRow() > 1) {
    Logger.log('溫濕度標準已有資料，跳過初始化');
    return;
  }
  
  const criteria = [];
  
  // 從 Sheet 2 讀取填空題項目
  const itemSheet = ss.getSheetByName(SHEETS.ITEM_MASTER);
  if (itemSheet && itemSheet.getLastRow() > 1) {
    const itemData = itemSheet.getDataRange().getValues();
    
    for (let i = 1; i < itemData.length; i++) {
      const [itemId, area, itemNo, nameCh, nameEn, questionType, unit, isEnabled] = itemData[i];
      
      // 只處理填空題
      if (questionType === '填空題' && (isEnabled === true || isEnabled === 'TRUE')) {
        let measureType = '';
        let lower = 0;
        let upper = 0;
        
        // 根據單位判斷類型和預設標準
        if (unit === '%RH') {
          measureType = '濕度';
          lower = 30;
          upper = 60;
        } else if (unit === '℃') {
          measureType = '溫度';
          // 根據項目名稱判斷溫度範圍
          const name = nameCh.toLowerCase();
          if (name.includes('冷凍') || name.includes('成品') || name.includes('原料')) {
            lower = -20;
            upper = -15;
          } else if (name.includes('半成品') && name.includes('冷凍')) {
            lower = -18;
            upper = -10;
          } else if (name.includes('暫存') || name.includes('冷藏')) {
            lower = 0;
            upper = 7;
          } else {
            // 預設冷藏
            lower = 0;
            upper = 7;
          }
        } else {
          // 其他單位暫不設定標準
          continue;
        }
        
        criteria.push([
          nameCh,           // 測點名稱
          area,             // 所屬區域
          measureType,      // 測量類型
          unit,             // 單位
          lower,            // 下限值
          upper,            // 上限值
          true,             // 是否啟用告警
          '郵件',           // 告警方式
          '',               // 告警收件人
          '自動產生'        // 備註
        ]);
      }
    }
  }
  
  // 如果沒有從 Sheet 2 找到填空題，使用預設標準
  if (criteria.length === 0) {
    criteria.push(
      ['秤料室濕度', 'B1區', '濕度', '%RH', 30, 60, true, '郵件', '', '依食品GMP規範'],
      ['物料室濕度', 'B1區', '濕度', '%RH', 30, 60, true, '郵件', '', '依食品GMP規範'],
      ['半成品暫存區溫度', '蒸煮區', '溫度', '℃', 0, 7, true, '郵件', '', '冷藏溫度控制'],
      ['半成品冷凍區溫度', '蒸煮區', '溫度', '℃', -18, -10, true, '郵件', '', '冷凍溫度控制'],
      ['原料庫溫度', '其他', '溫度', '℃', -20, -15, true, '郵件', '', '冷凍庫溫度控制'],
      ['成品庫溫度', '其他', '溫度', '℃', -20, -15, true, '郵件', '', '冷凍庫溫度控制']
    );
  }
  
  sheet.getRange(2, 1, criteria.length, 10).setValues(criteria);
  
  Logger.log(`溫濕度標準初始化完成：${criteria.length} 個測點`);
}

// ==================== 初始化系統設定 ====================

function initializeSystemConfig() {
  const ss = SpreadsheetApp.getActiveSpreadsheet();
  const sheet = ss.getSheetByName(SHEETS.SYSTEM_CONFIG);
  
  if (!sheet) {
    throw new Error('系統設定工作表不存在');
  }
  
  // 檢查是否已有資料
  if (sheet.getLastRow() > 1) {
    Logger.log('系統設定已有資料，跳過初始化');
    return;
  }
  
  const config = [
    ['點檢時段', '早,晚,其它'],
    ['預設點檢人員', '張三,李四,王五,趙六,陳七'],
    ['自動統計時間', '每日23:00'],
    ['數據保留期限', '3年'],
    ['預設語系', '繁體中文'],
    ['ISO表單編號', 'P-4-001 版本 A1'],
    ['ISO標準', 'ISO 22000:2018'],
    ['系統版本', 'v3.0'],
    ['最後更新日期', Utilities.formatDate(new Date(), 'GMT+8', 'yyyy-MM-dd')],
    ['點檢表表單編號', 'P-4-001 版本 A1'],
    ['統計報表表單編號', 'P-4-002 版本 A1'],
    ['項目主檔版本', '1.0'],
    ['最後同步時間', ''],
    ['PDF輸出設定', '啟用'],
    ['PDF頁首LOGO', ''],
    ['PDF頁尾資訊', '○○食品股份有限公司\n台北市○○區○○路○○號\n電話: 02-xxxx-xxxx']
  ];
  
  sheet.getRange(2, 1, config.length, 2).setValues(config);
  
  Logger.log('系統設定初始化完成');
}

// ==================== Sheet 8: 項目主檔修訂歷史 ====================

function createSheet_ItemHistory(ss) {
  const headers = [
    '歷史ID', '項目ID', '修訂時間', '修訂者', '修訂類型',
    '修訂前內容', '修訂後內容', '修訂原因', '版本號'
  ];
  
  const sheet = getOrCreateSheet(ss, SHEETS.ITEM_HISTORY, headers);
  
  // 設定欄寬
  sheet.setColumnWidth(1, 180);  // 歷史ID
  sheet.setColumnWidth(2, 100);  // 項目ID
  sheet.setColumnWidth(3, 150);  // 修訂時間
  sheet.setColumnWidth(4, 100);  // 修訂者
  sheet.setColumnWidth(5, 100);  // 修訂類型
  sheet.setColumnWidth(6, 300);  // 修訂前內容
  sheet.setColumnWidth(7, 300);  // 修訂後內容
  sheet.setColumnWidth(8, 200);  // 修訂原因
  sheet.setColumnWidth(9, 80);   // 版本號
  
  // 設定標題列樣式
  const headerRange = sheet.getRange(1, 1, 1, headers.length);
  headerRange.setBackground('#667eea');
  headerRange.setFontColor('#FFFFFF');
  headerRange.setFontWeight('bold');
  headerRange.setHorizontalAlignment('center');
  
  // 凍結第一列
  sheet.setFrozenRows(1);
  
  Logger.log('項目主檔修訂歷史工作表建立完成');
}