project_team4 · 혈당과 식사 통합 ERD v11 · 2026-10-24

테이블 (21)

AI 선택 동의 (public.ai_consents)

  • 동의 종류 (scope) — varchar(24) — 기본 키 — NOT NULL — personal_records / external_ai / chat_history 중 하나입니다.
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — 주인 계정입니다. auth.users(id)와 연결하며 scope와 함께 PK입니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 허용 여부 (enabled) — boolean — NOT NULL — 허용 여부입니다. 기본값은 false이며 사용자가 켜거나 끕니다.
  • 선택할 때 읽은 안내문 버전 (notice_version) — varchar(32) — NOT NULL — 선택할 때 읽은 안내문 버전입니다.
  • 허용한 시각 (granted_at) — timestamptz — 허용한 시각입니다. 허용한 적이 없으면 NULL입니다.
  • 허용을 끈 시각 (revoked_at) — timestamptz — 허용을 끈 시각입니다. 끈 적이 없으면 NULL입니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 마지막 변경 시각입니다. 기본값 now()이며 서버가 정합니다.

CSV 요청 확인표 (public.import_requests)

  • 요청 번호 (request_id) — uuid — 기본 키 — NOT NULL — 첫 제출 전에 정한 요청 번호입니다. 같은 번호로 다른 내용을 보내면 거부합니다.
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — request_id와 함께 PK입니다. auth.users(id)를 참조하며 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 가져오기 번호 (batch_id) — uuid — 외래 키 → 파일 가져오기 이력.고유 번호 — NOT NULL — user_id와 함께 import_batches(id,user_id)를 참조합니다. 이력 삭제 때 영수증도 지웁니다. FK (batch_id,user_id) → import_batches(id,user_id); O…
  • 요청 파일의 소문자 16진수 64글자 확인값 (file_sha256) — char(64) — NOT NULL — 요청 파일의 소문자 16진수 64글자 확인값입니다. 원본 파일과 파일명은 저장하지 않습니다.
  • 내용 확인값 (content_sha256) — char(64) — NOT NULL — 정리한 기록 내용의 소문자 16진수 64글자 확인값입니다. 행 순서가 달라도 같은 내용을 찾습니다.

건강 뉴스 수집 이력 (public.news_fetch_runs)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 수집 실행 번호 PK입니다. 기본 gen_random_uuid()입니다. UNIQUE (source_id,job_key).
  • 출처 번호 (source_id) — uuid — 외래 키 → 건강 뉴스 출처 설정.고유 번호 — NOT NULL — news_sources(id)를 참조합니다. 실행 이력이 남은 출처의 완전 삭제는 제한합니다. FK (source_id) → news_sources(id); ON DELETE RESTRICT.
  • 수집 작업 키 (job_key) — varchar(100) — NOT NULL — 예정된 수집 작업을 구분하는 키입니다. (source_id,job_key)는 고유하며 같은 작업의 중복 실행을 막습니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — queued/running/succeeded/failed/cancelled 중 하나입니다.
  • 접수 시각 (requested_at) — timestamptz — NOT NULL — 작업을 접수한 시각입니다. 기본 now()입니다.
  • 시작 시각 (started_at) — timestamptz — 수집을 시작한 시각입니다.
  • 종료 시각 (finished_at) — timestamptz — 성공·실패·취소를 확정한 시각입니다.
  • 읽은 기사 수 (found_count) — integer — NOT NULL — 읽은 기사 수입니다. 기본 0이며 0 이상입니다.
  • 저장한 기사 수 (saved_count) — integer — NOT NULL — 새로 저장하거나 바꾼 기사 수입니다. 기본 0이며 0 이상입니다.
  • 중복 기사 수 (duplicate_count) — integer — NOT NULL — 이미 같은 내용으로 저장된 기사 수입니다. 기본 0이며 0 이상입니다.
  • 제외한 기사 수 (rejected_count) — integer — NOT NULL — 출처·형식·주소 검사로 제외한 기사 수입니다. 기본 0이며 0 이상입니다.
  • 응답 상태 번호 (http_status) — smallint — 받은 HTTP 상태 번호입니다. 값이 있으면 100~599입니다.
  • 실패 코드 (error_code) — varchar(40) — 허용한 짧은 실패 코드입니다. 원문 응답과 비밀값은 남기지 않습니다.
  • 재시도 가능 시각 (retry_after_at) — timestamptz — 다시 요청할 수 있는 가장 이른 시각입니다. 출처의 대기 지시와 서버 정책을 따릅니다.
  • 실행 허용 기한 (lease_expires_at) — timestamptz — 실행 담당자의 작업 허용 시간 끝입니다. 멈춘 작업을 찾고 중복 수집을 막습니다.
  • 시도 횟수 (attempt_count) — smallint — NOT NULL — 실제 시도 횟수입니다. 기본 0이며 최대 횟수는 서버 정책으로 제한합니다.

