Add database-backed manual order grid with automatic cell saving

This commit is contained in:
2026-10-22 18:33:59 +09:00
parent 399e91518c
commit 827cb3b0a8
18 changed files with 1124 additions and 11 deletions
+62
View File
@@ -0,0 +1,62 @@
# 수동발주 표를 DB로 전환
설정·문자내역·수동발주내역을 `corm_db`로 옮긴 설치에서 사용한다.
같은 DB의 별도 `corm_manual_orders` 테이블에 실제 발주 행을 저장한다.
`itemcode_db`와 CS 기록은 변경하지 않는다.
## 화면과 저장
- 기존 Google 수동 발주 시트의 15개 열 이름·순서와 값을 유지한다. 원본에 추가 열이 있으면 함께 보존한다.
- 프로그램의 수동발주 탭에 편집 가능한 표를 표시한다. 셀을 클릭해 입력하면 약 0.45초 뒤, 또는 셀을 벗어날 때 자동 저장한다. 별도 저장 버튼은 없다.
- Enter/Shift+Enter는 아래/위 셀, Tab/Shift+Tab은 다음/이전 셀로 이동한다. Alt+Enter는 셀 안 줄바꿈이다.
- TSV 형식의 여러 셀 붙여넣기를 지원한다. 필요한 행을 먼저 추가하고 한 번에 1,000셀 이내로 붙여넣는다.
- 입력 중·저장 완료·실패 상태를 표시한다. 실패한 입력은 표에 유지하며 재시도할 수 있다. 미저장 입력이 있는 채로 창을 닫으면 브라우저가 확인한다.
- 같은 셀을 다른 사용자가 먼저 바꿨으면 자동으로 덮어쓰지 않는다. 재시도 시 최신값과 내 입력을 비교해 선택한다.
- 다른 셀에 대한 동시 수정은 DB 행 잠금 안에서 반영한다. 이전 저장 응답을 받지 못한 같은 값의 재시도는 허용한다.
- 다른 사용자의 변경은 편집하지 않는 동안 10초 간격으로 갱신한다. 화면의 새로고침으로 즉시 갱신할 수도 있다.
- 행 추가와 선택 행 삭제를 지원한다. 행 삭제는 DB에 보관 처리하며, Google 시트에는 쓰지 않는다.
- 발주 입력과 수동발주 내역 요약은 같은 DB 트랜잭션으로 저장한다. 브라우저에서 요약을 중복 생성하지 않는다.
- 셀 편집은 값 입력용이다. 수식 계산·Google Sheets의 서식/스크립트는 이 표의 기능에 포함하지 않는다.
## 엑셀 다운로드
기존처럼 발주 자료를 엑셀로 내려받고 현재 표를 비운다. 미저장 셀이 있으면 먼저 저장을 완료한다.
파일 생성·파일 보관·해당 행 보관 처리는 한 트랜잭션에서 수행한다. 파일 생성이 실패하면 표를 비우지 않는다.
내려받는 중 다른 사용자가 추가한 새 행은 함께 지우지 않는다.
표의 **다운로드 기록**에서 최근 10개 파일을 다시 받을 수 있다. 최근 10개만 화면에 표시하며 더 오래된 파일도 DB에서 자동 삭제하지 않는다.
주소·전화·상품코드·우편번호 등은 텍스트로 보존하고, 수량/금액의 일반 정수 값은 숫자로 내보낸다.
`=`로 시작하는 입력은 Excel 수식으로 실행하지 않고 텍스트로 저장한다.
## 서버 실행 명령
다른 앱과 Google 시트에서의 발주 편집을 잠시 중단한 뒤 운영 서버에서 실행한다.
별도 SSH 원격 실행 없이 운영자가 실행하는 명령이다.
```bash
cd /opt/dbx-corm && git pull --ff-only && bash deploy-manual-orders.sh
```
스크립트는 현재 설정·내역 DB 전환 상태 확인 → 이전 환경/이미지 보관 → 새 이미지 빌드 → CORM 정지 →
발주 원본 백업 → 테이블 생성·행/열 전체 이전·읽기 검증 → `.env`의 `MANUAL_ORDERS_BACKEND=postgres` 전환 →
기동·조회 API 점검 순서로 진행한다. 별도 DB 생성은 필요 없다.
백업은 `.settings-backups/manual-<시각>-<프로세스번호>/`에 보관한다.
Google 원본은 수정하거나 지우지 않는다. 이미 DB로 전환된 상태에서 다시 실행하면 현재 DB를 원본으로 백업하며,
기존 DB가 원본과 다르면 덮어쓰지 않고 중단한다.
실패하면 이전 환경/이미지로 앱 재시작을 시도하고, DB와 원본 백업을 보존한다.
전환 후 브라우저를 새로고침한다. 기존 구글 시트 iframe 대신 표가 표시되는지 확인하고,
테스트용 셀 수정 후 저장 완료 표시와 새로고침 후 값 유지를 확인한다.
실제 주문 삭제와 다운로드 후 비우기 검증에는 테스트 발주를 사용한다.
## 백업과 복구
`corm_db` 전체를 정기 백업한다. 이번에 추가되는 테이블은 다음과 같다.
- `corm_manual_sheet`: 열 이름과 최초 이전 정보
- `corm_manual_orders`: 발주 셀·수정 버전·주문 연결 정보·보관 시각
- `corm_manual_exports`: 다시 받을 수 있는 Excel 파일과 해당 행 ID
DB 전환 뒤의 추가·수정·삭제는 기존 Google 시트로 복제되지 않는다.
`MANUAL_ORDERS_BACKEND=google`로 단순 복귀하면 이전 시트 값이 표시되므로,
DB 전환 후 변경이 있다면 현재 발주와 백업을 보관하고 차이를 확인한 뒤 복구한다.