Skip to content

Latest commit

 

History

History
309 lines (228 loc) · 16.5 KB

ROADMAP.md

File metadata and controls

309 lines (228 loc) · 16.5 KB

CASSANDRA AI — 작업 로드맵

최종 갱신: 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 상세는 마이그레이션 문서로 이관.


0. 현재 상태 요약

영역 상태
배포 ✅ 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)

1. P0 — 지금 깨져 있는 것

1-1. 🔴 KOSDAQ 이상징후 파이프라인 산출물이 한 달째 전부 0건

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 코스닥 시그널 표시 재검증

1-2. 🔴 Expert 전용 데이터가 API로 무인증 노출

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건) → DB AppUser.role 조회로 전환

1-3. 🟠 LLM 호출 라우트에 인증·레이트리밋 둘 다 없음

/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 호출되도록 각 라우트 재확인

1-4. 🟠 남은 DeepSeek URL 불일치

이슈 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·헤더·에러처리 중복)

2. P1 — 품질 안전망 (현재 완전 부재)

2-1. CI 파이프라인

.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 스크립트 추가

2-2. 테스트

  • Vitest 도입
  • 순수 로직 우선 커버: saju-engine.ts(934줄) · risk-flags.ts 3레이어 룰셋 · quant-calc.ts · mu-hynix-predict.ts · person-uid.ts
  • dart-parsers.ts — DART 응답 픽스처 기반 파서 테스트 (리팩토링_평가0627.md에서 "작성됐으나 동작 증거 없음"으로 지적된 항목)
  • API 라우트 스모크 테스트 (인증 등급별 200/401 검증)

2-3. 입력 검증

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.tsx 16곳, nasdaq-movers/route.ts 5곳, saju/page.tsx 4곳)

2-4. Prisma 스키마 드리프트

prisma/migrations/ 마지막 항목이 20260611160045_add_batch_job. 이후 isCurrent, @@unique, AppUser.phone, ExpertInvite.phone, TqqqLog 등은 전부 db push로만 반영됨 (467줄 스키마 vs 13개 마이그레이션).

  • 현재 운영 DB 상태를 기준으로 baseline 마이그레이션 생성 → 이후 migrate deploy로 전환
  • 롤백·리뷰 가능한 스키마 변경 절차 문서화

3. P2 — 미완/보류 기능

3-1. 반도체 3종 비교 엔진 (커밋 안 된 채 방치)

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 예측과 통합 또는 분리 결정)
  • 미채택 시 명시적으로 삭제 — 지금이 가장 애매한 상태

3-2. 기존 로드맵 이월 항목

데이터 확장

  • 전체 코스닥 상시 공시 캐싱 (현행: 시총 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로 승격

3-3. 리스크 엔진 검증

  • scripts/backtest-riskflags.ts 정기 실행 → 룰셋별 TP율을 QUANT_BACKTEST.md에 반영
  • TP율 낮은 룰 임계값 조정 또는 제거 (현재 8종 룰셋을 사실상 동일 신뢰도로 취급)

3-4. Cloudflare · VibeQuant 통합 (상세 이관)

본문: CLOUDFLARE_MIGRATION.md

요약: 서빙 = CF Pages/Workers/D1/R2/KV · 수집 = 유휴 아이맥(+GHA 백업) · Auth = Supabase 유지.
제품 컷오버: Quant → Trump → SpaceX → 사주 → 관계망. 호스트: lab.vibequant.cc.

Workers Cron으로 대량 DART를 돌리지 말 것 (무료 CPU 10ms). 고빈도는 iMac/OCI ingest.


4. P3 — 성능 · 문서 · 정리

4-1. 응답 지연

운영 배포 콜드 응답 실측 (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시간 집계가 비어 있음. 의도된 것인지 확인

4-2. 번들·의존성

  • 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줄)

4-3. 문서 정합성

  • README 데이터 규모(622개사 / 984건)와 CHANGELOG(1,090개사 / 1,083건) 불일치 — DB 실측 기준으로 통일하고 자동 갱신 스크립트화
  • CHANGELOG.md에 v1.4 이후 항목 추가 (TQQQ 일반 공개 478bf6f, 섹터 Top 3 fe48a6c)
  • docs/CHANGELOG.md 스크립트 가이드의 절대경로 /Users/dennis/dart-monitor 제거
  • docs/ 27개 문서 중 리팩토링 관련 3종(REFACTORING_PLAN.md, 리팩토링_claude_plan.md, 리팩토링_평가0627.md) 결론 병합 후 아카이브

5. 권장 처리 순서

순서 작업 근거
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 참조.

v1.4 (2026-07-11 ~ 07-24)

  • TQQQ 물타기 페이지 일반 유저 공개 + 개인 매수 기록 분리 저장 (478bf6f)
  • NASDAQ 100 섹터별 Top 3 AMQS 퀀트 분석 (fe48a6c), 마감후 캐시 TTL 12h (8dba7ea)
  • README v1.4 한글/영문 — Toss API + 최신 기능 반영 (e9636a9)

v1.0 ~ v1.3 (2026-06-27 ~ 07-04)

  • 보안 감사 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

v0.8 ~ v0.9 (2026-06-27)

  • 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.ts 3레이어 (69fce5e)
  • daily-sync DB Corp 기준 전환 + GHA 백필/시총/동명이인 스텝 추가

v0.7.0 (2026-06-24)

코어

  • 관계망 그래프 (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)

SpaceX 대시보드 (/spacex)

  • SPCX 티커 교체 (UFO → SPCX), 스테일 종목 자동 DB 정리
  • Yahoo Finance 신규 IPO null-price 처리
  • nitter 차단 → Google News RSS 폴백
  • 뉴스 HTML 엔티티 디코딩 수정

퀀트 대시보드 (/quant) 실데이터 전환

  • 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시간(마감후)

TQQQ 투자 관리 (/tqqq)

  • 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 비교 테이블

🇺🇸 Trump Pick (/trump)

  • Truth Social Mastodon API → RSS 애그리게이터 → 직접 RSS 3단계 폴백
  • Google News RSS 7개 쿼리 + Yahoo News 병렬 수집
  • DeepSeek V3 분석: 의도 요약·무드·종목 픽 BUY/SELL
  • 증분 캐싱: 해시 비교 → 신규만 번역, 변동 없으면 재분석 안 함
  • Redis 3키 (trump:seen-hashes 48h / trump:items 24h / trump:analysis 1h)
  • 한국어 요약 + 원문 토글, 투자 위험 고지

네비게이션

  • 인명검색 상단 메뉴 제거 → WIKI 탭 내부로 통합
  • Trump Pick 중복 헤더 렌더링 버그 수정