개발 이야기

구글시트 자동입력에서 빈칸보다 수기 수정을 먼저 지킨 이유

쇼핑몰 주문의 주소와 연락처를 기존 구글시트에 채우면서, 직원이 수정하거나 지운 값과 동명이인 주문을 어떻게 구분했는지 정리했어요.

사이트 공개일
기록 수정일
기술과 주제
Node.js · PostgreSQL · Google Sheets API · Cafe24 API
이 글의 목차

같은 빈칸도 만들어진 이유는 달랐어요

제작·배송사진을 고객에게 보내는 시스템에서는 주문자 연락처가 있어야 다음 단계로 넘어갈 수 있어요. 기존 구글 주문시트에는 이름과 상품이 입력되어 있어도 주소나 연락처가 빠진 행이 있었어요. 쇼핑몰 주문과 대조해 필요한 값을 채우면, 직원이 같은 정보를 다시 옮기는 일을 줄일 수 있었죠.

그런데 직원도 계속 시트를 편집하고 있었어요. 자동입력한 주소를 고치거나, 잘못 연결됐다고 판단한 연락처를 일부러 지울 수 있어요. 주기적으로 빈칸만 찾는 프로그램은 그 삭제를 누락으로 보고 원래 값을 다시 넣을 수 있어요.

화면에 빈칸 하나가 보이더라도 처음부터 비어 있었는지, 사람이 지웠는지에 따라 다음 행동이 달라져야 했어요. 그래서 자동입력의 기준에 현재 값뿐 아니라 그 값이 어떻게 바뀌었는지를 함께 넣었어요.

주문을 찾는 단계부터 보수적으로 바꿨어요

카페24에서 가져온 주문을 시트의 채널과 이름 등으로 대조했어요. 같은 이름의 주문이 여러 개라면 결제 여부를 확인하고, 자동으로 하나를 고를 수 없는 경우에는 후보를 보여 주도록 했어요.

운영 중에는 결제 미확인 주문을 후보에서 먼저 빼면서 문제가 생겼어요. 같은 이름의 최근 주문이 제외되고 예전 결제 완료 주문만 남자, 시스템은 예전 주문을 유일한 후보로 판단했어요. 후보를 줄이는 규칙이 오히려 잘못된 확신을 만든 거예요.

미결제·결제 미확인 주문도 같은 이름의 후보 비교에 남기고, 실제 입력 가능 여부를 다음 단계에서 판단하도록 바꿨어요.

설명용 조건자동입력 판단
조건에 맞는 결제 완료 주문 한 건필드 보호와 시트 재검증 후 입력 가능
같은 이름의 결제 완료 주문과 결제 미확인 주문후보가 여러 건이므로 확인 대기
결제 미확인 주문만 한 건결제 확인 전으로 보류
이름만으로 연결한 뒤 복사해 넣은 주소가 일치그 주소를 독립적인 연결 근거로 다시 사용하지 않음

마지막 조건도 중요했어요. 프로그램이 앞서 복사한 값으로 자기 판단을 검증하면, 처음의 잘못된 연결이 계속 강화될 수 있어요. 직원이 직접 선택한 연결과 자동으로 추정한 연결을 구분해 관리했어요.

주소와 연락처의 보호 상태를 따로 남겼어요

시트 전체를 잠그면 직원의 업무를 막게 돼요. 대신 주소와 연락처 각각에 자동입력 가능 여부, 마지막으로 본 값, 마지막 자동입력 값, 편집 감지 정보를 남겼어요.

처음 읽었을 때 이미 값이 있는 칸은 직원의 기존 입력으로 보호해요. 자동입력한 뒤 값이 바뀌거나 편집 기록이 생기면 수기 수정으로 바꾸고요. 이때 새 값이 빈 문자열이어도 삭제한 의도로 취급해요.

관측한 상태다음 자동 대조
처음부터 비어 있고 편집 기록도 없음주문이 확정되면 자동입력 검토
직원이 기존에 입력한 값값 유지
자동입력 뒤 직원이 다른 값으로 수정수정한 값 유지
직원이 값을 지워 빈칸이 됨빈칸 유지, 자동 복원하지 않음
관리자가 해당 필드의 보호를 명시적으로 해제새 대조와 검증을 거쳐 자동입력 재개

