해설사 근무편성표

종이로 돌려보던 월별 근무편성표를 휴대폰에서 보고, 근무자끼리 직접 바꾸고, 바뀐 내용이 모두에게 즉시 보이도록 만든 앱입니다.

• 웹페이지이자 앱입니다. 주소만 알면 컴퓨터에서 열리고, 휴대폰에서는 홈 화면에 추가하면 아이콘이 생겨 앱처럼 열립니다. (설치·스토어 검색 필요 없음)
• 큰 글씨, 큰 버튼. 앱 안에서 글자 크기를 3단계로 키울 수 있습니다.
• 근무 교대는 3단계. 날짜 고르기 → 상대 고르기 → "이렇게 바뀝니다" 확인. 바꾼 직후 같은 화면에서 바로 되돌릴 수 있습니다.
• 근무가 없는 사람과도 바꿉니다. 맞바꿀 근무가 없으면 그 날 비어 있는 분에게 근무를 넘기거나, 반대로 남의 근무를 대신 맡을 수 있습니다.
• 근무 없는 날에도 교대합니다. 내 근무 달력에서 근무가 없는 날을 누르면 그 날 다른 분의 근무를 대신 맡을 수 있습니다.
• 모든 변경이 기록됩니다. 누가·언제·무엇을 바꿨는지 남고, 잘못된 변경은 되돌리기 한 번으로 원상복구됩니다.
• 바뀌면 알려줍니다. 다른 사람이 내 근무를 바꾸면 다음에 앱을 열 때 "언제 · 누구와 바뀌었는지" 알림창이 뜹니다.
• 최초 근무표도 봅니다. 전체 근무표에서 [최초 근무표]로 처음 등록된 모습을 보고, 표를 이미지로 저장할 수 있습니다.
• 근무표 등록은 두 가지 방법. 엑셀 업로드 / 화면에서 직접 입력.

---

1. 계정을 누구 것으로 만들 것인가

요청하신 대로 소유는 다른 분 계정, 나는 협업자로 구성하는 방법입니다.

무료 플랜에서는 배포 서비스(Vercel·Netlify)에 팀원을 추가할 수 없습니다. 그래서 협업은 GitHub에서 하고, 소유는 상대방 계정에 두는 방식이 가장 깔끔하고 돈이 들지 않습니다.

서비스	계정 주인	나의 위치	하는 일
GitHub	상대방	Collaborator (무료)	코드를 여기서 같이 고칩니다
Vercel 또는 Netlify	상대방	(필요 없음)	GitHub에 올린 코드를 자동으로 웹에 띄웁니다
Supabase	상대방	조직 멤버로 초대받음 (무료)	근무표 데이터가 저장되는 곳

설정 순서

1. 상대방이 GitHub에서 저장소를 새로 만들고, Settings → Collaborators → Add people 에서 나를 추가합니다.
2. 이 폴더의 내용을 그 저장소에 올립니다.
3. 상대방이 자기 계정으로 Vercel(또는 Netlify)에 로그인해서 그 GitHub 저장소를 연결합니다. → 이제부터 내가 코드를 GitHub에 올릴 때마다 상대방 소유의 사이트가 자동으로 갱신됩니다.
4. 상대방이 자기 계정으로 Supabase 프로젝트를 만들고, Organization → Team → Invite 로 나를 초대합니다.

이렇게 하면 서비스 소유권은 전부 상대방에게 있고, 나는 코드와 데이터베이스를 자유롭게 손볼 수 있습니다.

---

2. 설치하기 (한 번만 하면 됩니다)

2-1. Supabase 프로젝트 만들기

1. https://supabase.com 에서 새 프로젝트를 만듭니다. (지역은 Northeast Asia (Seoul) 추천)
2. SQL Editor 를 열고 supabase/schema.sql 의 내용을 전부 붙여넣고 실행합니다.
3. 이어서 supabase/seed.sql 을 붙여넣고 실행합니다.
   • 2026년 9월 근무표에 있던 근무지 10곳·해설사 25명이 등록됩니다.
   • 명단은 나중에 앱의 [더보기] → [해설사 명단 관리] 에서 얼마든지 고칠 수 있습니다.

