학교별 자료 배부 시스템 운영 도움말
자주 사용하지 않아도 다시 따라 할 수 있도록 기본 운영 순서를 정리한 안내서입니다.
보안 주의: 실제 개인정보가 포함된 자료는 기관의 클라우드 이용 승인을 받은 후 등록하세요. Supabase의 service role/secret 키와 인증번호 원본은 웹사이트, GitHub, 채팅에 올리지 마세요.
1. 새 자료 배부 시작
- 관리자 탭에서 관리자 계정으로 로그인합니다.
- 새 배부 건의 제목, 자료 유형, 시작·종료 시각을 입력하고 생성합니다.
- 학교별 비공개 자료라면 CSV 명단을 등록합니다. CSV 열은
school_name, contact_name, code입니다. - 파일 업로드 영역에서 배부 건을 선택합니다.
- 비공개 자료는 배부 대상 학교를 선택한 뒤 파일을 업로드합니다. 공개 자료는 학교를 선택하지 않습니다.
- 등록 파일 및 학교 연결 영역에서 파일명과 학교가 올바르게 연결되었는지 확인합니다.
- 배부 시작·종료 시각과 명단, 파일을 최종 점검합니다.
2. 기존 파일의 학교 연결
v1.1에서 업로드한 파일은 학교 연결 정보가 없을 수 있습니다. 관리자 화면의 등록 파일 및 학교 연결에서 파일별 학교를 선택하고 연결 저장을 누릅니다. 연결 전 파일은 학교 담당자에게 제공되지 않습니다.
3. 학교 담당자 안내
학교 담당자에게 사이트 주소, 배부 건 제목, 학교명, 담당자명, 개별 인증번호를 안내합니다. 인증번호는 다른 학교와 공유하지 않도록 안내합니다. 링크 발급 후 URL은 60초 동안 유효합니다.
4. 자주 확인하는 Supabase 메뉴
- Authentication → Users: 관리자 로그인 계정 생성·확인
- Table Editor → admins: 관리자 UID 등록 여부 확인
- Table Editor → distributions: 배부 건과 기간 확인
- Table Editor → distribution_files: 파일명, Storage 경로, 학교 연결 확인
- Storage → school-files: 실제 파일이 저장된 비공개 버킷 확인
- Edge Functions → Secrets: Pepper 및 허용 도메인 설정 확인
- Edge Functions: 함수 배포 상태와 실행 로그 확인
5. Edge Function 설정
admin-import: Verify JWT ONverify-download: Verify JWT OFF. 학교 인증은 함수 코드 내부에서 수행합니다.CODE_HASH_PEPPER: 인증번호 해시용 비밀값RATE_LIMIT_PEPPER: IP 해시용 비밀값ALLOWED_ORIGINS: Cloudflare Pages 사이트 도메인
6. 배부 종료
관리자 화면에서 해당 배부 건을 선택하고 배부 종료를 누릅니다. 종료 후에는 다운로드 함수가 요청을 차단합니다. 파일을 즉시 삭제하기보다는 기관의 보존·파기 기준에 따라 별도로 처리하세요.
7. 문제 해결
- 학교 파일이 나타나지 않음: 파일과 학교 연결값이 인증 학교명과 정확히 일치하는지 확인합니다.
- 명단 업로드 실패: CSV 열 이름과 Pepper Secret, admin-import JWT 설정을 확인합니다.
- 인증 요청 서버 오류: CODE_HASH_PEPPER와 RATE_LIMIT_PEPPER가 등록되어 있는지 확인합니다.
- CORS 오류: ALLOWED_ORIGINS에 사이트 도메인을 정확히 입력했는지 확인합니다.
- 관리자 권한 오류: Authentication Users의 UID와 admins 테이블의 user_id가 일치하는지 확인합니다.
8. 운영 전 체크리스트
- 기관의 클라우드·개인정보 처리 승인 확인
- 관리자 계정과 권한 최소화
- 배부 기간 및 학교별 명단 재확인
- 파일-학교 연결값 확인
- 가상자료로 타 학교 자료 접근 차단 시험
- 자료 보존·백업·파기 기준 확인