온기 쿠폰 — 구글시트 연동 설정

이 파일은 연결 준비가 된 버전입니다. 시트와 웹 앱의 실제 배포가 끝나야 연동됩니다.
1. 전달해주신 구글시트 첫 탭(gid=0)에 연결하도록 설정했습니다. 탭 이름은 그대로 두어도 됩니다.
시트: https://docs.google.com/spreadsheets/d/1WixGvBtGLR8eS_d7lMDH7nv4Xho3nAklTZQyK5aCYDs/edit?gid=0
A1 이름 / B1 작성 통수 / C1 기수 / D1 링크코드 / E1 쿠폰링크
A2 김예시 / B2 3 / C2 18 (D와 E는 비워둡니다.)
작성 통수는 0~12 정수입니다. 13통 이상은 지원하지 않습니다.

2. 확장 프로그램 > Apps Script를 열고 Code.gs 내용을 붙여 넣고 저장합니다.
시트를 새로고침하면 '온기 쿠폰' 메뉴가 나타납니다.
'1. 연결 초기 설정'을 실행하고 구글의 권한 요청을 확인합니다.
표시된 연결키는 본인의 Cloudflare 설정에만 넣고 다른 사람에게 전달하지 마세요.

3. Apps Script 오른쪽 위 배포 > 새 배포 > 유형 웹 앱을 선택합니다.
실행 사용자: 나 / 액세스 권한: 모든 사용자 (로그인 없이 접근 가능한 옵션)
조직 정책에 따라 이 옵션이 없다면 기관 관리자의 설정이 필요합니다.
배포 후 /exec로 끝나는 웹 앱 URL을 복사합니다. /dev 주소는 사용하지 않습니다.
시트의 링크 공유를 공개로 바꿀 필요는 없습니다.

4. Cloudflare Pages 프로젝트의 Settings에서 Variables and Secrets를 찾습니다.
운영 환경(Production)에 다음 두 값을 추가합니다.
GOOGLE_SCRIPT_URL = 3단계의 /exec 주소
COUPON_API_SECRET = 2단계의 연결키 (Secret으로 저장)
이번 ZIP을 Create a new deployment로 배포/재배포합니다.
_worker.js와 _routes.json을 포함한 전체 ZIP을 올려주세요.
미리보기 환경에서 테스트하려면 같은 변수들을 Preview에도 설정해야 합니다.

5. 시트의 온기 쿠폰 > 2. 개인 링크 만들기를 누릅니다.
Cloudflare 배포 주소를 넣으면 D열과 E열이 자동으로 채워집니다.
각 우체부님에게 E열의 본인 링크를 보내주세요.
이름이 같은 사람이 있어도 행별 링크코드로 구분합니다.

이후 운영
- B열 작성 통수를 수정하고 같은 링크를 다시 열면 변경된 통수가 반영됩니다.
- 이름이나 기수 수정도 다시 접속할 때 반영됩니다.
- 이미 열려 있는 화면이나 저장한 PNG는 자동 변경되지 않습니다.
- 링크코드를 지우거나 바꾸면 기존 링크를 사용할 수 없게 됩니다.
- 행을 정렬할 때는 A~E 전체 행을 함께 정렬해 주세요.
- 한 사람의 다른 기수 기록은 별도 행으로 만듭니다. 기수가 끝난 행은 유지해 주세요.
- 과거 쿠폰은 해당 기수의 통수를 확정한 뒤 수정하지 않아야 기록이 보존됩니다.
- 시트 전체 명단은 봉사자에게 내려주지 않습니다. 요청된 코드의 이름·통수·기수만 반환합니다.
- 연결키는 Cloudflare 서버와 Apps Script에서 사용하며 브라우저에 내려주지 않습니다.
- 개인 링크를 가진 사람은 쿠폰을 볼 수 있으므로 링크를 공개 게시하지 마세요.
- 기존 #n=이름&c=통수 링크는 당시 값으로만 동작합니다. 새 #id=링크코드 링크를 사용하세요.
- 구글 웹 앱의 호출 제한이나 기관 계정 정책에 따라 운영 조정이 필요할 수 있습니다.
- 장기 보관을 위해 시트, Apps Script, 웹페이지 파일, 계정과 도메인을 유지해야 합니다.