이미 쓰고 계신 곳이라면 schema.sql 을 다시 실행하는 대신 아래 파일들을 순서대로 실행하시면 됩니다. (모두 여러 번 실행해도 안전합니다)

1. supabase/migration_handover.sql — 근무 넘기기 · 되돌리기 권한 확대
2. supabase/migration_original_notice.sql — 최초 근무표 보관 · 근무 변경 알림
3. supabase/migration_change_memo.sql — 변경 이력 한 줄 메모 (쓴 사람만 보임)
4. supabase/migration_memo_visibility.sql — 메모 공개 범위
5. supabase/migration_history_privacy.sql — 변경 이력·메모를 근무자끼리 보지 않게 (나만 · 교대 상대도)

2-2. 첫 관리자 계정 만들기

1. Supabase 대시보드 → Authentication → Users → Add user → Create new user
   • Email: [email protected]
   • Password: 0000jeju-guide-2026 ← PIN 4자리 + 아래 VITE_PIN_PEPPER 값을 붙여쓴 것
   • Auto Confirm User 체크
2. SQL Editor 에서 seed.sql 맨 아래의 update public.members ... 한 줄을 실행합니다.

이제 앱에서 관리자 → PIN 0000 으로 로그인할 수 있습니다.

2-3. 환경 변수 넣기

.env.example 을 복사해 .env 파일을 만들고 값을 채웁니다. (Supabase 대시보드 → Project Settings → API 에서 복사)

VITE_SUPABASE_URL=https://xxxxxxxx.supabase.co
VITE_SUPABASE_ANON_KEY=eyJhbGciOi...
VITE_LOGIN_EMAIL_DOMAIN=guide.local
VITE_PIN_PEPPER=jeju-guide-2026

VITE_PIN_PEPPER 는 한 번 정하면 절대 바꾸지 마세요. 4자리 PIN을 Supabase의 최소 비밀번호 길이에 맞추려고 뒤에 붙이는 고정 문자열입니다. 이 값을 바꾸면 모든 사람의 PIN이 한꺼번에 무효가 됩니다.

Vercel/Netlify에 배포할 때도 같은 값을 환경 변수(Environment Variables) 로 넣어줘야 합니다.

2-4. Edge Function 올리기

계정 관리는 브라우저에서 다룰 수 없는 열쇠가 필요해서 서버 쪽 함수로 되어 있습니다.

방법 A — 대시보드에서 붙여넣기 (쉬움, 권장)

1. Supabase 대시보드 → Edge Functions → Deploy a new function → Via Editor
2. 이름을 manage-user 로 하고, supabase/functions/manage-user/index.ts 내용을 통째로 붙여넣고 배포합니다.
3. Edge Functions → Secrets 에서 아래 값을 추가합니다.
   • LOGIN_EMAIL_DOMAIN = guide.local
   • PIN_PEPPER = jeju-guide-2026

방법 B — 명령어로 배포

Supabase CLI는 전역 설치(npm install -g)가 지원되지 않으므로 프로젝트 안에 설치해서 npx 로 씁니다.

npm install supabase --save-dev
npx supabase login
npx supabase link --project-ref <프로젝트 ref>

npx supabase secrets set LOGIN_EMAIL_DOMAIN=guide.local PIN_PEPPER=jeju-guide-2026
npx supabase functions deploy manage-user

2-5. 로컬에서 확인 / 배포

npm install
npm run dev      # 내 컴퓨터에서 확인
npm run build    # 배포용 파일 만들기 (dist 폴더)

Vercel/Netlify에 GitHub 저장소를 연결하면 npm run build 는 자동으로 실행됩니다.

---

3. 근무자들에게 안내하는 법

문자로 이렇게 보내면 됩니다.

