최종 갱신: 2026-07-26 · 기준 커밋
eb200ab· 배포 dart-monitor-pi.vercel.app 관련: CLOUDFLARE_MIGRATION.md (이전·통합 본문) · CHANGELOG.md · REFACTORING_PLAN.md
상세·무료 티어 예산·성공 기준 → CLOUDFLARE_MIGRATION.md
| 순서 | 작업 |
|---|---|
| A | DART/KOSDAQ 복구 + personUid + API 보안 (이전 전 필수) |
| B | CF Pages/Workers/D1/R2/KV + lab.vibequant.cc |
| C | 수집 = 유휴 아이맥(주력) / GHA·OCI 백업 — Workers는 서빙만 |
| D | 제품 컷오버: Quant → Trump → SpaceX → 사주 → 관계망 |
| E | Neon/Upstash/Vercel 서빙 역할 폐기 |
관계망(M5)은 DeepSeek V4 Pro / Claude와 원인 분석 후 진행 (CLOUDFLARE_MIGRATION §7).
아래 §1~§4는 당장 깨진 것·품질 체크리스트. Cloudflare 상세는 마이그레이션 문서로 이관.
| 영역 | 상태 |
|---|---|
| 배포 | ✅ Vercel 정상 (/, /dashboard, /quant, /saju, /persona, /tqqq, /trump, /spacex 전부 200) |
| 코드베이스 | src 114개 TS/TSX (~18.4k LOC), API 라우트 41개, scripts 31개 |
| 자동화 | GitHub Actions 6종 (daily-sync, batch-analysis, elestock, person-history, person-scrape, spacex-quant) |
| 테스트 | ❌ 0건 — 테스트 프레임워크·설정 자체가 없음 |
| CI | ❌ 빌드/타입체크/린트 워크플로우 없음 (데이터 동기화 워크플로우만 존재) |
| 린트 | ❌ ESLint 설정 파일 없음 (npm run lint은 next lint — Next 15에서 deprecated) |
data/kosdaq-anomaly-report.json (2026-07-26 03:40 생성분):
{ "totalStocks": 0,
"summary": { "nameChanges": 0, "majorHolderChanges": 0, "purposeAdditions": 0,
"lawsuits": 0, "cbIssuances": 0, "volatilityScoreGt0": 0 } }data/kosdaq-cb-issuances.json · kosdaq-lawsuits.json · kosdaq-name-changes.json ·
kosdaq-major-holder-changes.json · kosdaq-purpose-additions.json · small-caps.json — 전부 2바이트([]).
git 이력상 과거엔 26KB까지 채워졌으나 f81e2f3(2026-06-26) 이후 계속 빈 배열.
-
scripts/extract-kosdaq.ts실패 지점 추적 — Toss API IP 화이트리스트 / 응답 스키마 변경 / 시총 필터(5,000억) 조건 중 어디서 0건이 되는지 - GHA
daily-sync.yml에 산출물 0건이면 job 실패 처리 추가 (지금은 조용히 빈 파일을 커밋 중) - 정상 동작 확인 후
/dashboard코스닥 시그널 표시 재검증
src/middleware.ts:12 — API_PREFIXES = ["/api/", ...] 로 모든 API 라우트가 미들웨어 인증을 우회.
따라서 각 라우트가 스스로 인증해야 하는데, 41개 중 40개에 인증 코드가 없음.
운영 배포에서 실제 확인 (쿠키 없이 curl):
| 엔드포인트 | 결과 | 페이지 등급 |
|---|---|---|
GET /api/graph?q=삼성 |
200 · 14KB 관계망 반환 | / = Expert 전용 |
GET /api/search?q=삼성 |
200 · 4.8KB | /search = Expert 전용 |
GET /api/dashboard |
200 · 3.6KB 시그널 | /dashboard = 로그인 필요 |
-
src/lib/admin-auth.ts의requireAdmin()패턴을 따라requireExpert()/requireUser()헬퍼 추가 - Expert 등급 라우트에 적용:
graph,search,person-search,person/[uid],corp/[code],fund/[uid],detail,samename,namechanges,board,board/[id],comment,vote - 로그인 등급 라우트에 적용:
dashboard,monitor,report,quant,quant-data,chat -
middleware.ts의EXPERT_EMAILS하드코딩(gameworker@gmail.com외 2건) → DBAppUser.role조회로 전환
/api/chat, /api/persona, /api/saju, /api/analyze-cluster, /api/trump, /api/seohak, /api/spacex/news
— 전부 무인증이며 코드베이스 전체에 레이트리밋 구현이 한 줄도 없음. DeepSeek/DART 키 비용이 외부에서 소진 가능.
README의 "사주 질문 제한 비로그인 3회 / 로그인 5회"는 클라이언트 측 제한이라 서버에서 강제되지 않음.
- Upstash Redis 기반 IP+유저 레이트리밋 도입 (
@upstash/ratelimit— Redis는 이미 사용 중) - 사주 질문 횟수 제한을 서버(Redis 카운터)로 이관
- 캐시 미스 시에만 LLM 호출되도록 각 라우트 재확인
이슈 I는 a4043f1에서 analyze-cluster만 고쳐졌고 한 곳이 누락.
-
src/app/api/spacex/news/route.ts:142—https://api.deepseek.com/chat/completions→/v1/chat/completions - DeepSeek 호출을
src/lib/deepseek.ts단일 클라이언트로 통합 (현재 4개 라우트에 URL·헤더·에러처리 중복)
.github/workflows/에 데이터 동기화 워크플로우 6개만 있고 코드 검증 워크플로우가 없음. 타입 오류가 Vercel 배포 시점에야 드러남.
-
.github/workflows/ci.yml— PR/푸시 시tsc --noEmit+next build - ESLint 9 flat config 도입 (
eslint.config.mjs) —next lint는 Next 15에서 deprecated -
package.json에typecheck스크립트 추가
- Vitest 도입
- 순수 로직 우선 커버:
saju-engine.ts(934줄) ·risk-flags.ts3레이어 룰셋 ·quant-calc.ts·mu-hynix-predict.ts·person-uid.ts -
dart-parsers.ts— DART 응답 픽스처 기반 파서 테스트 (리팩토링_평가0627.md에서 "작성됐으나 동작 증거 없음"으로 지적된 항목) - API 라우트 스모크 테스트 (인증 등급별 200/401 검증)
zod가 dependency에 있으나 import 하는 파일이 0개. 대부분의 POST 라우트가 await req.json() as any로 처리 중.
- POST 라우트 zod 스키마 도입 —
chat,saju,persona,board,comment,vote,wiki,tqqq -
as any캐스트 제거 (src/app/page.tsx16곳,nasdaq-movers/route.ts5곳,saju/page.tsx4곳)
prisma/migrations/ 마지막 항목이 20260611160045_add_batch_job. 이후 isCurrent, @@unique, AppUser.phone, ExpertInvite.phone, TqqqLog 등은 전부 db push로만 반영됨 (467줄 스키마 vs 13개 마이그레이션).
- 현재 운영 DB 상태를 기준으로 baseline 마이그레이션 생성 → 이후
migrate deploy로 전환 - 롤백·리뷰 가능한 스키마 변경 절차 문서화
src/lib/semiconductor-trio.ts(450줄) + src/app/api/semiconductor-trio/route.ts(27줄) 이
2026-07-11 작성 후 untracked 상태로 로컬에만 존재. MU · 000660.KS · SKHYV 상관계수·ADR 프리미엄·페어트레이딩 z-score 구현 완료, UI 없음.
- 동작 검증 후 커밋
-
/quant페이지에 섹션 추가 (기존 MU→Hynix 예측과 통합 또는 분리 결정) - 미채택 시 명시적으로 삭제 — 지금이 가장 애매한 상태
데이터 확장
- 전체 코스닥 상시 공시 캐싱 (현행: 시총 5,000억 이하
--cap-filter) - DART
dsab007인물명 검색 파이프라인 - 공시-뉴스 크로스레퍼런스
- 공시 본문(XBRL/XML) 파싱 →
Filing.involvedPeople·involvedFunds실제 데이터 채우기 (현재 2,630건 공시 중 제목 regex만 매칭, 배열 항상 빈 상태)
관계망 데이터 커버리지 (REFACTORING_PLAN.md 연계)
- Fund(조합·SPC·투자사) 노드 생성 검증 —
prisma.fund.create호출 지점이fund-builder.ts에 작성됐으나 실제 DB 적재 확인 필요 -
CorpFundRelation·FundPersonRelation엣지가 그래프에 실제로 출현하는지 엔드투엔드 검증 - EntityGraph risk badge 시각화 — 리스크 스코어 70+ 노드 경고 배지 표시
-
/api/risk-summary— 블랙리스트 인물·조합 집계 API 신규
LLM 파이프라인
- DeepSeek V3 NER 코스닥 연동 → 공시 본문 인물·법인 추출 (구조화 API 폴백)
- 다중 LLM 앙상블 → 신호 발화 (DeepSeek + Claude 등)
- 주식셀럽(WIKI) → 시스템 프롬프트 주입 (페르소나 분석 확장)
Trump Pick 고도화
- Truth Social 유료 API 또는 스크래핑 서비스 연동 (직접 RSS 차단 대응)
- 정책 카테고리별 섹터 영향 이력 DB화
- 신규 포스트 감지 → 카카오/슬랙 Webhook 알림
인프라
- OCI Always Free 크롤러 서버 (Vercel 10초 제한 우회, 장기 백필 실행)
-
CI/CD 자동화→ §2-1로 승격
-
scripts/backtest-riskflags.ts정기 실행 → 룰셋별 TP율을 QUANT_BACKTEST.md에 반영 - TP율 낮은 룰 임계값 조정 또는 제거 (현재 8종 룰셋을 사실상 동일 신뢰도로 취급)
요약: 서빙 = CF Pages/Workers/D1/R2/KV · 수집 = 유휴 아이맥(+GHA 백업) · Auth = Supabase 유지.
제품 컷오버: Quant → Trump → SpaceX → 사주 → 관계망. 호스트:lab.vibequant.cc.Workers Cron으로 대량 DART를 돌리지 말 것 (무료 CPU 10ms). 고빈도는 iMac/OCI ingest.
운영 배포 콜드 응답 실측 (2026-07-26):
| 엔드포인트 | 응답시간 |
|---|---|
/api/dashboard |
7.2s |
/api/search?q=삼성 |
5.3s |
/api/graph?q=삼성 |
5.3s |
-
/api/dashboard— 캐시 미적용 (getCache호출 없음). Redis 캐싱 추가 -
/api/search·/api/graph— DART 실시간 조회 폴백이 지연 원인인지 계측 후 타임아웃 설정 -
/api/trending운영 응답이[]— SearchLog 24시간 집계가 비어 있음. 의도된 것인지 확인
-
puppeteer(^25)가 dependencies에 있음 —person-scrape스크립트 전용인데 Vercel 배포에 포함됨. devDependencies 이동 검토 -
@anthropic-ai/sdk— Trump Pick이 DeepSeek로 전환(bd2ff60)된 뒤 실사용처 확인 필요 - 대형 클라이언트 컴포넌트 분할:
quant/page.tsx(1,032줄),BoardPage.tsx(828줄),tqqq/page.tsx(743줄),saju/page.tsx(727줄)
- README 데이터 규모(622개사 / 984건)와 CHANGELOG(1,090개사 / 1,083건) 불일치 — DB 실측 기준으로 통일하고 자동 갱신 스크립트화
- CHANGELOG.md에 v1.4 이후 항목 추가 (TQQQ 일반 공개
478bf6f, 섹터 Top 3fe48a6c) -
docs/CHANGELOG.md스크립트 가이드의 절대경로/Users/dennis/dart-monitor제거 -
docs/27개 문서 중 리팩토링 관련 3종(REFACTORING_PLAN.md,리팩토링_claude_plan.md,리팩토링_평가0627.md) 결론 병합 후 아카이브
| 순서 | 작업 | 근거 |
|---|---|---|
| 1 | KOSDAQ 파이프라인 복구 + 0건 CI fail | 한 달째 빈 데이터 |
| 2 | personUid 단일화 + officers/crawl dry-run | 인명 매칭·관계망 전제 |
| 3 | API 인증 · 레이트리밋 · DeepSeek 통합 | 보안·비용 |
| 4 | iMac(또는 OCI) ingest PoC → R2 | 수집/서빙 분리 검증 |
| 5 | CI + 최소 테스트 | 이전 안전망 |
| 6 | M1 Quant → M2 Trump → M3 SpaceX → M4 사주 CF 컷오버 | 시세·LLM 페이지 먼저 (CLOUDFLARE_MIGRATION) |
| 7 | M5 관계망 — 구조화 API·백필·Fund 엣지 | 데이터 복구 후 (REFACTORING_PLAN) |
| 8 | Neon/Upstash/Vercel 서빙 폐기 | SPOF·운용 단순화 |
| 9 | semiconductor-trio 커밋/삭제 · API 지연 | 정리 |
v1.0 이후 상세 변경 이력은 CHANGELOG.md 참조.
- TQQQ 물타기 페이지 일반 유저 공개 + 개인 매수 기록 분리 저장 (
478bf6f) - NASDAQ 100 섹터별 Top 3 AMQS 퀀트 분석 (
fe48a6c), 마감후 캐시 TTL 12h (8dba7ea) - README v1.4 한글/영문 — Toss API + 최신 기능 반영 (
e9636a9)
- 보안 감사 3차 — admin API 인증 누락,
adminEmail파라미터 우회,.env런타임 읽기, debug 키 노출 (985f1ca,11becd0,ebef59a) - Expert 초대 확장 — 가입 폼 강화 + Expert 초대 이력 +
/admin/experts(8830f62) - 초대 로그인 불가 근본 원인(
SUPABASE_SERVICE_ROLE_KEY미설정) 수정 (38a8ae9) - 동명이인 관리자 UI
/admin/samename+ WIKI 배너 (0900863) - 이슈 F·H·I 수정 — 노드 슬라이싱 30/15 상향, 캐시 TTL 30분, DeepSeek
/v1/(a4043f1) ※ spacex/news 1곳 누락 → §1-4
- P0 핫픽스 6건 — corp 404, 공시 표시 역설, BFS 병렬화, 캐시 TTL, 복합검색 AND (
82e4dec) - Phase 1 스키마 정합 —
isCurrent+@@unique, 중복 5,105건 제거 (514cd30) - Phase 2 파서/빌더 —
dart-parsers.ts,fund-builder.ts,backfill-relations.ts(e7e1b2e) - Phase 3 리스크 엔진 —
risk-flags.ts3레이어 (69fce5e) - daily-sync DB Corp 기준 전환 + GHA 백필/시총/동명이인 스텝 추가
- 관계망 그래프 (Cytoscape.js) + 통합 검색
- 실시간 검색어 순위 (24시간)
- 핀보드 + 리포트 (MD 다운로드)
- 동명이인 생년월일 구분 (SameNameGroup)
- BAD ASS / Good 투표 + 댓글
- 제보·분석요청 게시판
- CB 신호 6종 자동 탐지
- 법인명 변경 추적 (CorpEvent)
- 경제 지표 대시보드
- 코스닥 100종목 추출 + JSON 데이터
- 3,920개 상장사 DART corp_code 매핑
- 로그인 + 세션 (Supabase SSR Auth)
- 챗봇 DART 분석 (4단계 검색)
- 공시 분석 패널 (위험 신호 + 카테고리)
- WIKI — 주식셀럽 (10명 + 코멘트)
- DART 지식베이스 (사명변경·대주주·소송 82건)
- 시총 하위 200개사 3개월 공시 캐싱
- 일일 공시 동기화 (
npm run daily+ 8종 룰셋) - Vercel + Neon 배포 ($0/월)
- Naver Finance → Toss 증권 Open API 전환 (
56056d0) - GitHub Actions Node 20 → 24 (
a33a6a1)
- SPCX 티커 교체 (UFO → SPCX), 스테일 종목 자동 DB 정리
- Yahoo Finance 신규 IPO null-price 처리
- nitter 차단 → Google News RSS 폴백
- 뉴스 HTML 엔티티 디코딩 수정
- ARDS-X: 더미 → QQQ 실데이터(MA20/MA60/RSI/VIX) + 레짐 4단계
- AMQS-M7: 하드코딩 → NVDA·AVGO·AMD·QCOM·ASML·MU·TSM 실데이터
- ARDS 헤지: 고정 비율 →
calculateHedgeWeight(regime)동적 산출 - NASDAQ 주간 Top: 하드코딩 →
range=5d실데이터 - Redis 캐시 30분(장중) / 2시간(마감후)
- QQQ/TQQQ/QLD/TLT/IEF 실시간 시세 (Yahoo Finance 6mo)
- RSI14·Williams%R·SMA20/50·drawdown20d 자동 계산
- 딥바잉 트랜치 5단계 (-3%/-5%/-8%/-12%/-20%)
- 일일 액션 알람 (STRONG_BUY / BUY / WATCH / HOLD / REBALANCE)
- 투자 로그 입력/조회/삭제 (
TqqqLog) - DCA 플래너 + 백테스트 시뮬레이션
- QLD vs TQQQ 비교 테이블
- Truth Social Mastodon API → RSS 애그리게이터 → 직접 RSS 3단계 폴백
- Google News RSS 7개 쿼리 + Yahoo News 병렬 수집
- DeepSeek V3 분석: 의도 요약·무드·종목 픽 BUY/SELL
- 증분 캐싱: 해시 비교 → 신규만 번역, 변동 없으면 재분석 안 함
- Redis 3키 (
trump:seen-hashes48h /trump:items24h /trump:analysis1h) - 한국어 요약 + 원문 토글, 투자 위험 고지
- 인명검색 상단 메뉴 제거 → WIKI 탭 내부로 통합
- Trump Pick 중복 헤더 렌더링 버그 수정