BRIFO_ERD(과제 제출)

테이블 (23)

AI 보고서(전역 캐싱, user 무관) (briefings)

  • id — BIGINT — 기본 키 — NOT NULL — 내부 DB용 PK
  • public_id — UUID — NOT NULL — 외부 노출용 ID
  • 내용 (content_text) — TEXT
  • 표제 (headline) — VARCHAR(200)
  • 한 마디 (one_liner) — VARCHAR(200)
  • 방향 (direction) — VARCHAR(10) — AI예측: 'UP', 'DOWN', 'NEUTRAL'
  • 확신도 (confidence) — DECIMAL(3,2)
  • 보고서 상태 (status) — VARCHAR(20) — NOT NULL — 'PENDING', 'ANALYZING', 'COMPLETED', 'FAILED'
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • 수정 시간 (updated_at) — TIMESTAMP — NOT NULL
  • card_id — BIGINT — 외래 키 → 카드뉴스 요약본(LLM 산출).PK — NOT NULL
  • agent_id — BIGINT — 외래 키 → AI 사원(ROOKIE/PRO/TANKER, 3명 고정).PK — NOT NULL

AI 사원(ROOKIE/PRO/TANKER, 3명 고정) (agents)

  • PK (id) — BIGINT — 기본 키 — NOT NULL — 내부 DB용 PK
  • public_id — UUID — NOT NULL — 외부 노출용 ID
  • 사원 타입 (agent_type) — VARCHAR(10) — NOT NULL — 'ROOKIE', 'PRO', 'TANKER'
  • 모델명 (model_name) — VARCHAR(100) — NOT NULL — 사용중인 AI 모델 이름
  • 닉네임 (nickname) — VARCHAR(50)
  • 설명 (description) — VARCHAR(255)
  • 레벨 (level) — INTEGER — NOT NULL — 1~10
  • 경험치 (exp) — INTEGER — NOT NULL — 양수
  • 일급 (daily_salary) — INTEGER — NOT NULL — 양수
  • 브리핑 횟수 (total_analyses) — INTEGER — NOT NULL
  • 브리핑 정답 횟수 (correct_analyses) — INTEGER — NOT NULL — 적중률 (1~100%)
  • 마지막 근무 시간 (last_work_date) — DATE
  • 활성화 여부 (is_active) — BOOLEAN — NOT NULL
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • 수정 시간 (updated_at) — TIMESTAMP — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL

AP 입출금 원장 (ap_transactions)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • AP 변동량 (amount) — INTEGER — NOT NULL — signed integer
  • 변동 이유 (reason) — VARCHAR(30) — NOT NULL
  • 참조 타입 (ref_type) — VARCHAR(30) — decisions 등 테이블
  • 참조 ID (ref_id) — BIGINT — 테이블 내 PK
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL

결정 일기 카드 (diary_entries)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 공유 횟수 (share_count) — INTEGER — NOT NULL
  • 공유 이미지 URL (share_image_url) — TEXT
  • 공유 이미지 생성 시간 (share_image_created_at) — TIMESTAMP
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • decision_id — BIGINT — 외래 키 → 유저 의사결정(정산 전/후).PK — NOT NULL

뱃지 (badges)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 코드 (code) — VARCHAR(40) — NOT NULL
  • 이름 (name) — VARCHAR(50) — NOT NULL
  • 설명 (description) — VARCHAR(255)
  • 획득한 ap (ap) — INTEGER — NOT NULL
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL

사용자 학습 용어 (user_learned_terms)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 학습한 시간 (learned_at) — TIMESTAMP — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL
  • term_id — BIGINT — 외래 키 → 주식 용어 사전(정의 캐싱).PK — NOT NULL

