04_TELEMETRY_EVENTS

Tables (13)

auth_admin_user

  • user_id — VARCHAR(36) — Primary key — NOT NULL — PK 내부 사용자 식별자
  • user_code — VARCHAR(30) — NOT NULL — UQ 외부/MQTT 요청자 코드 (ADM-0042)
  • username — VARCHAR(50) — NOT NULL — UQ 로그인 아이디
  • password_hash — VARCHAR(255) — NOT NULL — 단방향 비밀번호 해시
  • display_name — VARCHAR(100) — NOT NULL — 관리자 표시 이름
  • email — VARCHAR(150) — NOT NULL — UQ 이메일
  • profile_file_id — VARCHAR(36) — Foreign key → storage_file_object.file_id — FK 프로필 이미지 파일
  • department_name — VARCHAR(100) — 부서명
  • job_title — VARCHAR(100) — 직급/직책
  • office_name — VARCHAR(100) — 근무 조직/지점
  • is_active — BOOLEAN — NOT NULL — 로그인 가능 여부
  • password_changed_at — DATETIME — 최근 비밀번호 변경 시각
  • last_login_at — DATETIME — 최근 로그인 시각
  • deleted_at — DATETIME — 소프트 삭제 시각
  • created_at — DATETIME — NOT NULL — 가입 시각
  • updated_at — DATETIME — NOT NULL — 최종 수정 시각

robot_mission

  • mission_id — VARCHAR(36) — Primary key — NOT NULL — PK 내부 임무 식별자
  • mission_code — VARCHAR(40) — NOT NULL — UQ MQTT mission_id (MIS-20260723-001)
  • mission_name — VARCHAR(100) — NOT NULL — 임무명
  • description — TEXT — 임무 설명
  • robot_id — VARCHAR(36) — Foreign key → robot_robot.robot_id — NOT NULL — FK 수행 로봇
  • patrol_area_id — VARCHAR(36) — Foreign key → robot_patrol_area.patrol_area_id — NOT NULL — FK 순찰 구역
  • patrol_route_id — VARCHAR(36) — Foreign key → robot_patrol_route.patrol_route_id — FK 계획 경로
  • mission_status — VARCHAR(20) — NOT NULL — READY/ASSIGNED/RUNNING/PAUSED/COMPLETED/CANCELLED/FAILED
  • priority — SMALLINT — NOT NULL — 우선순위 1~5
  • scheduled_start_at — DATETIME — 예정 시작 시각
  • scheduled_end_at — DATETIME — 예정 종료 시각
  • started_at — DATETIME — 실제 시작 시각
  • completed_at — DATETIME — 완료 시각
  • progress_percent — DECIMAL(5, 2) — NOT NULL — 진행률
  • estimated_completion_at — DATETIME — 예상 완료 시각
  • incident_count — INTEGER — NOT NULL — 임무 이상 사건 수
  • normal_detection_count — INTEGER — NOT NULL — 정상 점자블록 탐지 집계
  • result_distance_m — DECIMAL(12, 2) — 임무 완료 거리
  • completion_reason — VARCHAR(50) — 완료/중단 이유
  • created_by — VARCHAR(36) — Foreign key → auth_admin_user.user_id — NOT NULL — FK 생성 관리자
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

robot_patrol_area

  • patrol_area_id — VARCHAR(36) — Primary key — NOT NULL — PK 순찰 구역 식별자
  • zone_id — VARCHAR(10) — NOT NULL — UQ MQTT 구역 코드 (A-01)
  • area_name — VARCHAR(100) — NOT NULL — 구역명
  • area_geometry — VARCHAR(255) — NOT NULL — PostGIS GEOMETRY(POLYGON,4326) 구역 Polygon
  • description — TEXT — 구역 설명
  • is_active — BOOLEAN — NOT NULL — 활성 여부
  • created_by — VARCHAR(36) — Foreign key → auth_admin_user.user_id — NOT NULL — FK 생성 관리자
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

robot_patrol_route

  • patrol_route_id — VARCHAR(36) — Primary key — NOT NULL — PK 경로 식별자
  • patrol_area_id — VARCHAR(36) — Foreign key → robot_patrol_area.patrol_area_id — NOT NULL — FK 소속 순찰 구역
  • route_code — VARCHAR(30) — NOT NULL — UQ 경로 코드
  • route_name — VARCHAR(100) — NOT NULL — 경로명
  • route_geometry — VARCHAR(255) — NOT NULL — PostGIS GEOMETRY(LINESTRING,4326) 계획 경로
  • planned_distance_m — DECIMAL(12, 2) — 계획 거리(m)
  • display_order — INTEGER — NOT NULL — 표시 순서
  • is_active — BOOLEAN — NOT NULL — 활성 여부
  • created_by — VARCHAR(36) — Foreign key → auth_admin_user.user_id — NOT NULL — FK 생성 관리자
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

