personal-site
개인 웹사이트 + 퀀트 대시보드 (Next.js 16). 오른쪽 위 EN / 한국어 버튼으로 언어를 바꾼다 (쿠키에 1년 저장).
/ — 홈 (프로젝트 목록). 이름(SC)·프로젝트는 content/profile.ts 한 파일만 고치면 된다 (한국어·영어 둘 다)./quant — 오늘: PT-1 보유 종목·매도선, $5,000 계좌 vs 같은 날 SPY, 청산 성적, 다른 계좌, 후보 상위 5/quant/candidates — 스크리너 매수 후보 (필터 + 상세 + 차트)/quant/charts — 구글 시트 '차트분석' 탭처럼 종목별 차트를 아래로 쭉/quant/stock/<티커> — 종목 상세: 스크리너 판단, 재무(매출·이익 성장, 마진, ROE, 현금흐름…), 내부자 거래 90일, 패턴, 차트/quant/account — 내계좌: 구글 시트 '내계좌' 탭과 양방향 연결 (비밀번호 필요)
데이터는 어디서 오나
이 리포에는 데이터가 없다. Project_1 의 매일 CI 가
python -m web_export.dashboard 로 dashboard.json 을 만들어 dashboard-data 브랜치에 덮어쓰고,
차트 캡처는 원래대로 screenshots-sp500 / screenshots-nasdaq 브랜치에 올린다.
이 사이트는 그 GitHub raw 주소만 읽는다. CI 가 끝나면 /api/revalidate 를 불러 캐시를 바로 비우고,
그게 실패해도 30분마다 새로 받는다. 그래서 두 리포의 배포는 서로 엮이지 않는다.
Project_1 (매일 CI) ──► dashboard-data 브랜치 / screenshots-* 브랜치 ──► 이 사이트가 읽기만 함
└─► POST /api/revalidate (REVALIDATE_SECRET) ──► 캐시 비움
내계좌만 예외 — 사이트가 구글 시트 '내계좌' 탭을 직접 읽고 쓴다 (서비스 계정, lib/sheets.ts).
웹에서 추가·수정·삭제하면 시트에 바로 쓰고, 시트에서 고친 값은 페이지를 새로고침하면 보인다.
웹은 입력 칸(티커·회사명·거래소·섹터·매수가·수량·매수일·메모)만 쓰고, 현재가·RSI 같은 분석 칸은
Project_1 이 매일 밤 채운다. 수정·삭제 직전에 그 줄이 아직 같은 종목인지 다시 확인해서, 그 사이 시트가 바뀌었으면 거절한다.
로컬에서 보기
npm install
# Project_1 폴더에서 개발용 데이터 만들기 (차트 목록은 원격 스크린샷 브랜치에서 읽는다)
cd ../Project_1/Project_1
git fetch origin screenshots-sp500 screenshots-nasdaq
CI=1 PYTHONPATH=.:src .venv/bin/python -m web_export.dashboard \
--out ../../personal-site/dev-data/dashboard.json --charts-from-git
cd -
npm run dev # http://localhost:3000
.env.local 의 DASHBOARD_FILE=./dev-data/dashboard.json 이 있으면 파일에서, 없으면 GitHub 에서 읽는다.
(CI=1 은 Project_1 의 data/cache 에 일봉 캐시를 쓰지 않게 하려는 것. 내부자 거래는 이미 받아 둔 캐시만 읽는다)
배포 (Vercel, 무료 Hobby)
- GitHub 에 이 폴더를 새 리포로 올린다 (비공개 추천).
- vercel.com → GitHub 로 로그인 → Add New → Project → 이 리포 Import → Deploy.
설정은 기본값 그대로 (Framework: Next.js). 주소
<프로젝트이름>.vercel.app 가 생긴다. 이후 main 에 push 하면 자동 배포.
- Settings → Environment Variables 에 아래 환경변수를 넣고 다시 배포한다.
손으로 갱신·배포하기 (GitHub Actions)
이 리포 Actions → Deploy site → Run workflow 에서 고른다.
| mode | 하는 일 | 필요한 Secret |
|---|
refresh-data | 사이트 캐시만 비워 최신 dashboard.json 을 바로 보여 준다 (몇 초) | REVALIDATE_SECRET |
redeploy | Vercel 에 다시 빌드·배포를 시킨다 (1~2분) | VERCEL_DEPLOY_HOOK (Vercel → Settings → Git → Deploy Hooks) |
환경변수
| 이름 | 설명 |
|---|
REVALIDATE_SECRET | /api/revalidate 키. Project_1 GitHub Secret·이 리포 Secret 과 같은 값 |
SITE_PASSWORD | 내계좌 비밀번호 (브라우저 기본 로그인 창, 아이디는 아무거나). 없으면 내계좌는 열리지 않는다 |
GOOGLE_SERVICE_ACCOUNT_JSON | 구글 서비스 계정 JSON 전체 (Project_1 CI 와 같은 계정). 내계좌 시트 읽기·쓰기 |
GOOGLE_SHEETS_SPREADSHEET_ID | (선택) 시트 ID. 비우면 Project_1 config 의 ID |
DASHBOARD_URL | (선택) 데이터 주소. 비우면 sean-ccho/Project_1 의 dashboard-data 브랜치 |
DASHBOARD_FILE | 로컬 파일에서 읽기 (개발용) |
SHEETS_API_BASE | 로컬 시험에서 가짜 Sheets 서버로 바꿀 때만 |
참고: dashboard.json 과 차트 이미지는 공개 리포(Project_1)에 있으므로 주소를 알면 누구나 볼 수 있다.
비밀번호는 내계좌(실제 보유 종목)만 가린다 — 내계좌 데이터는 구글 시트에만 있고 공개 리포에는 없다.
구조
app/ 페이지 (layout, 홈, quant/*, quant/account 의 서버 액션, api/revalidate)
components/ 화면 부품 (보유 종목 패널, 평가액 차트, 후보·차트 보기, 내계좌 표, 언어 버튼 …)
lib/ 데이터 타입·불러오기·숫자 표시, i18n(문구), sheets(구글 시트), account(내계좌 줄)
content/ 홈 화면 내용
proxy.ts /quant/account 비밀번호 (Next.js 16 에서 middleware → proxy 로 이름이 바뀜)
.github/workflows/deploy.yml 손으로 갱신·배포
