구글시트 예약 상태별 현황 대시보드 만들기 — 대시보드 2편

// 상태별 뷰용 설정입니다.                       // → 상태 요약·상세 위치 정의
const DASH_STATUS_CONFIG = {                     // → 대시보드2 전용 설정
  TODAY_SHEET_NAME: 'TODAY',                    // → 일일 현황 시트 이름
  HEADER_ROW: 1,                                 // → TODAY 헤더 행 번호
  STATUS_COLUMN_INDEX: 7,                        // → TODAY에서 상태가 있는 열 번호 예시(G열이면 7)
  VIEW_INFO_CELL: 'A2',                          // → 기준 날짜 표시 셀
  SUMMARY_START_ROW: 4,                          // → 상태 요약 시작 행
  SUMMARY_START_COL: 1,                          // → 상태 요약 시작 열 (A열)
  DETAIL_START_ROW: 10,                          // → 상세 목록 시작 행
  STATUS_LABELS: [                               // → 화면에 보여줄 상태 이름
    { key: 'WAITING', label: '대기' },           // → 내부 키·한글 라벨
    { key: 'ARRIVED', label: '도착' },           // → 도착 상태
    { key: 'IN_PROGRESS', label: '작업중' },     // → 작업 진행중
    { key: 'DONE', label: '완료' },              // → 작업 완료
    { key: 'OTHER', label: '기타' }              // → 그 외 상태
  ],
  STATUS_MAP: {                                  // → 원시 상태값 → 내부 키 매핑
    'PENDING': 'WAITING',                        // → 예약만 된 상태
    'SCHEDULED': 'WAITING',                      // → 같은 의미로 묶기
    'ARRIVED': 'ARRIVED',                        // → 도착
    'CHECKED_IN': 'ARRIVED',                     // → 체크인 완료
    'IN_PROGRESS': 'IN_PROGRESS',                // → 작업중
    'LOADING': 'IN_PROGRESS',                    // → 로딩중
    'UNLOADING': 'IN_PROGRESS',                  // → 언로딩중
    'COMPLETED': 'DONE',                         // → 완료
    'DONE': 'DONE'                               // → 완료
  }
};

// 상태 뷰 기준 날짜 키를 계산해 씁니다.          // → 기준일 텍스트 기록
function DASH_getViewDateKey_() {                // → 내부 도우미 함수
  const ss = SpreadsheetApp.getActive();        // → 현재 스프레드시트
  const sheet = ss.getSheetByName(              // → TODAY 시트 찾기
    DASH_STATUS_CONFIG.TODAY_SHEET_NAME
  );
  if (!sheet) {                                 // → 시트 없으면
    throw new Error('TODAY 시트를 찾을 수 없습니다.'); // → 오류 발생
  }

  const today = new Date();                     // → 지금 시각
  const tz = 'America/New_York';                // → 고정 시간대
  const y = Utilities.formatDate(               // → 연도 추출
    today, tz, 'yyyy'
  );
  const m = Utilities.formatDate(               // → 월 추출
    today, tz, 'MM'
  );
  const d = Utilities.formatDate(               // → 일 추출
    today, tz, 'dd'
  );
  const key = y + '-' + m + '-' + d;            // → YYYY-MM-DD 문자열

  sheet.getRange(DASH_STATUS_CONFIG.VIEW_INFO_CELL) // → 기준 셀 선택
    .setValue('기준일: ' + key);                // → 텍스트로 기록
  return key;                                   // → 키를 반환
}