robot_robot

  • robot_id — VARCHAR(36) — Primary key — NOT NULL — PK 내부 로봇 식별자
  • robot_code — VARCHAR(30) — NOT NULL — UQ MQTT robot_id (RBT-001)
  • robot_name — VARCHAR(100) — NOT NULL — 관리자 표시명
  • serial_number — VARCHAR(100) — UQ 기기 시리얼번호
  • mqtt_client_id — VARCHAR(100) — NOT NULL — UQ 고정 MQTT Client ID
  • mqtt_username — VARCHAR(100) — NOT NULL — UQ 기기별 MQTT 계정
  • hardware_model — VARCHAR(100) — 하드웨어 모델
  • firmware_version — VARCHAR(50) — 최근 Presence 보고 펌웨어
  • operational_status — VARCHAR(20) — NOT NULL — ACTIVE/INACTIVE/MAINTENANCE/DISABLED
  • registered_by — VARCHAR(36) — Foreign key → auth_admin_user.user_id — FK 등록 관리자
  • registered_at — DATETIME — NOT NULL — 등록 시각
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

storage_file_object

  • file_id — VARCHAR(36) — Primary key — NOT NULL — PK 파일 내부 식별자 (UUID)
  • bucket_name — VARCHAR(100) — NOT NULL — S3 버킷명
  • object_key — VARCHAR(500) — NOT NULL — UQ 버킷 내부 객체 키
  • file_type — VARCHAR(30) — NOT NULL — ROBOT_INCIDENT_IMAGE/PROFILE_IMAGE/REPORT_PDF/OTHER
  • original_file_name — VARCHAR(255) — 원본 파일명
  • mime_type — VARCHAR(100) — NOT NULL — MIME 유형
  • size_bytes — BIGINT — 파일 크기(Byte)
  • sha256 — VARCHAR(64) — SHA-256 무결성 해시
  • anonymized — BOOLEAN — NOT NULL — 비식별화 완료 여부
  • upload_status — VARCHAR(20) — NOT NULL — PENDING/UPLOADED/FAILED/DELETED
  • uploaded_at — DATETIME — 업로드 완료 시각
  • deleted_at — DATETIME — 논리 삭제 시각
  • created_at — DATETIME — NOT NULL — 레코드 생성 시각

telemetry_robot_battery_event

  • event_id — VARCHAR(36) — Foreign key → telemetry_robot_event.event_id — NOT NULL — PK,FK 공통 사건 ID
  • previous_state — VARCHAR(20) — 이전 배터리 상태
  • battery_valid — BOOLEAN — NOT NULL — 배터리 값 유효 여부
  • battery_percent — DECIMAL(5, 2) — 사건 시 배터리 잔량
  • battery_state — VARCHAR(20) — NOT NULL — 현재 상태
  • threshold_pct — DECIMAL(5, 2) — 전이 임계값
  • action_mission_state — VARCHAR(30) — 로봇이 적용한 임무 상태
  • action_robot_mode — VARCHAR(40) — 로봇이 적용한 운행 모드

telemetry_robot_boot_session

  • boot_id — VARCHAR(36) — Primary key — NOT NULL — PK 로봇이 부팅 시 생성한 UUID
  • robot_id — VARCHAR(36) — Foreign key → robot_robot.robot_id — NOT NULL — FK 로봇
  • schema_version — VARCHAR(20) — NOT NULL — Presence 스키마 버전
  • firmware_version — VARCHAR(50) — 부팅 시 펌웨어 버전
  • presence_status — VARCHAR(20) — NOT NULL — ONLINE 또는 OFFLINE
  • connected_at — DATETIME — Birth 연결 시각
  • disconnected_at — DATETIME — 종료/LWT 서버 수신 시각
  • disconnect_reason — VARCHAR(50) — UNGRACEFUL_DISCONNECT/GRACEFUL_SHUTDOWN 등
  • graceful_shutdown — BOOLEAN — 정상 종료 여부
  • last_presence_received_at — DATETIME — NOT NULL — 마지막 Presence 수신 시각
  • created_at — DATETIME — NOT NULL — 생성 시각
  • updated_at — DATETIME — NOT NULL — 수정 시각

