/**
 * หมวดหมู่: INITIALIZATION
 * ฟังก์ชัน: initializeSheets
 * วัตถุประสงค์: จัดเตรียมหน้าชีท โครงสร้างตาราง และค่าเริ่มต้นสำหรับเว็บแอปพลิเคชัน
 */
function initializeSheets() {
  // ดึงไฟล์สเปรดชีตปัจจุบันที่สคริปต์นี้ผูกอยู่
  var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
  
  // กำหนดชื่อหน้าชีทที่เราจำเป็นต้องใช้ในระบบ
  var configSheetName = "System_Config";
  var logSheetName = "Activity_Logs";
  
  // ---------------------------------------------------------
  // ขั้นตอนที่ 1: จัดการหน้าชีทสำหรับเก็บค่าตั้งค่า (System_Config)
  // ---------------------------------------------------------
  var configSheet = spreadsheet.getSheetByName(configSheetName);
  
  if (!configSheet) {
    // ถ้ายังไม่มีหน้าชีทนี้ ให้ทำการสร้างใหม่
    configSheet = spreadsheet.insertSheet(configSheetName);
    Logger.log("สร้างหน้าชีท '" + configSheetName + "' สำเร็จ!");
    
    // กำหนดหัวตาราง (Headers) สำหรับชีทตั้งค่า
    var configHeaders = ["Config_Key", "JSON_Payload", "Last_Modified"];
    configSheet.getRange(1, 1, 1, configHeaders.length).setValues([configHeaders]);
    
    // สร้างวัตถุ JSON เริ่มต้นเพื่อควบคุมการทำงานของแอปพลิเคชัน
    var defaultSettings = {
      themeMode: "light",
      maintenanceMode: false,
      version: "1.0.0",
      allowedRoles: ["admin", "teacher", "student"]
    };
    
    // แปลงวัตถุ JavaScript ให้เป็นข้อความสตริง (String) เพื่อบันทึกลงเซลล์
    var jsonString = JSON.stringify(defaultSettings);
    
    // บันทึกข้อมูลเริ่มต้นลงในแถวที่ 2
    configSheet.getRange(2, 1).setValue("GLOBAL_SETTING");
    configSheet.getRange(2, 2).setValue(jsonString);
    configSheet.getRange(2, 3).setValue(new Date());
    
    Logger.log("ทำการตั้งค่าโครงสร้าง JSON เริ่มต้นเรียบร้อยแล้ว");
  } else {
    Logger.log("หน้าชีท '" + configSheetName + "' มีอยู่แล้ว ข้ามขั้นตอนการสร้าง");
  }

  // ---------------------------------------------------------
  // ขั้นตอนที่ 2: จัดการหน้าชีทสำหรับเก็บบันทึกประวัติ (Activity_Logs)
  // ---------------------------------------------------------
  var logSheet = spreadsheet.getSheetByName(logSheetName);
  
  if (!logSheet) {
    logSheet = spreadsheet.insertSheet(logSheetName);
    Logger.log("สร้างหน้าชีท '" + logSheetName + "' สำเร็จ!");
    
    // กำหนดหัวตารางสำหรับชีทประวัติการใช้งาน
    var logHeaders = ["Timestamp", "User_Email", "Action_Performed", "Status"];
    logSheet.getRange(1, 1, 1, logHeaders.length).setValues([logHeaders]);
  } else {
    Logger.log("หน้าชีท '" + logSheetName + "' มีอยู่แล้ว ข้ามขั้นตอนการสร้าง");
  }
  
  Logger.log("--- กระบวนการ INITIALIZATION เสร็จสิ้นสมบูรณ์ ---");
}

5. แผนผังการทำงานของโค้ด (Workflow Diagram)

เพื่อให้มองเห็นภาพการไหลของข้อมูล (Logic Flow) เมื่อฟังก์ชันนี้ทำงาน สามารถสรุปออกมาเป็นลำดับขั้นตอนได้ดังนี้ครับ:

6. ข้อดีของการเขียนโค้ดแยกส่วนแบบ "Initialization Pattern"

