지능형 전동화_R1_EA

테이블 (12)

alarm

  • id — BIGSERIAL — 기본 키 — NOT NULL — 알람 번호 (PK)
  • voyage_id — BIGINT — 외래 키 → voyage.id — 어느 항차인가 (FK voyage)
  • source — VARCHAR(10) — NOT NULL — 발생 위치 — SHIP(선내) / SHORE(육상)
  • severity — VARCHAR(10) — NOT NULL — 심각도 — WARNING(경고성) / CRITICAL(위험성)
  • code — VARCHAR(30) — NOT NULL — 알람 코드
  • occurred_at — TIMESTAMPTZ — NOT NULL — 발생 시각
  • recv_at — TIMESTAMPTZ — 육상 수신 시각 — 발생 시각과 벌어져 있으면 통신 지연이 있었다는 뜻
  • ack_at — TIMESTAMPTZ — 관제사 확인 시각 — 비어 있으면 놓친 알람
  • ack_user_id — BIGINT — 외래 키 → app_user.id — 확인한 사용자 번호 (FK app_user)

app_user

  • id — BIGSERIAL — 기본 키 — NOT NULL — 사용자 번호 (PK)
  • login_id — VARCHAR(50) — NOT NULL — 로그인 아이디
  • name — VARCHAR(50) — NOT NULL — 이름
  • org — VARCHAR(100) — 소속 기관
  • role — VARCHAR(30) — 역할
  • can_request_authority — BOOLEAN — NOT NULL — 원격 제어권 요청 가능 여부
  • status — VARCHAR(20) — NOT NULL — 계정 상태
  • created_at — TIMESTAMPTZ — NOT NULL — 계정 생성 시각

audit_log

  • id — BIGSERIAL — 기본 키 — NOT NULL — 감사 로그 번호 (PK)
  • user_id — BIGINT — 외래 키 → app_user.id — 행위자 사용자 번호 (FK app_user)
  • at — TIMESTAMPTZ — NOT NULL — 행위 시각
  • action — VARCHAR(40) — NOT NULL — 행위 종류
  • target — VARCHAR(100) — 행위 대상 — 무엇을 상대로 한 일인가
  • result — VARCHAR(20) — 처리 결과 — 성공 / 실패
  • session_start — TIMESTAMPTZ — 세션 시작 시각
  • session_end — TIMESTAMPTZ — 세션 종료 시각

config

  • value — JSONB — NOT NULL — 설정 내용
  • category — VARCHAR(30) — 설정 분류
  • updated_by — BIGINT — 외래 키 → app_user.id — 마지막으로 바꾼 사용자 번호 (FK app_user)
  • updated_at — TIMESTAMPTZ — NOT NULL — 마지막으로 바꾼 시각

contact

  • ts — TIMESTAMPTZ — 기본 키 — NOT NULL — 선박에서 탐지한 시각 (PK)
  • contact_id — VARCHAR(30) — 기본 키 — NOT NULL — 피탐체 식별자 (PK) — 같은 시각에 여러 개가 잡히므로 키에 들어간다
  • voyage_id — BIGINT — 외래 키 → voyage.id — NOT NULL — 어느 항차인가 (PK · FK voyage)
  • recv_ts — TIMESTAMPTZ — NOT NULL — 육상이 받은 시각
  • kind — VARCHAR(20) — 피탐체 종류 — 통항선 / 부두 / 장애 영역 / 가상선 / AIS 원본 등 (VSM-017)
  • confidence — REAL — 식별 정보 신뢰도
  • lat — DOUBLE PRECISION — 피탐체 위도 (도)
  • lon — DOUBLE PRECISION — 피탐체 경도 (도)
  • size_m — REAL — 추정 크기 (m)
  • course — REAL — 추정 진행 방향 (도)

handover_log

  • id — BIGSERIAL — 기본 키 — NOT NULL — 전환 이력 번호 (PK)
  • voyage_id — BIGINT — 외래 키 → voyage.id — NOT NULL — 어느 항차인가 (FK voyage)
  • requested_at — TIMESTAMPTZ — NOT NULL — 전환을 요청한 시각
  • from_authority — VARCHAR(10) — NOT NULL — 전환 전 제어권 주체 — CREW / ANS / REMOTE. ANS ↔ REMOTE 직접 전환은 차단된다 (OPC-013)
  • to_authority — VARCHAR(10) — NOT NULL — 전환 후 제어권 주체 — CREW / ANS / REMOTE
  • voyage_phase — SMALLINT — 항차 단계 — 1~9. 자율 구간은 4~6
  • result — VARCHAR(20) — 전환 결과 — COMPLETED(완료) / DENIED(거부) / ROLLBACK(원상 복귀) / FALLBACK(강제 회수)
  • duration_ms — INT — 전환 소요 시간(밀리초) — 5차년도 실증 시험의 합격 기준값
  • deny_reason — VARCHAR(50) — 전환 불가 사유 — 착수자료에 11종으로 정리되어 있음 (OPC-016)
  • check_result — JSONB — 전환 전 점검 결과 — 항목별 통과·실패. 항목이 고정