telemetry_robot_current_state

  • robot_id — VARCHAR(36) — Foreign key → robot_robot.robot_id — NOT NULL — PK,FK 로봇
  • boot_id — VARCHAR(36) — Foreign key → telemetry_robot_boot_session.boot_id — FK 현재 부팅 세션
  • presence_status — VARCHAR(20) — NOT NULL — ONLINE/OFFLINE/UNKNOWN
  • presence_reason — VARCHAR(50) — 종료/오프라인 이유
  • presence_received_at — DATETIME — Presence 수신 시각
  • state_seq — BIGINT — 최근 State 순번
  • state_updated_at — DATETIME — 로봇 State 시각
  • state_received_at — DATETIME — 서버 State 수신 시각
  • mode — VARCHAR(40) — NOT NULL — BOOTING/READY/PATROLLING/PAUSED/SAFE_STOP/ERROR 등
  • reason_code — VARCHAR(80) — NOT NULL — 정지/오류 원인 코드
  • mission_id — VARCHAR(36) — Foreign key → robot_mission.mission_id — FK 현재 임무
  • mission_state — VARCHAR(30) — 현재 임무 상태
  • battery_valid — BOOLEAN — NOT NULL — 배터리 유효 여부
  • battery_percent — DECIMAL(5, 2) — 배터리 잔량
  • battery_state — VARCHAR(20) — NOT NULL — NORMAL/LOW/CRITICAL/UNKNOWN
  • health_camera — VARCHAR(20) — NOT NULL — 카메라 건강 상태
  • health_lidar — VARCHAR(20) — NOT NULL — LiDAR 건강 상태
  • health_gps — VARCHAR(20) — NOT NULL — GPS 건강 상태
  • health_battery — VARCHAR(20) — NOT NULL — 배터리 건강 상태
  • health_motor — VARCHAR(20) — NOT NULL — 모터 건강 상태
  • health_storage — VARCHAR(20) — NOT NULL — 저장장치 건강 상태
  • overall_health_status — VARCHAR(20) — NOT NULL — 서버 계산 NORMAL/WARNING/CRITICAL
  • last_telemetry_message_id — VARCHAR(36) — Foreign key → telemetry_robot_telemetry.message_id — FK 최근 텔레메트리
  • telemetry_sampled_at — DATETIME — 최근 표본 시각
  • telemetry_received_at — DATETIME — 최근 표본 서버 수신 시각
  • position_valid — BOOLEAN — NOT NULL — 현재 지도 위치 유효 여부
  • location — VARCHAR(255) — PostGIS GEOMETRY(POINT,4326) 현재 유효 위치
  • location_accuracy_m — FLOAT — GPS 오차
  • heading_deg — FLOAT — 진행 방향
  • motion_moving — BOOLEAN — 이동 여부
  • speed_mps — FLOAT — 현재 속도
  • battery_source — VARCHAR(20) — MEASURED/ESTIMATED
  • battery_voltage_v — FLOAT — 전압
  • battery_current_a — FLOAT — 전류
  • battery_charging — BOOLEAN — 충전 여부
  • battery_temperature_c — FLOAT — 배터리 온도
  • estimated_runtime_sec — INTEGER — 예상 잔여 운용시간
  • jetson_temperature_c — FLOAT — Jetson 온도
  • environment_temperature_c — FLOAT — 외기 온도
  • environment_humidity_pct — FLOAT — 외기 습도
  • mission_elapsed_sec — INTEGER — 임무 경과시간
  • mission_incident_count — INTEGER — 임무 사건 수
  • charging_status — VARCHAR(30) — NOT NULL — NOT_CHARGING/RETURNING/CHARGING/FULL
  • state_raw_payload — JSON — 최근 State 원본
  • updated_at — DATETIME — NOT NULL — Read Model 갱신 시각

