아크가드

테이블 (14)

ai_diagnosis_result

  • result_id — BIGINT — 기본 키 — NOT NULL — 결과ID
  • circuit_id — BIGINT — 외래 키 → circuit.circuit_id — NOT NULL — 회로ID
  • frame_id — BIGINT — 외래 키 → sensor_frame.frame_id — 프레임ID
  • verdict — ENUM('NORMAL', 'ARC') — NOT NULL — 판정
  • confidence — FLOAT — 신뢰도, 0~1
  • diagnosed_at — DATETIME — NOT NULL — 판정일시

alert

  • alert_id — BIGINT — 기본 키 — NOT NULL — 경보ID
  • circuit_id — BIGINT — 외래 키 → circuit.circuit_id — 회로ID, 통신두절(COMM_LOST)은 NULL
  • panel_id — BIGINT — 외래 키 → panel.panel_id — 분전반ID, 소스 무관하게 항상 채움
  • source — ENUM('DEVICE', 'AI', 'SYSTEM') — NOT NULL — 소스
  • type — ENUM('ARC', 'OVERHEAT', 'LEAKAGE', 'OVERCURRENT', 'HUMIDITY', 'GAS', 'FIRE', 'DOOR_OPEN', 'DEVICE_ERROR', 'COMM_LOST') — NOT NULL — 유형, V6에서 하드웨어 ALARM/ERROR bit 전체를 담도록 확장
  • result_id — BIGINT — 외래 키 → ai_diagnosis_result.result_id — AI결과ID, source=AI일 때만 값 존재
  • status — ENUM('UNCONFIRMED', 'CONFIRMED', 'RESOLVED') — NOT NULL — 상태
  • triggered_at — DATETIME — NOT NULL — 발생일시
  • confirmed_by — BIGINT — 외래 키 → user.user_id — 확인자ID
  • confirmed_at — DATETIME — 확인일시
  • resolved_at — DATETIME — 조치일시
  • resolved_by — BIGINT — 외래 키 → user.user_id — 조치자ID, V13 신규, 조치완료 처리자
  • resolution_note — VARCHAR(500) — 조치비고, V8 추가, 조치완료 시 사용자 입력

circuit

  • circuit_id — BIGINT — 기본 키 — NOT NULL — 회로ID
  • panel_id — BIGINT — 외래 키 → panel.panel_id — NOT NULL — 분전반ID
  • channel_no — INT — NOT NULL — 채널번호, UNIQUE(panel_id, channel_no), CHECK 1~10
  • load_type — VARCHAR(50) — 부하유형, 참고정보
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — 수정일시
  • deleted_at — DATETIME — 삭제일시

facility_audit_log

  • audit_id — BIGINT — 기본 키 — NOT NULL — 감사ID
  • target_type — ENUM('SITE', 'PANEL', 'CIRCUIT') — NOT NULL — 대상종류
  • target_id — BIGINT — NOT NULL — 대상ID
  • actor_user_id — BIGINT — 외래 키 → user.user_id — 처리자ID
  • action — ENUM('CREATE', 'UPDATE', 'DELETE') — NOT NULL — 액션, CIRCUIT은 UPDATE 없음(수정 기능 자체가 없음)
  • before_data — JSON — 변경전데이터
  • after_data — JSON — 변경후데이터
  • created_at — DATETIME — NOT NULL — 생성일시

