v6

테이블 (14)

결과 자산 비중 (result_asset_ratio)

  • 결과 ID (result_id) — BIGINT — 기본 키 — 외래 키 → 백테스트 결과.결과 ID — NOT NULL — ON DELETE CASCADE
  • 자산 유형 (asset_type) — VARCHAR(20) — 기본 키 — NOT NULL — STOCK / BOND / GOLD / CASH
  • 비중 (ratio) — NUMERIC(20,10) — NOT NULL — 0 ~ 1

경제 이슈 (economic_issue)

  • 데이터셋 버전 ID (dataset_version_id) — BIGINT — 기본 키 — 외래 키 → 이슈 데이터셋 버전.버전 ID — NOT NULL — 복합 PK (dataset_version_id, issue_id). 버전 삭제 금지(cascade 없음)
  • 이슈 ID (issue_id) — BIGINT — 기본 키 — NOT NULL — > 0. 데이터 서버 발급값 그대로 보존, 재발급 없음. 버전이 바뀌어도 같은 사건은 같은 ID
  • 제목 (title) — TEXT — NOT NULL — 한국어 제목. 공백 불가
  • 사건 유형 (event_type) — VARCHAR(80) — NOT NULL — API 9.2 eventType 목록. 코드 증설 대비 CHECK 없음
  • 사건 시작일 (event_start_date) — DATE — NOT NULL — INDEX ix_economic_issue_overlap (dataset_version_id, event_start_date, event_end_date, score DESC, issue_id) WHERE PUBL…
  • 사건 종료일 (event_end_date) — DATE — NOT NULL — >= event_start_date
  • 사건 범위 (event_scope) — VARCHAR(20) — NOT NULL — DAILY / MULTI_DAY / STRUCTURAL
  • 게시 점수 (score) — NUMERIC(20,10) — NOT NULL — 0 ~ 1. 매칭 정렬에만 사용, API 미노출
  • 게시 상태 (publication_status) — VARCHAR(20) — NOT NULL — PUBLISHED만 허용
  • 확인된 사실 (confirmed_facts) — JSONB — NOT NULL — 배열 [{text, sourceIds[]}] 원형 보존. sourceIds는 같은 이슈의 sources[].sourceId만 참조(importer 검증). API는 text만 반환
  • 출처 (sources) — JSONB — NOT NULL — 배열 [{sourceId, publisher, title, url, publishedAt, sourceType}] 원형 보존. 내부 근거 추적용이며 API 미노출; URL 전역 UNIQUE·출처 재사용 없음
  • 경제 채널 (macro_variables) — JSONB — NOT NULL — 문자열 배열. API 9.2 macroVariables 15코드. 증설 대비 ENUM 없음
  • 영향 산업 (affected_industries) — JSONB — NOT NULL — 문자열 배열. 비어 있을 수 있음
  • 관련 자산 (related_assets) — JSONB — NOT NULL — 문자열 배열 STOCK/BOND/GOLD/CASH. handoff EQUITY→STOCK 변환은 importer가 반입 시 수행(API v7 9.5). API는 그대로 반환
  • 영향 가능 경로 (possible_impact_paths) — JSONB — NOT NULL — 배열 [{text, relatedAssets[]}] 원형·경로 순서 보존(EQUITY는 반입 시 STOCK). 자산별 {type,text} 펼침은 API projection 시점
  • 불확실성 (uncertainties) — JSONB — NOT NULL — 문자열 배열
  • 추출기 버전 (verification_extractor_version) — VARCHAR(80) — NOT NULL — API verification.extractorVersion
  • 의미 검수 통과 (verification_semantic_review_passed) — BOOLEAN — NOT NULL — API verification.semanticReviewPassed
  • 검증 방법 (verification_method) — VARCHAR(80) — NOT NULL — AUTOMATED_EVIDENCE_CHECK. DB 보존, API 미노출

구간 유형 (result_interval_type)

  • 구간 ID (interval_id) — BIGINT — 기본 키 — 외래 키 → 주요 변동 구간.구간 ID — NOT NULL — ON DELETE CASCADE
  • 구간 유형 (interval_type) — VARCHAR(30) — 기본 키 — NOT NULL — MDD / DOWN20 / UP20

