구글시트 일괄 예약 검증 방법: 붙여넣기 한 번에 검사하기 (완성본)

// 일괄 검증 설정입니다. 필요하면 여기만 본인 환경에 맞게 바꾸세요.
const BULK_CONFIG = {
  COLUMN_MAP: {                  // 붙여넣기 열 매핑 (0부터 시작, 배열 인덱스 기준)
    date: 0,                     // 0번째: 날짜
    startTime: 1,                // 1번째: 시작시간
    endTime: 2,                  // 2번째: 종료시간
    type: 3,                     // 3번째: 장비유형
    door: 4,                     // 4번째: 도어
    containerNo: 5,              // 5번째: 컨테이너번호
    carrier: 6,                  // 6번째: 운송사
    client: 7,                   // 7번째: 고객사
    remark: 8,                   // 8번째: 비고
    qty: 9,                      // 9번째: 수량
    pallet: 10                   // 10번째: 팔레트수
  },

  // 한 줄이라도 오류가 있으면 "저장" 단계에서 전체를 막을지 여부.
  // 검증 단계에서는 이 값과 상관없이 모든 줄을 끝까지 검사해서 오류 목록을 돌려줍니다.
  REQUIRE_ALL_OR_NOTHING: true,

  // 장비유형 허용 목록 — 앞 편에서 사용하는 BOOK_CAPACITY_CONFIG.VALID_TYPES 와 동일해야 합니다.
  // ['CONTAINER', 'TRAILER'] 외의 값을 추가 허용 목록으로 쓰지 마세요.
  VALID_TYPES: ['CONTAINER', 'TRAILER']
};

/**
 * 여러 줄 예약을 한 번에 검증합니다.
 * @param {Array<Array<*>>} rows 2차원 배열(각 행이 한 예약)
 * @return {{ok: boolean, errors: Array<{rowIndex: number|null, message: string}>, cleanedRows: Array<Object>}}
 */
