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 — 상태 갱신 시각