구간 자산 기여 (result_interval_asset)

  • 구간 ID (interval_id) — BIGINT — 기본 키 — 외래 키 → 주요 변동 구간.구간 ID — NOT NULL — ON DELETE CASCADE
  • 자산 유형 (asset_type) — VARCHAR(20) — 기본 키 — NOT NULL — STOCK / BOND / GOLD / CASH
  • 구간 시작 비중 (start_ratio) — NUMERIC(20,10) — NOT NULL — 0 ~ 1
  • 자산 수익률 (return_rate) — NUMERIC(20,10) — NULL이면 미투자 자산: start_ratio=0, contribution=0
  • 기여도 (contribution) — NUMERIC(20,10) — NOT NULL

백테스트 결과 (result)

  • 결과 ID (id) — BIGINT — 기본 키 — NOT NULL — IDENTITY
  • 포트폴리오 ID (portfolio_id) — BIGINT — 외래 키 → 포트폴리오.포트폴리오 ID — NOT NULL — UNIQUE (1:1). ON DELETE CASCADE
  • 이슈 데이터셋 버전 ID (issue_dataset_version_id) — BIGINT — 외래 키 → 이슈 데이터셋 버전.버전 ID — Result 생성 시 활성 버전으로 1회 고정, 없으면 최초 이슈 조회 시 조건부 UPDATE로 1회 고정. 고정 후 불변(trigger). 삭제 금지(cascade 없음). 부분 INDEX
  • 실제 계산 시작일 (actual_start_date) — DATE — NOT NULL
  • 실제 계산 종료일 (actual_end_date) — DATE — NOT NULL — >= actual_start_date
  • 최종 평가금액 (final_value) — BIGINT — NOT NULL — >= 0
  • 수익률 (return_rate) — NUMERIC(20,10) — NOT NULL
  • 최대 낙폭 (max_drawdown) — NUMERIC(20,10) — NOT NULL — <= 0
  • 금융 데이터 버전 (financial_data_version) — VARCHAR(160) — NOT NULL — API 1.7
  • 계산 정책 버전 (calculation_policy_version) — VARCHAR(160) — NOT NULL — API 1.7
  • 이슈 버전 고정 시각 (issue_version_pinned_at) — TIMESTAMPTZ — issue_dataset_version_id와 NULL 여부 동일. 고정 후 불변(trigger)
  • 계산 소요 ms (calculation_ms) — INTEGER — >= 0. 운영·타임아웃 분석용
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL

사용자 (users)

  • 사용자 ID (id) — BIGINT — 기본 키 — NOT NULL — IDENTITY
  • 이메일 (email) — VARCHAR(255) — NOT NULL — UNIQUE. 공백 불가
  • 닉네임 (nickname) — VARCHAR(30) — NOT NULL — 공백 불가
  • 비밀번호 (password) — VARCHAR(255) — NOT NULL — 해시 저장
  • 가입 시각 (created_at) — TIMESTAMPTZ — NOT NULL
  • 마지막 로그인 시각 (last_login_at) — TIMESTAMPTZ

