실행 방법

1. 로컬에서 실행

pnpm dev

http://localhost:3000

2. 링크

https://coupong.vercel.app

기술 스택

next.js typescript tailwind css zustand tanstack query pwa (next-pwa)

요구사항

• 로그인 / 로그아웃

• 쿠폰 등록

• 쿠폰 조회

  • 쿠폰 정렬
  • 사용 가능한 쿠폰만 보기
  • 쿠폰 검색 (사용처, 쿠폰명 검색)
    • 업로드한 쿠폰에서 키워드 추출

• 쿠폰 상세 조회

  • 쿠폰 사용
  • 쿠폰 수정
  • 쿠폰 삭제

• 프로필 조회

  • 프로필 수정

• 그룹 조회

  • 그룹 선택
  • 그룹 생성
  • 그룹 초대
    • 그룹 초대 받기
    • 초대 목록 조회
  • 그룹 멤버 조회
  • 그룹 나가기

• 쿠폰 알림

  • 쿠폰 추가 시 그룹원들에게 알림
  • 쿠폰 임박 시 그룹원들에게 알림

• supabase crud 권한 설정

Supabase

Extensions

이름	역할
pg_net	DB에서 외부로 HTTP 요청을 보낼 수 있게 해주는 확장
pg_cron	DB 내부에서 동작하는 크론 스케줄러

Functions

이름	스키마	역할
handle_new_user	public	신규 가입자가 생기면 public.users에 대응 행 생성. 이름은 raw_user_meta_data.name → email → '사용자' 순으로 결정
add_creator_to_organization	public	그룹 생성자를 user_organization에 자동 추가하여 멤버로 등록
notify_expiring_coupons	public	Vault에 저장된 webhook_url/webhook_secret을 꺼내 pg_net으로 만료 임박 쿠폰 알림 웹훅을 호출

Triggers

이름	대상 테이블	시점	호출 함수	역할
on_auth_user_created	auth.users	AFTER INSERT	handle_new_user	첫 가입 시 public.users 자동 생성
on_organization_created	public.organizations	AFTER INSERT	add_creator_to_organization	그룹 생성 시 생성자를 멤버로 자동 추가

Cron Jobs

이름	스케줄	실행 내용	설명
notify-expiring-coupons	0 0 * * *	select public.notify_expiring_coupons()	매일 UTC 00:00 (KST 09:00)에 만료 임박 쿠폰 알림 트리거

Vault Secrets

notify_expiring_coupons가 동작하려면 Supabase Dashboard → Project Settings → Vault에 아래 secret이 등록되어 있어야 한다.

이름	값
webhook_url	https://<your-domain>/api/push/expiring-soon 형태의 웹훅 URL
webhook_secret	임의의 긴 랜덤 문자열. Vercel 환경변수 WEBHOOK_SECRET와 동일해야 함

커밋 prefix

	설명
feat	기능 추가
fix	버그 수정
style	스타일 수정
refactor	코드 리팩토링
docs	README 수정