☁️ 수집기 주소 설정

1지금 쓰는 주소

주소는 이 브라우저에만 저장됩니다. 기기마다 한 번씩 넣어 주세요.

2주소 넣기

3우리 학교 수집기 만들기 (선택)

앱스스크립트는 계정마다 하루 실행 시간과 동시 실행 수에 한도가 있어요. 여러 학교가 한 주소를 함께 쓰면 수업 중에 느려질 수 있으니, 학교(또는 선생님) 계정으로 한 번 배포해 두면 좋습니다.

1. 새 구글 스프레드시트를 만듭니다 (sheets.new). 이 시트가 관리 대장이 됩니다.
2. 확장 프로그램 → Apps Script를 열고, 원래 있던 코드를 모두 지운 뒤 아래 [코드 복사]로 받은 코드를 붙여넣고 저장합니다.
3. 배포 → 새 배포 → 유형 웹 앱 · 실행 나 · 액세스 모든 사용자 → 배포 → 권한 승인.
4. 나온 웹 앱 URL을 위 2번 칸에 넣고 [확인하고 저장]을 누릅니다.

코드를 고친 뒤 다시 올릴 때는 배포 → 배포 관리 → 연필(수정) → 새 버전으로 하세요. 새 배포를 누르면 주소가 바뀌어 이미 나눠 준 링크가 끊깁니다.

4선생님 시트 준비

대시보드에서 수업을 처음 열 때 선생님 구글 시트 주소를 한 번 등록합니다. 학생 제출은 그 시트에 실험마다 새 탭으로 쌓여요.

시트 오른쪽 위 공유 → 일반 액세스를 「링크가 있는 모든 사용자」, 역할을 「편집자」로 바꿔 두어야 수집기가 쓸 수 있어요. 학생에게는 시트 주소가 아니라 방 코드와 실험 코드만 전해집니다.

5지능형 과학실 ON 연동 (선택)

학생이 잰 값을 선생님의 지능형 과학실 ON(한국과학창의재단) 탐구수업으로도 보내는 기능이에요. 학생 브라우저 → 이 사이트의 서버(워커) → 과학실 ON 오픈API 순서로 가고, 선생님은 새 수업 만들기 ④단계에서 「과학실 ON으로도 보내기」를 켜면 됩니다.

과학실 ON 인증키는 이 화면이나 브라우저에 넣지 않아요. 사이트 운영자가 Cloudflare 비밀 값 SCION_SERVICE_KEY 로만 넣습니다(Workers & Pages → sciencelab → Settings → Variables and Secrets → Secret). 키는 학생·선생님 화면으로 나가지 않고, 서버가 과학실 ON에 보낼 때만 붙입니다.

1. 지능형 과학실 ON 회원가입 → 오픈API → 오픈API 신청 및 현황에서 업체 「과학쌤과학습」, 제품 「과학쌤과학랩」과 센서 목록을 신청합니다.
2. 발급받은 인증키를 Cloudflare 비밀 값 SCION_SERVICE_KEY 에 넣고 저장합니다.
3. 위 지금 상태가 「인증키 설정됨」으로 바뀌는지 확인합니다(/api/health 의 "scion":true).
4. 과학실 ON에서 탐구수업을 만들고 센서 추가에 우리 수업의 일련번호(LAB-방코드-수업코드-역할)를 넣은 뒤, 학생이 측정해 그래프가 그려지는지 봅니다.

보낼 수 있는 센서는 과학실 ON 정의서에 있는 9종(온도·압력·소리·SpO2·전압·전류·조도·pH·전기 전도도)뿐이에요. 힘·가속도·자기장·CO₂ 같은 값은 보내지 않아요. 자세한 절차: docs/scion/README.md