지능형 전동화_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} 배열.