twin_cle
SSAFY 2학기 특화 프로젝트
테이블 (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 — 세션 연장 및 검증용 토큰 해시