새소리단 활동 플랫폼

파일	설명
index.html	Supabase 연동판. 여러 사람이 각자 기기에서 함께 사용합니다.
standalone.html	서버 없이 도는 단일 파일판. 데이터가 그 브라우저에만 저장됩니다. 시연·연습용.
supabase/schema.sql	데이터베이스 테이블 · 권한(RLS) · 파일 저장소 설정

---

설치 순서 (약 15분)

1. Supabase 프로젝트 만들기

supabase.com 에서 무료 프로젝트를 하나 만듭니다. 지역은 Northeast Asia (Seoul) 을 고르면 빠릅니다.

2. 데이터베이스 설정

대시보드 좌측 SQL Editor → New query → supabase/schema.sql 내용을 전부 붙여넣고 Run.

테이블, 권한 정책, media/docs 파일 저장소가 한 번에 만들어집니다. 다시 실행해도 안전합니다.

3. 익명 접속 켜기

Authentication → Sign In / Providers → Anonymous sign-ins 를 켭니다. 로그인 없이 소개·소식을 보고 의견함에 글을 남기려면 필요합니다.

4. 메일 인증 (선택)

내부에서만 쓴다면 Authentication → Sign In / Providers → Email → Confirm email 을 끄면 가입 즉시 로그인됩니다. 켜두면 가입자가 메일의 링크를 눌러야 합니다.

5. 접속 정보 입력

index.html 을 브라우저로 엽니다. 설정 화면이 나오면 Project Settings → API 의 두 값을 넣습니다.

• Project URL — https://xxxxxxxx.supabase.co
• anon public 키

anon 키는 공개되어도 되는 키입니다. 실제 권한은 데이터베이스의 RLS 정책이 결정하므로, 이 키를 알아도 남의 영수증은 볼 수 없습니다.

여러 사람에게 배포할 때는 index.html 위쪽의 이 줄에 값을 미리 박아두면 각자 입력할 필요가 없습니다.

const BAKED = { url:'', anonKey:'' };

6. 첫 관리자 지정

회원가입을 한 번 한 뒤, SQL Editor에서 이메일만 본인 것으로 바꿔 실행합니다.

update public.profiles set role = 'admin', name = '운영 관리자'
  where id = (select id from auth.users where email = '[email protected]');

이후 회원 · 권한 관리 메뉴에서 나머지 사람들의 권한을 화면으로 올릴 수 있습니다.

7. 배포

index.html 하나만 올리면 됩니다. Netlify Drop, Vercel, GitHub Pages, 기관 웹서버 어디든 됩니다.

---

권한 구조

권한	볼 수 있는 것	할 수 있는 것
일반 방문자 (visitor)	소개, 소식, 의견함, 일정	의견·댓글 작성, 본인 글 삭제
새소리단 단원 (member)	+ 공지방, 자유방, 활동 공유방	+ 게시글 작성, 보고서 제출, 정산 신청, 일정 등록
혁신행정담당관 (officer)	+ 전체 보고서·정산·영수증	+ 승인/반려 처리, 공지 작성
운영 관리자 (admin)	전체	+ 권한 부여, 소개 편집, 게임 등록, 모든 글 삭제

가입한 사람은 전부 visitor 로 시작합니다. 권한 승격은 관리자만 할 수 있고, DB에서만 바뀝니다.

---

핵심 요구사항이 지켜지는 방식

"단원이 영수증을 첨부하면 혁신행정담당관이 볼 수 있게" — 이건 화면에서 버튼을 숨기는 방식이 아니라, 데이터베이스 정책으로 막습니다.

create policy expenses_select on public.expenses for select
  using ( author_id = auth.uid() or public.is_officer() );

영수증 파일도 마찬가지로 비공개 docs 버킷에 들어가고, 열람 권한이 없으면 Supabase가 파일 주소 자체를 내주지 않습니다. 브라우저 개발자 도구로 코드를 고쳐도 남의 영수증은 나오지 않습니다.

익명 별칭 — 의견함의 새소리1, 새소리2 … 는 접속 IP를 SHA-256으로 해시한 값에 순번을 매긴 것입니다. IP 원본은 어디에도 저장하지 않습니다. 별칭은 DB 트리거가 붙이므로 클라이언트가 다른 사람 별칭을 사칭할 수 없습니다.

같은 사무실·같은 공유기에서 접속하면 IP가 같아 같은 별칭으로 보일 수 있습니다. 이건 IP 기준 별칭의 원래 성질입니다. 사람별로 구분하려면 schema.sql 의 my_alias() 에서 public.client_ip() 를 auth.uid()::text 로 바꾸면 됩니다.

---

무료 한도

Supabase 무료 플랜 기준 — 데이터베이스 500MB, 파일 저장소 1GB, 월 전송량 5GB. 사진은 업로드 전 1600px / 품질 0.75로 자동 축소되어 장당 200~400KB 정도입니다. 대략 사진 3,000장 수준까지 무료로 쓸 수 있습니다.

---

문제가 생기면

증상	확인할 것
"익명 로그인이 꺼져 있습니다"	3번 — Anonymous sign-ins 켜기
가입은 됐는데 로그인이 안 됨	4번 — 메일 인증 대기 중이거나 Confirm email 설정
글쓰기 버튼이 안 보임	권한이 아직 visitor — 6번으로 권한 부여
"권한이 없습니다"	RLS가 정상 작동 중. 해당 작업에 필요한 권한인지 확인
사진이 안 보임	2번 SQL을 끝까지 실행했는지 (media/docs 버킷 생성 부분)