체육대회 점수 관리 시스템
반대항전 6종목과 단합 미니게임(6~7개), 응원·질서 점수를 입력하고 학년별 반 순위를
실시간으로 집계·시상하는 교사 전용 웹앱입니다.
- 입력: 담당 종목을 배정받은 교사가 반별 결과를 입력 → 임시저장 → "최종 제출"
확인 후 제출. 제출 후에도 "수정하기"로 다시 고칠 수 있습니다.
- 결과: 최종 제출된 점수만 집계되며, 제출되는 순간 학년별 순위표에 실시간으로 반영됩니다.
- 관리자: 종목/배점표 관리, 교사 계정 생성·권한·종목 배정, 모든 점수 직접 수정/잠금해제,
변경 이력 조회.
배점 규칙 (기본값, 관리자 화면에서 수정 가능)
| 구분 | 방식 | 점수 |
|---|
| 반대항전 (6종목) | 순위 입력 | 1위 100 / 2위 80 / 3위 60 / 4위 40 / 5위 20 / 6위 이하 0점 |
| 단합 미니게임 (7종목) | 통과/실패 | 통과 20점 / 실패 0점 |
| 응원·질서 | 직접 입력 | 0~10점 |
반 구성: 1학년 112반, 2학년 112반, 3학년 1~14반 (총 38개 반). 시상은 학년별 반 순위로 산정됩니다.
기술 스택
Next.js (App Router) + Supabase (Postgres, Auth, Realtime). 배포는 Vercel을 권장합니다.
시작하기
1. Supabase 프로젝트 생성
- supabase.com에서 새 프로젝트를 생성합니다.
- 완전히 새 프로젝트라면
supabase/full_schema.sql 파일 하나만 SQL Editor에
붙여넣어 실행하면 됩니다 (0001~0019를 하나씩 실행할 필요 없음).
이미 사용 중인 프로젝트에 마이그레이션을 이어서 적용해야 한다면, 기존처럼
supabase/migrations/ 폴더의 0001_... → 0002_... → ... 순서대로 아직 실행하지
않은 파일만 이어서 실행하세요. (또는 Supabase CLI로 supabase db push)
- Project Settings → API 에서
Project URL, anon public key, service_role key를 확인합니다.
2. 환경 변수 설정
.env.local.example을 .env.local로 복사하고 값을 채웁니다.
NEXT_PUBLIC_SUPABASE_URL=...
NEXT_PUBLIC_SUPABASE_ANON_KEY=...
SUPABASE_SERVICE_ROLE_KEY=... # 서버 전용, 절대 클라이언트에 노출 금지
3. 최초 관리자 계정 만들기
앱에는 회원가입 화면이 없습니다 (교사만 접근하는 폐쇄형 시스템). 최초 관리자는 아래 순서로 만듭니다.
-
Supabase 대시보드 → Authentication → Users → "Add user"로 관리자 이메일/비밀번호 계정을 생성합니다.
(가입 즉시 profiles 테이블에 role='teacher' 행이 자동 생성됩니다.)
-
SQL Editor에서 아래 쿼리로 해당 계정을 관리자로 승격합니다.
update public.profiles set role = 'admin' where email = '관리자이메일@school.kr';
-
이후 추가 교사 계정은 관리자 화면(/admin/teachers)에서 생성할 수 있습니다.
4. 로컬 실행
npm install
npm run dev
http://localhost:3000 접속 → 로그인 → 역할에 따라 입력/결과/관리자 화면 이용.
5. 배포
Vercel 등에 배포 시 위 3개 환경 변수를 프로젝트 설정에 동일하게 등록하세요.
데이터 모델 요약
profiles: 로그인 계정 (teacher / admin)classes: 38개 반 목록events: 종목 (반대항전 / 단합 미니게임 / 응원·질서), 배점표 포함event_assignments: 교사 ↔ 종목 배정scores: 종목×반 점수 (draft/final 상태, 자동 배점 계산 트리거 포함)score_audit_log: 모든 점수 변경 이력 (관리자만 조회 가능)
점수 계산과 권한(RLS)은 모두 데이터베이스 레벨에서 강제되므로, 클라이언트 코드가 우회할 수 없습니다.
