rabbit

PoC — 내 투자를 요약해주는 도구. 새 아이디어 검증용 레포. 상태: 🛠️ v0 + 투자입력(Postgres) — 로그인 → 거래 입력 → Current Portfolio(KRW·Upbit 시세) → 1년 전망. Next.js + TypeScript + Prisma. (2026-06-26)

▶ 실행 방법 (How to run)

cd /Users/jay/work/task/rabbit
pnpm install        # 최초 1회 (의존성 설치)
cp .env.example .env.local   # 최초 1회 — 아래 "로그인 설정" + DATABASE_URL 채우기

# DB (투자입력·포트폴리오용) — 로컬 Postgres 1개
docker run -d --name rabbit-pg -e POSTGRES_PASSWORD=dev -e POSTGRES_DB=rabbit -p 5432:5432 postgres:16
#   .env.local → DATABASE_URL=postgresql://postgres:dev@localhost:5432/rabbit
pnpm db:push        # 최초 1회 — Trade 테이블 생성 (또는 pnpm db:migrate)

pnpm dev            # 개발 서버 → http://localhost:3000

🔑 로그인 설정 — 최초 1회

1차 구현부터 실행 모드(APP_MODE, 기본 local)에 따라 로그인이 다르다:

local 모드 (기본) — .env.local에 2가지만 채우면 된다:

1. AUTH_SECRET — 생성: npx auth secret (또는 openssl rand -base64 32)
2. LOCAL_PASSWORD — 로컬 로그인용 비밀번호 (직접 정하기)

cloud 모드 (GCP) — Google 로그인. 위에 더해:

1. AUTH_GOOGLE_ID / AUTH_GOOGLE_SECRET — Google Cloud Console → OAuth 2.0 클라이언트 ID 생성
   • Authorized redirect URI에 http://localhost:3000/api/auth/callback/google 등록 (배포 시 운영 도메인도 추가)
2. ALLOWED_EMAILS — 접근 허용 이메일(콤마 구분). 본인만 쓰면 한 개. 비우면 누구나 로그인되니 운영에선 꼭 설정.

🗄️ DB 설정 (투자입력 · 포트폴리오) — 최초 1회

/invest(투자입력) 탭은 거래를 Postgres에 저장한다. 로컬은 Docker로 띄운다 (위 실행 블록에 포함):

docker run -d --name rabbit-pg -e POSTGRES_PASSWORD=dev -e POSTGRES_DB=rabbit -p 5432:5432 postgres:16
# .env.local → DATABASE_URL=postgresql://postgres:dev@localhost:5432/rabbit
pnpm db:push     # Trade 테이블 생성 (마이그레이션 히스토리가 필요하면 pnpm db:migrate)

시세는 Upbit 공개 API(키 불필요, KRW)로 자동 조회 → 평균단가·평가손익 계산. 클라우드 DB(Cloud SQL)는 docs/runbooks/cloud-sql-setup.md 참고.

브라우저에서 http://localhost:3000 접속 →

1. / — know.html 공개 랜딩 → 우상단 로그인 → 버튼
2. 로그인 성공 → /summary (BTC·ETH·S&P 500·KOSPI, 60초 갱신)
3. 상단 탭: 요약(/summary) · AI 챗(/chat) · 투자입력(/invest, KRW·DB) · 포트폴리오(/dashboard, v0 인메모리)
   • AI 챗의 👤 About Hyunjae 토글: 방문자(잠재 고용주·고객)가 Hyunjae Lee에 대해 물으면 프로필·프로젝트 기반 RAG로 답함. 설계 → features/ai-chat.md (공개 게이팅 설계는 같은 문서의 Auth + LLM gating 섹션)
4. 투자입력 테스트: Transactions History에서 Buy · BTC · 0.1 · 95000000 추가 → Current Portfolio가 Upbit 시세로 자동 갱신(평가액·손익).

프로덕션 빌드 확인:

pnpm build          # 타입체크 + 빌드 (✅ 통과 확인됨)

시작 시드로 BTC·ETH 예시가 들어 있다. ✕ 로 지우고 직접 입력하면 된다. 현재는 수동 입력만 지원 (Excel 업로드는 다음 단계). 배포(GCP Cloud Run + IAP)는 아래 9번 참고.