건강 뉴스 출처 설정 (public.news_sources)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 출처 번호 PK입니다. 기본 gen_random_uuid()입니다. UNIQUE (endpoint_url).
  • 이름 (name) — varchar(200) — NOT NULL — 공식 발행 기관이나 뉴스 출처 이름입니다.
  • 사람이 확인할 공식 안내 주소 (homepage_url) — text — NOT NULL — 사람이 확인할 공식 안내 주소입니다. HTTPS 주소를 검토합니다.
  • 수집 주소 (endpoint_url) — text — NOT NULL — RSS 또는 API를 읽는 주소입니다. 비밀키를 주소나 쿼리 문자열에 넣지 않습니다.
  • rss/api 중 하나 (fetch_method) — varchar(16) — NOT NULL — rss/api 중 하나입니다. 출처가 허용한 방식만 사용합니다.
  • 접속과 이동을 허용한 공개 호스트 목록 (allowed_hosts) — text[] — NOT NULL — 접속과 이동을 허용한 공개 호스트 목록입니다. 내부 주소·로컬 주소로 이동하지 못하게 서버가 검사합니다.
  • link_only/metadata 중 하나 (reuse_scope) — varchar(16) — NOT NULL — link_only/metadata 중 하나입니다. 링크만 또는 허용된 제목·기관·날짜 정보를 뜻합니다.
  • 이용 조건을 확인한 공식 주소 (rights_url) — text — 이용 조건을 확인한 공식 주소입니다. 승인할 때 이용 조건 검토 기록이 있어야 합니다.
  • 비밀 설정 이름 (credential_ref) — varchar(80) — 서버 비밀 보관소의 설정 이름만 적습니다. API 비밀키 자체는 저장하지 않습니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — review/approved/disabled 중 하나입니다. 기본 review이며 승인된 출처만 수집합니다.
  • 수집 간격을 분으로 정합니다. 양수 (refresh_interval_minutes) — integer — NOT NULL — 수집 간격을 분으로 정합니다. 양수이며 출처의 호출 제한을 따릅니다.
  • 공식 출처와 사용 범위를 확인한 시각 (checked_at) — timestamptz — 공식 출처와 사용 범위를 확인한 시각입니다. 승인할 때 필수입니다.
  • 다음 출처 검토 시각 (review_due_at) — timestamptz — 다음 출처 검토 시각입니다. 승인할 때 필수이며 기한이 지나면 수집을 멈춥니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 만든 서버 시각입니다. 기본 now()입니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 바꾼 서버 시각입니다. 기본 now()입니다.

검토한 지식 버전 (public.knowledge_entries)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 지식 버전 번호 PK입니다. 기본값은 gen_random_uuid()입니다. UNIQUE (source_id,version).
  • 출처 번호 (source_id) — uuid — 외래 키 → 공식 자료 출처.고유 번호 — NOT NULL — knowledge_sources(id)를 참조합니다. 연결한 지식이 남으면 원문 삭제를 막습니다. FK (source_id) → knowledge_sources(id); ON DELETE RESTRICT.
  • 1 이상의 버전 번호 (version) — integer — NOT NULL — 1 이상의 버전 번호입니다. 같은 출처와 같은 버전의 조합은 중복되지 않습니다.
  • basic / measurement / meal / exercise / emergency 중 하나 (topic) — varchar(24) — NOT NULL — basic / measurement / meal / exercise / emergency 중 하나입니다.
  • 언어 (language) — varchar(12) — NOT NULL — 언어입니다. 기본값은 ko-KR입니다.
  • 사용권이 허용한 검토 요약 (summary) — text — NOT NULL — 사용권이 허용한 검토 요약입니다. 최대 10000글자입니다.
  • 검색말 목록 (keywords) — text[] — NOT NULL — 검색말 목록입니다. 기본값은 빈 목록 {}입니다.
  • 원문 발행일 (source_published_on) — date — 원문 발행일입니다. 모르면 NULL이며 날짜를 만들지 않습니다.
  • 내용을 확인한 시각 (reviewed_at) — timestamptz — NOT NULL — 내용을 확인한 시각입니다.
  • 다시 확인해야 하는 시각 (review_due_at) — timestamptz — NOT NULL — 다시 확인해야 하는 시각입니다. 기한이 지난 자료는 새 답변에서 제외합니다.
  • 내용 확인값 (content_sha256) — char(64) — NOT NULL — 버전 내용의 확인값입니다. 소문자 16진수 64글자입니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — draft / approved / retired 중 하나입니다.

