구글시트 대시보드 자동 갱신 방법: 여러 뷰 한 번에 돌리고 트리거로 자동화하기

// 대시보드 공용 설정 상수  // → 이 편에서만 사용하는 설정

const DASH_CONFIG4 = {                         // → 대시보드 4편 전용 설정
  TODAY_SHEET_NAME: 'TODAY',                   // → 대시보드용 시트 이름
  MAX_REFRESH_MINUTES: 5,                      // → 전체 갱신 허용 시간(분)
  TIMEZONE: 'America/New_York',                // → 공통 시간대
  TRIGGER_FUNCTION_NAME: 'DASH_refreshAllViews', // → 트리거 대상 함수명
};

function DASH_refreshAllViews() {                        // → 세 뷰를 한 번에 갱신
  const lock = LockService.getScriptLock();              // → 스크립트 잠금 객체
  const lockWaitMs = 5 * 1000;                           // → 최대 5초까지 대기

  if (!lock.tryLock(lockWaitMs)) {                       // → 잠금 획득 시도
    Logger.log('[DASH_refreshAllViews] 다른 실행이 진행 중입니다. 이번 실행을 건너뜁니다.'); // → 중복 방지 로그
    return { success: false, reason: 'LOCKED' };         // → 잠금 실패 반환
  }

  const started = new Date();                            // → 시작 시각 기록
  const log = [];                                        // → 실행 결과 로그 배열
  const results = {                                      // → 각 뷰 결과 요약
    daily: { ok: false, count: 0, skipped: false, error: null },
    status: { ok: false, count: undefined, skipped: false, error: null },
    yard: { ok: false, count: undefined, skipped: false, error: null },
  };

  try {                                                  // → 전체 실행 감싸기
    const maxMs = DASH_CONFIG4.MAX_REFRESH_MINUTES * 60 * 1000; // → 허용 총시간(ms)

    // 내부 헬퍼: 남은 시간이 충분한지 검사
    const hasTime = () => {                              // → 남은 시간 확인 함수
      const now = new Date();                            
      const elapsed = now.getTime() - started.getTime(); // → 경과 시간
      return elapsed < maxMs;                            // → 한도 이내 여부
    };

    // 1. 일일 예약 현황 갱신
    if (hasTime()) {                                     // → 시간 여유 확인
      try {
        const dailyCount = DASH_updateApptDailyView();   // → 1편 함수 호출 (숫자 반환)
        results.daily.ok = true;                         // → 성공 표시
        results.daily.count = Number.isFinite(dailyCount) ? dailyCount : 0; // → 건수 기록
        log.push(`Daily view updated: ${results.daily.count}`); // → 결과 로그
      } catch (e) {
        results.daily.error = e.message || String(e);    // → 오류 메시지 저장
        log.push(`Daily view FAILED: ${results.daily.error}`); // → 실패 로그
      }
    } else {
      results.daily.skipped = true;                      // → 시간 부족으로 스킵
      log.push('Daily view skipped due to time limit');  // → 스킵 로그
    }

    // 2. 상태별 예약 현황 갱신
    if (hasTime()) {                                     // → 남은 시간 재확인
      try {
        const statusResult = DASH_updateApptStatusView(); // → 2편 함수 호출 (숫자 또는 undefined)
        results.status.ok = true;                        // → 성공 표시
        if (Number.isFinite(statusResult)) {             // → 숫자 반환 시
          results.status.count = statusResult;
          log.push(`Status view updated: ${statusResult}`); // → 건수 로그
        } else {
          log.push('Status view updated');               // → 성공 로그
        }
      } catch (e) {
        results.status.error = e.message || String(e);   // → 오류 메시지 저장
        log.push(`Status view FAILED: ${results.status.error}`); // → 실패 로그
      }
    } else {
      results.status.skipped = true;                     // → 시간 부족으로 스킵
      log.push('Status view skipped due to time limit'); // → 스킵 로그
    }

    // 3. 야드 트레일러 현황 갱신
    if (hasTime()) {                                     // → 다시 남은 시간 확인
      try {
        const yardResult = DASH_updateYardStatusView();  // → 3편 함수 호출 (숫자 또는 undefined)
        results.yard.ok = true;                          // → 성공 표시
        if (Number.isFinite(yardResult)) {               // → 숫자 반환 시
          results.yard.count = yardResult;
          log.push(`Yard view updated: ${yardResult}`);  // → 건수 로그
        } else {
          log.push('Yard view updated');                 // → 성공 로그
        }
      } catch (e) {
        results.yard.error = e.message || String(e);     // → 오류 메시지 저장
        log.push(`Yard view FAILED: ${results.yard.error}`); // → 실패 로그
      }
    } else {
      results.yard.skipped = true;                       // → 시간 부족으로 스킵
      log.push('Yard view skipped due to time limit');   // → 스킵 로그
    }

  } finally {                                            // → 끝나면 항상 실행
    const ended = new Date();                            // → 종료 시각
    const elapsedMs = ended.getTime() - started.getTime(); // → 경과 시간(ms)
    const elapsedMin = (elapsedMs / 1000 / 60).toFixed(2); // → 분 단위 변환

    log.push(`Elapsed minutes: ${elapsedMin}`);          // → 시간 로그

    if (elapsedMs > DASH_CONFIG4.MAX_REFRESH_MINUTES * 60 * 1000) { // → 한도 초과
      log.push(
        `WARNING: refresh exceeded ${DASH_CONFIG4.MAX_REFRESH_MINUTES} minutes`, // → 경고
      );
    }

    Logger.log('[DASH_refreshAllViews] ' + log.join(' | ')); // → 전체 로그 출력
    lock.releaseLock();                                   // → 잠금 해제
  }

  const anyOk = results.daily.ok || results.status.ok || results.yard.ok; // → 일부 성공 여부
  return {                                              // → 요약 결과 반환
    success: anyOk,                                     // → 하나라도 성공했는지
    results,                                            // → 상세 결과
  };
}