telemetry_robot_event

  • event_id — VARCHAR(36) — Primary key — NOT NULL — PK MQTT event_id (QoS1 멱등키)
  • schema_version — VARCHAR(20) — NOT NULL — 페이로드 계약 버전
  • event_type — VARCHAR(80) — NOT NULL — 사건 유형
  • topic_category — VARCHAR(20) — NOT NULL — INCIDENT/BATTERY/SAFETY/MISSION
  • robot_id — VARCHAR(36) — Foreign key → robot_robot.robot_id — NOT NULL — FK 로봇
  • boot_id — VARCHAR(36) — Foreign key → telemetry_robot_boot_session.boot_id — NOT NULL — FK 부팅 세션
  • seq — BIGINT — NOT NULL — 부팅 내 공용 순번
  • source_component — VARCHAR(30) — NOT NULL — ai/power/safety/mission
  • occurred_at — DATETIME — NOT NULL — 실제 사건 발생 시각
  • sent_at — DATETIME — NOT NULL — MQTT 발행 시각
  • received_at — DATETIME — NOT NULL — 서버 수신 시각
  • mission_id — VARCHAR(36) — Foreign key → robot_mission.mission_id — FK 관련 임무
  • server_severity — VARCHAR(20) — 서버 계산 INFO/WARNING/CRITICAL
  • duplicate_count — INTEGER — NOT NULL — 동일 event_id 재수신 수
  • last_received_at — DATETIME — NOT NULL — 마지막 중복 수신 시각
  • raw_payload — JSON — NOT NULL — 원본 MQTT JSON
  • created_at — DATETIME — NOT NULL — 최초 저장 시각

telemetry_robot_mission_event

  • event_id — VARCHAR(36) — Foreign key → telemetry_robot_event.event_id — NOT NULL — PK,FK 공통 사건 ID
  • duration_sec — INTEGER — 임무 수행시간
  • distance_m — DECIMAL(12, 2) — 임무 이동 거리
  • incident_count — INTEGER — 이상 사건 수
  • normal_detection_count — INTEGER — 정상 블록 탐지 집계
  • completion_reason — VARCHAR(80) — ROUTE_COMPLETED 등

telemetry_robot_safety_event

  • event_id — VARCHAR(36) — Foreign key → telemetry_robot_event.event_id — NOT NULL — PK,FK 공통 사건 ID
  • reason_code — VARCHAR(80) — NOT NULL — OBSTACLE/BOUNDARY_LOST 등
  • distance_m — FLOAT — 장애물 거리
  • mode_before — VARCHAR(40) — 전이 전 모드
  • mode_after — VARCHAR(40) — 전이 후 모드
  • auto_resume_allowed — BOOLEAN — 자동 재출발 가능 여부

telemetry_robot_telemetry

  • message_id — VARCHAR(36) — Primary key — NOT NULL — PK MQTT message_id
  • schema_version — VARCHAR(20) — NOT NULL — 페이로드 버전
  • robot_id — VARCHAR(36) — Foreign key → robot_robot.robot_id — NOT NULL — FK 로봇
  • boot_id — VARCHAR(36) — Foreign key → telemetry_robot_boot_session.boot_id — NOT NULL — FK 부팅 세션
  • seq — BIGINT — NOT NULL — 부팅 내 공용 순번
  • sampled_at — DATETIME — NOT NULL — 로봇 표본 시각
  • received_at — DATETIME — NOT NULL — 서버 수신 시각
  • mission_id — VARCHAR(36) — Foreign key → robot_mission.mission_id — FK 수행 임무
  • position_valid — BOOLEAN — NOT NULL — GPS fix 유효 여부
  • location — VARCHAR(255) — PostGIS GEOMETRY(POINT,4326) 현재 위치
  • location_accuracy_m — FLOAT — GPS 오차 추정
  • heading_deg — FLOAT — 진행 방향
  • motion_moving — BOOLEAN — 이동 여부
  • speed_mps — FLOAT — 현재 속도
  • battery_valid — BOOLEAN — NOT NULL — 배터리 값 유효 여부
  • battery_percent — DECIMAL(5, 2) — 배터리 잔량
  • battery_state — VARCHAR(20) — NOT NULL — NORMAL/LOW/CRITICAL/UNKNOWN
  • battery_source — VARCHAR(20) — MEASURED 또는 ESTIMATED
  • battery_voltage_v — FLOAT — 배터리 전압
  • battery_current_a — FLOAT — 배터리 전류
  • battery_charging — BOOLEAN — 충전 여부
  • battery_temperature_c — FLOAT — 배터리 온도
  • estimated_runtime_sec — INTEGER — 예상 잔여 운용시간
  • jetson_temperature_c — FLOAT — NOT NULL — Jetson 열 존 최고 온도
  • environment_temperature_c — FLOAT — 외기 온도
  • environment_humidity_pct — FLOAT — 외기 습도
  • mission_state — VARCHAR(30) — RUNNING/PAUSED 등
  • mission_elapsed_sec — INTEGER — 임무 경과시간
  • mission_incident_count — INTEGER — 현재 임무 사건 수
  • raw_payload — JSON — NOT NULL — 원본 MQTT JSON
  • created_at — DATETIME — NOT NULL — 저장 시각