해피워크
행사 단기 아르바이트 모집 → 간편가입·지원 → 전자 근로계약 → 출퇴근 버튼 → 정산·임금명세서 → 월별 신고자료까지 한 번에 처리하는 웹앱입니다.
단톡방에 공고 링크를 올리면, 근무자는 휴대폰으로 가입하고 현장에서 근무 시작 / 근무 종료 버튼만 누르면 됩니다.
GitHub → Vercel(자동 배포) → Supabase(Postgres) 구성입니다.
화면을 만들거나 고칠 때의 기준(원칙·색·모양·움직임·문구·체크리스트)은 docs/DESIGN.md에 있습니다.
기능
근무자 (휴대폰 화면)
- 간편 가입: 이름 · 주민등록번호 · 휴대폰 번호 + 숫자 6자리 비밀번호 (계좌는 선택)
- 공고 보기 · 지원 (여러 날 행사는 가능한 날짜 선택) · 지원 취소
- 확정되면 근로계약서 등 서류를 읽고 손가락으로 전자서명 → 서명해야 출근 버튼이 열림
근무 시작 / 근무 종료 버튼 (서버 시각 기록, 행사장 위치 확인 선택)- 근무 내역 · 실수령 예상액 · 임금명세서 · 근무확인서 출력(PDF 저장)
- 내 정보(계좌·주소) 수정, 비밀번호 변경, 탈퇴
관리자
- 공고 등록: 일정·장소·인원, 시급/일급, 휴게(법정 자동/직접/없음), 절사 단위, 연장·야간 가산(5인 이상), 1일 수당, 공제 방식(일용근로소득세 / 3.3% / 없음), 고용보험, 필요 서류, 자동 확정, 현장 위치(GPS 반경)
- 최저임금(2026년 10,320원) 미달 공고 저장 차단, 예상 일급 미리보기
- 단톡방 모집 문구 자동 생성 · 복사, 공고 복사해서 새 공고
- 지원자 확정/미선발, 대기 전원 확정, 가입자 직접 추가, 연소자(만 18세 미만) 표시
- 날짜별 출퇴근 현황(근무 중/종료/미출근), 지각·조기출근·위치 벗어남 표시, 시각 보정(원본 보존), 수기 등록, 미종료 일괄 종료, 일괄 확정
- 정산표: 기본급·연장·야간·수당·소득세·지방세·고용보험·실지급액, 지급완료 처리, CSV(엑셀)
- 서류 서식 편집기(
{{근로자명}} 같은 자리채움 + 미리보기), 서명 현황, 재서명 요청·무효 처리
- 월별 신고자료 CSV: 일용근로소득 지급명세, 근로내용확인신고(고용·산재), 사업소득 간이지급명세, 근로자 명부
- 월 8일 이상 근무자 경고(국민연금·건강보험 가입 검토), 개인정보 처리 기록(주민번호 열람·자료 내려받기 등)
- 근무자 검색, 주민번호 전체 보기(기록 남음), 비밀번호 초기화, 관리자 권한 부여
기본 서식 3종 (관리자 > 서류 서식에서 수정 가능): 단기(일용) 근로계약서, 안전수칙 준수 및 비밀유지 서약서, 초상권(사진·영상) 활용 동의서
처음 설치 (약 15분)
1) Supabase
- Supabase 대시보드 → New project → 이름
socket-alba, 지역 Northeast Asia (Seoul)
- SQL Editor에
supabase/migrations/ 안의 SQL 파일을 번호 순서대로(0001_…, 0002_…) 붙여넣고 Run
- Project Settings → API에서 Project URL과 secret(service_role) 키를 복사
2) 비밀 값 만들기
npm run gen-keys
나오는 SESSION_SECRET, ENCRYPTION_KEY, ADMIN_SETUP_CODE를 안전한 곳에 보관하세요.
ENCRYPTION_KEY를 잃어버리면 저장된 주민등록번호·계좌번호를 다시 읽을 수 없습니다.
3) GitHub → Vercel
- GitHub에 비공개 저장소를 만들고 이 폴더를 push
- Vercel에서 저장소 Import (Framework: Next.js)
- Environment Variables에 다섯 개 입력:
SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, SESSION_SECRET, ENCRYPTION_KEY, ADMIN_SETUP_CODE
- Deploy. 이후 GitHub에 push할 때마다 자동 배포됩니다.
4) 첫 관리자
배포 주소의 /setup에서 설치 코드(ADMIN_SETUP_CODE)와 관리자 이름·휴대폰·비밀번호를 입력합니다.
관리자가 한 명이라도 생기면 /setup은 더 이상 동작하지 않습니다. 다른 직원은 일반 가입 후 관리자 > 근무자에서 권한을 줍니다.
5) 회사 설정 → 공고 → 단톡방
관리자 > 회사 설정에서 사업자등록번호·주소·직인(투명 PNG)·문의 연락처를 넣고, 공고를 등록한 뒤 문구 복사를 눌러 단톡방에 붙여넣으세요.
로컬 실행
npm install
cp .env.example .env.local # 값 채우기
npm run dev
보안 설계
- 브라우저는 Supabase에 직접 접근하지 않습니다. 모든 조회·저장은 서버(Next.js)에서 secret 키로 하고, 모든 테이블에 RLS를 켜고 공개 키 권한을 없앴습니다.
- 주민등록번호·계좌번호는 AES-256-GCM으로 암호화해 저장하고, 화면에는
900101-1******처럼 가려 보여 줍니다. 중복 가입 확인은 키를 섞은 해시로 합니다.
- 비밀번호는 scrypt 해시, 5회 틀리면 10분 잠금. 비밀번호 변경·초기화 시 다른 기기 로그인은 자동 해제됩니다.
- 로그인 쿠키는 서명된 httpOnly 쿠키(30일). 주민번호 열람·신고자료 내려받기·출퇴근 보정 등은 처리 기록(
audit_logs)에 남습니다.
- 탈퇴 시 근무 기록이 없으면 즉시 삭제, 있으면 근로기준법상 보존 의무(3년) 때문에 계정만 정지하고 기록은 보관합니다.
계산 규칙 (참고용)
| 항목 | 규칙 |
|---|
| 최저임금 | 2026년 시급 10,320원 |
| 휴게(법정 자동) | 휴게를 뺀 근로시간 4시간 이상 30분, 8시간 이상 1시간 |
| 연장·야간 가산 | 5인 이상 사업장 선택 시, 1일 8시간 초과분·22~06시분 시급의 50% |
| 일용근로소득세 | (일급 − 15만원) × 6% × 45%, 지방소득세 10%, 지급 1회 1천원 미만 소액부징수 |
| 사업소득 | 3% + 지방소득세 0.3% |
| 고용보험 | 근로자 부담 0.9% |
세율·보험요율·신고 기한은 바뀔 수 있으니 실제 신고 전에 세무사·노무사 확인을 권장합니다.
폴더 구조
src/app/(site)/ 근무자 화면 (공고, 가입·로그인, 내 근무, 서류, 출력물)
src/app/admin/ 관리자 화면, CSV 내려받기(export/[kind])
src/app/actions/ 서버 액션 (auth, worker, admin)
src/lib/pay.ts 급여·세금 계산
src/lib/docs.ts 서식 자리채움, 모집 문구
src/lib/default-templates.ts 기본 서식
supabase/migrations/ DB 스키마
