구글시트 컨테이너 번호 체크인: 기사 도착 예약 조회 만들기

// 열 번호는 **입고예약 시리즈가 확정한 APPT_MAIN 구조**를 그대로 따른다.
// A 날짜 · B 시작시간 · C 장비유형 · D 도어 · E 컨테이너 · F 운송사 · G 고객사 · H 비고
// I 종료시간 · J 생성일시 · K 수량 · L 팔레트 · M 예약ID — **체크인 상태 열은 아직 없다.**
// 여기서 한 칸이라도 어긋나면 컨테이너 번호를 장비 유형 칸에서 찾게 되어 아무것도 못 찾는다.
const CHK_CONFIG = {                               // → 체크인 설정 모음
  APPT_SHEET_NAME: 'APPT_MAIN',                    // → 예약 메인 시트 이름
  COL_DATE: 1,                                     // → A열: 예약일자
  COL_TIME: 2,                                     // → B열: 시작 시간
  COL_EQUIP_TYPE: 3,                               // → C열: 장비 유형
  COL_DOOR: 4,                                     // → D열: 도어/야드 슬롯
  COL_CNTR: 5,                                     // → E열: 컨테이너 번호
  COL_CARRIER: 6,                                  // → F열: 운송사
  COL_CLIENT: 7,                                   // → G열: 고객사
  SETTINGS_CHECKIN_NOTICE_KEY: 'CHECKIN_NOTICE',   // → 안내문 설정 키
  SETTINGS_BUSINESS_HOURS_KEY: 'CHECKIN_HOURS'     // → 운영시간 설정 키
};                                                 //

// 시간대는 **여기서 문자열로 적지 않는다.** 기본 5편이 만든 `APPT_TZ`(= 프로젝트 시간대)를
// 그대로 쓴다. 화면에는 엉뚱한 지역 시간대를 보내면서 날짜는 프로젝트 시간대로 계산하는
// 어긋남이 이렇게 생긴다. 프로젝트 시간대는 Apps Script 설정에서 America/New_York 로 둔다.

function getInitialDataForCheckIn() {                         // → 체크인 초기 데이터 제공
  const tz = APPT_TZ;                                         // → 기본 5편 프로젝트 시간대
  const now = new Date();                                     // → 현재 시각
  const todayYmd = APPT_ymd_(now);                            // → 'YYYY-MM-DD' 변환
  const settings = loadSettings_();                           // → SETTINGS 시트 읽기

  const noticeKey = CHK_CONFIG.SETTINGS_CHECKIN_NOTICE_KEY;   // → 안내문 키
  const hoursKey = CHK_CONFIG.SETTINGS_BUSINESS_HOURS_KEY;    // → 운영시간 키
  const notice = settings[noticeKey] || '';                   // → 안내문 없으면 빈 문자열
  const hours = settings[hoursKey] || '';                     // → 운영시간 없으면 빈 문자열

  const result = {                                            // → 화면에 보낼 객체
    todayYmd: todayYmd,                                       // → 오늘 날짜
    notice: notice,                                           // → 안내문
    businessHours: hours,                                     // → 운영시간 문자열
    timezone: tz                                              // → 타임존 정보
  };

  return result;                                              // → 웹앱으로 전달
}

function CHK_testInitialData() {                 // → 초기 데이터 테스트
  const data = getInitialDataForCheckIn();       // → 함수 호출
  Logger.log(JSON.stringify(data));              // → 내용 출력
}

