Files
dbx-corm/docs/history-postgres.md
T

7.4 KiB

문자내역·수동발주내역을 corm_db로 이전

설정은 corm_settings, 문자내역은 corm_sms_history, 수동발주내역은 corm_manual_history에 저장한다. 서버와 계정은 기존 POSTGRES_*, DB 이름은 SETTINGS_DB=corm_db를 공통 사용한다. 기존 itemcode_db의 코드표와 CS 기록은 그대로 유지한다.

동작

  • HISTORY_BACKEND=postgres이면 두 내역의 조회·저장과 문자내역 삭제는 DB만 사용한다. 기존 .dat와 내역 시트에는 추가로 쓰지 않는다.
  • 문자 내역의 고객 정보·상품 목록·할인/배송 옵션·문자 전문을 JSONB에 보존한다. 기록마다 고유 ID를 부여해 목록 순서가 바뀌어도 같은 내역을 선택·삭제한다.
  • 수동발주내역은 기존처럼 한국 시간의 오늘 내역을 표시한다. DB에는 과거 내역도 모두 보관하며 날짜가 바뀌어도 삭제하지 않는다.
  • 실제 발주 입력/엑셀 다운로드에 사용하는 별도 수동 발주 시트는 계속 사용한다.
  • 기존 수동발주 삭제는 발주 시트의 주문 행도 지우는 기능이다. DB 모드에서도 해당 주문 행 삭제를 확인한 뒤 내역을 삭제한다. 구글 장애 시 DB 내역을 보존하고 오류를 표시한다.
  • 같은 일시의 내역이 여러 건이면 주문을 잘못 취소하지 않도록 자동 삭제를 중단한다. 발주 시트에서 대상 주문을 먼저 확인해야 한다.
  • 구글 발주 시트 삭제와 DB 삭제는 서로 다른 서비스라 하나의 트랜잭션으로 묶이지 않는다. 시트 삭제 후 DB 오류가 발생하면 시트의 주문 상태를 확인하고 재시도한다. 없는 시트 행은 재삭제하지 않는다.
  • DB 장애를 저장 성공으로 표시하거나 예전 시트/파일로 자동 우회하지 않는다.

원본 준비

구글 시트에는 상품·문자 텍스트 위주로 저장되고, .dat 파일에 상세 상품 목록과 옵션이 더 남아 있을 수 있다. 따라서 실제 운영 중인 컨테이너의 로컬 내역 파일도 함께 가져와야 한다. 새 일회용 컨테이너에는 이 파일이 자동 복사되지 않는다.

