D201_twin_cle

D201_erd

테이블 (9)

What-if 시나리오 실행 이력 (scenario_runs)

  • 시나리오 실행 이력 ID (scenario_run_id) — UUID — 기본 키 — NOT NULL
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 대상 배치 내부 ID (batch_uid) — UUID — 외래 키 → 배치 기본 정보.내부 배치 식별자 — NOT NULL
  • 실행 시나리오명 (scenario_name) — VARCHAR(128) — NOT NULL
  • 실행 상세 설명 (scenario_description) — TEXT
  • 실제 적용된 Override 설정 (override_json) — JSONB — NOT NULL
  • 기준안 수율 비율 (baseline_yield_pct) — DOUBLE — 변경 전 KPI
  • 시나리오 수율 비율 (scenario_yield_pct) — DOUBLE — 변경 후 KPI
  • 수율 변화량 (delta_yield_pct) — DOUBLE — 시나리오 - 기준안
  • 기준안 OOS 위험 비율 (baseline_oos_risk_pct) — DOUBLE — 변경 전 위험도
  • 시나리오 OOS 위험 비율 (scenario_oos_risk_pct) — DOUBLE — 변경 후 위험도
  • OOS 위험 변화량 (delta_oos_risk_pct) — DOUBLE — 시나리오 - 기준안
  • 기준안 최종 타이터 (baseline_final_titer) — DOUBLE — 변경 전 KPI
  • 시나리오 최종 타이터 (scenario_final_titer) — DOUBLE — 변경 후 KPI
  • 최종 타이터 변화량 (delta_final_titer) — DOUBLE — 시나리오 - 기준안
  • 기준안 최종 생존율 (baseline_final_viability) — DOUBLE — 변경 전 KPI
  • 시나리오 최종 생존율 (scenario_final_viability) — DOUBLE — 변경 후 KPI
  • 최종 생존율 변화량 (delta_final_viability) — DOUBLE — 시나리오 - 기준안
  • 세부 비교 결과 JSON (details_json) — JSONB — 곡선/보조 지표 확장 정보
  • 시나리오 실행 생성 시각 (created_at) — TIMESTAMPTZ — NOT NULL

경보 이력 (alerts)

  • 경보 ID (alert_id) — UUID — 기본 키 — NOT NULL
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 대상 배치 내부 ID (batch_uid) — UUID — 외래 키 → 배치 기본 정보.내부 배치 식별자 — NOT NULL
  • 경보 발생 시점 (timestamp) — TIMESTAMPTZ — NOT NULL
  • 대상 채널/지표 (channel) — VARCHAR(64) — NOT NULL — ex) glucose, viability
  • 경보 세부 유형 (alert_type) — VARCHAR(64) — NOT NULL — ex) glucose_depletion
  • 경보 심각도 (severity) — VARCHAR(20) — NOT NULL — warning / critical
  • 현재값 (current_value) — DOUBLE
  • 기준 임계값 (threshold) — DOUBLE
  • 임계값 이탈 방향 (direction) — VARCHAR(8) — low (미달) / high (초과)
  • 경보 상세 메시지 (message) — TEXT
  • 관리자 인지 여부 (acknowledged) — BOOLEAN — NOT NULL
  • 관리자 인지 시점 (acknowledged_at) — TIMESTAMPTZ
  • 경보 확인 메모 (ack_note) — TEXT — 확인 사유/코멘트

공정 시계열 데이터 (process_data)

  • 공정 데이터 ID (process_data_id) — UUID — 기본 키 — NOT NULL
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 대상 배치 내부 ID (batch_uid) — UUID — 외래 키 → 배치 기본 정보.내부 배치 식별자 — NOT NULL
  • 관측 일시 (timestamp) — TIMESTAMPTZ — NOT NULL
  • 데이터 출처 (source_role) — VARCHAR(32) — NOT NULL — 기본값: simulated_sensor
  • 공정 단계 (phase) — VARCHAR(20)
  • 배양 일차 (day) — DOUBLE — NOT NULL
  • 배양 시간 (hour) — DOUBLE — NOT NULL
  • 생존 세포 밀도 (vcd) — DOUBLE
  • 세포 생존율 (viability) — DOUBLE — 세포 생존율 (%)
  • 포도당 농도 (glucose) — DOUBLE
  • 젖산 농도 (lactate) — DOUBLE
  • 암모니아 농도 (ammonia) — DOUBLE
  • 글루타민 농도 (glutamine) — DOUBLE
  • 생산물 농도 (titer) — DOUBLE
  • 배양 체적 (volume) — DOUBLE
  • 현재 온도 (temperature) — DOUBLE
  • 현재 pH (ph) — DOUBLE
  • 피드 주입 명령값 (feed_rate) — DOUBLE