근무표를 휴대폰에서 보실 수 있습니다. 아래 주소를 누르세요. → (배포된 주소) 본인 이름 → 숫자 4자리(처음엔 0000) 를 누르면 됩니다. 자주 쓰시려면 홈 화면에 추가를 해두세요. (앱 안 [더보기] 화면에 방법이 그림으로 있습니다)

• 아이폰: 사파리 아래 공유 버튼(□↑) → 홈 화면에 추가
• 안드로이드: 크롬 오른쪽 위 점 세 개(⋮) → 홈 화면에 추가

---

4. 관리자가 하는 일

하고 싶은 것	어디서
이번 달 근무표 올리기	[더보기] → [근무표 등록하기]
한두 칸만 고치기	[전체 근무표] 에서 칸을 누르면 담당자/휴무를 바꿀 수 있음
명단에 있는 사람들 로그인 계정 만들기	[더보기] → [해설사 명단 관리] → [○명 계정 한 번에 만들기]
새 해설사 추가	[더보기] → [해설사 명단 관리] → [해설사 추가하기]
PIN을 잊은 사람	같은 화면에서 [PIN 초기화] (다시 0000 이 됩니다)
그만둔 사람	같은 화면에서 [사용 중지] (기록은 남고 로그인만 막힘)
잘못된 변경 되돌리기	[변경 이력] 에서 [되돌리기]

근무표 등록 두 가지 방법

1. 엑셀 — [빈 양식 내려받기] 로 받은 파일에 이름을 채워 다시 올립니다. 가장 정확합니다. 첫 줄에 일자와 근무지 이름이 있어야 하고, 쉬는 날은 휴무 라고 적습니다. 올린 결과는 반드시 검토 화면을 거칩니다.
   • 노란 칸 = 비슷한 이름으로 짐작한 곳 (확인 필요)
   • 빨간 칸 = 명단에 없는 이름 (반드시 골라야 저장됨)
2. 직접 입력 — 빈 표를 만들어 칸마다 사람을 고릅니다.

---

5. 변경과 되돌리기가 어떻게 동작하나

• 근무자는 본인이 포함된 교대만 할 수 있습니다. (남의 근무끼리 바꾸는 건 관리자만)
• 바꾸는 방법은 두 가지입니다.
  • 맞바꾸기 — 서로 근무가 있을 때. 두 칸의 담당자를 통째로 맞바꿉니다.
  • 넘기기 — 한쪽이 그 날 근무가 없을 때. 한 칸의 담당자만 바뀝니다. 받는 사람이 그 날 이미 근무가 있으면 거절합니다.
• 같은 날 두 곳에 서게 되는 교대는 막습니다. 그런 조합은 고르는 목록에 아예 나오지 않고, 혹시 통과하더라도 데이터베이스가 거절합니다. (같은 날짜끼리 근무지만 맞바꾸는 것은 됩니다)
• 교대는 두 칸이 한 번에 바뀝니다. 데이터베이스 한 트랜잭션 안에서 처리하므로 "한쪽만 바뀌는" 사고가 나지 않습니다.
• 교대 한 건은 이력에 두 줄로 남되 하나로 묶여 있어서, 되돌리면 두 칸이 함께 원래대로 돌아갑니다.
• 되돌릴 수 있는 사람: 그 변경을 한 본인, 그 변경으로 근무를 주거나 받은 사람, 그리고 관리자.
• 한 번 바뀐 근무를 다시 누르면 [근무 바꾸기] 와 [변경 전으로 되돌리기] 중에서 고를 수 있습니다.
• 되돌린 기록도 이력에 남습니다. (지워지지 않습니다)
• 종이 근무표에서 녹색으로 표시하던 "변경된 칸"은 앱에서도 초록 글씨로 표시됩니다.

---

6. 비용

항목	무료 범위	이 앱의 사용량
Supabase	DB 500MB, 월 활성 사용자 50,000명	해설사 30명 규모는 한참 남습니다
Vercel / Netlify	개인 프로젝트 무료	충분합니다

이 앱은 전부 무료로 운영됩니다.

---

This is the beginning of the README. Read the rest at the original. Read the full README ↗