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 — 피험자 프로필 생성일시