panel

  • panel_id — BIGINT — 기본 키 — NOT NULL — 분전반ID
  • site_id — BIGINT — 외래 키 → site.site_id — NOT NULL — 현장ID
  • name — VARCHAR(100) — NOT NULL — 장비명
  • device_serial — VARCHAR(50) — NOT NULL — 장비일련번호, UNIQUE
  • m_no — VARCHAR(5) — NOT NULL — 장비번호, 하드웨어 프로토콜 필드, 정확히 5자리
  • installed_at — DATE — 설치일
  • status — ENUM('NORMAL', 'CAUTION', 'RISK', 'OFFLINE') — 상태, 소속 회로 중 최고위험도 또는 통신상태로 집계
  • is_online — TINYINT(1) — 온라인여부
  • last_communicated_at — DATETIME — 최종통신일시, 1분 경과 시 통신두절 판정(REQ-004)
  • circuit_count — INT — NOT NULL — 회로개수, CHECK 1~10
  • leak_ma_threshold — DECIMAL(4, 1) — NOT NULL — 누설전류임계치, 서버 관제용 주의 기준값(mA)
  • temp_threshold — DECIMAL(4, 1) — NOT NULL — 온도임계치, 서버 관제용 주의 기준값(℃)
  • humidity_threshold — DECIMAL(4, 1) — NOT NULL — 습도임계치, 서버 관제용 주의 기준값(%)
  • overcurrent_threshold — DECIMAL(4, 1) — NOT NULL — 과전류임계치, 서버 관제용 주의 기준값(A)
  • gas_threshold — INT — 가스임계치, 미입력 시 잠정 기본값 5000
  • fire_threshold — INT — 화재임계치, 미입력 시 잠정 기본값 5000
  • created_at — DATETIME — NOT NULL — 생성일시, V7에서 추가
  • updated_at — DATETIME — 수정일시
  • deleted_at — DATETIME — 삭제일시

password_reset_token

  • token_id — BIGINT — 기본 키 — NOT NULL — 토큰ID
  • user_id — BIGINT — 외래 키 → user.user_id — NOT NULL — 사용자ID
  • token_hash — VARCHAR(64) — NOT NULL — 토큰해시, UNIQUE, SHA-256 16진수
  • expires_at — DATETIME — NOT NULL — 만료일시
  • used_at — DATETIME — 사용일시, 값 존재 시 사용 완료
  • created_at — DATETIME — NOT NULL — 생성일시
  • request_ip — VARCHAR(45) — 요청IP
  • user_agent — VARCHAR(255) — User-Agent

refresh_token

  • token_id — BIGINT — 기본 키 — NOT NULL — 토큰ID
  • user_id — BIGINT — 외래 키 → user.user_id — NOT NULL — 사용자ID
  • token_hash — VARCHAR(64) — NOT NULL — 토큰해시, UNIQUE, SHA-256 16진수
  • expires_at — DATETIME — NOT NULL — 만료일시
  • revoked_at — DATETIME — 폐기일시, 값 존재 시 폐기된 토큰
  • created_at — DATETIME — NOT NULL — 생성일시

sensor_frame

  • frame_id — BIGINT — 기본 키 — NOT NULL — 프레임ID
  • panel_id — BIGINT — 외래 키 → panel.panel_id — NOT NULL — 분전반ID
  • received_at — DATETIME — NOT NULL — 수신일시
  • mode — TINYINT — 모드, 프로토콜 mode
  • volt_v — DECIMAL(4, 1) — 전압, 단위 V
  • leak_ma — DECIMAL(4, 1) — 누설전류, 단위 mA
  • temperature — DECIMAL(4, 1) — 온도, 단위 ℃
  • humidity — DECIMAL(4, 1) — 습도, 단위 %
  • fire_raw — INT — 화재원시값, 프로토콜 fire 원시값
  • gas_raw — INT — 가스원시값, 프로토콜 gas 원시값
  • error_bits — VARCHAR(20) — 에러비트, `aerror` 8자리 원본값(파싱 전 보관)
  • door_status — TINYINT(1) — 도어상태, 0:close, 1:open
  • total_current — DECIMAL(4, 1) — 총전류, 단위 A
  • total_power — INT — 총전력, 단위 W