📱 iPhone 실기기에 iOS 앱 설치해서 테스트

iOS 앱(ios/Rabbit/Rabbit.xcodeproj)은 웹 앱을 감싸는 WKWebView 래퍼다. 시뮬레이터는 localhost가 Mac을 가리켜서 그냥 ▶ Run 하면 되지만, 실기기는 아래 순서를 따른다:

1. 서명 설정 (최초 1회) — Xcode > Settings > Accounts에 Apple ID 추가 → 프로젝트 타깃 Rabbit > Signing & Capabilities > Team에 본인 Personal Team 선택. Bundle Identifier가 겹치면 고유하게 변경 (예: com.linked0.rabbit).
2. iPhone 연결 — USB 케이블로 연결 (이후엔 같은 Wi-Fi면 무선 디버깅도 가능).
3. Developer Mode 켜기 (최초 1회, iOS 16+) — iPhone 설정 > 개인정보 보호 및 보안 > 개발자 모드 ON → 재부팅.
4. 실행 대상을 내 iPhone으로 선택 후 ▶ Run — Xcode가 빌드해서 폰에 설치한다.
5. 개발자 신뢰 (최초 1회) — 폰에서 앱이 안 열리면: 설정 > 일반 > VPN 및 기기 관리 > 본인 Apple ID 신뢰.
6. 접속 주소 바꾸기 — 실기기의 localhost는 폰 자신이다. 둘 중 하나:
   • 같은 Wi-Fi에서 Mac의 dev 서버 사용: ContentView.swift 상단의 rabbitURL을 http://<Mac의-LAN-IP>:3000 으로 변경 (IP 확인: ipconfig getifaddr en0). 평문 HTTP라서 타깃 > Info에 App Transport Security Settings > Allows Local Networking = YES 추가 필요. 폰의 "로컬 네트워크" 권한 허용.
   • 배포된 서버 사용 (권장, 가장 간단): GCP 배포 후 rabbitURL을 https://<Cloud-Run-URL> 로 변경 — HTTPS라 ATS 설정 불필요.

무료 Apple ID로 설치한 앱은 7일 후 만료된다 — Xcode에서 다시 Run 하면 갱신. 유료 개발자 계정($99/년)이면 1년 + TestFlight 배포 가능.

🚀 서버 배포 (Deploy to server) — 빠른 순서

이 앱은 GCP Cloud Run(컨테이너 1개, HTTPS 자동, 트래픽 0이면 비용 0)에 올린다. 모든 명령은 scripts/deploy.sh 하나에 들어 있다(재실행 안전). 수동 명령·Dockerfile·IAP·CI 등 자세한 설명은 9번 섹션에 있다.

사전 준비 (최초 1회)

gcloud auth login
cp scripts/deploy.env.example scripts/deploy.env   # PROJECT_ID / REGION / SERVICE 입력 (git-ignored)

• .env.local에 실제 값 채우기 — AUTH_SECRET, AUTH_GOOGLE_ID/SECRET, AI_PROVIDER/AI_API_KEY, MARKET_API_KEY, ALLOWED_EMAILS
• GCP 프로젝트에 결제(billing) 활성화 필요

1) 배포 — 한 줄

./scripts/deploy.sh

스크립트가 순서대로 처리한다:

1. 필요한 API 활성화 (Cloud Run, Cloud Build, Artifact Registry, Secret Manager)
2. .env.local의 시크릿 5개를 Secret Manager에 upsert (처음엔 생성, 이후엔 새 버전)
3. gcloud run deploy --source . — Dockerfile로 빌드, APP_MODE=cloud + 시크릿 연결
4. 배포된 서비스 URL을 읽어 AUTH_URL 자동 설정

첫 실행은 빌드 때문에 5–10분 걸리고, Artifact Registry 저장소 생성 질문에는 Y로 답한다. .gcloudignore가 .env* 파일의 업로드를 차단한다 (시크릿은 Secret Manager로만 전달).

2) Google Cloud Console에 운영 redirect URI 등록 (최초 1회) ⚠️ 이걸 빠뜨리면 로그인에서 redirect_uri_mismatch로 차단된다 (위 트러블슈팅 참고). OAuth 클라이언트 → Authorized redirect URIs에 스크립트가 출력한 URL로 추가:

