바름 ERD_서비스 데이터
테이블 (17)
AI 수정안 (issue_suggestion)
- 수정안 ID (id) — BIGINT — 기본 키 — NOT NULL
- 제안 변경 내용 (changes) — JSONB — NOT NULL — MVP: 그룹의 대상 문장에 대한 수정 제안
- 생성 방식 (generation_type) — VARCHAR(30) — NOT NULL — RULE / LLM
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
- 이슈 그룹 ID (issue_group_id) — BIGINT — 외래 키 → 이슈 그룹.이슈 그룹 ID — NOT NULL — UNIQUE. 그룹당 현재 수정안 최대 1개
리프레시 토큰 (refresh_token)
- 토큰 기록 ID (id) — BIGINT — 기본 키 — NOT NULL
- 회원 ID (member_id) — BIGINT — 외래 키 → 사용자.회원 ID — NOT NULL — UNIQUE
- 토큰 고유 식별자 (jti) — UUID — NOT NULL — UNIQUE
- 만료될 일시 (expires_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
보고서 (report)
- 보고서 ID (id) — BIGINT — 기본 키 — NOT NULL
- 회원 ID (member_id) — BIGINT — 외래 키 → 사용자.회원 ID — NOT NULL
- 보고서 타입 (report_type) — VARCHAR(30) — NOT NULL — PLAN/RESULT
- 보고서 표시 이름 (title) — VARCHAR(255) — NOT NULL — 파일 업로드: 파일명으로 초기화 / 직접 입력: 제목 필수 입력
- 보고서 파일 형식 (file_format) — VARCHAR(30) — HWPX / DOCX / PDF, 직접 입력이면 NULL
- 입력 방식 (input_method) — VARCHAR(30) — NOT NULL — FILE / TEXT(텍스트 직접 입력)
- S3에 저장된 원본 경로 (source_object_key) — TEXT — 고정된 원본 파일의 S3 키
- 원본 파일명 (original_filename) — VARCHAR(255)
- 원본 파일 크기 (file_size_bytes) — BIGINT — 바이트 단위
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
- 원본 파일 만료일시 (source_expires_at) — TIMESTAMPTZ — 업로드 완료 후 30일. 직접 입력은 NULL
- 원본 파일 삭제일시 (source_deleted_at) — TIMESTAMPTZ — S3 원본 삭제 성공 시각. 본문·결과 유지
보고서 본문 (report_content)
- 본문 ID (id) — BIGINT — 기본 키 — NOT NULL
- 보고서 ID (report_id) — BIGINT — 외래 키 → 보고서.보고서 ID — NOT NULL
- 본문 (content) — JSONB — NOT NULL
- 본문 상태 (status) — VARCHAR(30) — NOT NULL — DRAFT(편집 중) / FROZEN(분석·최종 평가 본문 고정)
- 현재 본문 여부 (is_current) — BOOLEAN — NOT NULL — 현재 채택한 본문. 보고서별 true 최대 1개
- 본문 수정 버전 (revision) — BIGINT — NOT NULL — 본문 변경마다 증가. 저장 충돌 검사
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
- 기준 본문 ID (base_content_id) — BIGINT — 외래 키 → 보고서 본문.본문 ID — 편집을 시작한 FROZEN 본문
보고서 분석 (report_analysis)
- 보고서 분석 ID (id) — BIGINT — 기본 키 — NOT NULL
- 분석 입력 본문 ID (content_id) — BIGINT — 외래 키 → 보고서 본문.본문 ID — NOT NULL — FROZEN 본문. 실패 재시도 시 재사용
- 요청 식별자 (request_key) — UUID — NOT NULL — UNIQUE
- 종합 점수 (total_score) — NUMERIC(5,2) — 최초 분석 점수. 최종 점수는 report_result에 저장
- 분석 상태 (status) — VARCHAR(30) — NOT NULL — PENDING / PROCESSING / SUCCEEDED / PARTIAL_FAILED / FAILED / CANCELLED
- 시작일시 (started_at) — TIMESTAMPTZ
- 종료일시 (finished_at) — TIMESTAMPTZ
- 실패 코드 (failure_code) — VARCHAR(30)
- 실패 사유 (failure_reason) — TEXT
- 접수일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 룰셋 버전 (ruleset_version) — VARCHAR(255) — NOT NULL
- 프롬프트 버전 (prompt_version) — VARCHAR(255) — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
보고서 분석 단계 (report_analysis_step)
- 분석 단계 ID (id) — BIGINT — 기본 키 — NOT NULL
- 단계 코드 (step_code) — VARCHAR(30) — NOT NULL — STRUCTURE / REGULATION / EXPRESSION / CONSISTENCY / SUGGESTION / SCORING
- 단계 상태 (status) — VARCHAR(30) — NOT NULL — PENDING / PROCESSING / SUCCEEDED / FAILED / CANCELLED / SKIPPED
- 시작일시 (started_at) — TIMESTAMPTZ
- 종료일시 (finished_at) — TIMESTAMPTZ
- 실패 코드 (failure_code) — VARCHAR(30)
- 실패 사유 (failure_reason) — TEXT
- 보고서 분석 ID (report_analysis_id) — BIGINT — 외래 키 → 보고서 분석.보고서 분석 ID — NOT NULL
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
보고서 영역별 분석 결과 (report_analysis_area_result)
- 영역별 분석 결과 ID (id) — BIGINT — 기본 키 — NOT NULL
- 보고서 분석 ID (report_analysis_id) — BIGINT — 외래 키 → 보고서 분석.보고서 분석 ID — NOT NULL
- 영역 감점 (deduction_score) — NUMERIC(5,2) — 분석 당시 본문 기준 영역별 감점. 이후 편집·처리 상태 변경 미반영
- 검사 영역 (area_code) — VARCHAR(30) — NOT NULL — REGULATION / STRUCTURE / EXPRESSION / CONSISTENCY
- 상세 결과 (result_detail) — JSONB
보고서 파싱 시도 (report_parse_attempt)
- 파싱 시도 ID (id) — BIGINT — 기본 키 — NOT NULL
- 처리 상태 (process_status) — VARCHAR(30) — NOT NULL — PENDING / PROCESSING / SUCCEEDED / FAILED
- 추출 품질 (extraction_quality) — VARCHAR(30) — COMPLETE / PARTIAL. 추출 전·실패 시 NULL
- 추출 경고 (extraction_warnings) — JSONB — NOT NULL — 추출하지 못한 표 등의 위치·사유
- 오류 코드 (error_code) — VARCHAR(30)
- 접수일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 시작일시 (started_at) — TIMESTAMPTZ
- 종료일시 (completed_at) — TIMESTAMPTZ
- 보고서 ID (report_id) — BIGINT — 외래 키 → 보고서.보고서 ID — NOT NULL
- 생성 본문 ID (produced_content_id) — BIGINT — 외래 키 → 보고서 본문.본문 ID — 파싱으로 생성한 본문. UNIQUE
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
분석 결과 리포트 (report_result)
- 결과 리포트 ID (id) — BIGINT — 기본 키 — NOT NULL
- 보고서 분석 ID (report_analysis_id) — BIGINT — 외래 키 → 보고서 분석.보고서 분석 ID — NOT NULL — 기준 분석
- 본문 ID (content_id) — BIGINT — 외래 키 → 보고서 본문.본문 ID — NOT NULL — 최종 점수 계산에 사용한 FROZEN 본문
- 최종 점수 (final_score) — NUMERIC(5,2) — 최종 고정 본문 기준. 계산 전 NULL
- 생성 상태 (status) — VARCHAR(30) — NOT NULL — PENDING / PROCESSING / SUCCEEDED / FAILED
- 실패 코드 (failure_code) — VARCHAR(30)
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
- 완료일시 (completed_at) — TIMESTAMPTZ
- 삭제일시 (deleted_at) — TIMESTAMPTZ — Soft delete. 미삭제는 NULL
사용자 (member)
- 회원 ID (id) — BIGINT — 기본 키 — NOT NULL
- 이메일(로그인 아이디) (email) — VARCHAR(255) — NOT NULL — UNIQUE
- 사용자 이름 (name) — VARCHAR(255) — NOT NULL
- 비밀번호 해시 (password_hash) — VARCHAR(255) — 비밀번호 해시 문자열, 구글 로그인의 경우 NULL
- 계정 상태 (status) — VARCHAR(30) — NOT NULL — ACTIVE/SUSPENDED/DELETED
- 최초 가입 수단 (signup_method) — VARCHAR(30) — NOT NULL — LOCAL/GOOGLE
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
- 탈퇴일시 (withdrawn_at) — TIMESTAMPTZ
- 탈퇴 사유 (withdrawn_reason) — VARCHAR(255)
사용자 약관 동의 이력 (member_term)
- 약관 동의 이력 ID (id) — BIGINT — 기본 키 — NOT NULL
- 회원 ID (member_id) — BIGINT — 외래 키 → 사용자.회원 ID — NOT NULL
- 약관 ID (term_id) — BIGINT — 외래 키 → 약관.약관 ID — NOT NULL
- 동의일시 (agreed_at) — TIMESTAMPTZ
- 철회일시 (withdrawn_at) — TIMESTAMPTZ
- 동의 여부 (is_agreed) — BOOLEAN — NOT NULL
- 응답일시 (responded_at) — TIMESTAMPTZ — NOT NULL
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
약관 (term)
- 약관 ID (id) — BIGINT — 기본 키 — NOT NULL
- 약관 종류 (code) — VARCHAR(30) — NOT NULL — AGE_OVER_14 / TERMS_OF_SERVICE / PRIVACY_POLICY / MARKETING_CONSENT
- 버전 (version) — VARCHAR(30) — NOT NULL
- 필수여부 (is_required) — BOOLEAN — NOT NULL
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
이메일 인증 (email_verification)
- 인증 요청 ID (id) — BIGINT — 기본 키 — NOT NULL
- 인증 대상 이메일 (email) — VARCHAR(255) — NOT NULL
- 인증 목적 (purpose) — VARCHAR(30) — NOT NULL — SIGNUP / PASSWORD_RESET
- 인증번호 검증값 (code_hash) — VARCHAR(255) — NOT NULL
- 인증번호 만료일시 (expires_at) — TIMESTAMPTZ — NOT NULL
- 검증 실패 횟수 (attempt_count) — INTEGER — NOT NULL — 재발송 시 초기화하지 않음
- 마지막 발송 요청일시 (last_sent_at) — TIMESTAMPTZ
- 인증 완료일시 (verified_at) — TIMESTAMPTZ
- 인증 완료 증명 해시 (verification_token_hash) — VARCHAR(255) — 인증 완료 후 발급하는 임시 토큰의 해시
- 인증 완료 증명 만료일시 (verification_expires_at) — TIMESTAMPTZ
- 최종 사용일시 (consumed_at) — TIMESTAMPTZ — 가입·비밀번호 재설정에 사용한 시각
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
이슈 (issue)
- 이슈 ID (id) — BIGINT — 기본 키 — NOT NULL
- 영역별 분석 결과 ID (analysis_area_result_id) — BIGINT — 외래 키 → 보고서 영역별 분석 결과.영역별 분석 결과 ID — NOT NULL
- 이슈 그룹 ID (issue_group_id) — BIGINT — 외래 키 → 이슈 그룹.이슈 그룹 ID — NOT NULL — 그룹과 동일 분석
- 심각도 (severity) — VARCHAR(30) — NOT NULL — HIGH / MEDIUM / LOW / UNDETERMINED
- 이슈 제목 (title) — VARCHAR(255) — NOT NULL
- 판정 사유 (reason) — TEXT — NOT NULL
- 사용자 확인사항 (review_guidance) — TEXT
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
이슈 그룹 (issue_group)
- 이슈 그룹 ID (id) — BIGINT — 기본 키 — NOT NULL
- 보고서 분석 ID (report_analysis_id) — BIGINT — 외래 키 → 보고서 분석.보고서 분석 ID — NOT NULL — 그룹 소속 분석
- 대상 편집 단위 ID (target_id) — VARCHAR(255) — JSON 본문 내 문장·문단·섹션 ID. DOCUMENT는 NULL
- 대상 범위 (scope) — VARCHAR(30) — NOT NULL — SENTENCE / PARAGRAPH / SECTION / DOCUMENT
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 처리 상태 (status) — VARCHAR(30) — NOT NULL — UNPROCESSED / PROCESSED / IGNORED. 카드 단위 처리
이슈 근거 (issue_evidence)
- 이슈 근거 ID (id) — BIGINT — 기본 키 — NOT NULL
- 이슈 ID (issue_id) — BIGINT — 외래 키 → 이슈.이슈 ID — NOT NULL
- 근거 유형 (evidence_type) — VARCHAR(30) — NOT NULL — LAW / LOCAL_LAW / ADMINISTRATIVE_RULE / GUIDELINE / HIGHER_LEVEL_PLAN / POLICY / OFFICIAL_DOCUMENT / INTERNAL_DIRECTIVE…
- 자료명 (source_title) — VARCHAR(255) — NOT NULL
- 근거 문서 내 인용 위치 (source_locator) — VARCHAR(255) — 근거로 인용한 부분의 조·항·호, 장·절 또는 페이지. 예: 제15조 제2항, 제3장 예산 편성 기준, 12쪽. 위치를 알 수 없으면 NULL.
- 원문 인용문 (quoted_text) — TEXT — NOT NULL — 분석 당시 인용문 보존
- 원문 링크 (source_url) — TEXT
- 자료 버전 (source_version) — VARCHAR(255) — 근거 문서 자체의 버전 의미
- 자료 시행일 (source_effective_date) — DATE — 법령 등의 시행일 의미, 없다면 NULL
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
인증수단 (member_auth)
- 인증 수단 ID (id) — BIGINT — 기본 키 — NOT NULL
- 회원 ID (member_id) — BIGINT — 외래 키 → 사용자.회원 ID — NOT NULL
- 소셜 제공자 (provider) — VARCHAR(30) — NOT NULL — GOOGLE
- 소셜 사용자 ID (provider_user_id) — VARCHAR(255) — NOT NULL — 구글 ID 토큰의 sub 저장
- 소셜 이메일 (provider_email) — VARCHAR(255) — 구글 계정에서 받은 이메일
- 연결일시 (linked_at) — TIMESTAMPTZ — NOT NULL
- 연결 해제 일시 (unlinked_at) — TIMESTAMPTZ
- 생성일시 (created_at) — TIMESTAMPTZ — NOT NULL
- 수정일시 (updated_at) — TIMESTAMPTZ — NOT NULL