미래 시계열 포인트 (forecast_points)

  • 예측 시계열 포인트 고유 번호 (forecast_point_id) — UUID — 기본 키 — NOT NULL
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 소속 예측 실행 번호 (forecast_run_id) — UUID — NOT NULL
  • 예측 단계 순번 (step_index) — INT — NOT NULL — 1부터 시작, 실행 내 UNIQUE
  • 예측 시각 (timestamp) — TIMESTAMPTZ — 절대 시각이 있을 때 사용
  • 기준 시점 이후 경과 시간 (t_hr) — DOUBLE — 시간(hour) 축
  • 예측된 공정 단계 (phase) — VARCHAR(20) — 미래 단계 예측
  • 예측 생존 세포 밀도 (vcd) — DOUBLE — 미래 시계열 값
  • 예측 생존율 (viability) — DOUBLE — 미래 시계열 값
  • 예측 포도당 농도 (glucose) — DOUBLE — 미래 시계열 값
  • 예측 젖산 농도 (lactate) — DOUBLE — 미래 시계열 값
  • 예측 암모니아 농도 (ammonia) — DOUBLE — 미래 시계열 값
  • 예측 글루타민 농도 (glutamine) — DOUBLE — 미래 시계열 값
  • 예측 타이터 (titer) — DOUBLE — 미래 KPI 곡선
  • 예측 배양액 부피 (volume) — DOUBLE — 미래 운전값
  • 예측 온도 (temperature) — DOUBLE — 미래 운전값
  • 예측 pH (ph) — DOUBLE — 미래 운전값
  • 예측 feed 주입 속도 (feed_rate) — DOUBLE — 미래 운전값
  • 예측 규격 이탈 확률 (oos_probability) — DOUBLE — 시점별 위험도
  • 하한 신뢰구간/밴드 (lower_bound_json) — JSONB — 채널별 하한값 JSON
  • 상한 신뢰구간/밴드 (upper_bound_json) — JSONB — 채널별 상한값 JSON

배치 기본 정보 (batches)

  • 내부 배치 식별자 (batch_uid) — UUID — 기본 키 — NOT NULL — 시스템 내부 관리용 식별자
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 배치 외부 ID (batch_id) — VARCHAR(32) — NOT NULL — 업무용 외부 키 (테넌트 내 유일)
  • 시나리오 유형 (scenario_type) — VARCHAR(32) — NOT NULL
  • 배양 시작 일차 (starting_at_day) — INT
  • 소요 일수 (duration_days) — INT — NULL이면 미확정
  • 배치 파라미터 벡터 (param_vector_json) — JSONB — 시뮬레이션/운영 입력값 JSON
  • 관측 모델 설정값 (obs_model_json) — JSONB — 추정/예측 기준 모델 JSON
  • feed 계획 프로파일 (feed_profile_json) — JSONB
  • 온도 운영 프로파일 (temp_profile_json) — JSONB
  • 배치 상태 (status) — VARCHAR(20) — NOT NULL — RUNNING / COMPLETED / FAILED
  • 실제 배양 시작 일시 (start_time) — TIMESTAMPTZ
  • 실제 배양 종료 일시 (end_time) — TIMESTAMPTZ
  • 기본 배양 온도 (temperature) — DOUBLE
  • 기본 pH (ph) — DOUBLE
  • 용존산소 설정값 (do_setpoint) — DOUBLE — 용존산소 (DO)
  • 포도당 피드 주입 속도 (glucose_feed_rate) — DOUBLE
  • 초기 배양 체적 (initial_volume) — DOUBLE
  • 초기 세포 농도 (seed_density) — DOUBLE
  • 최종 생산량 (final_titer) — DOUBLE
  • 최종 생존율 (final_viability) — DOUBLE — 생존율 (Viability)
  • 배치 평가 등급 (batch_grade) — CHAR(1) — A / B / C 등급
  • 데이터 생성 일시 (created_at) — TIMESTAMPTZ — NOT NULL
  • 데이터 수정 일시 (updated_at) — TIMESTAMPTZ — NOT NULL

예측 실행 헤더 (forecast_runs)

  • 예측 실행 고유 번호 (forecast_run_id) — UUID — 기본 키 — NOT NULL
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 대상 배치 내부 ID (batch_uid) — UUID — 외래 키 → 배치 기본 정보.내부 배치 식별자 — NOT NULL
  • 예측 기준 시각 (base_timestamp) — TIMESTAMPTZ — NOT NULL — 어떤 시점의 상태를 기준으로 예측했는지 표시
  • 예측 수평선 길이(시간) (horizon_hours) — DOUBLE — NOT NULL — 0 이상
  • 예측 결과 요약 JSON (summary_json) — JSONB — 헤더 KPI/위험 요약
  • 생성 일시 (created_at) — TIMESTAMPTZ — NOT NULL