function validateBulkSlots(rows) {
  const result = { ok: true, errors: [], cleanedRows: [] };

  if (!Array.isArray(rows) || rows.length === 0) {
    result.ok = false;
    result.errors.push({
      rowIndex: null,
      message: '검증할 행이 없습니다.'
    });
    return result;
  }

  const seenContainers = new Set();       // 이번 붙여넣기 안에서만 중복 체크
  const col = BULK_CONFIG.COLUMN_MAP;

  for (let i = 0; i < rows.length; i++) {
    const row = rows[i];
    const displayRow = i + 1;             // 사용자에게 보여줄 줄 번호(1부터)

    try {
      if (!row || row.length === 0) {
        // 완전히 빈 행은 건너뜁니다. APPT_ymd_ 가 빈 값을 던지기 때문입니다.
        continue;
      }

      // 1) 원시 값 꺼내기
      const rawDate = row[col.date];
      const rawStartTime = row[col.startTime];
      const rawEndTime = row[col.endTime];
      const rawType = row[col.type];
      const rawDoor = row[col.door];
      const rawCntr = row[col.containerNo];
      const rawCarrier = row[col.carrier];
      const rawClient = row[col.client];
      const rawRemark = row[col.remark];
      const rawQty = row[col.qty];
      const rawPallet = row[col.pallet];

      // 2) 필수값 검사
      if (!rawDate) {
        throw new Error(displayRow + '행: 날짜 없음');
      }
      if (!rawStartTime) {
        throw new Error(displayRow + '행: 시작 시간 없음');
      }
      if (!rawEndTime) {
        throw new Error(displayRow + '행: 종료 시간 없음');
      }
      if (!rawType) {
        throw new Error(displayRow + '행: 장비유형 없음');
      }
      if (!rawCntr) {
        throw new Error(displayRow + '행: 컨테이너 번호 없음');
      }

      // 3) 날짜·시간 형식 정리
      // 앞 편 [입고예약 기본 5편] 의 APPT_ymd_ 를 그대로 사용합니다.
      const ymd = APPT_ymd_(rawDate);   // 'YYYY-MM-DD' 문자열
      if (!ymd) {
        // APPT_ymd_ 는 잘못된 날짜일 때 예외를 던지므로 이 분기는 거의 오지 않습니다.
        throw new Error(displayRow + '행: 날짜 형식이 잘못되었습니다');
      }

      const startTimeStr = String(rawStartTime).trim();
      const endTimeStr = String(rawEndTime).trim();

      // 앞 편 [입고예약 등록 1편] 의 BOOK_timeToMinutes_ 를 그대로 사용합니다.
      const startMin = BOOK_timeToMinutes_(startTimeStr);
      if (!Number.isFinite(startMin)) {
        throw new Error(displayRow + '행: 시작 시간 형식이 잘못되었습니다');
      }

      const endMin = BOOK_timeToMinutes_(endTimeStr);
      if (!Number.isFinite(endMin)) {
        throw new Error(displayRow + '행: 종료 시간 형식이 잘못되었습니다');
      }

      if (endMin <= startMin) {
        throw new Error(displayRow + '행: 종료 시간이 시작 시간보다 이후여야 합니다');
      }

      // 4) 운영일·운영시간 검사
      // 앞 편 [입고예약 등록 1편] 에서 만든 getDateBlockInfo 를 그대로 사용합니다.
      const blockInfo = getDateBlockInfo(ymd);
      if (!blockInfo) {
        throw new Error(displayRow + '행: 운영정보가 없는 날짜입니다');
      }

      // FULL / CLOSED 는 휴무, PARTIAL 은 예약 가능
      if (blockInfo.holidayType === 'FULL' || blockInfo.holidayType === 'CLOSED') {
        throw new Error(displayRow + '행: 휴무일에는 예약할 수 없습니다');
      }
      if (!blockInfo.open || !blockInfo.close) {
        throw new Error(displayRow + '행: 운영시간이 설정되지 않은 날짜입니다');
      }

      const openMin = BOOK_timeToMinutes_(blockInfo.open);
      const closeMin = BOOK_timeToMinutes_(blockInfo.close);
      if (!Number.isFinite(openMin) || !Number.isFinite(closeMin)) {
        throw new Error(displayRow + '행: 운영시간 설정이 잘못되었습니다');
      }

      // 시작·종료 모두 운영시간 안에 있어야 합니다.
      if (startMin < openMin || startMin >= closeMin) {
        throw new Error(displayRow + '행: 시작 시간이 운영시간 밖입니다');
      }
      if (endMin <= openMin || endMin > closeMin) {
        throw new Error(displayRow + '행: 종료 시간이 운영시간 밖입니다');
      }

      // 5) 장비유형 허용 목록 검사
      const typeKey = String(rawType).trim().toUpperCase();
      if (!BULK_CONFIG.VALID_TYPES.includes(typeKey)) {
        throw new Error(displayRow + '행: 허용되지 않은 장비유형입니다');
      }

      // 6) 정원(용량) 검사
      // 시간대 버그를 피하기 위해 'YYYY-MM-DD' 를 직접 year, month, day 로 쪼갭니다.
      const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(ymd);
      if (!m) {
        throw new Error(displayRow + '행: 날짜 파싱 오류입니다');
      }
      const year = Number(m[1]);
      const month = Number(m[2]); // 1~12
      const day = Number(m[3]);

      const dateObj = new Date(year, month - 1, day); // 로컬 기준 자정
      // BOOK_getSeqUsageForSlotCore_ 는 "슬롯 단위" 기준 시각만 필요하므로 시작 시각 기준으로 계산합니다.
      const timeObj = new Date(year, month - 1, day, Math.floor(startMin / 60), startMin % 60);

      const usage = BOOK_getSeqUsageForSlotCore_(dateObj, timeObj, typeKey);
      if (!usage || !Number.isFinite(usage.remaining)) {
        throw new Error(displayRow + '행: 용량 정보를 불러오지 못했습니다');
      }
      if (usage.remaining <= 0) {
        throw new Error(displayRow + '행: 정원 초과 슬롯입니다');
      }

      // 7) 이번 붙여넣기 내 중복 컨테이너 검사
      const keyCntr = String(rawCntr).trim().toUpperCase();
      if (seenContainers.has(keyCntr)) {
        throw new Error(displayRow + '행: 붙여넣은 목록 안에서 컨테이너 중복입니다');
      }
      seenContainers.add(keyCntr);

      // 8) 수량·팔레트 유효성 검사
      const qtyNum = (rawQty === '' || rawQty == null) ? 1 : Number(rawQty);
      if (!Number.isFinite(qtyNum) || qtyNum <= 0) {
        throw new Error(displayRow + '행: 수량이 잘못되었습니다');
      }

      const palletNum = (rawPallet === '' || rawPallet == null) ? 0 : Number(rawPallet);
      if (!Number.isFinite(palletNum) || palletNum < 0) {
        throw new Error(displayRow + '행: 팔레트 수가 잘못되었습니다');
      }

      // 9) 통과한 행을 정리해서 저장
      result.cleanedRows.push({
        // 날짜·시간·유형·컨테이너는 검증/정규화된 값으로, 나머지는 트리밍해서 저장합니다.
        date: ymd,
        startTime: startTimeStr,
        endTime: endTimeStr,
        type: typeKey,
        door: rawDoor ? String(rawDoor).trim() : '',
        containerNo: keyCntr,
        carrier: rawCarrier ? String(rawCarrier).trim() : '',
        client: rawClient ? String(rawClient).trim() : '',
        remark: rawRemark ? String(rawRemark).trim() : '',
        qty: qtyNum,
        pallet: palletNum
      });

    } catch (e) {
      // 행 단위 오류만 잡아서 누적합니다. 다른 행 검사는 계속 진행합니다.
      result.ok = false;
      result.errors.push({
        rowIndex: displayRow,
        message: e && e.message ? e.message : String(e)
      });

      // REQUIRE_ALL_OR_NOTHING 가 true 라도, "검증" 단계에서는
      // 어디가 어떻게 잘못됐는지 모두 보여주는 것이 목적이므로
      // 여기서 반복을 멈추지 않습니다. 실제 "저장" 단계에서만 전체 차단 여부를 쓸 예정입니다.
    }
  }

  result.ok = result.errors.length === 0;
  return result;
}

