강사 준비 문서

1 프로젝트 만들기

console.firebase.google.com 접속 → 프로젝트 추가 → 이름은 영문으로 (예: yj-gallery-2026). 애널리틱스는 꺼도 됩니다.

결제 정보는 등록하지 마세요. 무료 범위를 넘으면 과금되는 대신 기능이 멈춥니다.

2 구글 로그인 켜기

Authentication → 시작하기 → Google → 사용 설정 → 지원 이메일 선택 → 저장. SMS 인증은 유료이므로 쓰지 않습니다.

3 데이터베이스 만들기

Firestore Database → 데이터베이스 만들기 → 위치는 asia-northeast3 (서울) → 프로덕션 모드로 시작합니다. 규칙은 다음 단계에서 넣습니다.

4 내 UID 확인하기

작품·점수를 지울 수 있는 사람은 선생님 계정 하나뿐입니다. 그러려면 선생님 계정의 UID를 알아야 합니다.

1. 전시관 페이지를 열어 선생님 구글 계정으로 한 번 로그인합니다. (이걸 해야 목록에 나타납니다)
2. 파이어베이스 콘솔 → Authentication → 사용자 탭
3. 본인 계정 행의 사용자 UID를 복사합니다. 28자쯤 되는 영문·숫자입니다.

5 보안 규칙 붙여넣기

아래에서 여기에-선생님-UID 두 군데를 4단계에서 복사한 UID로 바꾼 뒤, Firestore → 규칙 탭에 통째로 붙여넣고 게시를 누릅니다.

rules_version = '2';
service cloud.firestore {
  match /databases/{database}/documents {

    // 선생님 계정인지 확인하는 함수
    function isAdmin() {
      return request.auth != null
        && request.auth.uid == '여기에-선생님-UID';
    }

    // 작품 — 누구나 보고, 내 것만 내가 올리고, 선생님만 지운다
    match /gallery/{docId} {
      allow read: if true;
      allow create, update: if request.auth != null
        && request.auth.uid == request.resource.data.uid
        && request.resource.data.title is string
        && request.resource.data.title.size() <= 40;
      allow delete: if isAdmin();
    }

    // 랭킹 — 누구나 보고, 내 기록만 내가 올리고, 선생님만 지운다
    match /ranking/{docId} {
      allow read: if true;
      allow create, update: if request.auth != null
        && request.auth.uid == request.resource.data.uid
        && request.resource.data.score is number
        && request.resource.data.score >= 0
        && request.resource.data.score <= 1000000
        && request.resource.data.nickname is string
        && request.resource.data.nickname.size() <= 12
        && request.resource.data.game is string
        && request.resource.data.game.size() <= 30;
      allow delete: if isAdmin();
    }

    match /{document=**} { allow read, write: if false; }
  }
}

6 설정값과 관리자 UID를 전시관 파일에 넣기

프로젝트 설정(⚙️) → 내 앱 → 웹 앱 추가(</>) → 나타나는 firebaseConfig 블록을 복사합니다.

킷의 tool_gallery.html을 열고 ▼ 강사용 — 여기 한 곳만 바꾸세요 ▼ 아래 두 가지를 넣은 뒤 올립니다. 학생은 이 파일을 고칠 일이 없습니다.

• firebaseConfig — 방금 복사한 설정값
• ADMIN_UID — 4단계에서 복사한 선생님 UID

ADMIN_UID를 비워 두면 지금까지처럼 아무도 지울 수 없는 상태가 됩니다. 그것도 안전한 선택입니다.

7 전시관 주소를 승인된 도메인에 등록

Authentication → Settings → 승인된 도메인에 전시관을 올린 도메인을 추가합니다. 선생님 깃허브 아이디가 teacher라면 teacher.github.io입니다.