공식 건강 소식 (public.health_articles)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — DB에서 기사를 구분하는 UUID입니다. RSS가 반환하는 mohw-숫자는 external_id에 매핑합니다. UNIQUE (url); (source_id,external_id).
  • 제목 (title) — varchar(300) — NOT NULL — 공식 기사나 보도자료의 제목입니다.
  • 발행 기관 (source) — varchar(200) — NOT NULL — 발행 기관입니다.
  • 원문 게시 시각 (published_at) — timestamptz — 원문 게시 시각입니다. 모르면 NULL이며 날짜를 만들지 않습니다.
  • 원문 주소 (url) — text — NOT NULL — 원문 URL입니다. UNIQUE로 중복을 막습니다.
  • 성공적으로 가져온 시각 (fetched_at) — timestamptz — NOT NULL — 성공적으로 가져온 시각입니다. 기본 now()입니다.
  • 당뇨·혈당·식사 등 분류말 목록 (keywords) — text[] — NOT NULL — 당뇨·혈당·식사 등 분류말 목록입니다. 기본 빈 목록입니다.
  • 공식 출처와 링크를 확인한 시각 (checked_at) — timestamptz — NOT NULL — 공식 출처와 링크를 확인한 시각입니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — review/approved/blocked 중 하나입니다.
  • rss/api/public_page 중 하나 (source_channel) — varchar(16) — NOT NULL — rss/api/public_page 중 하나입니다. 무단 본문 복제는 하지 않습니다.
  • 출처 번호 (source_id) — uuid — 외래 키 → 건강 뉴스 출처 설정.고유 번호 — 자동 수집 기사이면 news_sources(id)를 참조해야 합니다. 직접 검토한 기존 자료는 NULL을 허용하며 출처 삭제는 제한합니다. FK (source_id) → news_sources(id); ON DEL…
  • 발행처 기사 번호 (external_id) — varchar(200) — 제공처의 기사 번호입니다. RSS id mohw-숫자를 이 값에 매핑하며 DB id UUID와 혼동하지 않습니다.
  • 마지막 발견 시각 (last_seen_at) — timestamptz — 같은 기사가 마지막으로 수집 결과에 나타난 시각입니다. 게시 시각과 구분합니다.
  • 내용 확인값 (content_sha256) — char(64) — 허용한 제목·기관·게시일·주소의 변경 확인값입니다. 기사 본문은 보관하지 않으며 이 값만으로 다른 URL을 같은 기사로 합치지 않습니다.
  • 담당 부서 또는 작성자 (author) — text — RSS에 나온 작성자입니다. 모르면 NULL입니다.
  • 허용된 짧은 요약 (summary) — text — 이용 조건을 확인한 180글자 이내 요약입니다. 원문 전체를 복사하지 않습니다.
  • 기사 이용 조건 (license_label) — varchar(80) — 기사별 사용 조건입니다. 보건복지부 기사는 KOGL-1을 원문에서 확인합니다.
  • 이용 조건 주소 (license_url) — text — 사용 조건을 설명하는 공식 HTTPS 주소입니다.

공식 자료 출처 (public.knowledge_sources)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 원문 자료 번호 PK입니다. 기본값은 gen_random_uuid()입니다. UNIQUE (canonical_url).
  • 공식 원문 주소 (canonical_url) — text — NOT NULL — 공식 원문 주소입니다. UNIQUE로 같은 주소의 중복 저장을 막습니다.
  • 자료를 낸 기관 (publisher) — varchar(200) — NOT NULL — 자료를 낸 기관입니다.
  • 제목 (title) — varchar(300) — NOT NULL — 자료 제목입니다.
  • 자료를 사용할 수 있는 조건 (license_label) — varchar(200) — NOT NULL — 자료를 사용할 수 있는 조건입니다.
  • 사용 조건을 확인한 주소 (license_url) — text — 사용 조건을 확인한 주소입니다. 별도 페이지가 없으면 NULL입니다.
  • link_only / metadata_only / summary_allowed / fulltext_allowed 중 하나 (reuse_scope) — varchar(24) — NOT NULL — link_only / metadata_only / summary_allowed / fulltext_allowed 중 하나입니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — review / approved / blocked 중 하나입니다.
  • 출처와 사용권을 확인한 시각 (reviewed_at) — timestamptz — 출처와 사용권을 확인한 시각입니다. 검토 전에는 NULL입니다.