사용자(CEO) (users)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 소셜로그인 제공자 (provider) — VARCHAR(20) — NOT NULL — 'KAKAO', 'NAVER', 'APPLE'
  • 소셜로그인 ID (social_id) — VARCHAR(100) — NOT NULL
  • 닉네임 (nickname) — VARCHAR(50) — NOT NULL
  • 이메일 (email) — VARCHAR(255)
  • 회사 이름 (company_name) — VARCHAR(100) — NOT NULL
  • AP(재화) (balance_ap) — INTEGER — NOT NULL
  • 의사결정 정답 횟수 (total_correct) — INTEGER — NOT NULL
  • 의사결정 횟수 (total_decision) — INTEGER — NOT NULL
  • 마지막 로그인 시간 (last_login_at) — TIMESTAMP
  • 온보딩 완료 여부 (onboarding_completed_at) — TIMESTAMP
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • 수정 시간 (updated_at) — TIMESTAMP — NOT NULL
  • 삭제 시간 (deleted_at) — TIMESTAMP

사용자-뱃지 (user_badges)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 수여 시간 (awarded_at) — TIMESTAMP — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL
  • badge_id — BIGINT — 외래 키 → 뱃지.PK — NOT NULL

사용자-약관 (user_policies)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 동의 시간 (agreed_at) — TIMESTAMP — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL
  • policy_id — BIGINT — 외래 키 → 약관.PK — NOT NULL

사용자별 선택 종목(예약) (pending_user_stocks)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • 변경 시간 (effective_at) — TIMESTAMP — NOT NULL
  • PK (user_id) — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL
  • PK (stock_id) — BIGINT — 외래 키 → 코스피200 마스터.PK — NOT NULL

사원 급여 로그 (agent_salary_logs)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 급여 양 (salary_amount) — INTEGER — NOT NULL
  • 급여 시간 (salary_date) — DATE — NOT NULL
  • 급여 상태 (status) — VARCHAR(30) — NOT NULL — 'PAID', 'PAID_WITH_CREDIT', 'INSUFFICIENT_BALANCE'
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • agent_id — BIGINT — 외래 키 → AI 사원(ROOKIE/PRO/TANKER, 3명 고정).PK — NOT NULL

수집 뉴스/공시 메타(원문 미저장) (news)

  • PK (id) — BIGINT — 기본 키 — NOT NULL — 내부 DB용 PK
  • public_id — UUID — NOT NULL — 외부 노출용 ID
  • 출처 (source) — VARCHAR(30) — NOT NULL — 'NAVER', 'DART', 'KRX'
  • 출처 URL (source_url) — TEXT — NOT NULL
  • 제목 (title) — VARCHAR(500) — NOT NULL
  • 요약 (summary) — TEXT
  • 중요성 (importance) — DECIMAL(3,2) — 종목당 카드뉴스화할 상위 2개 고르는 용도
  • dedup_key — VARCHAR(255) — NOT NULL — 중복 제거용 key
  • 진행 상태 (processing_status) — VARCHAR(20) — NOT NULL — 'PENDING', 'PROCESSED', 'FAILED', 'SKIPPED'
  • 게시 날짜 (published_at) — TIMESTAMP — NOT NULL
  • 크롤링한 날짜 (crawled_at) — TIMESTAMP — NOT NULL
  • stock_id — BIGINT — 외래 키 → 코스피200 마스터.PK — NOT NULL

알림 (notifications)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 제목 (title) — VARCHAR(100) — NOT NULL
  • 내용 (body) — VARCHAR(500)
  • 참조 타입 (ref_type) — VARCHAR(30) — 'DECISION', 'AP_TRANSACTION', 'BRIEFING', 'AGENT', 'ATTENDANCE_REWARD', 'USER_BADGE', 'SALARY_LOG', 'POLICY'
  • 참조 ID (ref_public_id) — BIGINT — 테이블 PK
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • notification_type_id — BIGINT — 외래 키 → 알림 타입.PK — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL

알림 타입 (notification_types)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 코드 (code) — VARCHAR(40) — NOT NULL

약관 (policies)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 제목 (title) — VARCHAR(100) — NOT NULL
  • 내용 (content) — TEXT — NOT NULL
  • 필수 여부 (is_required) — BOOLEAN — NOT NULL
  • 버전 (version) — INTEGER — NOT NULL
  • 활성화 여부 (is_active) — BOOLEAN — NOT NULL
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • 수정 시간 (updated_at) — TIMESTAMP — NOT NULL