제어 및 조치 요청 이력 (control_actions)

  • 제어 액션 요청 ID (action_id) — UUID — 기본 키 — NOT NULL
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 대상 배치 내부 ID (batch_uid) — UUID — 외래 키 → 배치 기본 정보.내부 배치 식별자 — NOT NULL
  • 근거 시나리오 실행 이력 ID (scenario_run_id) — UUID — 외래 키 → What-if 시나리오 실행 이력.시나리오 실행 이력 ID — 이 제어 결정을 내리기 위해 참고한 What-if 기록
  • 수행할 액션 유형 (action_type) — VARCHAR(64) — NOT NULL — ex) feed_addition, temp_shift
  • 목표 온도 (target_temperature) — DOUBLE
  • 피드 주입 액션 여부 (add_feed) — BOOLEAN — NOT NULL
  • 피드 주입 예약 시점 (feed_addition_day) — DOUBLE
  • 조치 후 예상 수율 향상 (expected_yield_pct) — DOUBLE — 조치 후 예상 수율 향상 (%)
  • 조치 후 예상 OOS 위험 (expected_oos_risk_pct) — DOUBLE — 조치 후 예상 OOS 위험 (%)
  • 조치 진행 상태 (status) — VARCHAR(24) — NOT NULL — REQUESTED / APPLIED / CANCELLED
  • 조치 관련 관리자 메모 (note) — TEXT
  • 조치 요청 일시 (requested_at) — TIMESTAMPTZ — NOT NULL
  • 상태 변경 처리 일시 (status_changed_at) — TIMESTAMPTZ
  • 생성 일시 (created_at) — TIMESTAMPTZ — NOT NULL
  • 갱신 일시 (updated_at) — TIMESTAMPTZ — NOT NULL

파생 및 추정 지표 (derived_metrics)

  • 파생 지표 ID (derived_metric_id) — UUID — 기본 키 — NOT NULL
  • 테넌트 ID (tenant_id) — UUID — 외래 키 → 회사/테넌트 정보.테넌트 ID — NOT NULL
  • 대상 배치 내부 ID (batch_uid) — UUID — 외래 키 → 배치 기본 정보.내부 배치 식별자 — NOT NULL
  • 지표 기준 일시 (timestamp) — TIMESTAMPTZ — NOT NULL
  • 지표 추정 출처 (source_role) — VARCHAR(32) — NOT NULL — 기본값: twin_estimate
  • 공정 단계 (phase) — VARCHAR(20)
  • 추정기 이름 (estimator_name) — VARCHAR(32) — NOT NULL — ex) baseline, enkf
  • 비성장속도 (mu) — DOUBLE
  • 포도당 소비 속도 (q_glc) — DOUBLE
  • 젖산 생성/소비 속도 (q_lac) — DOUBLE
  • 비생산속도 (q_p) — DOUBLE — 비생산속도 (Productivity)
  • 적분 생존 세포 밀도 (ivcd) — DOUBLE — 적분 생존 세포 밀도 (Integral Viable Cell Density)
  • 젖산 대비 포도당 비율 (lac_glc_ratio) — DOUBLE — 대사 상태 모니터링 주요 지표
  • 성장 이상 여부 (growth_anomaly) — BOOLEAN — NOT NULL
  • 대사 이상 여부 (metabolic_anomaly) — BOOLEAN — NOT NULL
  • 생존율 경고 발생 여부 (viability_alert) — BOOLEAN — NOT NULL
  • OOS 발생 확률 (oos_probability) — DOUBLE — 기준 이탈(Out Of Specification) 위험도 예측치

회사/테넌트 정보 (tenants)

  • 테넌트 ID (tenant_id) — UUID — 기본 키 — NOT NULL — 시스템 내 모든 운영 데이터의 최상위 귀속 주체
  • 테넌트 코드 (tenant_code) — VARCHAR(64) — NOT NULL — 고객사 식별 고유 코드
  • 회사명 (tenant_name) — VARCHAR(128) — NOT NULL — 고객사 및 테넌트 이름
  • 로그인 이메일 (login_email) — VARCHAR(255) — NOT NULL — 회사 계정 인증에 사용되는 마스터 이메일
  • 비밀번호 해시 (password_hash) — TEXT — NOT NULL
  • 테넌트 상태 (status) — VARCHAR(16) — NOT NULL — ACTIVE (활성) / SUSPENDED (정지)
  • 최근 로그인 일시 (last_login_at) — TIMESTAMPTZ
  • 계정 생성 일시 (created_at) — TIMESTAMPTZ — NOT NULL
  • 계정 정보 수정 일시 (updated_at) — TIMESTAMPTZ — NOT NULL
  • 리프레시 토큰 해시 (refresh_token_hash) — TEXT — NOT NULL — 세션 연장 및 검증용 토큰 해시