/**
 * validateBulkSlots 동작을 테스트합니다.
 * - 1행: 정상
 * - 2행: 시작 시간 누락 → "시작 시간 없음"
 * - 3행: 종료 시간 형식 오류 → "종료 시간 형식이 잘못되었습니다"
 * - 4행: 종료 시간이 시작보다 앞섬 → "종료 시간이 시작 시간보다 이후여야 합니다"
 * - 5행: 잘못된 장비유형 → "허용되지 않은 장비유형입니다"
 * - 6행: 수량 문자 → "수량이 잘못되었습니다"
 */
function BULK_testValidateSlots_() {
  const sampleRows = [
    // 날짜        시작     종료     유형        도어  컨테이너  운송사     고객사    비고  수량   팔레트
    ['2026-08-30', '09:00', '10:00', 'CONTAINER', 'D1', 'C001',  'CARRIER1', 'CLIENT1', '', 1,    0],     // 1행 정상
    ['2026-08-30', '',       '11:00', 'CONTAINER', 'D2', 'C002',  'CARRIER2', 'CLIENT2', '', 1,    0],     // 2행 시작 시간 비움
    ['2026-08-30', '11:00',  'aa:bb', 'CONTAINER', 'D3', 'C003',  'CARRIER3', 'CLIENT3', '', 1,    0],     // 3행 종료 시간 형식 오류
    ['2026-08-30', '13:00',  '12:00', 'CONTAINER', 'D4', 'C004',  'CARRIER4', 'CLIENT4', '', 1,    0],     // 4행 종료<시작
    ['2026-08-30', '14:00',  '15:00', 'XYZ',       'D5', 'C005',  'CARRIER5', 'CLIENT5', '', 1,    0],     // 5행 잘못된 유형
    ['2026-08-30', '16:00',  '17:00', 'CONTAINER', 'D6', 'C006',  'CARRIER6', 'CLIENT6', '', 'ABC', 0]     // 6행 수량 문자
  ];

  const result = validateBulkSlots(sampleRows);
  Logger.log(JSON.stringify(result, null, 2));

  if (result.ok) {
    Logger.log('전체 통과했습니다. 통과 행 수: ' + result.cleanedRows.length);
  } else {
    Logger.log('오류 행 수: ' + result.errors.length);
    result.errors.forEach(function (err) {
      Logger.log(err.rowIndex + '행 오류: ' + err.message);
    });
  }
}

   !Number.isFinite(qtyNum) || qtyNum <= 0

   const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(ymd);
   const dateObj = new Date(year, month - 1, day);
   const timeObj = new Date(year, month - 1, day, hour, minute);