이슈 데이터셋 버전 (issue_dataset_version)

  • 버전 ID (id) — BIGINT — 기본 키 — NOT NULL — IDENTITY
  • 데이터셋 종류 (dataset_kind) — VARCHAR(40) — NOT NULL — ECONOMIC_ISSUES만. UNIQUE (dataset_kind, dataset_version). 부분 UNIQUE INDEX (dataset_kind) WHERE status='ACTIVE' → 활성 버전은…
  • 데이터셋 버전 (dataset_version) — VARCHAR(160) — NOT NULL — API issueDataVersion. handoff manifest.datasetVersion
  • 상태 (status) — VARCHAR(20) — NOT NULL — IMPORTED / ACTIVE / SUPERSEDED. FAILED는 없음(실패는 issue_import_attempt). 활성 전환은 잠금 + 단일 트랜잭션
  • handoff 스키마 버전 (handoff_schema_version) — VARCHAR(80) — NOT NULL — classet-handoff.v2
  • payload 스키마 버전 (issue_payload_schema_version) — VARCHAR(80) — NOT NULL — classet-issue-payload.v2
  • 검증 상태 (validation_status) — VARCHAR(80) — NOT NULL — manifest.validationStatus (STRUCTURE_AND_EVIDENCE_VALIDATED)
  • 생성 시각(데이터 서버) (generated_at) — TIMESTAMPTZ — NOT NULL — manifest.generatedAt
  • 대상 시작일 (coverage_start_date) — DATE — NOT NULL — manifest.coverage.startDate
  • 대상 종료일 (coverage_end_date) — DATE — NOT NULL — >= coverage_start_date
  • 커버리지 완전 여부 (coverage_complete) — BOOLEAN — NOT NULL — 현재 생성기는 항상 false. API coverage.complete
  • 수집 방식 (discovery_method) — VARCHAR(40) — NOT NULL — GDELT / CURATED_WEB_SEARCH / SYNTHETIC_FIXTURE
  • 이슈 건수 (issue_count) — INTEGER — NOT NULL — >= 0. manifest.rowCount
  • manifest 체크섬 (manifest_sha256) — VARCHAR(64) — NOT NULL — hex 64. 같은 버전·다른 바이트 → IMMUTABLE_VERSION_CONFLICT
  • issues.json 체크섬 (issues_sha256) — VARCHAR(64) — NOT NULL — hex 64
  • 생산 정책 버전 (producer_policy_version) — VARCHAR(160) — NOT NULL — manifest.producer.policyVersion
  • manifest 원문 (manifest) — JSONB — NOT NULL — 검증된 manifest.json 전체(synthetic, inputSha256, sourceReferences 포함). 감사·재수신 판정용
  • 반입 시각 (imported_at) — TIMESTAMPTZ — NOT NULL
  • 활성화 시각 (activated_at) — TIMESTAMPTZ — IMPORTED면 NULL, ACTIVE/SUPERSEDED면 NOT NULL
  • 대체 시각 (superseded_at) — TIMESTAMPTZ — SUPERSEDED일 때만 NOT NULL

이슈 반입 시도 이력 (issue_import_attempt)

  • 시도 ID (id) — BIGINT — 기본 키 — NOT NULL — IDENTITY
  • 데이터셋 종류 (dataset_kind) — VARCHAR(40) — 형식 오류로 읽지 못한 실패도 남기기 위해 NULL 허용
  • 데이터셋 버전 (dataset_version) — VARCHAR(160) — INDEX (dataset_kind, dataset_version, started_at DESC)
  • 시도 결과 (attempt_status) — VARCHAR(20) — NOT NULL — SUCCEEDED / FAILED
  • 결과 코드 (outcome_code) — VARCHAR(80) — NOT NULL — 예: IMMUTABLE_VERSION_CONFLICT, SCHEMA_INVALID, SYNTHETIC_REJECTED
  • manifest 체크섬 (manifest_sha256) — VARCHAR(64) — hex 64
  • 시작 시각 (started_at) — TIMESTAMPTZ — NOT NULL
  • 완료 시각 (completed_at) — TIMESTAMPTZ — NOT NULL — >= started_at
  • 상세 (detail) — JSONB — 오류 상세·재시도 정보

일별 평가금액 (result_daily_value)

  • 결과 ID (result_id) — BIGINT — 기본 키 — 외래 키 → 백테스트 결과.결과 ID — NOT NULL — ON DELETE CASCADE
  • 평가일 (valuation_date) — DATE — 기본 키 — NOT NULL
  • 전체 평가금액 (total_value) — BIGINT — NOT NULL — >= 0. GET /api/result/graph

주식형 자산 (stock_asset)

  • 자산 ID (id) — BIGINT — 기본 키 — NOT NULL — IDENTITY
  • 포트폴리오 ID (portfolio_id) — BIGINT — 외래 키 → 포트폴리오.포트폴리오 ID — NOT NULL — ON DELETE CASCADE. INDEX
  • 자산 유형 (asset_type) — VARCHAR(20) — NOT NULL — ETF / STOCK
  • 종목 코드 (code) — TEXT — NOT NULL — 공백 불가
  • 종목명 (name) — TEXT — NOT NULL — 공백 불가
  • 투자 금액 (amount) — BIGINT — NOT NULL — >= 0

