0728

Tables (23)

account_login_history

  • login_history_id — BIGINT — Primary key — NOT NULL — 로그인 시도 레코드 식별자
  • account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 로그인을 시도한 계정 FK
  • login_at — DATETIME — NOT NULL — 로그인 시도 일시
  • login_ip — VARCHAR(45) — NOT NULL — 접속 IP (IPv4/IPv6) - 암호화하지 않음(보안 모니터링/이상탐지 쿼리 성능을 위해 평문 유지)
  • user_agent — VARCHAR(255) — 접속 기기/브라우저 정보 (User-Agent)
  • login_result — ENUM('SUCCESS', 'FAILED') — NOT NULL — 로그인 성공/실패 - Firebase Auth 도입 시 FAILED는 비밀번호 오류가 아니라 "우리 백엔드의 Firebase ID 토큰 검증 실패"를 의미(비밀번호 자체의 성공/실패 시도 이력은 Firebase 콘…
  • logout_at — DATETIME — 로그아웃 일시 (세션 종료 추적용, 없으면 NULL)

account_profiles

  • account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — accounts.account_id와 1:1
  • real_name_encrypted — VARBINARY(255) — NOT NULL — 실명 (암호화 저장) - 동의서 서명, 법적 문서용. 화면 표시는 accounts.display_name 사용
  • phone_number_encrypted — VARBINARY(255) — NOT NULL — 연락처 (암호화 저장) - 본인인증, 이상반응 긴급알림 발송, 계정복구용
  • phone_verified_at — DATETIME — 휴대폰 본인인증 완료일시 (NULL이면 미인증)
  • updated_at — DATETIME — NOT NULL — 최종 수정일시

account_subject_access

  • access_id — BIGINT — Primary key — NOT NULL — 접근권한 레코드 식별자
  • account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 접근 권한을 가진 계정 FK
  • subject_id — BIGINT — Foreign key → subjects.subject_id — NOT NULL — 접근 대상 피험자 FK
  • relationship_type — ENUM('GUARDIAN', 'SELF') — NOT NULL — 관계 유형: GUARDIAN=보호자가 대리 관리(아동/노인 등 스마트폰 사용이 서툰 피험자 전연령 대상, 부모-자녀 관계로 한정하지 않음), SELF=피험자 본인이 자신에게 접근. 연령(subjects.life_s…
  • is_primary_guardian — BOOLEAN — NOT NULL — 가족 내 대표 보호자 여부(업무지시서 2장) - 결제/대표 알림 수신 대상. relationship_type=GUARDIAN에서만 의미 있음, 같은 subject_id에 TRUE는 1명만 권장(앱 레벨 검증)
  • granted_at — DATETIME — NOT NULL — 접근권한 부여일시
  • revoked_at — DATETIME — 접근권한 회수일시 (NULL이면 현재 유효)

accounts

  • account_id — BIGINT — Primary key — NOT NULL — 계정 고유 식별자 (내부 서로게이트키)
  • account_type — ENUM('GUARDIAN', 'FACILITY_STAFF', 'ADMIN', 'SUBJECT_SELF') — NOT NULL — 계정 유형: GUARDIAN=보호자, FACILITY_STAFF=담당자(교사/케이스매니저), ADMIN=관리자, SUBJECT_SELF=성인 피험자 본인
  • admin_level — ENUM('GENERAL', 'SUPERVISOR') — 관리자 등급 (account_type=ADMIN 일 때만 값 존재). SUPERVISOR=총괄관리자, 마스터 설정화면 등 승인 권한 보유
  • login_id — VARCHAR(100) — NOT NULL — 이메일/휴대폰 등 표시·검색용 캐시값 - 실제 인증 출처는 Firebase이며 이 값은 스냅샷일 뿐(로그인 시 검증에 사용하지 않음)
  • firebase_uid — VARCHAR(128) — NOT NULL — Firebase Authentication UID - 실제 인증(비밀번호 검증, 소셜로그인 등)은 Firebase에 위임하고, 여기서는 Firebase 계정 ↔ 내부 account_id 매핑만 담당
  • display_name — VARCHAR(100) — NOT NULL — 화면에 노출되는 별칭/이름 (실명이 아니어도 됨 - PII는 별도 관리)
  • status — ENUM('INVITED', 'ACTIVE', 'SUSPENDED', 'WITHDRAWN') — NOT NULL — 계정 상태: INVITED=관리자가 계정을 미리 만들어 초대했으나 첫 로그인 전(주로 담당자), ACTIVE=정상, SUSPENDED=일시정지, WITHDRAWN=탈퇴
  • last_login_at — DATETIME — 최근 로그인 성공 일시 (화면 표시용 요약값 - 전체 이력은 account_login_history 참조)
  • last_login_ip — VARCHAR(45) — 최근 로그인 IP (IPv6 포함 45자) - 화면 표시용 요약값
  • created_at — DATETIME — NOT NULL — 계정 생성일시
  • updated_at — DATETIME — NOT NULL — 최종 수정일시

adverse_event_logs

  • event_id — BIGINT — Primary key — NOT NULL — 이상반응 이벤트 식별자
  • campaign_subject_id — BIGINT — Foreign key → campaign_subjects.campaign_subject_id — NOT NULL — 이상반응이 발생한 캠페인 참여 건 FK
  • reported_by_account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 일별 체크리스트에서 Q5=유 를 입력한 계정 (보호자 또는 담당자)
  • reported_at — DATETIME — NOT NULL — 이상반응 보고 일시
  • symptom_detail — VARCHAR(500) — NOT NULL — 복통/구토/설사/발진 등 상세 선택지
  • severity_score — TINYINT — 중증도 점수(1~5, 요구사항정의서 6.2절 관찰지표 척도) - 3점 이상이면 긴급 프로토콜
  • ack_status — ENUM('UNACKED', 'ACKED') — NOT NULL — 담당자/관리자의 확인 여부 - 에스컬레이션 판단 기준
  • acked_by_account_id — BIGINT — Foreign key → accounts.account_id — 확인 처리한 계정
  • acked_at — DATETIME — 확인 처리 일시

campaign_products

  • campaign_product_id — BIGINT — Primary key — NOT NULL — 캠페인-제품 연결 식별자
  • campaign_id — BIGINT — Foreign key → campaigns.campaign_id — NOT NULL — 대상 캠페인 FK
  • product_id — BIGINT — Foreign key → rice_products.product_id — NOT NULL — 이 캠페인에서 실험한 제품 FK
  • group_label — VARCHAR(50) — 대조군/실험군 등 그룹 라벨 (한 캠페인에 여러 제품을 병행 실험하는 경우에만 사용, 단일 제품이면 NULL)

campaign_staff

  • campaign_staff_id — BIGINT — Primary key — NOT NULL — 캠페인-담당자 배정 레코드 식별자
  • campaign_id — BIGINT — Foreign key → campaigns.campaign_id — NOT NULL — 대상 캠페인 FK
  • account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 배정된 담당자/관리자 계정 FK (account_type=FACILITY_STAFF 또는 ADMIN)
  • role_in_campaign — ENUM('FACILITY_TEACHER', 'CASE_MANAGER', 'SUPERVISOR') — NOT NULL — 캠페인 내 역할: FACILITY_TEACHER=현장교사, CASE_MANAGER=케이스매니저, SUPERVISOR=총괄관리자
  • assigned_at — DATETIME — NOT NULL — 배정일시
  • unassigned_at — DATETIME — 배정 해제일시 (NULL이면 현재 담당 중 - 이 값이 NULL인 행만 유효한 접근권한으로 취급)

campaign_subjects

  • campaign_subject_id — BIGINT — Primary key — NOT NULL — 캠페인-피험자 참여 레코드 식별자 - 이후 모든 실데이터(설문응답/일별기록 등)가 참조할 진입점
  • campaign_id — BIGINT — Foreign key → campaigns.campaign_id — NOT NULL — 참여 대상 캠페인 FK
  • subject_id — BIGINT — Foreign key → subjects.subject_id — NOT NULL — 참여하는 피험자 FK
  • enrollment_code — VARCHAR(30) — NOT NULL — 이 피험자의 이 캠페인 참여에 대한 개인별 참여번호 (예: WH2026A-014) - campaigns.campaign_code(캠페인 공용 입장코드)와는 다른 개념. 화면/상담/문의 시 이 건을 특정하는 용도
  • enrolled_by_account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 참여코드를 실제로 입력/등록을 실행한 계정 - 성인은 본인(SUBJECT_SELF), 아동은 보호자(GUARDIAN)
  • consent_status — ENUM('PENDING', 'ACTIVE', 'WITHDRAWN', 'EXPIRED', 'COMPLETED') — NOT NULL — 동의 상태 (STD-2026-001 공통 상태코드 기준): PENDING=동의대기, ACTIVE=참여중, WITHDRAWN=철회, EXPIRED=기간만료, COMPLETED=정상종료
  • enrolled_at — DATETIME — NOT NULL — 캠페인 참여 등록일시
  • withdrawn_at — DATETIME — 참여 철회일시 (해당 시 consent_status=WITHDRAWN과 함께 기록)
  • dissent_hold — BOOLEAN — NOT NULL — 아동 본인의 거부권(Dissent) 행사 여부 - TRUE면 보호자 동의(consent_status=ACTIVE)와 무관하게 데이터 수집/화면 렌더링을 즉시 차단 (세부알고리즘정의서 7.2절)
  • dissent_recorded_at — DATETIME — 거부권 행사가 기록된 일시
  • baseline_survey_completed_at — DATETIME — 최초 전체 NQ 문항(14/21개) 1회 완료 일시. NULL이면 아직 초기 스크리닝 전 - 이 경우 앱은 라운드로빈이 아니라 전체 문항 일괄 입력 화면을 띄워야 함. 값이 채워진 이후부터 일별 알림장에서 라운드로…

campaigns

  • campaign_id — BIGINT — Primary key — NOT NULL — 캠페인 고유 식별자 - 담당자/피험자/가족을 묶는 허브 PK
  • campaign_code — VARCHAR(50) — NOT NULL — 성인 본인 또는 보호자가 앱에서 직접 입력하는 참여 코드 (예: DEMO_FREEZE_2026)
  • campaign_name — VARCHAR(200) — NOT NULL — 캠페인 표시명
  • start_date — DATE — NOT NULL — 캠페인(실증기간) 시작일
  • end_date — DATE — 캠페인 종료일 (진행 중이면 NULL)
  • status — ENUM('PLANNED', 'ACTIVE', 'CLOSED') — NOT NULL — 캠페인 상태: PLANNED=예정, ACTIVE=진행중, CLOSED=종료
  • target_enrollment_count — INT — 목표 참여 인원 (요구사항정의서 기초조사 항목 - 예: 초기 참여군 목표 20명). 대시보드 "목표 대비 진행률" 표시용
  • created_at — DATETIME — NOT NULL — 캠페인 등록일시

daily_intake_logs

  • log_id — BIGINT — Primary key — NOT NULL — 일별 기록 식별자
  • campaign_subject_id — BIGINT — Foreign key → campaign_subjects.campaign_subject_id — NOT NULL — 어느 캠페인 참여 건에 대한 기록인지
  • recorded_by_account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 입력자 계정 (보호자 또는 본인) - 덮어쓰기 아닌 append로 보존
  • log_date — DATE — NOT NULL — 기록 대상 일자
  • supplement_taken — BOOLEAN — NOT NULL — 당일 보충제 섭취 여부 - Dose_supp 연산에 사용
  • rice_intake_code — ENUM('NONE', 'HALF', 'ONE', 'TWO') — NOT NULL — 당일 기능성 쌀 섭취량 코드 (없음/반공기/한공기/두공기) - Intake_rice 연산에 사용
  • adverse_event_flag — BOOLEAN — NOT NULL — Q5 이상반응 유/무 - TRUE 시 adverse_event_logs에도 별도 이벤트로 반드시 함께 기록
  • created_at — DATETIME — NOT NULL — 기록 제출 일시

device_tokens

  • token_id — BIGINT — Primary key — NOT NULL — 토큰 레코드 식별자
  • account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 토큰 소유 계정 FK - 한 계정이 여러 기기(폰 교체, 재설치 등)를 가질 수 있어 1:N
  • fcm_token — VARCHAR(255) — NOT NULL — Firebase Cloud Messaging 등록 토큰
  • platform — ENUM('IOS', 'ANDROID', 'WEB') — NOT NULL — 토큰이 발급된 플랫폼
  • is_active — BOOLEAN — NOT NULL — 유효 여부 - 로그아웃/토큰 갱신 시 FALSE 처리(삭제하지 않고 이력 보존)
  • registered_at — DATETIME — NOT NULL — 토큰 최초 등록일시
  • last_used_at — DATETIME — 마지막으로 푸시 발송에 사용된 일시

families

  • family_id — BIGINT — Primary key — NOT NULL — 가족 고유 식별자
  • family_name — VARCHAR(100) — 가족 표시명 (선택 입력, 화면 그룹핑용 - 실제 접근권한 판단에는 사용하지 않음)
  • family_code — VARCHAR(20) — 가족 초대 코드 - 이미 만들어진 가족에 다른 구성원(성인 자가등록자 포함)이 합류할 때 입력. campaign_code와 동일한 방식(코드 입력으로 합류)
  • created_at — DATETIME — NOT NULL — 가족 레코드 생성일시

notification_dispatches

  • dispatch_id — BIGINT — Primary key — NOT NULL — 발송 레코드 식별자
  • adverse_event_id — BIGINT — Foreign key → adverse_event_logs.event_id — NOT NULL — 어느 이상반응 이벤트에 대한 알림인지 FK
  • recipient_account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 수신 대상 계정 (담당 교사/케이스매니저/총괄관리자 등)
  • escalation_level — TINYINT — NOT NULL — 에스컬레이션 단계: 0=1차(담당 교사/케이스매니저), 1=2차(총괄관리자), 2=3차(비상 채널/연구소)
  • channel — ENUM('PUSH', 'SMS') — NOT NULL — 발송 채널 - PUSH는 FCM, SMS는 미확인 시 최종 백업 채널
  • fcm_message_id — VARCHAR(255) — FCM 발송 응답 메시지 ID (전달 여부 추적용)
  • delivery_status — ENUM('SENT', 'FAILED') — NOT NULL — 발송 결과 - FCM 응답 기준(토큰 만료 등으로 FAILED 가능)
  • sent_at — DATETIME — NOT NULL — 발송 일시

nq_questions

  • question_id — VARCHAR(20) — Primary key — NOT NULL — 문항 고유 코드 (예: CHILD_BAL_01)
  • campaign_id — BIGINT — Foreign key → campaigns.campaign_id — NULL=전 캠페인 공용 문항(식약처 NQ 공식 문항 풀), 값이 있으면 해당 캠페인 전용 커스텀 문항 - 관리자가 캠페인별로 문항을 조절/신규 생성 가능
  • target_group — ENUM('CHILD', 'ADULT') — NOT NULL — 어린이용(14문항)/성인용(21문항) 풀 구분 - 피험자 life_stage_group에 따라 자동 매칭
  • category — ENUM('BALANCE', 'DIVERSITY', 'MODERATION', 'PRACTICE') — NOT NULL — NQ 영역: 균형/다양/절제/실천
  • question_text — VARCHAR(500) — NOT NULL — 문항 텍스트 (공용 문항은 라이선스 확보 전까지 자리표시자, 캠페인 전용 문항은 관리자가 자유 작성)
  • weight_omega — DECIMAL(4, 2) — NOT NULL — 문항내가중치 - 동일 target_group+category(+campaign_id) 내 합계 1.0
  • is_active — BOOLEAN — NOT NULL — 캠페인 운영 중 문항을 끄고 켤 수 있도록 - 삭제 대신 비활성화 권장(응답 이력 보존)

nq_responses

  • response_id — BIGINT — Primary key — NOT NULL — 응답 레코드 식별자
  • campaign_subject_id — BIGINT — Foreign key → campaign_subjects.campaign_subject_id — NOT NULL — 어느 캠페인 참여 건에 대한 응답인지 - subject_id 직접 참조 금지(캠페인 간 데이터 혼선 방지)
  • question_id — VARCHAR(20) — Foreign key → nq_questions.question_id — NOT NULL — 응답 대상 문항 FK
  • cycle_number — INT — NOT NULL — 몇 번째 순환 사이클의 응답인지. cycle_number=1은 초기 스크리닝(회원가입 직후 전체 문항 일괄 응답)에 해당하며 한 세션에서 모든 문항이 한 번에 제출됨. cycle_number=2 이상부터는 일별 알…
  • answer_value — DECIMAL(5, 2) — NOT NULL — 선택지 응답값 (척도/코드화된 값)
  • recorded_by_account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 실제로 응답을 입력한 계정 - 아동은 보호자(GUARDIAN), 성인은 본인(SUBJECT_SELF)
  • answered_at — DATETIME — NOT NULL — 응답 제출 일시

nutrient_formulation_factors

  • formulation_type — ENUM('TABLET', 'SOFT_CAPSULE', 'LIQUID', 'POWDER') — Primary key — NOT NULL — 보충제 제형 - 정제/연질캡슐/액상/분말
  • nutrient_id — VARCHAR(20) — Foreign key → nutrients.nutrient_id — NOT NULL — 영양소 FK
  • factor_value — DECIMAL(4, 3) — NOT NULL — 제형 계수(β/α_form) - Nutrient_Total,i 연산에서 Supplement_mcg,i에 곱해지는 값

nutrient_reference_master

  • reference_id — BIGINT — Primary key — NOT NULL — 기준값 레코드 식별자
  • reference_source — VARCHAR(30) — NOT NULL — 기준 출처 코드 (예: KR_KDRI, NP_MOH, WFP 등) - 신규 국가/기관 추가 시 이 값만 새로 추가하면 되고 스키마 변경 불필요
  • age_group — VARCHAR(30) — NOT NULL — 연령대 구간 (기준 출처마다 구간 정의가 다를 수 있어 코드 대신 자유 문자열, 예: 1-3세, 19-29세)
  • gender — ENUM('M', 'F', 'ALL') — NOT NULL — 성별 - 남녀 구분 없는 기준치는 ALL
  • nutrient_id — VARCHAR(20) — Foreign key → nutrients.nutrient_id — NOT NULL — 영양소 FK
  • recommended_amount — DECIMAL(10, 4) — NOT NULL — 권장량 (RNI/RDA 등 출처별 명칭은 다르나 값의 성격은 동일)
  • upper_limit — DECIMAL(10, 4) — 상한섭취량(UL) - 출처에 상한 기준이 없으면 NULL 허용
  • unit — VARCHAR(10) — NOT NULL — 단위 - nutrients.base_unit과 다를 경우 연산 시 환산 필요

nutrients

  • nutrient_id — VARCHAR(20) — Primary key — NOT NULL — 영양소 코드 (예: VIT_A, VIT_D, CALCIUM, OMEGA3 등) - rice_product_nutrients.nutrient_code와 동일 값 체계
  • nutrient_name — VARCHAR(50) — NOT NULL — 영양소명 (예: 비타민 A)
  • category — ENUM('VITAMIN', 'MINERAL', 'OTHER') — NOT NULL — 분류 - 비타민군/미네랄 및 기타 계열
  • base_unit — VARCHAR(10) — NOT NULL — 기본 단위 (mg/mcg 등) - 이 영양소 관련 전 테이블에서 단위 고정 기준
  • base_absorption_rate — DECIMAL(4, 3) — NOT NULL — 영양소 자체의 기본 흡수계수 (α_absorption) - Nutrient_Total,i 연산에 사용, 관리자가 조정 가능
  • is_active — BOOLEAN — NOT NULL — 사용 여부 - 삭제 대신 비활성화 권장(기존 연산/응답 이력 참조 보존)

reference_coefficients

  • coefficient_id — BIGINT — Primary key — NOT NULL — 계수 레코드 식별자
  • coefficient_type — ENUM('SEVERITY_WEIGHT', 'LIFE_STAGE_ABSORPTION', 'RICE_INTAKE_GRAM') — NOT NULL — 계수 종류: SEVERITY_WEIGHT=식습관 중증도 가중치(Wd), LIFE_STAGE_ABSORPTION=생애주기별 기본 소화흡수율(Ea), RICE_INTAKE_GRAM=일별 체크리스트 쌀 간식 섭취코드→그…
  • key_code — VARCHAR(30) — NOT NULL — 계수 종류별 키 값 (예: SEVERITY_WEIGHT면 HIGH/MEDIUM/LOW, LIFE_STAGE_ABSORPTION이면 INFANT_CHILD/ADULT 등, RICE_INTAKE_GRAM이면 daily…
  • value — DECIMAL(10, 4) — NOT NULL — 계수 값 (가중치/흡수율/그램 등 - coefficient_type에 따라 단위 의미가 다름)
  • unit — VARCHAR(10) — 단위 (예: RICE_INTAKE_GRAM이면 g, 나머지는 무차원이라 NULL)
  • description — VARCHAR(200) — 설명 (관리자 화면 표시용)

rice_product_nutrients

  • nutrient_code — VARCHAR(20) — Primary key — NOT NULL — 영양소 코드 (17대 영양소 마스터 기준 - 예: VIT_A, VIT_D, CALCIUM 등)
  • product_id — BIGINT — Foreign key → rice_products.product_id — NOT NULL — 제품 FK
  • amount_per_100g — DECIMAL(10, 4) — NOT NULL — 100g당 함량 (Nutrient_FRK100,i 연산에 직접 사용되는 값)
  • unit — VARCHAR(10) — NOT NULL — 단위 (mg/mcg 등) - 영양소마다 표준 단위 고정

rice_products

  • product_id — BIGINT — Primary key — NOT NULL — 제품 고유 식별자
  • product_code — VARCHAR(30) — NOT NULL — 제품 코드 (예: WH-RICE-001)
  • product_name — VARCHAR(200) — NOT NULL — 제품명 (예: 저항전분 강화 기능성 쌀)
  • serving_size_g — DECIMAL(6, 2) — NOT NULL — 1회 제공량(g) 기준 - 연산공식정의서의 Intake_rice 등 단위 환산 기준값
  • description — VARCHAR(500) — 제품 설명/특징
  • created_at — DATETIME — NOT NULL — 등록일시

subject_consents

  • consent_id — BIGINT — Primary key — NOT NULL — 동의 이벤트 고유 일련번호
  • campaign_subject_id — BIGINT — Foreign key → campaign_subjects.campaign_subject_id — NOT NULL — 대상 캠페인 참여 건 FK (family_id/subject_id는 이를 통해 조회 - 원본 스펙의 두 FK를 대체)
  • consent_version — VARCHAR(10) — NOT NULL — 동의서 문서 개정 버전 (예: v1.0, v1.1) - 버전이 바뀌면 재동의 이벤트가 새 행으로 추가됨
  • consent_type — ENUM('SUBJECT', 'REPRESENTATIVE') — NOT NULL — SUBJECT=피험자 본인 동의, REPRESENTATIVE=보호자 대리 동의
  • event_type — ENUM('CONSENT', 'WITHDRAWAL', 'DISSENT', 'DISSENT_LIFTED') — NOT NULL — 이벤트 종류: CONSENT=동의, WITHDRAWAL=철회, DISSENT=아동본인 거부권 행사, DISSENT_LIFTED=거부권 철회(재동의)
  • consent_status — ENUM('PENDING', 'ACTIVE', 'WITHDRAWN', 'EXPIRED', 'COMPLETED') — NOT NULL — 이 이벤트 발생 직후의 상태 (STD-2026-001 공통 상태코드) - campaign_subjects.consent_status 캐시 갱신에 사용
  • event_actor_account_id — BIGINT — Foreign key → accounts.account_id — NOT NULL — 이 동의/철회/거부 이벤트를 실제로 실행한 계정 - 보호자 본인 또는 성인 피험자 본인(SUBJECT_SELF). 아동 거부권은 대개 현장 담당자(FACILITY_STAFF)가 대리 기록
  • agreed_at — DATETIME — 최초 자발적 동의 완료 일시 (event_type=CONSENT일 때)
  • withdrawn_at — DATETIME — 철회 요청 일시 (event_type=WITHDRAWAL일 때)
  • withdrawal_reason — TEXT — 철회/거부 사유 (서술형 또는 선택형 코드)
  • explainer_name — VARCHAR(100) — 연구 설명자 명의 (시스템 자동 마킹 또는 연구원 ID)
  • digital_signature — TEXT — 전자서명 검증 토큰 또는 서명 이미지 Base64 스트링
  • access_ip — VARCHAR(45) — NOT NULL — 이벤트 진행 당시 접속 IP
  • device_info — VARCHAR(255) — 접속 디바이스 메타데이터 (User-Agent 등)
  • created_at — DATETIME — NOT NULL — 이 감사 레코드 자체의 생성일시 - 이후 절대 UPDATE하지 않음(append-only)

subjects

  • subject_id — BIGINT — Primary key — NOT NULL — 피험자 내부 서로게이트키 - 절대 화면/API/리포트에 그대로 노출 금지
  • family_id — BIGINT — Foreign key → families.family_id — NOT NULL — 소속 가족 FK - 형제자매는 같은 family_id를 공유
  • subject_pseudo_code — VARCHAR(30) — NOT NULL — 화면/리포트/API에 노출되는 비식별 코드 (예: WH-2026-A7X4) - 실명 대신 사용
  • birth_year_month — CHAR(7) — NOT NULL — 생년월(YYYY-MM) - 생년월일 원본 대신 저장, 만나이/생애주기 판별용
  • sex — ENUM('M', 'F') — NOT NULL — 성별
  • life_stage_group — ENUM('INFANT_CHILD', 'ADOLESCENT', 'ADULT', 'ELDERLY') — NOT NULL — 생애주기 그룹 - ADULT/ELDERLY는 본인 로그인(SUBJECT_SELF) 가능성 있음, 그 외는 보호자 대리입력 전제
  • created_at — DATETIME — NOT NULL — 피험자 프로필 생성일시