// TODAY 시트를 읽어 상태별 요약·상세 뷰를 만듭니다. // → 대시보드2 메인 함수
function DASH_updateApptStatusView() {          // → 메뉴·수동 실행용
  const lock = LockService.getScriptLock();     // → 잠금 객체
  lock.waitLock(30000);                         // → 최대 30초 대기
  try {
    const ss = SpreadsheetApp.getActive();      // → 현재 스프레드시트
    const sheet = ss.getSheetByName(            // → TODAY 시트 찾기
      DASH_STATUS_CONFIG.TODAY_SHEET_NAME
    );
    if (!sheet) {                               // → 없으면
      throw new Error('TODAY 시트를 찾을 수 없습니다.'); // → 오류
    }

    const lastRow = sheet.getLastRow();         // → 마지막 행 번호
    const headerRow = DASH_STATUS_CONFIG.HEADER_ROW; // → 헤더 행
    if (lastRow <= headerRow) {                 // → 데이터 없음
      clearStatusViewArea_(sheet);              // → 기존 뷰 지우기
      DASH_getViewDateKey_();                   // → 기준일만 기록
      return 0;                                 // → 처리 행 수 0
    }

    const lastCol = sheet.getLastColumn();      // → 마지막 열 번호
    const dataRange = sheet.getRange(           // → 데이터 범위
      headerRow + 1, 1,                         // → 헤더 다음 행부터
      lastRow - headerRow,                      // → 데이터 행 수
      lastCol                                   // → 전체 열 수
    );
    const values = dataRange.getValues();       // → 2차원 배열로 읽기

    const statusCol = DASH_STATUS_CONFIG.STATUS_COLUMN_INDEX; // → 상태 열
    const counts = initStatusCounts_();         // → 상태별 카운터 초기화
    const detailRows = [];                      // → 상세 목록 배열

    for (let i = 0; i < values.length; i++) {   // → 각 행 순회
      const row = values[i];                    // → 현재 행

      if (row.join('').trim() === '') {         // → 완전히 빈 행이면
        continue;                               // → 건너뛰기
      }

      const rawStatus = String(row[statusCol - 1] || '') // → 상태값 읽기
        .trim()
        .toUpperCase();

      const key = mapStatusKey_(rawStatus);     // → 내부 키로 변환
      if (!counts.hasOwnProperty(key)) {        // → 사전에 없으면
        counts.OTHER++;                         // → 기타로 올리기
      } else {
        counts[key]++;                          // → 해당 상태 증가
      }

      detailRows.push(row);                     // → 상세 목록에 추가
    }

    DASH_getViewDateKey_();                     // → 기준일 기록
    writeStatusSummary_(sheet, counts);         // → 요약 영역 갱신
    writeStatusDetails_(sheet, dataRange, detailRows); // → 상세 영역 갱신

    return detailRows.length;                   // → 처리된 행 수
  } finally {
    lock.releaseLock();                         // → 잠금 해제
  }
}

// 상태별 카운터 객체를 초기화합니다.            // → 0으로 시작
function initStatusCounts_() {                  // → 내부 도우미
  return {
    WAITING: 0,                                 // → 대기
    ARRIVED: 0,                                 // → 도착
    IN_PROGRESS: 0,                             // → 작업중
    DONE: 0,                                    // → 완료
    OTHER: 0                                    // → 기타
  };
}

// 원시 상태값을 내부 상태 키로 매핑합니다.       // → STATUS_MAP 사용
function mapStatusKey_(rawStatus) {             // → 내부 도우미
  if (!rawStatus) {                             // → 빈 문자열이면
    return 'OTHER';                             // → 기타로 처리
  }
  const map = DASH_STATUS_CONFIG.STATUS_MAP;    // → 매핑 객체
  if (map.hasOwnProperty(rawStatus)) {          // → 정의된 값이면
    return map[rawStatus];                      // → 매핑된 키
  }
  return 'OTHER';                               // → 나머지는 기타
}

// 상태 뷰 요약·상세 영역을 초기화합니다.        // → 이전 결과 삭제
function clearStatusViewArea_(sheet) {          // → 내부 도우미
  const startRow = DASH_STATUS_CONFIG.SUMMARY_START_ROW; // → 요약 시작 행
  const lastRow = sheet.getMaxRows();          // → 시트 최대 행
  const lastCol = sheet.getMaxColumns();       // → 시트 최대 열

  if (lastRow >= startRow) {                   // → 지울 행이 있으면
    const range = sheet.getRange(              // → 요약+상세 범위
      startRow,                                // → 시작 행
      1,                                       // → A열부터
      lastRow - startRow + 1,                  // → 행 수
      lastCol                                  // → 모든 열
    );
    range.clearContent();                      // → 값 지우기
  }
}

// 상태별 카운트를 요약 영역에 씁니다.            // → 위쪽 표 만들기
function writeStatusSummary_(sheet, counts) {   // → 내부 도우미
  const startRow = DASH_STATUS_CONFIG.SUMMARY_START_ROW; // → 시작 행
  const startCol = DASH_STATUS_CONFIG.SUMMARY_START_COL; // → 시작 열
  const labels = DASH_STATUS_CONFIG.STATUS_LABELS; // → 라벨 목록

  const output = [];                            // → 시트에 쓸 2차원 배열
  output.push(['상태', '건수']);                // → 헤더 행

  labels.forEach(function(item) {               // → 각 상태 순회
    const key = item.key;                       // → 내부 키
    const label = item.label;                   // → 한글 라벨
    const count = counts[key] || 0;             // → 개수
    output.push([label, count]);                // → 한 줄 추가
  });

  const range = sheet.getRange(                 // → 출력 범위
    startRow,                                   // → 시작 행
    startCol,                                   // → 시작 열
    output.length,                              // → 행 수
    output[0].length                            // → 열 수
  );
  range.setValues(output);                      // → 값 쓰기
}