link_quality

  • ts — TIMESTAMPTZ — 기본 키 — NOT NULL — 측정 시각 (PK)
  • network — VARCHAR(10) — 기본 키 — NOT NULL — 망 구분 (PK) — PRIMARY(주 망) / BACKUP(예비 망)
  • jitter_ms — REAL — 지연 흔들림 (밀리초)
  • loss_pct — REAL — 패킷 손실률 (%)
  • bandwidth_mbps — REAL — 대역폭 (Mbps)

remote_command

  • id — BIGSERIAL — 기본 키 — NOT NULL — 명령 번호 (PK)
  • voyage_id — BIGINT — 외래 키 → voyage.id — NOT NULL — 어느 항차인가 (FK voyage)
  • user_id — BIGINT — 외래 키 → app_user.id — NOT NULL — 조작한 사용자 번호 (FK app_user)
  • issued_at — TIMESTAMPTZ — NOT NULL — 명령을 보낸 시각
  • command_type — VARCHAR(20) — NOT NULL — 명령 종류 — RUDDER(타각) / RPM(회전수) / EMERGENCY_STOP(비상 정지)
  • input_value — NUMERIC(8,2) — 육상에서 입력한 값
  • applied_value — NUMERIC(8,2) — 선박에서 실제 적용된 값
  • delta — NUMERIC(8,2) — 입력값과 적용값의 차이
  • link_snapshot — JSONB — 조작 시점의 통신 상태

state_change

  • id — BIGSERIAL — 기본 키 — NOT NULL — 상태 변경 번호 (PK)
  • voyage_id — BIGINT — 외래 키 → voyage.id — NOT NULL — 어느 항차인가 (FK voyage)
  • ts — TIMESTAMPTZ — NOT NULL — 선박에서 바뀐 시각
  • recv_ts — TIMESTAMPTZ — NOT NULL — 육상이 받은 시각
  • item — VARCHAR(30) — NOT NULL — 변경된 점
  • prev_value — VARCHAR(30) — 바뀌기 전 값
  • new_value — VARCHAR(30) — NOT NULL — 바뀐 뒤 값
  • reason — VARCHAR(30) — 변경 사유

telemetry

  • ts — TIMESTAMPTZ — 기본 키 — NOT NULL — 선박에서 그 값이 만들어진 시각 (PK)
  • voyage_id — BIGINT — 외래 키 → voyage.id — NOT NULL — 어느 항차인가 (PK · FK voyage)
  • recv_ts — TIMESTAMPTZ — NOT NULL — 육상이 받은 시각
  • lat — DOUBLE PRECISION — 위도 (도)
  • lon — DOUBLE PRECISION — 경도 (도)
  • sog — REAL — 대지 속력 (노트)
  • heading — REAL — 선수 방위 (도)
  • rot — REAL — 선회율 (도/분)
  • rudder_cmd — REAL — 타각 지시값 (도)
  • rudder_act — REAL — 타각 실제값 (도)
  • rpm_cmd — REAL — 회전수 지시값 (rpm)
  • rpm_act — REAL — 회전수 실제값 (rpm)
  • battery_soc — REAL — 배터리 잔량 (%)
  • power_kw — REAL — 전력 사용량 (kW)
  • motor_state — JSONB — 모터·추진기 상태 — 항목 구성이 인터페이스 규격에 달려있어 현재는 알 수 없음.

voyage

  • id — BIGSERIAL — 기본 키 — NOT NULL — 항차 번호 (PK)
  • vessel_name — VARCHAR(100) — 선박명
  • call_sign — VARCHAR(20) — 호출 부호
  • voyage_no — VARCHAR(30) — NOT NULL — 항차 번호(업무용 표기) — 사람이 부르는 이름
  • planned_departure — TIMESTAMPTZ — 출항 예정 시각
  • actual_departure — TIMESTAMPTZ — 실제 출항 시각
  • planned_arrival — TIMESTAMPTZ — 입항 예정 시각
  • actual_arrival — TIMESTAMPTZ — 실제 입항 시각
  • status — VARCHAR(20) — NOT NULL — 항차 상태
  • current_authority — VARCHAR(10) — 현재 제어권 주체 . 화면 상시 표시용 캐시이며 덮어쓴다. 이력은 state_change 에 있다
  • authority_changed_at — TIMESTAMPTZ — 제어권이 바뀐 시각 (선박 기준)
  • authority_recv_at — TIMESTAMPTZ — 그 변경을 육상이 받은 시각

voyage_plan

  • id — BIGSERIAL — 기본 키 — NOT NULL — 항해 계획 번호 (PK)
  • voyage_id — BIGINT — 외래 키 → voyage.id — NOT NULL — 어느 항차인가 (FK voyage)
  • author_id — BIGINT — 외래 키 → app_user.id — 작성자 사용자 번호 (FK app_user)
  • version — INT — NOT NULL — 계획 판번호
  • sent_at — TIMESTAMPTZ — 선박으로 보낸 시각
  • approved_at — TIMESTAMPTZ — 선내 승인 시각
  • approval_status — VARCHAR(20) — NOT NULL — 승인 상태 — DRAFT(작성 중) / SENT(전송) / APPROVED(승인) / REJECTED(반려)
  • is_alternate — BOOLEAN — NOT NULL — 대안 항로 여부 — 주 항로인가 예비(대안) 항로인가
  • waypoints — JSONB — NOT NULL — 경유점 목록 — {seq, lat, lon, speed} 배열.