데이터 모델 · Schema
머니플로우 그래프의 데이터 모델과 에이전트용 머신 엔드포인트. 데이터를 직접 연동할 때 참조하는 페이지입니다.
머신 엔드포인트
/<slug>.md— 회사 노드를 LLM 추론용 마크다운으로. ?lang=en 지원./<slug>.json— 구조화 JSON. 무손실 이중언어(ko+en 필드 모두)./<slug>/customers.md— 질문형 문서: 이 회사에 돈을 내는 상대(고객·투자자). ?lang=en 지원./<slug>/suppliers.md— 질문형 문서: 이 회사가 돈을 내는 상대(공급사·투자처). ?lang=en 지원./<slug>/ripple.md— 질문형 문서: 가치사슬 파급(선행 수요 사슬·수혜 지출 사슬). ?lang=en 지원./<slug>/consensus.md— 질문형 문서: 증권사 투자의견·목표가 컨센서스. ?lang=en 지원./analysis/<slug>.md— 분석 아티클을 LLM 추론용 마크다운으로. ?lang=en 지원./llms.txt— 에이전트 발견 색인(전 회사 + .md 링크).
테이블
vc_companies · 회사 노드
slugtextURL 식별자(유일)name / name_entext회사명(한/영)tickertext티커(예: NVDA, 000660.KS)kicker / lead (+_en)text자유 텍스트 분류·요약(한/영)categoriestext[]사업 분류 key 1~3개(통제 어휘 vc_vocab_categories, 테마는 vc_vocab_themes). 아직 안 붙은 노드는 nullcategory_primarytext비중을 셀 때 쓰는 대표 분류 key 하나(categories 안의 값)segments / segments_enjsonb총매출·집중도·사업부문name_ko / countrytext한글명(해외사) · 국가코드returns_yearly / return_asofjsonb/date연도별 수익률{연:%}·기준일(히트맵)price / price_currency / price_asofnum/text/date현재가·통화·기준일(투자의견 옆 표시)analysis_ko / analysis_en / analysis_asoftext/date가치사슬 검증 노트(한/영)·기준일updated_atdate갱신일(홈 정렬 기준)
vc_edges · 돈흐름 엣지
company_iduuid출발 노드directiontext'revenue'(매출) | 'cost'(비용)counterparty_nametext상대 회사명counterparty_iduuid상대 노드(있으면 그래프 연결)confidencetext'high' | 'mid' | 'low'metricjsonb정규화 수치 {type,value,unit,period,basis,qualifier}note (+_en)text설명(한/영)
vc_edge_sources · 관측(엣지 × 출처)
edge_id / source_iduuid엣지·출처 참조stancetext'confirms'(확인) | 'mentions'(언급) | 'contradicts'(상충)as_ofdate관측 기준일metricjsonb관측 단위 정규화 수치excerpt (+_en)text인용문(한/영)
vc_sources · 출처
urltext원문 URL(유일)title (+_en)text제목(한/영)publisher (+_en)text발행처(한/영)kindtext'filing'(공시) | 'news' | 'ir' | 'research'published_at / langdate/text발행일 · 언어(ko/en)
vc_analyst_ratings · 증권사 투자의견
company_iduuid대상 노드broker (+_en) / analysttext증권사(한/영) · 애널리스트rating / rating_normtext원문 의견 · 정규화('buy'|'hold'|'sell')target_price / currencynum/text목표가 · 통화report_title (+_en) / report_urltext리포트 제목(한/영) · 원문 URLsummary_ko / summary_entext요약(한/영)published_at / accessed_atdate리포트 발행일 · 수집일
vc_articles · 분석 아티클
slugtextURL 식별자(유일)title / summary (+_en)text제목·요약(한/영)body_ko / body_entext본문 마크다운(이중언어)tags (+_en) / related_slugstext[]태그 · 관련 노드 slugfaqjsonbQ&A [{q,a,q_en,a_en}] (FAQPage JSON-LD로 렌더)positionsjsonb종목 포지션 그룹(수익률은 노드에서 라이브 조인)changelogjsonb변경 이력 [{date,note,note_en}] 최신순pinned / sort_orderbool/int상단 고정(하우스 종합 뷰) · 읽기 순서published_at / updated_atdate발행일 · 수정일
vc_roadmap · 업데이트·확장 일정
entry_datedate기준일kindtext'update'(완료 기록) | 'planned'(예정)statustext'done' | 'in_progress' | 'planned'title (+_en) / detail (+_en)text제목·상세(한/영)sort_orderint정렬 순서(유일)
vc_crawl_log · AI 크롤 인용 로그
ts / pathtimestamp/text크롤 시각 · 요청 경로sitetext사이트 구분. 이 사이트는 'valuechain'이며 다른 사이트 기록과 함께 쌓이므로 이 값으로 거른다categorytext기록 종류: 'ai'(AI 크롤러) | 'search'(검색·링크 미리보기) | 'attack'(차단한 시크릿 탐색) | 'referral'(AI 답변에서 넘어온 사람) | 'referral_nav'(그 사람의 이후 30분 탐색) | 'panel_nav'(체인 패널 열기) | 'cta_portle'(Portle 안내 클릭) | 'cta_lang_en'(영어 읽기 안내 클릭)bottextai·search·attack은 User-Agent에서 걸린 봇 이름(attack은 없으면 scanner), referral·referral_nav는 답변엔진 이름, panel_nav는 panel-revenue|panel-cost, cta_portle은 cta-portle|cta-portle-top, cta_lang_en은 cta-lang-en. 학습·인덱싱·인용 단계는 저장하지 않고 이 값에서 계산한다user_agenttext원본 User-Agentcountry / langtext요청 국가 코드 · Accept-Language 첫 언어referertext리퍼러(panel_nav·cta_portle은 출발 노드 경로, cta_lang_en에는 없음)querytext요청 쿼리 문자열(panel_nav·cta_portle·cta_lang_en에는 없음)
모든 테이블은 PostgREST로 공개 읽기 전용. 버전·인증이 붙은 정식 API는 예정.