주소를 수정했다고 연락처까지 모두 보호하는 방식도 피했어요. 필드별로 판단해야 한쪽 수정이 다른 쪽의 정상적인 보완을 막지 않아요.

두 번의 조회 사이에 일어난 편집도 확인했어요

서버가 시트를 읽는 간격 사이에 직원이 값을 수정했다가 지우면, 앞뒤 조회에서는 같은 빈칸으로 보일 수 있어요. 값만 비교해서는 그 사이의 행동을 알 수 없어요.

시트 편집 감지 스크립트가 변경 정보를 남기고, 서버는 마지막 관측 정보와 함께 확인하도록 했어요. 스크립트가 살아 있는지 확인하는 신호도 주기적으로 갱신해요. 운영에서는 최근 5분 안의 정상 신호가 있을 때만 쓰기를 허용했어요. 편집 관측을 믿을 수 없는 상태에서는 빈칸을 발견해도 입력을 멈추는 쪽을 택했어요.

관측한 수정·삭제 상태는 외부 쇼핑몰 주문을 읽기 전에 저장해요. 뒤이어 API 조회가 실패하더라도 이미 확인한 직원의 수정 의도가 사라지지 않게 한 거예요.

업무 흐름

  1. 01시트 값·편집 기록 관측
  2. 02필드 보호 상태 저장
  3. 03쇼핑몰 주문 대조
  4. 04현재 시트 재검증
  5. 05허용된 빈칸만 입력
업무 흐름 개념도

목록에 보이는 주문과 입력할 수 있는 주문을 나눴어요

출고일이 없는 주문은 대조를 확정할 수 없어도 직원이 목록에서 찾아야 했어요. 날짜가 없다는 이유로 목록에서도 제외하면, 입력이 멈춘 이유를 확인하기 어려웠어요.

출고일이 없는 택배 주문도 목록에 표시하고 ‘출고일 확인 필요’로 남기도록 보완했어요. 날짜를 입력한 뒤에는 처음 감지한 시점을 기준으로 대조 범위를 이어가요. 목록은 시스템이 처음 확인한 순서로 정렬하되, 그 시각을 쇼핑몰 주문 생성 시각이라고 부르지는 않아요.

후보가 여러 건인 주문도 같은 원칙이에요. 목록과 보류 이유는 보여 주고, 직원이 확인하기 전까지 입력은 막아요. 조회 가능성과 실행 가능성을 분리하니 자동화가 멈춘 건도 같은 화면에서 다룰 수 있었어요.

입력 직전에도 같은 칸인지 다시 확인했어요

후보를 찾은 순간부터 시트에 쓰는 순간까지 직원의 편집은 계속될 수 있어요. 그래서 이전에 세운 입력 계획만 믿고 쓰지 않아요. 허용된 주문 파일인지, 현재 행과 값이 계획 당시와 같은지, 해당 필드가 보호되어 있지 않은지 다시 확인해요.

동시에 두 대조 작업이 실행되지 않도록 데이터베이스 잠금도 사용했어요. 다만 서버끼리의 잠금은 직원의 시트 편집을 막지 못하므로, 잠금과 쓰기 직전 검증이 함께 필요했어요. 입력을 마친 뒤에는 자동으로 넣은 값과 시각을 남겨 다음 관측에서 수기 변경을 구분해요.

값을 채운 경우와 유지한 경우를 함께 검증했어요

구현 검증에서는 빈칸 자동입력뿐 아니라 기존 값 보존, 자동입력 뒤 수정·삭제, 주소와 연락처의 독립 보호, 오래된 편집 신호에서 쓰기 차단을 확인했어요. 같은 이름의 미결제 주문이 남아 있는 조건도 재현해, 과거 주문으로 확정되던 경우가 확인 대기로 바뀌는지 대조했고요.

운영 반영 기록에서는 실제로 입력한 셀의 값과 표시를 다시 읽고, 인접 값·서식과 기존 발송 설정이 유지되는지 확인했어요. 주문 정보를 입력하는 작업이 고객 메시지를 새로 보내는 동작으로 이어지지 않도록 경로도 나눴어요.

기존 업무 도구에 자동입력을 붙일 때는 얼마나 많은 칸을 채웠는지만으로 동작을 설명하기 어려웠어요. 사람이 고친 값과 지운 값이 다음 대조에서도 유지되는지가 같은 비중의 검증 항목이었어요.