개발 이야기

하늘색 체크는 예약, 초록색 체크는 발송 완료

체크박스 색상 요청을 구현하며 예약의 소유 정보, 수기 수정, 행 이동과 동시 갱신까지 함께 다뤘어요.

사이트 공개일
기록 수정일
기술과 주제
Google Sheets API · PostgreSQL · 상태 동기화
이 글의 목차

색을 바꾸기 전에 체크의 의미가 달라졌어요

제작사진을 등록한 뒤 미래 시각에 보내도록 예약할 수 있었어요. 기존 주문시트의 체크박스는 실제 발송 성공을 확인한 뒤 채워졌고요. 그러다 의뢰인이 성수기 제작 진행 상황을 보기 위해 예약 건도 체크로 표시해 달라고 요청했어요.

확정한 표시는 예약 대기 하늘색 체크, 발송 성공 초록색 체크였어요. 단순한 색상 변경처럼 보이지만 두 상태 모두 체크값은 TRUE가 돼요. 기존의 ‘체크돼 있으면 이미 보낸 주문’이라는 판정과 충돌하는 요구였어요.

색이 하늘색이면 발송해도 된다고 바꾸는 것도 충분하지 않았어요. 사람이 직접 칠한 칸이나 다른 예약의 체크까지 예외로 통과시킬 수 있기 때문이에요.

이 체크를 어떤 작업이 만들었는지 남겼어요

예약 표시를 만들 때 행에 연결된 developerMetadata에 작업 ID, 주문의 주요 정보로 만든 식별값, 대상 열과 기존 글자색을 함께 기록했어요. 시트를 다시 읽을 때는 화면의 하늘색 체크와 이 정보가 모두 맞는지 확인해요.

셀에서 확인한 상태해석
하늘색 체크와 예약 작업·주문·열이 모두 일치시스템이 표시한 해당 예약
체크는 있지만 예약 소유 정보가 없음임의로 예약으로 해석하지 않음
하늘색이지만 다른 작업의 정보가 연결됨현재 작업의 발송 허용 근거로 사용하지 않음
같은 행에 예약 정보가 중복되거나 주문이 바뀜확인이 필요한 상태

원본의 판단을 읽기 쉽게 요약하면 다음과 같아요. 아래는 실제 코드를 그대로 복사한 것이 아니라 조건을 설명하는 의사코드예요.

text
내 예약 표시인가 =
  체크됨 + 하늘색 확인 + 유효한 예약 정보 한 개
  + 작업 ID 일치 + 주문 식별값 일치 + 대상 열 일치

기존 발송 완료로 차단할 것인가 =
  체크 또는 예약 정보가 있음 AND 내 예약 표시가 아님

예약 표시는 진행 상태를 보여주고, 발송을 계속할 수 있는지는 소유 정보로 확인해요. 색상 하나가 업무 판단을 대신하지 않도록 한 거예요.

기록과 복원을 한 묶음으로 처리했어요

예약을 표시할 때 체크값·색상·예약 정보를 한 번의 batchUpdate에 담았어요. 취소할 때는 시스템이 만든 예약인지 다시 확인하고 체크를 해제하면서 원래 체크박스 색상을 복원해요. 사람이 넣은 체크, 셀 배경, 테두리와 유효성 검사는 임의로 바꾸지 않아요.

서버가 쓰기 응답을 받지 못했다고 같은 예약 정보를 계속 추가하면 중복이 생길 수 있어요. 이때는 시트를 다시 읽어 이미 반영됐는지 확인해 복구해요. 취소 요청도 메모리에 남은 상태만 믿지 않고 실제 예약 정보를 찾아 확인해요.

사진만 올린 초안, 아직 주문을 고르지 않은 건, 지난 예약, 확인 대기 건은 새 예약 표시 대상에서 제외해요. 체크가 ‘사진을 한 번 올렸다’는 뜻으로 넓어지지 않도록 했어요.

행이 움직이거나 사람이 수정하면

주문시트에는 행이 추가될 수 있어요. 고정된 셀 주소만 저장하면 주문이 밀렸을 때 다른 행을 지울 위험이 있어요. 행에 연결한 예약 정보를 다시 찾고, 현재 주문 식별값과 열이 일치하는지 확인한 뒤 갱신해요. 연도가 바뀌더라도 기존 예약이 연결된 원본 시트도 유지해요.

사람이 예약 칸의 체크나 색을 바꿨다면 시스템이 이전 모양으로 조용히 되돌리지 않아요. 발송이나 취소 복원을 보류해 확인하도록 해요. 사람의 수정이 의도적인지 알 수 없기 때문이에요.

기본 체크박스를 유지한 만큼 표시에도 제약은 있어요. 기존 셀 배경을 보존하므로 체크 기호를 항상 같은 흰색으로 보이게 하는 별도 디자인까지 적용한 것은 아니에요.

늦게 끝난 예약 갱신이 완료 표시를 덮지 않게

예약 표시 갱신과 문자 성공 기록은 별도 비동기 작업이에요. 성공을 확인해 초록색으로 바꾼 직후, 먼저 시작한 예약 갱신이 늦게 끝나 하늘색으로 덮을 수 있어요.

그래서 두 작업이 같은 PostgreSQL 자문 잠금을 사용하도록 했어요. 잠금 안에서는 같은 데이터베이스 연결을 재사용해, 이미 잠금을 잡은 요청이 다른 연결을 기다리는 구조도 피했어요.

시트 쓰기에 실패한 경우에도 발송 성공은 되돌리지 않아요. 복구 대상은 시트 기록이에요. 문자를 다시 보내서 화면을 맞추려 하지 않아요.

실제로 확인한 경계

예약 생성→취소 복원, 예약→전달 성공→초록색 전환을 검사했어요. 수기 체크, 소유 정보 없는 하늘색, 중복 예약 정보, 주문 변경, 행 삽입, 응답 유실과 재시작도 포함했어요. 성공 기록과 예약 표시가 경합할 때 완료 색상이 뒤집히지 않는지도 확인했어요.

당시에는 실제 Google Sheets API의 임시 숨김 탭에서 체크·색상·예약 정보의 생성과 제거, 기본 체크박스 유지까지 확인하고 탭을 정리했어요. 단순히 화면 색이 바뀌는지만 보지 않고, 그 표시가 다음 발송 판단에 어떤 영향을 주는지 함께 검증했어요.

작은 표시 변경도 기존 데이터의 의미를 바꿀 수 있어요. 이번에는 체크값에 더 많은 의미를 밀어 넣기보다, 눈에 보이는 표시와 그 표시를 만든 작업의 근거를 함께 관리했어요.