📈 수익률 알리미
보유 종목 + 매수단가 + 목표 수익률을 등록하면, 실시간 시세로 수익률을 계산해 목표 도달 시 브라우저 소리/팝업과 텔레그램으로 알려주는 1인용 웹앱.
Next.js 16 · Supabase(서울) · Vercel(icn1 서울).
설정 순서
- Supabase 프로젝트 생성 (Region: Northeast Asia – Seoul)
- SQL Editor에서
supabase/migrations/ 의 0001_init.sql → 0003_order_date.sql → 0004_prefix_tables.sql 순서로 실행
(모든 테이블은 stockprofit_ 접두어: stockprofit_stocks, stockprofit_holdings, stockprofit_price_cache, stockprofit_alert_events, stockprofit_kv)
- Database → Extensions에서
pg_cron, pg_net 활성화 (배포 후 0002_cron.sql 실행용)
- 환경변수 —
.env.example을 .env.local로 복사해 채우기
KIS_APP_KEY/SECRET 이 없으면 Yahoo Finance(지연 시세)로 자동 폴백 → 계좌 없이도 먼저 써볼 수 있음DATA_GO_KR_KEY: 공공데이터포털 "금융위원회_KRX상장종목정보" 활용신청 후 발급
- 종목 목록 적재(최초 1회)
curl -X POST -H "Authorization: Bearer $CRON_SECRET" http://localhost:3000/api/cron/sync-stocks
npm run dev → http://localhost:3000- Vercel 배포: 저장소 연결, 환경변수 등록.
vercel.json의 regions: ["icn1"]로 함수가 서울에서 실행됨.
배포 후 응답 헤더 x-vercel-id에 icn1이 있는지 확인.
- 탭을 닫아도 알림:
supabase/migrations/0002_cron.sql의 <APP_URL>, <CRON_SECRET>을 바꿔 실행(1분마다 체크).
- 텔레그램: @BotFather로 봇 생성 →
TELEGRAM_BOT_TOKEN 등록 → 앱의 ⚙ 설정에서 "웹훅 등록" → 봇에게 /start.
구조
lib/quotes/* — QuoteProvider (KIS / Yahoo), DB 캐시(장중 3초)로 호출 제한 보호lib/alerts/evaluate.ts — 알람 평가 (조건부 UPDATE로 중복 발송 방지, 목표 −1%p 아래로 내려가면 재무장)- 로그인 없음: URL을 아는 사람은 누구나 접근 가능 (cron/webhook만 시크릿으로 보호)
- Supabase는 서버(service role)에서만 접근, 모든 테이블 RLS ON(정책 없음)