아래는 Linux 서버 프로젝트 폴더에서 실행하는 명령이다. 먼저 설정 DB 이전 문서에 따라 corm_db를 준비하고 새 코드를 빌드한다. .env에는 SETTINGS_DB=corm_db를 지정하고, 내역 모드는 아직 HISTORY_BACKEND=google로 유지한다.

  1. 직원 및 다른 구버전 앱의 문자 생성·발주·내역 저장·삭제와 시트 직접 편집을 잠시 중단하고, 앱을 정지한다.

    mkdir -p .settings-backups
    docker compose stop corm-app
    
  2. 기존 컨테이너에서 원본 파일을 호스트로 복사한다. 아래는 기본 경로 예시다. SMS_HISTORY_FILE·MANUAL_HISTORY_FILE을 따로 지정했다면 해당 경로를 사용한다. 정지된 컨테이너에서도 docker cp가 가능하다. 파일이 없다는 오류가 나면 실제 운영 경로부터 확인한다.

    docker cp dbx-corm:/app/sms_history.dat .settings-backups/legacy-sms.dat
    docker cp dbx-corm:/app/manual_history.dat .settings-backups/legacy-manual.dat
    

    원래 해당 로컬 파일이 존재하지 않았다면 그 파일의 복사와 다음 명령의 해당 --*-local-file 인자를 생략한다. 파일이 없으면 시트에 남은 정보만 이전할 수 있다. 브라우저에만 남아 있는 고객 캐시는 자동 이전하지 않는다.

  3. 구글의 문자내역·수동발주내역 전체와 로컬 파일을 읽어 원본 백업을 생성한다. DB에는 접속하지 않는다.

    docker compose run --rm --no-deps -v "$PWD/.settings-backups:/backups" corm-app python history_migrate.py snapshot --sms-local-file /backups/legacy-sms.dat --manual-local-file /backups/legacy-manual.dat --output /backups/history-source.json
    

    출력된 두 내역 건수와 로컬 파일 유무를 확인한다. 개인 정보나 문자 내용은 콘솔에 출력하지 않는다. 같은 일시의 시트·로컬 기록은 다른 필드도 비교해 한 건씩 병합하고, 매칭되지 않은 기록과 로컬에만 저장된 기록도 보존한다. 같은 일시라는 이유만으로 여러 기록을 한 건으로 합치지 않는다. 형식이 깨진 로컬 JSON은 조용히 누락시키지 않고 이전을 중단한다. 백업에는 원본 전체 행·셀과 로컬 기록도 포함된다. 백업 경로는 덮어쓰지 않으므로 재실행 시 새 파일명을 사용한다.

  4. 백업에서 DB로 이전하고 원본과 전체 내역을 검증한다.

    docker compose run --rm --no-deps -v "$PWD/.settings-backups:/backups" corm-app python history_migrate.py import --input-file /backups/history-source.json --apply --backup /backups/before-history-db.json
    docker compose run --rm --no-deps -v "$PWD/.settings-backups:/backups" corm-app python history_migrate.py verify --input-file /backups/history-source.json
    

    두 테이블의 생성·저장·전체 검증은 하나의 DB 트랜잭션으로 처리한다. 이미 내역이 있으면 덮어쓰거나 중복으로 추가하지 않는다. 빈 원본도 이전 완료 상태로 기록한다. 이전 완료 후 내역을 지웠더라도 재가져오기로 삭제한 내역이 되살아나지 않는다.

  5. .env를 변경하고 앱을 기동한다. 설정도 함께 전환했다면 다음 세 값을 사용한다.

    SETTINGS_DB=corm_db
    SETTINGS_BACKEND=postgres
    HISTORY_BACKEND=postgres
    
    docker compose up -d --no-deps corm-app
    docker compose logs --tail=100 corm-app
    

    두 내역 테이블과 이전 완료 표시가 없으면 기동이 실패한다. 기존 브라우저 탭은 새로고침해 새 ID 기반 동작을 사용한다. 직원 계정으로 과거 문자 불러오기, 고객 정보·문자 옵션 복원, 새 문자내역 저장 및 오늘의 수동발주 내역 표시를 확인한다. 실제 주문 취소를 수반하는 수동발주 삭제 검증에는 테스트 주문을 사용한다. 운영 DB에는 자동 테스트를 실행하지 않는다.

설정을 이미 DB로 이전했다면 설정 이전을 반복할 필요는 없다. 이번에는 위 내역 이전과 HISTORY_BACKEND 전환만 진행한다.

백업과 복귀

정기 백업은 corm_db 전체를 포함한다. 내역을 JSON으로 별도 보관하려면 다음을 실행한다.

docker compose run --rm --no-deps -v "$PWD/.settings-backups:/backups" corm-app python history_migrate.py export --output /backups/current-histories.json

항상 새 파일명을 사용하고 고객 정보가 포함된 백업의 접근 권한을 제한한다. .settings-backups/는 Git과 이미지 빌드에서 제외된다. 이 JSON도 import --input-file로 아직 내역이 없는 DB에 복구할 수 있다. 기존 DB 덮어쓰기는 지원하지 않는다.

전환 직후 복귀가 필요하면 HISTORY_BACKEND=google로 바꾸고 컨테이너를 재생성한다. DB 전환 후의 추가·삭제는 기존 시트/파일에 복제되지 않으므로 복귀 전 DB 내역을 내보내 보관한다. 이전 때 복사한 .dat는 백업이며, Google 모드에서 로컬 상세 복원을 계속 사용하려면 원래 경로에 마운트하거나 복원해야 한다. DB 전환 후 변경이 있었다면 양쪽 자료의 차이를 검토해 복구해야 한다.