주요 변동 구간 (result_interval)

  • 구간 ID (id) — BIGINT — 기본 키 — NOT NULL — IDENTITY
  • 결과 ID (result_id) — BIGINT — 외래 키 → 백테스트 결과.결과 ID — NOT NULL — ON DELETE CASCADE. INDEX
  • 구간 시작일 (start_date) — DATE — NOT NULL
  • 구간 종료일 (end_date) — DATE — NOT NULL — >= start_date
  • 구간 수익률 (return_rate) — NUMERIC(20,10) — NOT NULL — 백테스트 엔진 산출물. 이슈 매칭은 조회 시 DATE_OVERLAP으로 계산하며 연결 테이블을 두지 않음

포트폴리오 (portfolio)

  • 포트폴리오 ID (id) — BIGINT — 기본 키 — NOT NULL — IDENTITY. UNIQUE (id, user_id)
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 소유자. 복합 FK (parent_portfolio_id, user_id) → portfolio(id, user_id): 부모와 같은 사용자만 허용
  • 부모 포트폴리오 ID (parent_portfolio_id) — BIGINT — 외래 키 → 포트폴리오.포트폴리오 ID — 비교용 자식일 때만. 자기 자신 불가. NULL 여부는 comparison_type과 항상 동일
  • 비교 유형 (comparison_type) — VARCHAR(30) — MAX_RETURN / MIN_MDD / MDD_DEFENSE / SAVED. parent_portfolio_id가 있을 때만
  • 저장 제목 (title) — TEXT — is_saved=true면 필수(공백 불가)
  • 총 투자금액 (total_amount) — BIGINT — NOT NULL — > 0
  • 채권 금액 (bond_amount) — BIGINT — NOT NULL — >= 0
  • 금 금액 (gold_amount) — BIGINT — NOT NULL — >= 0
  • 현금 금액 (cash_amount) — BIGINT — NOT NULL — >= 0
  • 요청 시작일 (requested_start_date) — DATE — NOT NULL
  • 요청 종료일 (requested_end_date) — DATE — NOT NULL — >= requested_start_date
  • 보관함 저장 여부 (is_saved) — BOOLEAN — NOT NULL — INDEX ix_portfolio_archive (user_id, saved_at DESC) WHERE is_saved AND parent IS NULL
  • 저장 시각 (saved_at) — TIMESTAMPTZ — is_saved=true면 필수
  • 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL
  • 수정 시각 (updated_at) — TIMESTAMPTZ

학습 진도 (learning_progress)

  • 학습 진도 ID (id) — BIGINT — 기본 키 — NOT NULL
  • 사용자 ID (user_id) — BIGINT — 외래 키 → 사용자.사용자 ID — NOT NULL — 사용자당 학습 진도 1행
  • 현재 챕터 (current_chapter) — INT — NOT NULL — 현재 Chapter 1 / 2 / 3
  • 현재 콘텐츠 ID (current_content_id) — VARCHAR(30) — API pageId · 미시작 NULL
  • 전체 진행 상태 (status) — VARCHAR(30) — 전체 진행 상태 · 규칙 추후 확정
  • 마지막 접근 시각 (last_accessed_at) — DATETIME — 마지막 학습 접근 시각
  • 학습 완료 시각 (completed_at) — DATETIME — 학습 완료 시각 · 기존 유지
  • 현재 번들 ID (current_bundle_id) — VARCHAR(30) — API bundleId · 미시작 NULL

학습 진도 상세 (learning_progress_detail)

  • 학습 상세 ID (id) — BIGINT — 기본 키 — NOT NULL
  • 학습 진도 ID (learning_progress_id) — BIGINT — 외래 키 → 학습 진도.학습 진도 ID — NOT NULL — 상위 학습 진도 ID
  • 콘텐츠 ID (content_id) — VARCHAR(30) — NOT NULL — 학습 JSON 콘텐츠 ID
  • 진행 상태 (status) — VARCHAR(20) — NOT NULL — 콘텐츠 열람 / 완료 상태
  • 갱신 시각 (updated_at) — DATETIME — NOT NULL — 상태 갱신 시각