การฝึกเขียนฟังก์ชันตั้งค่าเริ่มต้นแยกไว้ต่างหาก มีประโยชน์มหาศาลต่อการพัฒนาซอฟต์แวร์ในระยะยาว ดังนี้ครับ:

• ปลอดภัยจาก Error (Robustness): ลดโอกาสที่ระบบจะล่มเพราะหาไฟล์หรือหาแท็บไม่เจอให้เหลือใกล้ศูนย์ เปรียบเสมือนมีเบาะนิรภัยคอยรองรับโครงสร้างข้อมูลไว้ก่อนเสมอ

• ย้ายระบบได้ง่าย (Portability): ลองนึกภาพว่าถ้าคุณส่งโปรเจกต์นี้ให้ลูกค้า หรือแชร์โค้ดให้เพื่อนในทีมเอาไปใช้ต่อ พวกเขาไม่จำเป็นต้องมานั่งเปิดหน้า Google Sheets แล้วไล่สร้างแท็บทีละแท็บ พิมพ์หัวคอลัมน์ทีละคอลัมน์ให้เสียเวลา แค่กดปุ่ม "เรียกใช้" ฟังก์ชันนี้เพียงครั้งเดียว ทุกอย่างจะถูกเนรมิตขึ้นมาพร้อมใช้งานเหมือนกันเด้ง 100%

• โค้ดเป็นระเบียบตามหลักสถาปัตยกรรมซอฟต์แวร์ (Clean Code): การแยกหน้าที่ของโค้ด (Separation of Concerns) ช่วยให้เวลาที่ระบบเกิดปัญหาในอนาคต คุณจะรู้ได้ทันทีว่าต้องไปแก้ไขที่จุดไหน ไม่ต้องไปรื้อโค้ดฟังก์ชันบันทึกข้อมูลหลักให้ปวดหัว

7. ข้อควรระวังที่มือใหม่มักพลาด!

แม้ว่าฟังก์ชันนี้จะดูเรียบง่าย แต่มีจุดตกม้าตายที่ต้องระวังอยู่ 2 เรื่องหลักๆ ครับ:

1. ระวังการเขียนทับข้อมูลเก่า (Data Overwrite): สังเกตไหมครับว่าในโค้ดตัวอย่าง มีการใช้คำสั่ง if (!targetSheet) เพื่อเช็คก่อนว่ามีชีทนั้นอยู่แล้วหรือยัง หากเราลืมเช็คเงื่อนไขนี้ แล้วสั่งให้ระบบสร้างใหม่หรือล้างค่า (Clear) ทุกครั้งที่รัน ข้อมูลเก่าที่ลูกค้าหรือผู้ใช้เคยบันทึกไว้ในอดีตอาจจะหายวับไปกับตาได้ทันที!

2. สิทธิ์การเข้าถึงไฟล์ (Permissions): เนื่องจากฟังก์ชันนี้มีการสั่งสร้างแท็บใหม่และเขียนข้อมูลลงสเปรดชีต ในการรันครั้งแรกสุด Google จะขึ้นหน้าต่างป๊อปอัปเพื่อขอสิทธิ์การเข้าถึง (Authorization) โปรแกรมเมอร์มือใหม่ต้องกดยอมรับสิทธิ์ให้เรียบร้อย ระบบจึงจะสามารถทำงานได้เต็มประสิทธิภาพครับ

สรุป

ฟังก์ชัน initializeSheets() ภายใต้หมวดหมู่ INITIALIZATION ไม่ใช่เรื่องยากเกินเอื้อมสำหรับมือใหม่ แต่มันคือ "ก้าวแรกสู่การเป็นมืออาชีพ" ที่จะช่วยให้คุณออกแบบระบบบน Google Apps Script ได้อย่างมั่นคง ปลอดภัย และมีความเป็นสากล

หากคุณกำลังจะเริ่มโปรเจกต์ใหม่ในวันนี้ อย่าลืมสร้างฟังก์ชันตั้งค่าเริ่มต้นเอาไว้เป็นฐานรากของบ้าน เพื่อให้แอปพลิเคชันของคุณเติบโตได้อย่างแข็งแรงและไร้รอยต่อครับ!