https://<배포도메인>/api/auth/callback/google

3) 확인 — 브라우저로 서비스 URL 접속 → "Google 계정으로 로그인" → 허용된 이메일로 통과되는지 확인.

🔒 브라우저 접근을 Google 계정으로 한 번 더 보호하려면 Cloud Run 앞에 IAP를 켠다 → 9번-3) 참고. (스크립트는 앱 자체 로그인 + 이메일 allowlist를 믿고 --allow-unauthenticated로 배포한다.) 🔁 코드 수정 후 재배포는 ./scripts/deploy.sh만 다시 실행하면 된다 (시크릿·env·URL 유지, 2) 반복 불필요).

🚧 트러블슈팅: Google 로그인 시 "액세스 차단됨" (redirect_uri_mismatch)

증상 — "Google 계정으로 로그인" 버튼을 누르면 앱이 아니라 Google의 빨간 "액세스 차단됨 / Error 400: redirect_uri_mismatch" 페이지가 뜬다.

원인 — 코드 문제가 아니다. 앱(NextAuth)은 표준 redirect URI http://localhost:3000/api/auth/callback/google 를 정확히 보내지만, 이 URI가 Google Cloud Console의 OAuth 클라이언트에 등록되어 있지 않아서 Google이 차단한다.

해결 — Google Cloud Console → API 및 서비스 → 사용자 인증 정보 → AUTH_GOOGLE_ID와 일치하는 OAuth 2.0 클라이언트 ID 열기:

1. 승인된 리디렉션 URI(Authorized redirect URIs) 에 아래를 정확히 추가 (끝 슬래시 없음):

   http://localhost:3000/api/auth/callback/google
   

2. (권장) 승인된 JavaScript 원본에 http://localhost:3000 추가
3. 저장 후 1~2분 기다렸다가 다시 로그인
4. 배포 시에는 운영 도메인용도 추가: https://<배포도메인>/api/auth/callback/google

💡 앱이 실제로 보내는 redirect URI는 다음으로 확인할 수 있다: curl -s -c /tmp/c -b /tmp/c http://localhost:3000/api/auth/csrf 로 토큰을 받은 뒤 /api/auth/signin/google 에 POST 하면 Location 헤더의 redirect_uri= 값이 보인다.

현재 구현된 것 (v0)

• Google 로그인 (NextAuth/Auth.js v5) — 허용 이메일만 통과
  • auth.ts — Google provider + 이메일 allowlist
  • app/api/auth/[...nextauth]/route.ts — 인증 라우트
  • app/page.tsx — 서버 컴포넌트 로그인 게이트(미로그인 시 로그인 화면, 로그인 시 상단바+대시보드)
• app/Dashboard.tsx — 입력 폼 + 현재 수익성 표 + 시나리오 전망 (클라이언트, 인메모리)
• app/api/prices/route.ts — CoinGecko 현재가 프록시 (/api/prices?ids=bitcoin,ethereum&vs=usd)
• lib/coins.ts — 심볼→CoinGecko id 매핑 + 손익/전망 계산 헬퍼
• 투자입력 · Current Portfolio (/invest, 2026-06-26) — Postgres 영속화, KRW 기준, Upbit 시세
  • prisma/schema.prisma(Trade 모델) · lib/db.ts · lib/portfolio.ts(compute-on-read) · lib/upbit.ts(KRW 시세)
  • app/api/trades(거래 추가/조회/삭제) · app/api/portfolio(계산된 포트폴리오) · app/invest/(UI)

아직 안 된 것

• Excel 업로드 (R5) · GCP 배포 · Verex 연동(R8)
• 데이터 영속화: /invest는 Postgres로 영속화 ✅ / /dashboard(v0)만 인메모리(새로고침 시 초기화)

1. 한 줄 소개 (Elevator pitch)

내 포트폴리오 데이터를 넣으면, 지금 얼마나 수익이 났는지를 요약하고 앞으로의 수익 전망까지 보여주는 개인 투자 요약 도구. (PoC)

2. 목표 & 비목표 (Goals / Non-goals)

목표 (Goals)

• 내 암호화폐 포트폴리오 데이터를 입력 → 현재 수익성(profitability) 요약
• 미래 수익 전망(prospect/forecast) 제시
• 일단 동작하는 것을 보여주는 PoC 수준 (완성 제품 아님)

