배움나눔 — 학생 질문/답변 웹 앱
학생들이 공부하다 이해하기 어려운 내용을 서로 질문하고 답변하는 학습 커뮤니티입니다.
질문 게시판(반 공유) + 반별 공부방 + KWL 성찰 + 관리자 대시보드로 구성됩니다.
실행 방법
npm install
npm run dev # http://localhost:3000
npm run build # 프로덕션 빌드
동작 모드
앱은 lib/firebase.js의 설정 유무에 따라 두 모드로 동작합니다.
- 실서비스 모드 (Firebase 설정됨 · 현재 상태): Firebase Authentication으로
실제 로그인/회원가입하고, 데이터는 Firestore에 저장됩니다. 권한은
Firestore 보안 규칙과 Cloud Functions가 서버에서 강제합니다.
- 데모 모드 (Firebase 미설정): 브라우저 메모리에 임시 저장(새로고침 시
초기화)되고, 테스트 유저로 자동 입장합니다. 화면·기능을 빠르게 확인할 때만
쓰입니다. (
lib/user.js의 TEST_USER)
인증과 권한
- 로그인: 이메일/비밀번호 + Google 로그인 (
lib/auth.js). 로그인 시
users/{uid} 프로필을 보장하고, 학생은 접속 세션마다 새 익명 닉네임을 받습니다.
- 역할 구조: 최고 관리자(1명) → 선생님(중간 관리자) → 학생.
- 최고 관리자: 부트스트랩 이메일로 지정(코드에 하드코딩). 역할 부여·
선생님 승인/탈퇴 등 최상위 권한.
- 선생님: 회원가입 시 "선생님"으로 신청 → 최고 관리자 승인 시 부여.
대시보드·공지·학생 관리 등 대부분의 관리 권한.
- 학생: 기본 역할. 질문/답변, 공부방 카드, KWL 작성.
- 권한 부여: 클라이언트가 스스로 못 바꾸며, Cloud Functions
setUserRole이
커스텀 클레임으로만 부여합니다. 보안 규칙은 request.auth.token.role을
검사합니다. 화면의 isAdmin(user)는 UI 노출용일 뿐, 실제 강제는 규칙입니다.
배포
- 프론트엔드: Vercel —
main에 push하면 자동 배포됩니다.
- Firebase(규칙·색인·함수·Storage 규칙): 저장소 파일을 원본으로 삼아
CLI로 배포합니다(콘솔에서 직접 수정하지 마세요).
firebase deploy --only firestore,storage,functions
# 또는 개별: firestore:rules / firestore:indexes / storage / functions
firestore.rules / storage.rules — 보안 규칙firestore.indexes.json — 복합 색인 + collectionGroup 필드 오버라이드functions/index.js — Cloud Functions (아래)- Cloud Functions 배포에는 Blaze(종량제) 요금제가 필요합니다(대부분 무료 한도 내).
Cloud Functions (functions/index.js)
setUserRole — 역할(커스텀 클레임) 부여 (관리자만 호출)deleteAuthUser — 탈퇴 시 로그인 계정 삭제 (관리자/교사)onAnswerCreated / onAnswerDeleted — answerCount 서버 집계 + 새 답변 알림weeklyTopAnswerers — 매주 월요일 09시 주간 답변왕 공지
Firestore 데이터 구조
식별 정보(실명·이메일·학번)는 users/{uid}에만 저장하고, 게시물·카드에는
익명 정보(닉네임·이모지)만 넣습니다.
users/{uid} 프로필 (email, realName, displayName, role, requestedRole ...)
questions 질문 (authorId, keyword, resolved, meTooIds[] ...)
└ answers 답변 (하위 컬렉션)
notices 공지 (교사만 작성)
keywords 과목 키워드 (교사만 생성/수정)
classes 반 / joinCodes 입장 코드 / memberships 소속
studyBoards 공부방 보드
└ cards 공부방 카드 (반 멤버 격리)
kwl KWL 성찰 (본인 + 교사만 열람)
폴더 구조
app/page.js 랜딩 + 로그인/회원가입(역할 선택)
app/board/page.js 질문 게시판 (키워드 | 질문 | 공지)
app/study/page.js 반별 공부방
app/admin/page.js 관리자 대시보드
app/report/page.js 학생 학습 리포트
lib/firebase.js Firebase 초기화 (config)
lib/auth.js 인증 (이메일/구글) + 프로필/역할
lib/user.js 현재 사용자 캐시 + 역할 헬퍼
lib/store.js 데이터 레이어 (Firestore ↔ 데모 모드 자동 전환)
functions/index.js Cloud Functions (서버 코드)
자세한 아키텍처·규칙 세부는 CLAUDE.md를 참고하세요.