외부 API 호출 로그 (external_api_call_logs)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • API 이름 (api_name) — VARCHAR(100) — NOT NULL
  • 제공자 (provider) — VARCHAR(100)
  • 요청 페이로드 (request_payload) — JSONB
  • 응답 페이로드 (response_payload) — JSONB
  • 상태 (status) — VARCHAR(20) — 'SUCCESS', 'FAIL', 'TIMEOUT'
  • HTTP 상태코드 (http_status_code) — INTEGER
  • 재시도 횟수 (retry_count) — INTEGER — NOT NULL
  • 지연 시간 (latency_ms) — INTEGER
  • 호출 시간 (called_at) — TIMESTAMP — NOT NULL

유저 의사결정(정산 전/후) (decisions)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 방향 (direction) — VARCHAR(10) — NOT NULL — 사용자 예측: 'UP', 'DOWN', 'NEUTRAL'
  • 확신도 (confidence) — SMALLINT — NOT NULL
  • 정답 여부 (is_correct) — BOOLEAN
  • 정산 시간 (settled_at) — TIMESTAMP — 정산 여부 판단
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL
  • card_id — BIGINT — 외래 키 → 카드뉴스 요약본(LLM 산출).PK — NOT NULL — 내부 DB용 PK
  • briefing_id — BIGINT — 외래 키 → AI 보고서(전역 캐싱, user 무관).id — NOT NULL

일간 주가 (daily_stock_prices)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 거래날 (trade_date) — DATE — NOT NULL
  • 주가(장 마감 기준) (close_price) — DECIMAL(12,2) — NOT NULL
  • 변동률 (change_rate) — DECIMAL(5,2) — NOT NULL
  • 생성 시간 (fetched_at) — TIMESTAMP — NOT NULL
  • stock_id — BIGINT — 외래 키 → 코스피200 마스터.PK — NOT NULL

주식 용어 사전(정의 캐싱) (glossary_terms)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 용어 (term) — VARCHAR(80) — NOT NULL
  • 정의 (definition) — VARCHAR(200) — NOT NULL
  • 카테고리 (category) — VARCHAR(50)
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL

출석 보상 (attendance_rewards)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 출석 보너스 여부 (bonus_rewarded) — BOOLEAN — NOT NULL
  • 연속 출석 수 (consecutive_days) — INTEGER — NOT NULL — consecutive_days BETWEEN 1 AND 7
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • user_id — BIGINT — 외래 키 → 사용자(CEO).PK — NOT NULL

카드뉴스 요약본(LLM 산출) (news_cards)

  • PK (id) — BIGINT — 기본 키 — NOT NULL — 내부 DB용 PK
  • public_id — UUID — NOT NULL — 외부 노출용 ID
  • 표제 (headline) — VARCHAR(80) — NOT NULL
  • 내용 핵심 요약 (points) — JSONB — NOT NULL — 내용 요약본 -- ["...", "...", "..."]
  • 키워드 (keywords) — JSONB — NOT NULL — 요약 문장별 대표 키워드 -- ["HBM", "외국인 순매수", "반도체 업황"]
  • 중요도 (importance_badge) — VARCHAR(5) — 'HOT', 'MID', 'LOW'
  • 카드뉴스 날짜 (card_date) — DATE — NOT NULL
  • 생성 시간 (created_at) — TIMESTAMP — NOT NULL
  • news_id — BIGINT — 외래 키 → 수집 뉴스/공시 메타(원문 미저장).PK — NOT NULL

카드뉴스-용어 (news_card_terms)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • 원문 표현 (surface) — VARCHAR(80)
  • 순서 (display_order) — INTEGER — NOT NULL
  • card_id — BIGINT — 외래 키 → 카드뉴스 요약본(LLM 산출).PK — NOT NULL
  • term_id — BIGINT — 외래 키 → 주식 용어 사전(정의 캐싱).PK — NOT NULL

코스피200 마스터 (stocks)

  • PK (id) — BIGINT — 기본 키 — NOT NULL
  • public_id — UUID — NOT NULL
  • 주식 코드 (code) — VARCHAR(10) — NOT NULL
  • 주식명 (name) — VARCHAR(100) — NOT NULL
  • 분류 (sector) — VARCHAR(50) — NOT NULL
  • 활성화 여부 (is_active) — BOOLEAN — NOT NULL