비목표 (Non-goals) — 이번엔 안 함

• 실거래/주문 실행 (조회·요약만, 매매 X)
• 다중 사용자/계정 시스템
• (확정 예정)

3. 요구사항 (Requirements)

분류: 기능(feat) · 제약(constraint) · UX · 데이터(data) · 인프라(infra) · 비기능(NFR) 상태: 🆕 신규 · 🔨 진행 · ✅ 완료 · ❄️ 보류 · ❌ 폐기

4. 결정 로그 (Decision log)

5. 미해결 질문 (Open questions)

다음에 정하면 좋은 것들. 답이 정해지면 요구사항/결정 로그로 옮긴다.

각 질문에 👉 추천안을 달았다. 별다른 의견 없으면 이 추천대로 진행.

• Q1. Excel 컬럼 구조 👉 추천: symbol(BTC), quantity(0.5), avg_buy_price(USD), buy_date(YYYY-MM-DD) 4개 필수 + exchange 선택. 이 4개면 평가손익 계산에 충분. 샘플 .xlsx 템플릿은 PoC에 동봉.
• Q2. 자산 종류 → ✅ 암호화폐 전용 (R6)
• Q3. "미래 수익 전망" 방식 👉 추천: 시나리오 3종(보수/기본/낙관) = 사용자가 연 성장률 가정(예: -20% / +30% / +100%)을 넣으면 1년 후 평가액을 단순 계산.
  • 선택적으로 과거 데이터 기반 CAGR 자동 제안. (LLM 코멘트는 후순위) — 예측은 가정일 뿐, 투자 조언 아님 명시.
• Q4. 형태 → ✅ 웹사이트(web app) (R7)
• Q7. Verex 연동 방식 — "connected to Verex"가 구체적으로 무엇인가요? ① 같은 도메인/모노레포에 메뉴로 합치기 ② Verex API에서 데이터 가져오기 ③ 로그인/계정 공유(SSO) ④ 단순 링크 연결. 👉 추천: 우선 PoC는 독립 서비스로 만들고, Verex와 같은 스택·같은 GCP 프로젝트에 두어 나중에 합치기 쉽게. (→ Q9: Verex 기술 스택 확인 필요)
• Q8. GCP 배포 방식 👉 추천: Cloud Run (컨테이너 1개, 트래픽 0이면 비용 0, HTTPS 자동). Streamlit·FastAPI·Next 무엇이든 Docker로 올리면 됨. (대안: App Engine, GKE — PoC엔 과함)
• Q9. Verex 기술 스택 → ✅ 확인됨 (/Users/jay/work/verex): pnpm + Turborepo (TS) 모노레포. web=Next.js+React+wagmi+viem, api=Fastify, sdk=@verex/sdk(viem), contracts, cli. → 결론: 경로 B (Next.js/TypeScript) 채택. Python/Streamlit은 통합 불리.
• Q10. rabbit를 어디에 둘까 — ① Verex 모노레포에 새 패키지 packages/rabbit(또는 packages/web 내 라우트)로 추가 ② 별도 레포로 만들되 @verex/sdk 의존. 👉 추천: 통합·시세/체인 데이터 재사용을 생각하면 ① Verex 모노레포 내 새 패키지. 단, PoC 독립성을 원하면 ②.
• Q5. 실시간 시세 👉 추천: CoinGecko 무료 API (API 키 불필요)로 현재가 조회 → 평가손익 자동 계산. 오프라인 대비 수동 입력도 폴백으로 허용.
• Q6. 기준 통화 👉 추천: USD 기준 계산 (크립토 표준), 화면에 KRW 환산 병기 옵션.

6. 용어 (Glossary)

8. 추천 기술 스택 (Recommended stack) — ✅ 확정 (Verex 정렬)

Verex가 TypeScript 모노레포(Next.js+Fastify+viem)이므로 거기에 맞춰 정한다.

화면 흐름(초안): ① Excel 업로드 또는 직접 입력 → ② 현재 평가손익 요약 → ③ 시나리오별 미래 전망

9. GCP 배포 방법 (Deploy)

확정: 언어 TypeScript, 프레임워크 Next.js (App Router), 배포 GCP Cloud Run. Cloud Run = 컨테이너 1개를 올리면 끝. 트래픽 없으면 0으로 축소(비용 0), HTTPS 자동.