공식 정책과 대상 조건 (public.benefit_rules)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 고유 번호 PK입니다. 검토한 자료 입력 경로에서 번호를 정하며 DB 자동 기본값은 없습니다. UNIQUE (source_key,version).
  • 이름 (name) — varchar(200) — NOT NULL — 공식 제도 이름입니다.
  • 담당 기관 (agency) — varchar(200) — NOT NULL — 담당 기관입니다.
  • 전국 또는 적용 지역 코드 목록 (region_scope) — jsonb — NOT NULL — 전국 또는 적용 지역 코드 목록입니다. 실행할 코드가 아닌 자료로 읽습니다.
  • 버전이 있는 조건 자료 (criteria_json) — jsonb — NOT NULL — 버전이 있는 조건 자료입니다. 지역·나이 범위·본인 선택 조건과 추가 확인 요건을 담습니다.
  • 지원 내용을 쉬운 말로 설명합니다. 자격 확정 문구를 쓰지 않습니다 (description) — text — NOT NULL — 지원 내용을 쉬운 말로 설명합니다. 자격 확정 문구를 쓰지 않습니다.
  • 공식 안내와 신청을 확인하는 주소 (source_url) — text — NOT NULL — 공식 안내와 신청을 확인하는 주소입니다.
  • 같은 제도의 버전들을 묶는 고유 코드 (source_key) — varchar(100) — NOT NULL — 같은 제도의 버전들을 묶는 고유 코드입니다.
  • 1 이상의 버전 (version) — integer — NOT NULL — 1 이상의 버전입니다. (source_key,version)은 고유합니다.
  • 공식 시작일 (valid_from) — date — 공식 시작일입니다. 모르면 NULL입니다.
  • 공식 종료일 (valid_until) — date — 공식 종료일입니다. 모르면 NULL입니다.
  • 원문과 조건을 검토한 시각 (checked_at) — timestamptz — NOT NULL — 원문과 조건을 검토한 시각입니다.
  • 다시 검토할 시각 (review_due_at) — timestamptz — NOT NULL — 다시 검토할 시각입니다. 기한이 지나면 선별에서 제외합니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — review/approved/retired 중 하나입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 만든 시각입니다. 기본 now()입니다.