// TODAY 데이터에서 읽은 상세 행을 뷰 영역에 씁니다. // → 아래쪽 목록
function writeStatusDetails_(sheet, sourceRange, detailRows) { // → 내부 도우미
  const detailStartRow = DASH_STATUS_CONFIG.DETAIL_START_ROW; // → 상세 시작 행
  const headerRow = DASH_STATUS_CONFIG.HEADER_ROW; // → TODAY 헤더 행
  const lastCol = sourceRange.getNumColumns(); // → 열 개수

  // 먼저 기존 상세 영역만 지웁니다.             // → 다른 영역 보호
  const maxRows = sheet.getMaxRows();           // → 시트 전체 행 수
  if (maxRows >= detailStartRow) {              // → 상세 영역 존재
    const clearRange = sheet.getRange(          // → 상세 전체 범위
      detailStartRow,                           // → 시작 행
      1,                                        // → A열
      maxRows - detailStartRow + 1,             // → 행 수
      lastCol                                   // → 열 수
    );
    clearRange.clearContent();                  // → 내용 지우기
  }

  // 헤더를 TODAY 헤더에서 복사합니다.           // → 동일 헤더 유지
  const headerRange = sheet.getRange(           // → TODAY 헤더 범위
    headerRow,                                  // → 헤더 행
    1,                                          // → A열
    1,                                          // → 1행
    lastCol                                     // → 전체 열
  );
  const headerValues = headerRange.getValues(); // → 헤더 값 읽기

  const totalRows = detailRows.length + 1;      // → 헤더+데이터 행
  if (totalRows <= 1) {                         // → 데이터 없으면
    const destHeader = sheet.getRange(          // → 헤더 위치
      detailStartRow,                           // → 시작 행
      1,                                        // → A열
      1,                                        // → 1행
      lastCol                                   // → 열 수
    );
    destHeader.setValues(headerValues);         // → 헤더만 쓰기
    return;                                     // → 종료
  }

  const destRange = sheet.getRange(             // → 전체 출력 범위
    detailStartRow,                             // → 헤더 위치
    1,                                          // → A열
    totalRows,                                  // → 행 수
    lastCol                                     // → 열 수
  );

  const output = [];                            // → 출력용 배열
  output.push(headerValues[0]);                 // → 첫 행에 헤더
  for (let i = 0; i < detailRows.length; i++) { // → 상세 행 복사
    output.push(detailRows[i]);                 // → 한 행씩 추가
  }

  destRange.setValues(output);                  // → 한 번에 쓰기
}

// 스프레드시트가 열릴 때 한 번 실행되는 공용 onOpen입니다.
// 주의: 프로젝트 전체에서 onOpen은 이 함수 하나만 남기고,
//       나머지 파일들에 있던 onOpen 선언은 삭제하거나 주석 처리합니다.
function onOpen(e) {
  const ui = SpreadsheetApp.getUi();
  const menu = ui.createMenu('예약 도구'); // 공용 상위 메뉴 이름

  // 1) 기본·시드 데이터 메뉴 (입고예약 기본 1·2편)
  if (typeof addApptBaseMenu_ === 'function') {
    addApptBaseMenu_(menu);        // /posts/20260811-q218-906ac0
  }
  if (typeof APPT_addSeedMenu_ === 'function') {
    APPT_addSeedMenu_(menu);       // /posts/20260812-q219-2e1150
  }

  // 2) 설정·웹앱 메뉴 (입고예약 기본 3·4편)
  if (typeof APPT_addSettingsMenu_ === 'function') {
    APPT_addSettingsMenu_(menu);   // /posts/20260812-q220-4bcc4c
  }
  if (typeof APPT_addWebAppMenu_ === 'function') {
    APPT_addWebAppMenu_(menu);     // /posts/20260813-q221-120eba
  }

  // 3) 대시보드 메뉴 (대시보드 1편)
  if (typeof DASH_addDashboardMenu_ === 'function') {
    DASH_addDashboardMenu_(menu);  // /posts/20260821-q233-f92dcd
  }

  // 4) 이 글(대시보드 2편)의 상태별 현황 메뉴를 추가합니다.
  //    다른 add○○Menu_ 함수와 같은 최상위 메뉴 아래에 붙입니다.
  menu.addSeparator()
      .addItem('상태별 현황 갱신', 'DASH_updateApptStatusView');

  menu.addToUi();                  // 실제 UI에 메뉴 추가
}