sensor_frame_circuit

  • reading_id — BIGINT — 기본 키 — NOT NULL — 리딩ID
  • frame_id — BIGINT — 외래 키 → sensor_frame.frame_id — NOT NULL — 프레임ID
  • circuit_id — BIGINT — 외래 키 → circuit.circuit_id — NOT NULL — 회로ID
  • current_a — DECIMAL(6, 3) — 전류, 단위 A (프로토콜 amN 환산)
  • arc_counter — INT — 아크카운터, 0=정상, 증가 시 아크 의심
  • device_arc_flag — TINYINT(1) — 하드웨어아크플래그, 에러비트필드 파싱 결과

site

  • site_id — BIGINT — 기본 키 — NOT NULL — 현장ID
  • name — VARCHAR(100) — NOT NULL — 현장명
  • address — VARCHAR(200) — NOT NULL — 주소, V11에서 필수로 변경(REQ-510)
  • zip_code — VARCHAR(10) — 우편번호, V12 신규, 도로명주소 검색 결과의 우편번호
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — 수정일시
  • deleted_at — DATETIME — 삭제일시

user

  • user_id — BIGINT — 기본 키 — NOT NULL — 사용자ID
  • email — VARCHAR(100) — NOT NULL — 이메일, UNIQUE
  • password — VARCHAR(255) — NOT NULL — 비밀번호, BCrypt 암호화
  • name — VARCHAR(50) — NOT NULL — 이름
  • phone — VARCHAR(20) — 연락처
  • role — ENUM('SUPER_ADMIN', 'ADMIN', 'GENERAL') — NOT NULL — 권한, SUPER_ADMIN=최고관리자, ADMIN=현장관리자, GENERAL=일반직원
  • account_status — ENUM('ACTIVE', 'DELETED') — NOT NULL — 계정상태
  • created_by — BIGINT — 외래 키 → user.user_id — 생성자ID, 최초 계정은 NULL, 이후 상위 역할이 생성
  • updated_by — BIGINT — 외래 키 → user.user_id — 수정자ID
  • deleted_by — BIGINT — 외래 키 → user.user_id — 삭제자ID
  • restored_at — DATETIME — 복구일시
  • restored_by — BIGINT — 외래 키 → user.user_id — 복구자ID
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — 수정일시
  • deleted_at — DATETIME — 삭제일시

user_audit_log

  • audit_id — BIGINT — 기본 키 — NOT NULL — 감사ID
  • target_user_id — BIGINT — 외래 키 → user.user_id — NOT NULL — 대상사용자ID
  • actor_user_id — BIGINT — 외래 키 → user.user_id — 처리자ID, 비인증 흐름(비밀번호 재설정)이면 NULL
  • action — ENUM('CREATE', 'UPDATE', 'DELETE', 'RESTORE', 'PASSWORD_RESET') — NOT NULL — 액션
  • before_data — JSON — 변경전데이터, 비밀번호 해시/토큰 원문 기록 금지
  • after_data — JSON — 변경후데이터, 비밀번호 해시/토큰 원문 기록 금지
  • created_at — DATETIME — NOT NULL — 생성일시

user_fcm_token

  • token_id — BIGINT — 기본 키 — NOT NULL — 토큰ID
  • user_id — BIGINT — 외래 키 → user.user_id — NOT NULL — 사용자ID
  • fcm_token — VARCHAR(255) — NOT NULL — FCM토큰, UNIQUE
  • created_at — DATETIME — NOT NULL — 생성일시
  • updated_at — DATETIME — NOT NULL — 수정일시, ON UPDATE CURRENT_TIMESTAMP

user_site

  • mapping_id — BIGINT — 기본 키 — NOT NULL — 매핑ID
  • user_id — BIGINT — 외래 키 → user.user_id — NOT NULL — 사용자ID, UNIQUE(user_id, site_id)
  • site_id — BIGINT — 외래 키 → site.site_id — NOT NULL — 현장ID, UNIQUE(user_id, site_id)
  • assigned_at — DATETIME — NOT NULL — 배정일시
  • updated_at — DATETIME — 수정일시
  • deleted_at — DATETIME — 삭제일시