function getApptInfoByCntr(cntrRaw) {                         // → 컨테이너 번호로 오늘 예약 찾기
  const ss = SpreadsheetApp.getActiveSpreadsheet();           // → 현재 스프레드시트
  const sheet = ss.getSheetByName(CHK_CONFIG.APPT_SHEET_NAME);// → 예약 메인 시트
  if (!sheet) {                                               // → 시트 없을 때
    throw new Error('예약 시트를 찾을 수 없습니다.');          // → 설정 오류
  }

  const todayYmd = APPT_ymd_(new Date());                     // → 오늘 날짜 문자열

  const cntr = String(cntrRaw || '').trim().toUpperCase();   // → 입력 정리
  if (!cntr) {                                                // → 빈 입력
    return {
      found: false,
      reason: 'EMPTY_CNTR',
      message: '컨테이너 번호를 입력해 주세요.'
    };
  }
  if (cntr.length < 4) {                                      // → 너무 짧은 번호
    return {
      found: false,
      reason: 'INVALID_CNTR',
      message: '컨테이너 번호 형식이 올바르지 않습니다.'
    };
  }

  const lastRow = sheet.getLastRow();                         // → 마지막 행
  if (lastRow < 2) {                                          // → 데이터 없음
    return {                                                  // → 결과 객체
      found: false,                                           // → 미발견
      reason: 'NO_DATA_TODAY',                                // → 오늘 데이터 없음
      message: '오늘 등록된 예약이 없습니다.'                  // → 안내문
    };
  }

  const lastCol = sheet.getLastColumn();                      // → 마지막 열 번호
  const rng = sheet.getRange(2, 1, lastRow - 1, lastCol);     // → 2행부터 전체 열 읽기
  const values = rng.getValues();                             // → 값 2차원 배열

  const matches = [];                                         // → 오늘 일치 행 목록
  let hasOtherDate = false;                                   // → 다른 날짜에 존재 여부
  const dataErrorRows = [];                                   // → 날짜를 못 읽은 '이 컨테이너' 행

  for (let i = 0; i < values.length; i++) {                   // → 각 행 반복
    const row = values[i];                                    // → 한 행
    const dateCell = row[CHK_CONFIG.COL_DATE - 1];            // → 날짜 셀
    const cntrCell = String(row[CHK_CONFIG.COL_CNTR - 1] || '').trim().toUpperCase(); // → 컨테이너
    if (!cntrCell) {                                          // → 컨테이너 없는 행
      continue;                                               // → 볼 것 없다
    }
    // **번호부터 맞춰 본다.** 날짜를 먼저 읽고 실패했다고 넘겨 버리면, 정작 찾는
    // 컨테이너의 날짜가 깨졌을 때 '오늘 예약 없음'으로 잘못 안내하게 된다.
    if (cntrCell !== cntr) {                                  // → 번호 불일치
      continue;                                               // → 건너뛰기
    }

    // 여기서부터는 **찾는 컨테이너의 행**이다. 날짜를 못 읽으면 조용히 넘기지 않는다.
    let rowYmd;                                               // → 행 날짜 문자열
    try {                                                     // → 형식 통일 시도
      rowYmd = (dateCell instanceof Date)                     // → Date·시리얼·문자열 모두
        ? APPT_ymd_(dateCell)                                 // → 'YYYY-MM-DD'
        : APPT_ymd_(String(dateCell).trim());                 // → 공백·'2026-8-3' 도 통일
    } catch (e) {                                             // → 날짜로 못 읽음
      dataErrorRows.push(i + 2);                              // → 사람이 봐야 할 행
      continue;                                               //
    }                                                         //

    if (rowYmd === todayYmd) {                                // → 오늘 날짜
      matches.push({                                          // → 결과에 추가
        rowIndex: i + 2,                                      // → 실제 행 번호
        row: row                                              // → 전체 행 데이터
      });
    } else {                                                  // → 다른 날짜
      hasOtherDate = true;                                    // → 다른 날짜 있음 표시
    }
  }

  // 오늘 예약을 정확히 한 건 찾았다면 그것으로 확정한다. 그 밖의 경우에 날짜가 깨진
  // 행이 있었다면 '예약 없음' 이라고 말해서는 안 된다 — 데이터 문제라고 알려 준다.
  if (matches.length !== 1 && dataErrorRows.length > 0) {     // → 판단할 수 없음
    return {
      found: false,
      reason: 'DATA_ERROR',
      message: '해당 컨테이너 예약 행의 날짜를 읽을 수 없습니다(행 ' +
               dataErrorRows.slice(0, 10).join(', ') + '). 사무실에 문의해 주세요.'
    };
  }

  if (matches.length === 0) {                                 // → 오늘 일치 예약 없음
    if (hasOtherDate) {                                       // → 다른 날짜에만 있음
      return {
        found: false,
        reason: 'OTHER_DATE',
        message: '해당 컨테이너 번호 예약이 다른 날짜에만 있습니다. 예약 날짜를 확인해 주세요.'
      };
    }
    return {
      found: false,
      reason: 'NOT_FOUND_TODAY',
      message: '입력한 컨테이너 번호로 오늘 예약이 없습니다.'
    };
  }

  if (matches.length > 1) {                                   // → 여러 건 발견
    return {
      found: false,
      reason: 'DUPLICATE_CNTR',
      message: '같은 컨테이너 번호로 오늘 예약이 여러 건 있습니다. 사무실에 문의해 주세요.'
    };
  }

  const match = matches[0];                                   // → 유일한 행
  const row = match.row;                                      // → 행 데이터

  const timeCell = row[CHK_CONFIG.COL_TIME - 1];              // → 시간 셀
  const equipType = row[CHK_CONFIG.COL_EQUIP_TYPE - 1] || ''; // → 장비 유형
  const door = row[CHK_CONFIG.COL_DOOR - 1] || '';            // → 도어/슬롯
  const carrier = row[CHK_CONFIG.COL_CARRIER - 1] || '';       // → 운송사
  const client = row[CHK_CONFIG.COL_CLIENT - 1] || '';         // → 고객사

  let timeStr = '';                                           // → 시간 문자열
  if (timeCell instanceof Date) {                             // → Date 인 경우
    timeStr = APPT_hm_(timeCell);                             // → 'HH:mm' 변환
  } else if (timeCell) {                                      // → 값이 있는 경우
    timeStr = String(timeCell);                               // → 문자열 처리
  }

  return {                                                    // → 성공 결과
    found: true,                                              // → 발견됨
    reason: 'OK',                                             // → 정상
    message: '예약을 찾았습니다.',                            // → 안내
    data: {                                                   // → 상세 정보
      rowIndex: match.rowIndex,                               // → 행 번호
      date: todayYmd,                                         // → 날짜
      time: timeStr,                                          // → 시간
      container: cntr,                                        // → 컨테이너 번호
      equipType: equipType,                                   // → 장비 유형
      door: door,                                             // → 도어/슬롯
      carrier: carrier,                                       // → 운송사
      client: client                                          // → 고객사
    }
  };
}

function CHK_testGetApptInfoByCntr_() {         // → 컨테이너 조회 테스트
  const existingCntr = 'TESTCNTR1';             // → 실제 존재하는 번호로 교체
  const missingCntr = 'NO_SUCH_CNTR';           // → 존재하지 않는 번호
  const otherDateCntr = 'OTHER_DATE_CNTR';      // → 다른 날짜에만 있는 번호로 교체

  const res1 = getApptInfoByCntr(existingCntr); // → 있는 번호 조회
  const res2 = getApptInfoByCntr(missingCntr);  // → 아예 없는 번호 조회
  const res3 = getApptInfoByCntr(otherDateCntr);// → 다른 날짜만 있는 번호 조회

  Logger.log('EXISTING: ' + JSON.stringify(res1));  // → 결과 출력
  Logger.log('MISSING: ' + JSON.stringify(res2));   // → 결과 출력
  Logger.log('OTHER_DATE: ' + JSON.stringify(res3));// → 결과 출력
}