// DASH_refreshAllViews 동작 확인용 테스트 함수
function DASH_testRefreshAllViews() {
  const result = DASH_refreshAllViews();                // → 전체 갱신 실행
  Logger.log(JSON.stringify(result));                   // → 결과를 JSON으로 로그 출력
}

function DASH_getDashboardData() {                        // → 화면용 요약 데이터 생성
  const ss = SpreadsheetApp.getActiveSpreadsheet();       // → 현재 스프레드시트
  const sheet =
    ss.getSheetByName(DASH_CONFIG4.TODAY_SHEET_NAME);     // → TODAY 시트 찾기

  if (!sheet) {                                           // → 시트 없으면
    throw new Error('TODAY 시트를 찾을 수 없습니다.');    // → 오류 던지기
  }

  const lastRow = sheet.getLastRow();                     // → 마지막 행 번호
  let totalAppts = 0;                                     // → 예약 수 합계
  let yardCount = 0;                                      // → 야드 트레일러 수 예시

  // 범위는 최대 10열까지만 안전하게 읽도록 제한
  const maxCol = Math.min(10, sheet.getLastColumn());

  if (lastRow > 1) {                                      // → 데이터가 있을 때만
    const range = sheet.getRange(2, 1, lastRow - 1, maxCol); // → A2 ~ 최대 열 범위
    const values = range.getValues();                     // → 값 읽기

    values.forEach((row) => {                             // → 각 행 반복
      // A열에 값이 있으면 예약 1건으로 간주
      if (row[0]) {
        totalAppts += 1;
      }

      // J열(10번째 열)에 'YARD' 표기가 있고, 실제로 해당 열까지 존재할 때만 집계
      if (row.length > 9 && row[9] === 'YARD') {
        yardCount += 1;
      }
    });
  }

  const now = new Date();                                 // → 현재 시각
  const tz = DASH_CONFIG4.TIMEZONE;                       // → 시간대
  const dateStr = Utilities.formatDate(now, tz, 'yyyy-MM-dd'); // → 날짜 문자열
  const timeStr = Utilities.formatDate(now, tz, 'HH:mm:ss');   // → 시각 문자열

  return {                                                // → 요약 객체 반환
    date: dateStr,                                        // → 오늘 날짜
    totalAppts: totalAppts,                               // → 예약 수
    yardTrailers: yardCount,                              // → 야드 트레일러 수
    refreshedAt: `${dateStr} ${timeStr}`,                 // → 갱신 시각
  };
}

// DASH_getDashboardData 동작 및 기대값 검증용 테스트 함수
function DASH_testGetDashboardData() {
  const data = DASH_getDashboardData();                   // → 요약 데이터 가져오기
  const today = Utilities.formatDate(
    new Date(),
    DASH_CONFIG4.TIMEZONE,
    'yyyy-MM-dd',
  );
  const isValid =
    data.date === today && typeof data.totalAppts === 'number';

  // PASS 여부와 함께 전체 객체를 JSON으로 출력
  Logger.log(
    '[PASS:' + (isValid ? 'true' : 'false') + ']' + JSON.stringify(data),
  );
}

function DASH_resetRefreshTrigger() {                       // → 시간 트리거 재설정
  const funcName = DASH_CONFIG4.TRIGGER_FUNCTION_NAME;      // → 함수 이름 상수
  const triggers = ScriptApp.getProjectTriggers();          // → 현재 프로젝트 트리거

  // 1. 기존 동일 함수 트리거 삭제
  triggers.forEach((t) => {                                 // → 각 트리거 반복
    if (t.getHandlerFunction() === funcName) {              // → 대상 함수인지 확인
      ScriptApp.deleteTrigger(t);                           // → 해당 트리거 삭제
    }
  });

  // 2. 새 시간 트리거 생성
  ScriptApp.newTrigger(funcName)                            // → 새 트리거 생성
    .timeBased()                                            // → 시간 기반 트리거
    .everyMinutes(5)                                        // → 5분마다 실행 예시
    .create();                                              // → 트리거 만들기

  Logger.log(
    `Time trigger for ${funcName} has been reset.`,         // → 로그 출력
  );
}

// 위치: 이미 있는 DASH_addDashboardMenu_(menu) 함수 안, 다른 메뉴들 아래에 한 줄 추가
menu.addItem('대시보드 전체 새로 고침', 'DASH_refreshAllViews');  // → 전체 갱신 버튼