1) Next.js를 standalone으로 빌드

next.config.js에 한 줄:

// next.config.js
module.exports = { output: 'standalone' }

2) Dockerfile (멀티스테이지, 가벼운 런타임)

# build
FROM node:20-slim AS builder
WORKDIR /app
COPY package.json pnpm-lock.yaml ./
RUN corepack enable && pnpm install --frozen-lockfile
COPY . .
RUN pnpm build

# run
FROM node:20-slim AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/.next/standalone ./
COPY --from=builder /app/.next/static ./.next/static
COPY --from=builder /app/public ./public
EXPOSE 8080
ENV PORT=8080
CMD ["node", "server.js"]

Cloud Run은 $PORT(기본 8080)로 요청을 보낸다 → Next standalone 서버가 이 포트를 듣게 함.

3) 배포 — 보호된 접근 (앱 세션 없음, jay 본인만)

gcloud run deploy rabbit \
  --source . \
  --region asia-northeast3 \         # 서울 리전
  --no-allow-unauthenticated         # 🔒 공개 X — IAM/IAP로만 접근

--source .는 Cloud Build가 Dockerfile로 자동 빌드→Artifact Registry 푸시→Cloud Run 배포까지 한 번에. 끝나면 https://...run.app URL이 나온다.

브라우저에서 Google 로그인으로 접근 (IAP, 앱 세션 코드 0) 브라우저로 접속하려면 Cloud Run 앞에 IAP(Identity-Aware Proxy) 를 켠다. 그러면 Google 로그인 페이지가 뜨고, 허용된 계정(jay)만 통과한다. 앱은 인증을 전혀 신경 쓰지 않는다.

# IAP 켜고, 내 계정만 접근 허용
gcloud run services update rabbit --region asia-northeast3 --iap
gcloud run services add-iam-policy-binding rabbit \
  --region asia-northeast3 \
  --member="user:linked0@gmail.com" \
  --role="roles/iap.httpsResourceAccessor"

헤더 X-Goog-Authenticated-User-Email로 누가 접속했는지 앱이 읽을 수도 있다(원하면). 기본은 그냥 jay만 통과 = 세션 불필요.

3-대안) 명시적 빌드/푸시 (CI에 적합)

gcloud builds submit --tag asia-northeast3-docker.pkg.dev/PROJECT/REPO/rabbit
gcloud run deploy rabbit --image asia-northeast3-docker.pkg.dev/PROJECT/REPO/rabbit --region asia-northeast3

4) 환경변수 / 비밀값 (배포 시 필수)

앱 내 Google 로그인을 쓰므로 Cloud Run에도 인증 env를 넣어야 한다:

gcloud run deploy rabbit \
  --set-env-vars ALLOWED_EMAILS=linked0@gmail.com,AUTH_URL=https://<배포도메인> \
  --set-secrets AUTH_SECRET=auth-secret:latest,AUTH_GOOGLE_ID=google-id:latest,AUTH_GOOGLE_SECRET=google-secret:latest

⚠️ 배포 후 Google Cloud Console의 OAuth 클라이언트 Authorized redirect URI에 https://<배포도메인>/api/auth/callback/google 를 추가해야 로그인 콜백이 동작한다.

사전 준비(1회): gcloud auth login, 프로젝트 지정(gcloud config set project PROJECT), run.googleapis.com·cloudbuild.googleapis.com·artifactregistry.googleapis.com API 활성화.

모노레포(packages/rabbit)에 둘 경우: 빌드 컨텍스트를 레포 루트로 잡고 Dockerfile에서 해당 패키지만 빌드(turbo --filter=rabbit)하도록 조정.

10. 다음 할 일 (Next steps)

• 남은 추천안 확인 → 특히 Q10(모노레포 새 패키지 vs 별도 레포) 결정
• 샘플 Excel 템플릿 만들기 (symbol·quantity·avg_buy_price·buy_date)
• Next.js 스켈레톤: 입력 → 현재 수익 요약 → 미래 전망 화면
• CoinGecko 현재가 조회 연동
• Dockerfile + Cloud Run 배포 설정

이 문서는 jay의 요구사항이 들어올 때마다 갱신된다.