답변 지식 연결 (public.assistant_citations)

  • 질문과 답변 번호 (turn_id) — uuid — 기본 키 — NOT NULL — 질문·답변 행의 id입니다. 대화방 번호·지식 번호와 함께 PK입니다.
  • 대화방 번호 (conversation_id) — uuid — 외래 키 → 질문과 답변.대화방 번호 — NOT NULL — turn_id와 user_id를 함께 검사하여 같은 주인의 질문·답변에 연결합니다. UNIQUE (conversation_id,turn_id,ordinal). FK (conversation_id,turn_id,us…
  • 지식 버전 번호 (entry_id) — uuid — 외래 키 → 검토한 지식 버전.고유 번호 — NOT NULL — 검토한 지식 버전 knowledge_entries(id)를 참조합니다. 공개 출처의 문자열 id를 UUID에 직접 넣지 않고 자료 주소·버전으로 대응시킵니다. 공복 기록 요약은 공개 출처 연결 행을 만들지 않습니다…
  • 주인 계정 (user_id) — uuid — NOT NULL — 질문·답변 행과 같은 주인 계정이어야 합니다.
  • 출처를 보여 주는 순서 (ordinal) — smallint — NOT NULL — 답변 안의 출처 순서이며 1~8입니다. 대화방과 질문 번호 안에서 중복되지 않습니다.

도우미 요청 처리 (public.assistant_requests)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — PK입니다. 첫 전송 전에 정한 번호이며 같은 번호를 다시 처리하지 않습니다.
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — 서버가 정한 auth.users(id) 주인입니다. 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 대화방 번호 (conversation_id) — uuid — 외래 키 → 보관한 대화방.고유 번호 — 보관하는 대화방 번호입니다. user_id와 함께 assistant_conversations(id,user_id)를 참조합니다. 대화방을 지우면 연결 요청 정보도 지웁니다. FK (conversation_id,us…
  • 요청 내용 확인값 (request_fingerprint) — char(64) — NOT NULL — 서버 비밀값으로 계산한 HMAC-SHA256 확인값입니다. 질문 원문과 건강값을 저장하지 않으며 같은 요청의 내용 변경을 막습니다.
  • 확인값 규칙 버전 (fingerprint_version) — varchar(32) — NOT NULL — 확인값을 계산한 규칙과 비밀값 버전을 구분합니다. 비밀값 자체는 저장하지 않습니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — queued/running/succeeded/failed/cancelled 중 하나입니다. 기다림·처리·완료·실패·취소를 뜻합니다.
  • 시도 횟수 (attempt_count) — smallint — NOT NULL — 실제 실행 횟수입니다. 기본 0이며 0 이상입니다. 서버 정책에서 최대 횟수를 제한합니다.
  • 요청 때 동의 (consent_snapshot) — jsonb — NOT NULL — 요청 당시의 선택 사본입니다. 개인 기록 조회·요약 보관·모델 처리·외부 전송을 각각 구분합니다. 요약은 allow_record_access와 allow_storage를 모두 확인하며 이전 선택을 자동 재사용하지…
  • AI 제공사 (provider) — varchar(80) — 서버가 사용한 외부 AI 제공사입니다. 아직 실행하지 않았거나 외부 전송이 없으면 NULL입니다.
  • AI 모델 (model) — varchar(120) — 서버가 사용한 모델 이름입니다. 실제 값만 기록하며 사용자에게 보내는 내부 오류에 섞지 않습니다.
  • 실패 코드 (error_code) — varchar(40) — 허용한 짧은 실패 코드입니다. 원문 응답·질문·비밀키를 넣지 않습니다.
  • 중지 요청 시각 (cancel_requested_at) — timestamptz — 사용자가 중지를 선택하거나 동의를 철회한 서버 시각입니다.
  • 시작 시각 (started_at) — timestamptz — 실제 처리를 시작한 시각입니다. 대기 중에는 NULL입니다.
  • 종료 시각 (finished_at) — timestamptz — 완료·실패·취소가 확정된 시각입니다. 끝나기 전에는 NULL입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 서버가 요청을 접수한 시각입니다. 기본 now()이며 변경하지 않습니다.
  • 삭제 기한 (expires_at) — timestamptz — NOT NULL — 원문 없는 요청 처리 정보의 삭제 시각입니다. 별도 보관 정책에 따라 서버가 정합니다.
  • 실행 허용 기한 (lease_expires_at) — timestamptz — 실행 담당자가 작업할 수 있는 시간의 끝입니다. 만료된 실행은 중복 실행 여부를 확인한 뒤 회수합니다.

독립 식사 기록 (public.meal_records)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — PK입니다. 첫 제출 전에 정한 번호로 중복 저장을 막습니다. UNIQUE (id,user_id).
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — auth.users(id) FK입니다. 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 식사 시각 (meal_at) — timestamptz — NOT NULL — 유효한 식사 시각입니다. 화면은 한국 시간을 사용합니다.
  • 식사 종류 (meal_type) — varchar(16) — NOT NULL — breakfast/lunch/dinner/snack/other 중 하나입니다.
  • 식사 메모 (memo) — varchar(500) — 식사 메모입니다. 공백 정리 후 비면 NULL입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 서버가 정한 생성 시각이며 변경하지 않습니다. 기본 now()입니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 서버가 갱신하는 변경 시각입니다. 기본 now()입니다.

로그인 계정 (auth.users)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 계정 번호입니다. PK이며 모든 개인 자료가 이 번호를 참조합니다.
  • 로그인 이메일의 참고 항목 (email) — varchar(255) — 로그인 이메일의 참고 항목입니다. 인증 서비스가 관리합니다.
  • 만든 시각 (created_at) — timestamptz — 계정을 만든 시각의 참고 항목입니다. 인증 서비스가 관리합니다.

맞춤 정보 선택 (public.user_preferences)

  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — PK이며 auth.users(id) FK입니다. 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 사용자가 고른 지역 코드 (region) — varchar(80) — 사용자가 고른 지역 코드입니다. 선택하지 않으면 NULL입니다.
  • under_19/19_39/40_64/65_plus 중 하나 (age_band) — varchar(16) — under_19/19_39/40_64/65_plus 중 하나입니다. 생년월일을 수집하지 않으며 미선택은 NULL입니다.
  • 사용자가 밝힌 당뇨 진단 여부 (diagnosed) — boolean — 사용자가 밝힌 당뇨 진단 여부입니다. 미선택은 NULL이며 혈당으로 추정하지 않습니다.
  • 실제 정책 조건에 필요한 경우만 선택 입력합니다. 불필요하면 수집하지 않으며 미선택은 NULL (insulin_use) — boolean — 실제 정책 조건에 필요한 경우만 선택 입력합니다. 불필요하면 수집하지 않으며 미선택은 NULL입니다.
  • 맞춤 정보 선별 허용 여부 (matching_enabled) — boolean — NOT NULL — 맞춤 정보 선별 허용 여부입니다. 기본 false입니다.
  • 맞춤 정보 안내 버전 (notice_version) — varchar(32) — NOT NULL — 맞춤 정보 안내 버전입니다. matching-v1이며 서버가 허용한 버전만 저장합니다.
  • 선별에 동의한 서버 시각 (consented_at) — timestamptz — 선별에 동의한 서버 시각입니다. 동의하지 않았으면 NULL입니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 설정을 바꾼 서버 시각입니다. 기본 now()입니다.

보관한 대화방 (public.assistant_conversations)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 처음 요청할 때 정한 UUID입니다. 재전송할 때 같은 번호를 사용합니다. UNIQUE (id,user_id).
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — 서버가 확인한 본인 계정입니다. 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 대화 제목 (title) — text — NOT NULL — 1~60글자입니다. 처음에는 새 대화이며 첫 질문을 기준으로 서버가 정합니다.
  • 보관 안내 버전 (notice_version) — text — NOT NULL — assistant-chat-v1 안내에 동의한 대화방만 저장합니다.
  • 보관 동의 시각 (consented_at) — timestamptz — NOT NULL — 서버가 별도 보관 동의를 확인한 유효한 시각입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 서버가 기록한 유효한 생성 시각입니다. DB 자동 기본값은 없습니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 서버가 기록한 마지막 변경 시각입니다. 오래된 수정 요청을 거부할 때 비교합니다.
  • 개인 기록 사용 여부 (contains_personal_records) — boolean — NOT NULL — 공복 기록 요약 등 개인 자료의 사본을 담은 대화방인지 서버가 정하는 표시입니다. 원본 혈당의 변경·삭제가 이미 저장한 요약을 자동으로 바꾸지는 않습니다. 개인 요약은 모델 대화 이력에서 제외합니다.
  • 삭제 기한 (expires_at) — timestamptz — NOT NULL — 보관기간 종료 시각입니다. 정책 설정값에 따라 서버가 계산합니다.
  • 개인 기록 변경 시각 (personal_context_invalidated_at) — timestamptz — 개인 기록의 변경을 확인한 시각입니다. 해당하지 않으면 NULL입니다. 당시 요약은 asOf와 함께 보존하고 현재 값으로 해석하지 않습니다. 이 값만으로 저장된 대화를 자동 삭제하지 않습니다.

선택 건강 프로필 (public.health_profiles)

  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — 계정당 0~1건입니다. PK이며 auth.users(id)를 참조합니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 성별 선택 (sex) — text — female, male, other 또는 NULL입니다. 입력하지 않아도 됩니다.
  • 입력 당시 나이 (age) — smallint — 0~120의 정수입니다. 입력 당시 나이이며 생년월일 수집이나 자동 나이 증가를 하지 않습니다.
  • 키 cm (height_cm) — numeric — 30~250cm이며 소수 첫째 자리까지 저장합니다. NULL을 허용합니다.
  • 몸무게 kg (weight_kg) — numeric — 1~500kg이며 소수 첫째 자리까지 저장합니다. NULL을 허용합니다.
  • 보관 안내 버전 (notice_version) — text — NOT NULL — health-profile-v1입니다. allow_storage=true 입력을 검사한 뒤 서버가 동의 시각을 남깁니다.
  • 보관 동의 시각 (consented_at) — timestamptz — NOT NULL — 서버가 별도 보관 동의를 확인한 유효한 시각입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 서버가 기록한 유효한 생성 시각입니다. DB 자동 기본값은 없습니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 서버가 기록한 마지막 변경 시각입니다. 오래된 수정 요청을 거부할 때 비교합니다.

식사에 담은 음식 (public.meal_items)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 음식 항목 번호 PK입니다.
  • user_id와 함께 meal_records(id,user_id)를 참조합니다 (meal_id) — uuid — 외래 키 → 독립 식사 기록.고유 번호 — NOT NULL — user_id와 함께 meal_records(id,user_id)를 참조합니다. FK (meal_id,user_id) → meal_records(id,user_id); ON DELETE CASCADE.
  • 주인 계정 (user_id) — uuid — NOT NULL — 부모 식사의 주인과 같은 계정 번호입니다.
  • 선택한 food_catalog(id) (food_id) — uuid — 외래 키 → 음식과 영양정보.고유 번호 — 선택한 food_catalog(id)입니다. 직접 글로 쓰면 NULL입니다. 참조 중인 음식의 삭제는 제한합니다. FK (food_id) → food_catalog(id); ON DELETE RESTRICT.
  • 검색하지 않고 적은 음식 이름 (free_text) — varchar(200) — 검색하지 않고 적은 음식 이름입니다. food_id 또는 이 값이 있어야 합니다.
  • 섭취량 양수 (amount_value) — numeric(12,4) — 섭취량 양수입니다. 입력하지 않으면 NULL이며 amount_unit도 비웁니다.
  • 사용자가 입력한 섭취량 단위 (amount_unit) — varchar(40) — 사용자가 입력한 섭취량 단위입니다. amount_value와 함께 입력합니다.
  • 선택 당시 영양값 (nutrition_snapshot) — jsonb — 음식 선택 때의 이름·기준량·영양값·단위·출처·버전을 복사합니다. food_id가 있으면 필수이며 모르는 영양값은 JSON null로 유지합니다.
  • not_calculated/same_basis/verified/unavailable 중 하나 (conversion_state) — varchar(20) — NOT NULL — not_calculated/same_basis/verified/unavailable 중 하나입니다. 기본 not_calculated입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 만든 시각입니다. 기본 now()입니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 바꾼 시각입니다. 기본 now()입니다.

음식과 영양정보 (public.food_catalog)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 고유 번호 PK입니다. 검토한 자료 입력 경로에서 번호를 정하며 DB 자동 기본값은 없습니다. UNIQUE (source,source_version,source_code).
  • 원본 식품코드 (source_code) — varchar(100) — NOT NULL — 원본 식품코드입니다. 데이터 버전과 함께 중복을 막습니다.
  • 음식 이름 (food_name) — varchar(200) — NOT NULL — 원본 식품명입니다. 한국어 부분 검색에 사용합니다.
  • 기준량 (basis_value) — numeric(12,4) — NOT NULL — 영양값의 기준량입니다. 양수이며 확인 파일은 모두 100입니다.
  • 기준 단위 (basis_unit) — varchar(40) — NOT NULL — 원본 기준량 단위입니다. 공백 아닌 글자로 저장하며 g와 ml를 구분합니다. 섭취량과 같은 단위를 검증했을 때만 환산합니다.
  • 기준량당 열량 kcal (kcal) — numeric(12,4) — 기준량당 열량 kcal입니다. 0 이상이며 미상은 NULL입니다.
  • 기준량당 탄수화물 g (carbs_g) — numeric(12,4) — 기준량당 탄수화물 g입니다. 0 이상이며 미상은 NULL입니다.
  • 기준량당 당류 g (sugars_g) — numeric(12,4) — 기준량당 당류 g입니다. 0 이상이며 미상은 NULL입니다.
  • 기준량당 단백질 g (protein_g) — numeric(12,4) — 기준량당 단백질 g입니다. 0 이상이며 미상은 NULL입니다.
  • 기준량당 지방 g (fat_g) — numeric(12,4) — 기준량당 지방 g입니다. 0 이상이며 미상은 NULL입니다.
  • 기준량당 식이섬유 g (fiber_g) — numeric(12,4) — 기준량당 식이섬유 g입니다. 0 이상이며 미상은 NULL입니다.
  • 기준량당 나트륨 mg (sodium_mg) — numeric(12,4) — 기준량당 나트륨 mg입니다. g 값과 혼동하지 않으며 미상은 NULL입니다.
  • 원본 제공기관명 (source) — varchar(200) — NOT NULL — 원본 제공기관명입니다.
  • 확인한 공식 자료 주소 (source_url) — text — 확인한 공식 자료 주소입니다. 미확인 주소를 만들지 않습니다.
  • 정제 자료 버전 (source_version) — varchar(80) — NOT NULL — 정제 자료 버전입니다. 발표일을 임의로 버전으로 쓰지 않습니다.
  • 원본 파일의 소문자 16진수 64글자 확인값 (source_sha256) — char(64) — NOT NULL — 원본 파일의 소문자 16진수 64글자 확인값입니다.
  • 원본 데이터구분명 (source_type) — varchar(32) — NOT NULL — 원본 데이터구분명입니다.
  • 원본 식품중량 글자 (source_weight) — varchar(80) — 원본 식품중량 글자입니다. 250ml 같은 값을 기준량과 구분합니다.
  • 단위와 기준량 검사를 통과했는지 표시합니다. 기본 false (unit_validated) — boolean — NOT NULL — 단위와 기준량 검사를 통과했는지 표시합니다. 기본 false입니다.
  • 처리 상태 (status) — varchar(16) — NOT NULL — review, approved, blocked 중 하나입니다. approved 상태이며 이름 맨 앞이 물음표가 아닌 음식만 검색과 건수 계산에 포함합니다. 검색어가 없으면 전체 대상에서 100개를 무작위로 고릅니다…
  • 출처와 원본 값을 검토한 시각 (checked_at) — timestamptz — 출처와 원본 값을 검토한 시각입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 만든 시각입니다. 기본값 now()입니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 마지막 변경 시각입니다. 기본값 now()입니다.

이용 동의 (public.user_consents)

  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — PK이며 auth.users(id)와 연결합니다. 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 읽은 안내문 버전 (policy_version) — varchar(32) — NOT NULL — 읽은 안내문 버전입니다. 가상 자료 시연 정책은 demo-v3입니다.
  • 동의한 시각 (agreed_at) — timestamptz — NOT NULL — 동의한 시각입니다. 기본값은 now()이며 서버가 저장 시각을 정합니다.

질문과 답변 (public.assistant_turns)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 대화방 안에서 질문 한 건을 구분합니다. conversation_id와 함께 PK입니다.
  • 대화방 번호 (conversation_id) — uuid — 외래 키 → 보관한 대화방.고유 번호 — NOT NULL — user_id와 함께 같은 주인의 대화방을 참조합니다. UNIQUE (conversation_id,id,user_id). FK (conversation_id,user_id) → assistant_conversati…
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — 서버가 확인한 본인 계정입니다. 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 질문 (question) — text — NOT NULL — 1~1000글자의 질문 또는 서버가 정한 요약 요청 이름입니다. 공복 기록 요약은 최근 7일 공복 혈당 기록 요약으로 저장합니다. 질문과 답변을 한 행에 묶으며 공백만 있는 값은 거부합니다.
  • 답변과 출처 (answer) — jsonb — 답변·출처 또는 공복 기록 요약을 담는 JSON입니다. kind는 answer, no_evidence, unsupported, safety, record_summary입니다. 공통 키는 kind·answer·cit…
  • 처리 상태 (status) — text — NOT NULL — pending(처리 중), completed(완료), failed(실패)입니다. 상태별 answer와 error 규칙을 함께 검사합니다.
  • 실패 안내 (error) — text — 실패 상태만 1~300글자 안내를 보관합니다. 질문·비밀키·원문 서버 오류를 넣지 않습니다.
  • 실행 확인 번호 (attempt_id) — uuid — NOT NULL — 현재 실행만 결과를 저장하도록 비교하는 서버 내부 UUID입니다. 일반 회원의 조회 권한과 API 응답에 포함하지 않습니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 서버가 기록한 유효한 생성 시각입니다. DB 자동 기본값은 없습니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 서버가 기록한 마지막 변경 시각입니다. 오래된 수정 요청을 거부할 때 비교합니다.
  • 참고한 자료 묶음 버전 (knowledge_version) — varchar(80) — 참고한 자료 묶음 버전입니다. 해당하지 않으면 NULL입니다.
  • 답변을 만드는 안내 규칙의 버전 (prompt_version) — varchar(32) — 답변을 만드는 안내 규칙의 버전입니다. 해당하지 않으면 NULL입니다.
  • 답변 모델 버전 (model_version) — varchar(120) — 답변을 만든 모델 파일의 버전 또는 확인값입니다. 비밀 설정은 넣지 않습니다.

파일 가져오기 이력 (public.import_batches)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 가져오기 번호 PK입니다. 기본값은 gen_random_uuid()입니다. UNIQUE (id,user_id); (user_id,content_sha256); (user_id,file_sha256); (user_i…
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — auth.users(id)와 연결한 주인 계정입니다. 탈퇴 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 요청 번호 (request_id) — uuid — NOT NULL — 같은 요청의 결과를 다시 확인하는 번호입니다.
  • 원본 파일이 같은지 확인하는 값 (file_sha256) — char(64) — NOT NULL — 원본 파일이 같은지 확인하는 값입니다. 소문자 16진수 64글자입니다.
  • 내용 확인값 (content_sha256) — char(64) — NOT NULL — 정리한 행 내용의 확인값입니다. DB 함수가 소문자 16진수 64글자로 계산합니다.
  • 성공한 데이터 행 수 (row_count) — integer — NOT NULL — 성공한 데이터 행 수입니다. 1~1000이며 오류가 있으면 전체를 저장하지 않습니다.
  • 가져온 시각 (imported_at) — timestamptz — NOT NULL — 가져온 시각입니다. 기본값 statement_timestamp()이며 서버가 정합니다.
  • 파일과 내용을 읽고 정리하는 규칙의 버전 (format_version) — varchar(32) — NOT NULL — 파일과 내용을 읽고 정리하는 규칙의 버전입니다.

혈당 기록 (public.glucose_records)

  • 고유 번호 (id) — uuid — 기본 키 — NOT NULL — 기록 번호 PK입니다. 첫 제출 전에 한 번 만들며 DB 기본값은 없습니다. UNIQUE (import_batch_id,source_row_number).
  • 주인 계정 (user_id) — uuid — 외래 키 → 로그인 계정.고유 번호 — NOT NULL — 주인 계정입니다. auth.users(id)와 연결하며 계정 삭제 때 함께 지웁니다. FK (user_id) → auth.users(id); ON DELETE CASCADE.
  • 혈당값 (glucose_mg_dl) — integer — NOT NULL — mg/dL 혈당값입니다. 1~2,147,483,647 정수이며 건강 판정 기준은 아닙니다.
  • 측정 시각 (measured_at) — timestamptz — NOT NULL — 측정한 시각입니다. isfinite 검사로 무한 시각을 막고 화면은 한국 시간을 씁니다.
  • 측정 상황 (measurement_context) — varchar(24) — NOT NULL — 허용 코드 10개 중 하나입니다. fasting / before_meal / after_meal / after_meal_2h / on_waking / before_sleep / nighttime / before_e…
  • 식사 시간대 (meal_slot) — varchar(16) — 식전·식후·식후 2시간에만 breakfast/lunch/dinner/snack을 넣습니다. 미지정은 NULL이며 다른 상황은 NULL입니다. 시간으로 자동 추정하지 않습니다.
  • 식사 메모 (meal_memo) — varchar(500) — 식사 메모입니다. 앞뒤 공백을 지운 뒤 빈 글은 NULL이며 최대 500자입니다.
  • 만든 시각 (created_at) — timestamptz — NOT NULL — 만든 시각입니다. 기본값 now()이며 서버가 정하고 수정하지 않습니다.
  • 바꾼 시각 (updated_at) — timestamptz — NOT NULL — 마지막 변경 시각입니다. 기본값 now()이며 서버가 갱신합니다.
  • 가져오기 이력 번호 (import_batch_id) — uuid — 외래 키 → 파일 가져오기 이력.고유 번호 — 가져오기 번호입니다. 직접 입력하면 NULL, 파일에서 가져오면 값이 있어야 합니다. FK (import_batch_id,user_id) → import_batches(id,user_id); ON DELETE NO…
  • 원본 행 번호 (source_row_number) — integer — 데이터 행 번호 1~1000입니다. 직접 입력하면 NULL이며 파일의 머리글은 제외합니다.