KZEN_v1.1_검침_테이블

테이블 (33)

alarm_comm_error (통신 에러 이력) (alarm_comm_error)

  • comm_error_id — bigint(20) unsigned — 기본 키 — NOT NULL — 장애 구간 일련번호
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 지점 ID
  • item_key — varchar(20) — NOT NULL — 장애 채널 (code_details.COMM_ERROR_CHANNEL: scu|elec|water|hot_water|gas|heating|etc)
  • comm_status — tinyint(3) unsigned — 최초 발생 시 응답 Status (0:성공 1:OBIS 2:Control 3:Data 4:Connect 5:CRC16 Error)
  • started_dt — datetime — NOT NULL — 장애 최초 발생 일시 (5분 구간). 연속 발생 중에는 갱신하지 않음
  • last_dt — datetime — NOT NULL — 장애 마지막 관측 일시. 진행중에는 매 주기 갱신
  • ended_dt — datetime — 정상 확인 시각 (정상 범위 값이 실제로 들어온 첫 판정). NULL = 진행중
  • is_continuing — char(1) — Y=진행중 / N=복구됨같은 장애의 진행중 확인
  • occur_cnt — int(10) unsigned — NOT NULL — 구간 내 연속 실패 주기 수 (같은 장애를 반복 표시 하지 않음) (DEFAULT VALUE = 1)
  • detail — varchar(500) — 상세 (자유 텍스트)

alarm_threshold_cfg (알람 임계치 설정, INSTANT + USAGE) (alarm_threshold_cfg)

  • threshold_cfg_id — int(10) unsigned — 기본 키 — NOT NULL — 알람 설정 식별 ID. 업무 유일키는 apt_no + alarm_type + item_key + product_code
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드 (사용량 알람은 단지별로 상이할 수 있음 - 통합 관제 관점 기준)
  • alarm_type — varchar(20) — NOT NULL — USAGE=사용량 / INSTANT=순시치. 업무 유일키 구성
  • product_code — varchar(20) — NOT NULL — 적용 품목: code_details PRODUCT_METER.code_detail_id / 공통 ALL. 업무 유일키 구성
  • item_key — varchar(20) — NOT NULL — 알람 항목: USAGE는 READING_ITEM, INSTANT는 INSTANT_ITEM. 업무 유일키 구성
  • use_yn — char(1) — NOT NULL — Y=알람 사용 / N=미사용
  • period_days — tinyint(3) unsigned — 감시 기간(일, 1~5). USAGE 전용 - INSTANT는 NULL
  • threshold_min — decimal(15,5) — 하한 임계값 (미만이면 알람). 미사용 시 NULL. 전류 current는 저전류를 사용하지 않으므로 항상 NULL
  • threshold_max — decimal(15,5) — 상한 임계값. 이 값 초과 시 알람, 미사용은 NULL
  • created_dt — datetime — NOT NULL — 등록일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(30) — 수정자 아이디
  • remark — varchar(100) — 비고

alarm_threshold_error (사용량·순시치·설비 이벤트 알람 이력) (alarm_threshold_error)

  • threshold_error_id — bigint(20) unsigned — 기본 키 — NOT NULL — 임계치 이상 구간 일련번호
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 지점 ID
  • alarm_type — varchar(20) — NOT NULL — 알람 종류 (USAGE:사용량 INSTANT:순시치 EVENT:설비 이벤트)
  • item_key — varchar(20) — NOT NULL — 항목 (USAGE/EVENT: READING_ITEM, INSTANT: INSTANT_ITEM). 표시 예: 전압 · S상
  • period_days — tinyint(3) unsigned — 사용량 감시 기간(일). 순시·설비 이벤트는 NULL
  • threshold_max — decimal(15,5) — 발생 당시 상한 임계값. 설비 이벤트는 NULL
  • threshold_min — decimal(15,5) — 발생 당시 하한 임계값. 설비 이벤트는 NULL
  • detected_value — decimal(15,5) — 최초 측정값. 설비 이벤트는 NULL
  • started_dt — datetime — NOT NULL — 최초 알람 판정 시각
  • last_dt — datetime — NOT NULL — 장애 마지막 관측 일시. 진행중에는 매 주기 갱신
  • ended_dt — datetime — 정상 확인 시각 (정상 범위 값이 실제로 들어온 첫 판정). NULL = 진행중
  • is_continuing — char(1) — Y=진행중 N=복구됨. 지점·종류·항목·이벤트별 진행중 1건
  • occur_cnt — int(10) unsigned — NOT NULL — 구간 내 연속 이상 판정 횟수 (같은 이상을 반복 표시하지 않음) (DEFAULT VALUE = 1)
  • detail — varchar(500) — 상세 (자유 텍스트)
  • event_code — varchar(32) — 설비 이벤트 코드 (code_details.METER_ALARM_EVENT)

apt_info (단지 or 건물정보) (apt_info)

  • apt_no — varchar(30) — 기본 키 — NOT NULL — 단지코드 (국가 제정 번호)
  • apt_name — varchar(100) — 단지명
  • location_id — varchar(10) — 지역코드
  • zipcode — varchar(5) — 우편번호
  • jibun_addr — varchar(100) — 지번(법정)주소
  • road_addr — varchar(100) — 도로명 주소
  • main_use — varchar(30) — 주용도 (code_details MAIN_USE) -> 주거용, 비주거용 판단 가능
  • dong_cnt — smallint(5) unsigned — 동수 (단지)
  • ho_cnt — smallint(5) unsigned — 세대수 (단지)
  • ground_floors — tinyint(3) unsigned — 지상 층수 (건물)
  • basement_floors — tinyint(3) unsigned — 지하 층수 (건물)
  • total_area — decimal(12,2) — 연면적(㎡) -> 해당 단지의 ZEB 평가 대상 건축물 연면적 합계
  • contract_power — int(10) unsigned — 계약전력
  • billing_day — tinyint(3) unsigned — 정기검침일
  • tel_no — varchar(15) — 관리사무소_전화번호
  • approval_date — date — 사용 승인일
  • created_dt — datetime — 등록 일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정 일시
  • updated_by — varchar(30) — 수정자 아이디
  • remark — text — 비고

apt_maintenance_doc (종합유지관리 문서 ) (apt_maintenance_doc)

  • doc_id — int(10) unsigned — 기본 키 — NOT NULL — 문서 일련번호
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드
  • title — varchar(200) — NOT NULL — 문서명 (ex. 운영 매뉴얼, 데이터 관리절차서)
  • version — varchar(20) — 문서 버전 (예: v1.3)
  • doc_date — date — 문서 기준일/개정일
  • owner_name — varchar(50) — 문서 담당자
  • description — varchar(500) — 문서 설명
  • orig_file_name — varchar(255) — NOT NULL — 업로드 원본 파일명
  • stored_file_path — varchar(500) — NOT NULL — 서버 저장 경로/키 (실제 파일은 파일시스템 보관)
  • file_ext — varchar(10) — 확장자 (pdf/hwp/xlsx 등)
  • file_size — bigint(20) — 파일 크기(byte)
  • created_dt — datetime — 등록일시
  • created_by — varchar(30) — 등록자아이디
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(30) — 수정자아이디

apt_manager_info (에너지 관리 조직) (apt_manager_info)

  • manager_id — int(10) unsigned — 기본 키 — NOT NULL — 관리자 일련 번호
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 에너지 관리 조작의 담당 단지코드
  • role_type — varchar(50) — NOT NULL — 역할 (code_details MANAGER_ROLE)
  • dept_name — varchar(50) — 부서명
  • name — varchar(50) — NOT NULL — 성명
  • position — varchar(50) — 직위
  • phone — varchar(20) — 전화번호
  • email — varchar(100) — 전자메일
  • is_active — char(1) — 현재 담당 여부 (Y: 활성 담당자, N: 이전 담당자/퇴사)
  • created_dt — datetime — 등록 일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정 일시
  • updated_by — varchar(30) — 수정자 아이디

apt_photo (단지 or 건물 사진) (apt_photo)

  • photo_no — tinyint(3) unsigned — 기본 키 — NOT NULL — 사진 순번 (1~10, 1=대표)
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드
  • orig_file_name — varchar(255) — NOT NULL — 업로드 원본 파일명
  • stored_file_path — varchar(500) — NOT NULL — 서버 저장 경로/키 (실제 파일은 파일시스템 보관, DB에는 경로만)
  • file_ext — varchar(10) — 확장자 (jpg/png/webp)
  • file_size — int(10) unsigned — 파일 크기(byte)
  • created_dt — datetime — 등록일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정일시 (사진 교체)
  • updated_by — varchar(30) — 수정자 아이디

apt_zero_info (ZEB 인증 정보) (apt_zero_info)

  • cert_id — int(10) unsigned — 기본 키 — NOT NULL — 인증 기본키
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드
  • cert_category — enum('PRE','MAIN') — NOT NULL — 인증 구분 (PRE: 예비인증, MAIN: 본인증)
  • cert_type — varchar(20) — 주거용/비주거용 (code_details CERT_TYPE) -> 공동주택, 개별 인증 받는 경우
  • acquired_grade — varchar(50) — 인증 취득등급 (code_details ZEB_GRADE) -> 실제 인증기관에서 발급받은 등급
  • acquired_dt — date — 인증 발급일
  • expired_dt — date — 인증 만료일
  • agency — varchar(100) — 인증 기관
  • is_current — char(1) — (Y/N) 최신 유효 여부 -> 현재 유효한 인증 정보인지
  • created_dt — timestamp — 등록 일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정 일시
  • updated_by — varchar(30) — 수정자 아이디

cfg_item_purpose_default (채널→용도 전역 기본 매핑) (cfg_item_purpose_default)

  • item_key — varchar(20) — 기본 키 — NOT NULL — READING_ITEM 고정키: import|export|water|hot_water|gas|heating|etc
  • purpose — varchar(20) — NOT NULL — 용도 코드: HEATING|COOLING|DHW|LIGHTING|VENTILATION|MIXED|ETC (code_details ENERGY_USE)
  • flow — char(1) — NOT NULL — C=소비, P=생산 (code_details ENERGY_FLOW)
  • updated_dt — datetime — 수정 일자
  • updated_by — varchar(255) — 수정자 아이디
  • remark — varchar(255) — 비고

cfg_reading_item (검침항목(수전, 가스 등) 표시설정 + 환산계수) (cfg_reading_item)

  • id — int(10) unsigned — 기본 키 — NOT NULL — 표시설정 및 환산계수 id
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드
  • meter_type — varchar(255) — EM, WM, WM, HM 등
  • item_key — varchar(20) — NOT NULL — READING_ITEM 고정키: import|export|water|hot_water|gas|heating|etc|renewable. renewable=발전(GENERATE) 지점 수전값 집계
  • item_name — varchar(50) — NOT NULL — READING_ITEM 기본명칭: 수전(유효), 송전(유효), 수도, 온수, 가스, 난방, 기타, 신재생
  • display_name — varchar(50) — 사용자 지정 표시명
  • unit — varchar(20) — 단위: kwh, m3
  • max_usage — int(11) — 최대 정상 상한값
  • decimal_pt — int(11) — 소수점 자릿수 설정
  • kwh_factor — decimal(10,4) — NOT NULL — kWh 환산계수 (대시보드 에너지원별 비중용)
  • use_yn — char(1) — Y=표시 / N=숨김
  • sort_order — int(11) — 정렬 순서: 수전, 송전, 수도, 온수, 가스, 난방, 기타, 신재생
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(255) — 수정자 아이디

cfg_unit_item_purpose (지점별 채널→용도 예외 매핑) (cfg_unit_item_purpose)

  • item_key — varchar(20) — 기본 키 — NOT NULL — READING_ITEM 고정키: import|export|water|hot_water|gas|heating|etc
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 지점 ID
  • purpose — varchar(20) — NOT NULL — 용도 코드: HEATING|COOLING|DHW|LIGHTING|VENTILATION|MIXED|ETC (code_details ENERGY_USE)
  • flow — char(1) — NOT NULL — C=소비, P=생산 (code_details ENERGY_FLOW)
  • updated_dt — datetime — 수정 일자
  • updated_by — varchar(255) — 수정자 아이디
  • remark — varchar(255) — 비고

code_details (코드 상세 관리 대장) (code_details)

  • group_code — varchar(64) — 기본 키 — NOT NULL — 코드 그룹 ID (code_groups.group_code_id)
  • code_detail_id — varchar(64) — 기본 키 — NOT NULL — 그룹 내 코드값. COMM_TYPE: CT001=RS-485, CT002=LTE, CT003=TCP/IP
  • code_name — varchar(100) — NOT NULL — 코드 표시명. READING_ITEM 8종: 수전(유효), 송전(유효), 수도, 온수, 가스, 난방, 기타, 신재생(renewable: 발전 지점 수전값 집계)
  • description — varchar(255) — 코드 설명. READ_PROTOCOL: SEVEN=7종 누적 검침, TOU=TOU 검침, SAFETY=안전진단 검침, LP=LP 검침)
  • sort_order — int(11) — 정렬 순서
  • is_active — char(1) — 사용 여부 Y/N. 예: ACTION_TYPE.DEVICE_REPAIR는 예약 코드로 보존하며 N(미사용)
  • created_at — timestamp — 등록일시
  • created_by — varchar(50) — NOT NULL — 등록자 아이디
  • updated_at — timestamp — 수정일시
  • updated_by — varchar(50) — 수정자 아이디

code_groups (코드 그룹 관리 대장) (code_groups)

  • group_code_id — varchar(64) — 기본 키 — NOT NULL — 그룹 코드
  • group_name — varchar(100) — NOT NULL — 그룹 이름
  • description — text — 설명 · 사용 컬럼
  • is_active — char(1) — 활성화 여부 Y/N
  • created_at — timestamp — 등록일시
  • created_by — varchar(50) — NOT NULL — 등록자 아이디
  • updated_at — timestamp — 수정일시
  • updated_by — varchar(50) — 수정자 아이디

comm_settings (관리자용 - 통신 설정) (comm_settings)

  • id — int(10) unsigned — 기본 키 — NOT NULL — 고유 ID
  • protocol — varchar(50) — NOT NULL — 현장 전체 PC–DCU 통신방식: RS485 / TCP
  • read_protocol — varchar(20) — NOT NULL — 현재 설정한 검침 명령 (code_details READ_PROTOCOL): SEVEN=7종 누적 검침, TOU=TOU 검침, SAFETY=안전진단 검침, LP=LP 검침
  • com_port — varchar(5) — NOT NULL — com_port 번호
  • host — varchar(100) — TCP host
  • port — int(11) — NOT NULL — TCP port
  • baud_rate — int(11) — NOT NULL — 통신 속도 (bps)
  • parity — int(11) — NOT NULL — 패리티 (0: None, 1:ODD, 2: EVEN)
  • delay — int(11) — NOT NULL — 지연 시간 (ms)
  • timeout — int(11) — NOT NULL — 타임아웃 (ms)
  • created_at — datetime — 생성 일시
  • updated_at — datetime — 수정 일시

data_instant_5m (5분 순시값 집계) (data_instant_5m)

  • unit_id — int(10) unsigned — 기본 키 — NOT NULL — 지점 ID
  • read_date — datetime — 기본 키 — NOT NULL — 5분 구간 시작 시각 [시작, 종료). 종료 경계 검침은 다음 구간
  • save_date — datetime — 저장 시각 (스케줄러가 저장한 시간)
  • volt_avg — decimal(7,2) — 전압 V 5분 평균 (data_raw.volt_all 유효값, 없음 NULL)
  • curr_avg — decimal(9,3) — 전류 A 5분 평균 (data_raw.curr_all 유효값, 없음 NULL)
  • active_power_avg — decimal(12,3) — 순시 유효전력 W 5분 평균 (data_raw.active_power 유효값, 없음 NULL)
  • pf_avg — decimal(4,3) — 역률 5분 평균 (data_raw.pf_all 유효값, 없음 NULL)
  • freq_avg — decimal(5,2) — 주파수 Hz 5분 평균 (data_raw.freq 유효값, 없음 NULL)
  • thd_avg — decimal(6,3) — THD % 5분 평균 (data_raw.thd_all 유효값, 없음 NULL)
  • heating_supply_temp_avg — decimal(6,2) — 난방 공급온도 ℃ 5분 평균 (data_raw.heating_supply_temp 유효값, 없음 NULL)
  • heating_return_temp_avg — decimal(6,2) — 난방 환수온도 ℃ 5분 평균 (data_raw.heating_return_temp 유효값, 없음 NULL)
  • etc_supply_temp_avg — decimal(6,2) — 기타 공급온도 ℃ 5분 평균 (data_raw.etc_supply_temp 유효값, 없음 NULL)
  • etc_return_temp_avg — decimal(6,2) — 기타 환수온도 ℃ 5분 평균 (data_raw.etc_return_temp 유효값, 없음 NULL)

data_instant_day (일 순시값 집계) (data_instant_day)

  • unit_id — int(10) unsigned — 기본 키 — NOT NULL — 지점 ID
  • read_date — date — 기본 키 — NOT NULL — 검침 일자 (일 집계)
  • save_date — datetime — 저장 시각 (스케줄러가 저장한 시간)
  • volt_avg — decimal(9,3) — 전압 V 일 평균 (합계/유효 구간 수, 없음 NULL)
  • curr_avg — decimal(9,3) — 전류 A 일 평균 (합계/유효 구간 수, 없음 NULL)
  • active_power_avg — decimal(12,3) — 순시 유효전력 W 일 평균 (합계/유효 구간 수, 없음 NULL)
  • pf_avg — decimal(5,3) — 역률 일 평균 (합계/유효 구간 수, 없음 NULL)
  • freq_avg — decimal(5,2) — 주파수 Hz 일 평균 (합계/유효 구간 수, 없음 NULL)
  • thd_avg — decimal(6,3) — THD % 일 평균 (합계/유효 구간 수, 없음 NULL)
  • heating_supply_temp_avg — decimal(6,2) — 난방 공급온도 ℃ 일 평균 (합계/유효 구간 수, 없음 NULL)
  • heating_return_temp_avg — decimal(6,2) — 난방 환수온도 ℃ 일 평균 (합계/유효 구간 수, 없음 NULL)
  • etc_supply_temp_avg — decimal(6,2) — 기타 공급온도 ℃ 일 평균 (합계/유효 구간 수, 없음 NULL)
  • etc_return_temp_avg — decimal(6,2) — 기타 환수온도 ℃ 일 평균 (합계/유효 구간 수, 없음 NULL)
  • volt_sum — decimal(20,6) — 전압 V 일 합계 (유효 5분 평균값, 없음 NULL)
  • volt_count — int(10) unsigned — NOT NULL — 전압 V 일 유효 5분 구간 수 (없음 0)
  • curr_sum — decimal(20,6) — 전류 A 일 합계 (유효 5분 평균값, 없음 NULL)
  • curr_count — int(10) unsigned — NOT NULL — 전류 A 일 유효 5분 구간 수 (없음 0)
  • active_power_sum — decimal(20,6) — 순시 유효전력 W 일 합계 (유효 5분 평균값, 없음 NULL)
  • active_power_count — int(10) unsigned — NOT NULL — 순시 유효전력 W 일 유효 5분 구간 수 (없음 0)
  • pf_sum — decimal(20,6) — 역률 일 합계 (유효 5분 평균값, 없음 NULL)
  • pf_count — int(10) unsigned — NOT NULL — 역률 일 유효 5분 구간 수 (없음 0)
  • freq_sum — decimal(20,6) — 주파수 Hz 일 합계 (유효 5분 평균값, 없음 NULL)
  • freq_count — int(10) unsigned — NOT NULL — 주파수 Hz 일 유효 5분 구간 수 (없음 0)
  • thd_sum — decimal(20,6) — THD % 일 합계 (유효 5분 평균값, 없음 NULL)
  • thd_count — int(10) unsigned — NOT NULL — THD % 일 유효 5분 구간 수 (없음 0)
  • heating_supply_temp_sum — decimal(20,6) — 난방 공급온도 ℃ 일 합계 (유효 5분 평균값, 없음 NULL)
  • heating_supply_temp_count — int(10) unsigned — NOT NULL — 난방 공급온도 ℃ 일 유효 5분 구간 수 (없음 0)
  • heating_return_temp_sum — decimal(20,6) — 난방 환수온도 ℃ 일 합계 (유효 5분 평균값, 없음 NULL)
  • heating_return_temp_count — int(10) unsigned — NOT NULL — 난방 환수온도 ℃ 일 유효 5분 구간 수 (없음 0)
  • etc_supply_temp_sum — decimal(20,6) — 기타 공급온도 ℃ 일 합계 (유효 5분 평균값, 없음 NULL)
  • etc_supply_temp_count — int(10) unsigned — NOT NULL — 기타 공급온도 ℃ 일 유효 5분 구간 수 (없음 0)
  • etc_return_temp_sum — decimal(20,6) — 기타 환수온도 ℃ 일 합계 (유효 5분 평균값, 없음 NULL)
  • etc_return_temp_count — int(10) unsigned — NOT NULL — 기타 환수온도 ℃ 일 유효 5분 구간 수 (없음 0)

data_lp (LP 데이터) - 세대 단위 O, 그룹 집계 대상 X (data_lp)

  • unit_id — int(10) unsigned — 기본 키 — NOT NULL — 지점 ID
  • lp_date — datetime — 기본 키 — NOT NULL — LP 시각 (5분 구간)
  • collected_dt — datetime — NOT NULL — 수집기가 이 블록을 읽어온 시각
  • lp_index — smallint(5) unsigned — 전력량계 내부의 LP 기록 인덱스
  • time_zone — tinyint(3) unsigned — LP 기록과 함께 전달되는 1바이트 시간대 코드
  • import_acc_t0 — bigint(20) — 수전 누적값 T0 (Wh) =========전기 누적 [저장: Wh 정수]
  • export_acc_t0 — bigint(20) — 송전 누적값 T0 (Wh) [저장: Wh 정수]
  • reactive_acc_q1 — bigint(20) — 무효 전력량 Q1 누적 [저장: varh 정수]
  • reactive_acc_q2 — bigint(20) — 무효 전력량 Q2 누적 [저장: varh 정수]
  • reactive_acc_q3 — bigint(20) — 무효 전력량 Q3 누적 [저장: varh 정수]
  • reactive_acc_q4 — bigint(20) — 무효 전력량 Q4 누적 [저장: varh 정수]
  • lp_event — smallint(5) unsigned — LP 이벤트 2Byte (전기 채널의 상태·이벤트) =========상태
  • lp_interval — tinyint(3) unsigned — LP 주기

data_raw(검침 원시 데이터, insert only) - 수집기 응답 그대로 보관 (30~90일) (data_raw)

  • raw_id — bigint(20) unsigned — 기본 키 — NOT NULL — 원시 로그 ID (AUTO_INCREMENT)
  • read_date — datetime — 기본 키 — NOT NULL — 검침 일시
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 지점 ID
  • log_date — datetime — NOT NULL — 로그 저장 일시
  • read_type — varchar(20) — NOT NULL — 수집 당시 실제 사용한 검침 명령 (code_details READ_PROTOCOL)
  • import_acc_t0 — bigint(20) — 수전 누적값 T0 (Wh) =========전기 누적 [저장: Wh 정수]
  • import_acc_t1 — bigint(20) — 수전 누적값 T1 (Wh) [저장: Wh 정수]
  • import_acc_t2 — bigint(20) — 수전 누적값 T2 (Wh) [저장: Wh 정수]
  • import_acc_t3 — bigint(20) — 수전 누적값 T3 (Wh) [저장: Wh 정수]
  • import_acc_t4 — bigint(20) — 수전 누적값 T4 (Wh) [저장: Wh 정수]
  • export_acc_t0 — bigint(20) — 송전 누적값 T0 (Wh) [저장: Wh 정수]
  • export_acc_t1 — bigint(20) — 송전 누적값 T1 (Wh) [저장: Wh 정수]
  • export_acc_t2 — bigint(20) — 송전 누적값 T2 (Wh) [저장: Wh 정수]
  • export_acc_t3 — bigint(20) — 송전 누적값 T3 (Wh) [저장: Wh 정수]
  • export_acc_t4 — bigint(20) — 송전 누적값 T4 (Wh) [저장: Wh 정수]
  • reactive_acc_q1 — bigint(20) — 무효 전력량 Q1 (정기 검침 응답에는 없음) [저장: varh 정수]
  • reactive_acc_q2 — bigint(20) — 무효 전력량 Q2 [저장: varh 정수]
  • reactive_acc_q3 — bigint(20) — 무효 전력량 Q3 [저장: varh 정수]
  • reactive_acc_q4 — bigint(20) — 무효 전력량 Q4 [저장: varh 정수]
  • net_metering_acc — bigint(20) — net_metering 누적값 [저장: Wh 정수]
  • active_power — decimal(12,3) — 순시 유효전력 ALL (W) =========전기 순시
  • active_power_r — decimal(12,3) — 순시 유효전력 R (W)
  • active_power_s — decimal(12,3) — 순시 유효전력 S (W)
  • active_power_t — decimal(12,3) — 순시 유효전력 T (W)
  • reactive_power — decimal(12,3) — 무효 전력
  • volt_all — decimal(9,3) — 전압 ALL (V)
  • volt_r — decimal(9,3) — 전압 R
  • volt_s — decimal(9,3) — 전압 S
  • volt_t — decimal(9,3) — 전압 T
  • curr_all — decimal(9,3) — 전류 ALL (A)
  • curr_r — decimal(9,3) — 전류 R
  • curr_s — decimal(9,3) — 전류 S
  • curr_t — decimal(9,3) — 전류 T
  • pf_all — decimal(5,3) — 역률 ALL
  • pf_r — decimal(5,3) — 역률 R
  • pf_s — decimal(5,3) — 역률 S
  • pf_t — decimal(5,3) — 역률 T
  • phase_r — decimal(6,3) — 위상 R (°)
  • phase_s — decimal(6,3) — 위상 S
  • phase_t — decimal(6,3) — 위상 T
  • thd_all — decimal(6,3) — THD ALL (%) (총 고조파 왜율)
  • thd_r — decimal(6,3) — THD R
  • thd_s — decimal(6,3) — THD S
  • thd_t — decimal(6,3) — THD T
  • freq — decimal(5,2) — 주파수 (Hz)
  • water_acc — decimal(15,5) — 수도 누적 (m3) =========설비 누적
  • hot_water_acc — decimal(15,5) — 온수 누적 (m3)
  • gas_acc — decimal(15,5) — 가스 누적 (m3)
  • heating_acc — decimal(15,5) — 난방 누적 (열량)
  • heating_flow_acc — decimal(15,5) — 난방 유량 누적
  • etc_acc — decimal(15,5) — 기타 누적
  • etc_flow_acc — decimal(15,5) — 기타 유량 누적
  • water_inst — decimal(12,4) — 수도 순시 =========설비 순시
  • hot_water_inst — decimal(12,4) — 온수 순시
  • gas_inst — decimal(12,4) — 가스 순시
  • heating_inst — decimal(12,4) — 난방 순시
  • heating_flow_inst — decimal(12,4) — 난방 유량 순시
  • heating_supply_temp — decimal(6,2) — 난방 공급온도 (℃)
  • heating_return_temp — decimal(6,2) — 난방 환수온도 (℃)
  • etc_inst — decimal(12,4) — 기타 순시
  • … +10

data_realtime (실시간 검침 데이터) - 각 지점의 가장 최근 상태(Snapshot), upsert (data_realtime)

  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 지점 ID
  • read_date — datetime — NOT NULL — 검침 일시
  • import_acc_t0 — bigint(20) — 수전 누적값 T0 (Wh) =========전기 누적 [저장: Wh 정수]
  • import_acc_t1 — bigint(20) — 수전 누적값 T1 (Wh) [저장: Wh 정수]
  • import_acc_t2 — bigint(20) — 수전 누적값 T2 (Wh) [저장: Wh 정수]
  • import_acc_t3 — bigint(20) — 수전 누적값 T3 (Wh) [저장: Wh 정수]
  • import_acc_t4 — bigint(20) — 수전 누적값 T4 (Wh) [저장: Wh 정수]
  • export_acc_t0 — bigint(20) — 송전 누적값 T0 (Wh) [저장: Wh 정수]
  • export_acc_t1 — bigint(20) — 송전 누적값 T1 (Wh) [저장: Wh 정수]
  • export_acc_t2 — bigint(20) — 송전 누적값 T2 (Wh) [저장: Wh 정수]
  • export_acc_t3 — bigint(20) — 송전 누적값 T3 (Wh) [저장: Wh 정수]
  • export_acc_t4 — bigint(20) — 송전 누적값 T4 (Wh) [저장: Wh 정수]
  • reactive_acc_q1 — bigint(20) — 무효 전력량 Q1 [저장: varh 정수]
  • reactive_acc_q2 — bigint(20) — 무효 전력량 Q2 [저장: varh 정수]
  • reactive_acc_q3 — bigint(20) — 무효 전력량 Q3 [저장: varh 정수]
  • reactive_acc_q4 — bigint(20) — 무효 전력량 Q4 [저장: varh 정수]
  • net_metering_acc — bigint(20) — net_metering 누적값 [저장: Wh 정수]
  • active_power — decimal(12,3) — 순시 유효전력 ALL (W) =========전기 순시
  • active_power_r — decimal(12,3) — 순시 유효전력 R (W)
  • active_power_s — decimal(12,3) — 순시 유효전력 S (W)
  • active_power_t — decimal(12,3) — 순시 유효전력 T (W)
  • reactive_power — decimal(12,3) — 무효 전력
  • volt_all — decimal(9,3) — 전압 ALL (V)
  • volt_r — decimal(9,3) — 전압 R
  • volt_s — decimal(9,3) — 전압 S (단상이면 0이 정상)
  • volt_t — decimal(9,3) — 전압 T (단상이면 0이 정상)
  • curr_all — decimal(9,3) — 전류 ALL (A)
  • curr_r — decimal(9,3) — 전류 R
  • curr_s — decimal(9,3) — 전류 S
  • curr_t — decimal(9,3) — 전류 T
  • pf_all — decimal(5,3) — 역률 ALL
  • pf_r — decimal(5,3) — 역률 R
  • pf_s — decimal(5,3) — 역률 S
  • pf_t — decimal(5,3) — 역률 T
  • phase_r — decimal(6,3) — 위상 R (°)
  • phase_s — decimal(6,3) — 위상 S
  • phase_t — decimal(6,3) — 위상 T
  • thd_all — decimal(6,3) — THD ALL (%)
  • thd_r — decimal(6,3) — THD R
  • thd_s — decimal(6,3) — THD S
  • thd_t — decimal(6,3) — THD T
  • freq — decimal(5,2) — 주파수 (Hz)
  • water_acc — decimal(15,5) — 수도 누적 (m3) =========설비 누적
  • hot_water_acc — decimal(15,5) — 온수 누적 (m3)
  • gas_acc — decimal(15,5) — 가스 누적 (m3)
  • heating_acc — decimal(15,5) — 난방 누적 (열량)
  • heating_flow_acc — decimal(15,5) — 난방 유량 누적
  • etc_acc — decimal(15,5) — 기타 누적
  • etc_flow_acc — decimal(15,5) — 기타 유량 누적
  • water_inst — decimal(12,4) — 수도 순시 =========설비 순시
  • hot_water_inst — decimal(12,4) — 온수 순시
  • gas_inst — decimal(12,4) — 가스 순시
  • heating_inst — decimal(12,4) — 난방 순시
  • heating_flow_inst — decimal(12,4) — 난방 유량 순시
  • heating_supply_temp — decimal(6,2) — 난방 공급온도 (℃)
  • heating_return_temp — decimal(6,2) — 난방 환수온도 (℃)
  • etc_inst — decimal(12,4) — 기타 순시
  • etc_flow_inst — decimal(12,4) — 기타 유량 순시
  • etc_supply_temp — decimal(6,2) — 기타 공급온도 (℃)
  • etc_return_temp — decimal(6,2) — 기타 환수온도 (℃)
  • … +7

data_reconcile (정합용 확정 데이터, Snapshot) - 지점별 마지막 유효 누적값 (data_reconcile)

  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 지점 ID
  • import_acc_t0 — bigint(20) — 수전 누적값 T0 (Wh) 마지막 유효값 =========전기 누적 [저장: Wh 정수]
  • import_acc_t1 — bigint(20) — 수전 누적값 T1 (Wh) 마지막 유효값 [저장: Wh 정수]
  • import_acc_t2 — bigint(20) — 수전 누적값 T2 (Wh) 마지막 유효값 [저장: Wh 정수]
  • import_acc_t3 — bigint(20) — 수전 누적값 T3 (Wh) 마지막 유효값 [저장: Wh 정수]
  • import_acc_t4 — bigint(20) — 수전 누적값 T4 (Wh) 마지막 유효값 [저장: Wh 정수]
  • export_acc_t0 — bigint(20) — 송전 누적값 T0 (Wh) 마지막 유효값 [저장: Wh 정수]
  • export_acc_t1 — bigint(20) — 송전 누적값 T1 (Wh) 마지막 유효값 [저장: Wh 정수]
  • export_acc_t2 — bigint(20) — 송전 누적값 T2 (Wh) 마지막 유효값 [저장: Wh 정수]
  • export_acc_t3 — bigint(20) — 송전 누적값 T3 (Wh) 마지막 유효값 [저장: Wh 정수]
  • export_acc_t4 — bigint(20) — 송전 누적값 T4 (Wh) 마지막 유효값 [저장: Wh 정수]
  • reactive_acc_q1 — bigint(20) — 무효 전력량 Q1 확정값 [저장: varh 정수]
  • reactive_acc_q2 — bigint(20) — 무효 전력량 Q2 확정값 [저장: varh 정수]
  • reactive_acc_q3 — bigint(20) — 무효 전력량 Q3 확정값 [저장: varh 정수]
  • reactive_acc_q4 — bigint(20) — 무효 전력량 Q4 확정값 [저장: varh 정수]
  • net_metering_acc — bigint(20) — net_metering 누적 확정값 [저장: Wh 정수]
  • water_acc — decimal(15,5) — 수도 누적 확정값 =========설비 누적
  • hot_water_acc — decimal(15,5) — 온수 누적 확정값
  • gas_acc — decimal(15,5) — 가스 누적 확정값
  • heating_acc — decimal(15,5) — 난방 누적 확정값
  • heating_flow_acc — decimal(15,5) — 난방 유량 누적 확정값
  • etc_acc — decimal(15,5) — 기타 누적 확정값
  • etc_flow_acc — decimal(15,5) — 기타 유량 누적 확정값
  • elec_date — datetime — 전기 T0 유효검사 통과값의 검침 시각 =========기본 누적값 유효 시각
  • water_date — datetime — 수도 유효검사 통과값의 검침 시각
  • hot_water_date — datetime — 온수 유효검사 통과값의 검침 시각
  • gas_date — datetime — 가스 유효검사 통과값의 검침 시각
  • heating_date — datetime — 난방 유효검사 통과값의 검침 시각
  • etc_date — datetime — 기타 유효검사 통과값의 검침 시각
  • elec_tou_date — datetime — 전기 TOU 유효검사 통과값의 검침 시각 =========추가 누적값 유효 시각
  • elec_reactive_date — datetime — 무효 누적 유효검사 통과값의 검침 시각
  • net_metering_date — datetime — NET 누적 유효검사 통과값의 검침 시각
  • heating_flow_date — datetime — 난방 유량 유효검사 통과값의 검침 시각
  • etc_flow_date — datetime — 기타 유량 유효검사 통과값의 검침 시각

data_total_5m (5분 간격 검침 데이터 총합) (data_total_5m)

  • apt_no — varchar(30) — 기본 키 — NOT NULL — 단지코드
  • scope — varchar(20) — 기본 키 — NOT NULL — 지점 구분: HOUSEHOLD(세대) | COMMON(공용) | GENERATE(발전)
  • read_date — datetime — 기본 키 — NOT NULL — 5분 구간 시작 시각 [시작, 종료). 종료 경계 검침은 다음 구간
  • import_usage_t0 — int(11) — 범위내 수전 유효 전력량 T0 사용량 합 =========전기 [저장: Wh 정수]
  • export_usage_t0 — int(11) — 범위내 송전 유효 전력량 T0 사용량 합 [저장: Wh 정수]
  • water_usage — decimal(15,5) — 범위내 수도 사용량 합 (m3) =========설비
  • hot_water_usage — decimal(15,5) — 범위내 온수 사용량 합 (m3)
  • gas_usage — decimal(15,5) — 범위내 가스 사용량 합 (m3)
  • heating_usage — decimal(15,5) — 범위내 난방 사용량 합 (열량)
  • etc_usage — decimal(15,5) — 범위내 기타 사용량 합
  • unit_cnt — int(10) unsigned — NOT NULL — 합산에 포함된 지점 수 =========데이터 품질
  • substituted_cnt — int(10) unsigned — NOT NULL — 항목별 대체 비트(item_substituted)가 0이 아닌 지점 수
  • save_date — datetime — NOT NULL — 집계 시각 (재집계 시 갱신)
  • net_metering_usage — int(11) — 범위내 net_metering 사용량 합 [저장: Wh 정수]

data_total_day (일별 검침 데이터 총합) (data_total_day)

  • apt_no — varchar(30) — 기본 키 — NOT NULL — 단지코드
  • scope — varchar(20) — 기본 키 — NOT NULL — 지점 구분: HOUSEHOLD(세대) | COMMON(공용) | GENERATE(발전)
  • read_date — date — 기본 키 — NOT NULL — 검침 일자 (일 집계)
  • import_usage_t0 — int(11) — 범위내 수전 유효 전력량 T0 일사용량 합 =========전기 [저장: Wh 정수]
  • export_usage_t0 — int(11) — 범위내 송전 유효 전력량 T0 일사용량 합 [저장: Wh 정수]
  • net_metering_usage — int(11) — 범위내 net_metering 일사용량 합 [저장: Wh 정수]
  • water_usage — decimal(15,5) — 범위내 수도 일사용량 합 (m3) =========설비
  • hot_water_usage — decimal(15,5) — 범위내 온수 일사용량 합 (m3)
  • gas_usage — decimal(15,5) — 범위내 가스 일사용량 합 (m3)
  • heating_usage — decimal(15,5) — 범위내 난방 일사용량 합 (열량)
  • etc_usage — decimal(15,5) — 범위내 기타 일사용량 합
  • unit_cnt — int(10) unsigned — NOT NULL — 합산에 포함된 지점 수 =========데이터 품질
  • substituted_cnt — int(10) unsigned — NOT NULL — 항목별 대체 비트(item_substituted)가 0이 아닌 지점-구간 수
  • save_date — datetime — NOT NULL — 집계 시각 (재집계 시 갱신)

data_usage_1h (1시간 사용량 집계) (data_usage_1h)

  • unit_id — int(10) unsigned — 기본 키 — NOT NULL — 지점 ID
  • read_date — datetime — 기본 키 — NOT NULL — 1시간 구간 시작 시각 [시작, 종료)
  • reading_date — datetime — 원본 수신 시각 (data_raw.read_date)
  • save_date — datetime — 저장 시각 (스케줄러가 저장한 시간)
  • import_acc_t0 — bigint(20) — 수전 누적값 T0 (Wh) =========전기 누적(acc) & 사용량(usage) [저장: Wh 정수]
  • import_usage_t0 — int(11) — 수전 유효 전력량 T0 사용량 [저장: Wh 정수]
  • import_acc_t1 — bigint(20) — 수전 누적값 T1 (Wh) [저장: Wh 정수]
  • import_usage_t1 — int(11) — 수전 유효 전력량 T1 사용량 [저장: Wh 정수]
  • import_acc_t2 — bigint(20) — 수전 누적값 T2 (Wh) [저장: Wh 정수]
  • import_usage_t2 — int(11) — 수전 유효 전력량 T2 사용량 [저장: Wh 정수]
  • import_acc_t3 — bigint(20) — 수전 누적값 T3 (Wh) [저장: Wh 정수]
  • import_usage_t3 — int(11) — 수전 유효 전력량 T3 사용량 [저장: Wh 정수]
  • import_acc_t4 — bigint(20) — 수전 누적값 T4 (Wh) [저장: Wh 정수]
  • import_usage_t4 — int(11) — 수전 유효 전력량 T4 사용량 [저장: Wh 정수]
  • export_acc_t0 — bigint(20) — 송전 누적값 T0 (Wh) [저장: Wh 정수]
  • export_usage_t0 — int(11) — 송전 유효 전력량 T0 사용량 [저장: Wh 정수]
  • export_acc_t1 — bigint(20) — 송전 누적값 T1 (Wh) [저장: Wh 정수]
  • export_usage_t1 — int(11) — 송전 유효 전력량 T1 사용량 [저장: Wh 정수]
  • export_acc_t2 — bigint(20) — 송전 누적값 T2 (Wh) [저장: Wh 정수]
  • export_usage_t2 — int(11) — 송전 유효 전력량 T2 사용량 [저장: Wh 정수]
  • export_acc_t3 — bigint(20) — 송전 누적값 T3 (Wh) [저장: Wh 정수]
  • export_usage_t3 — int(11) — 송전 유효 전력량 T3 사용량 [저장: Wh 정수]
  • export_acc_t4 — bigint(20) — 송전 누적값 T4 (Wh) [저장: Wh 정수]
  • export_usage_t4 — int(11) — 송전 유효 전력량 T4 사용량 [저장: Wh 정수]
  • reactive_acc_q1 — bigint(20) — 무효 전력량 Q1 [저장: varh 정수]
  • reactive_usage_q1 — int(11) — 무효 전력량 Q1 사용량 [저장: varh 정수]
  • reactive_acc_q2 — bigint(20) — 무효 전력량 Q2 [저장: varh 정수]
  • reactive_usage_q2 — int(11) — 무효 전력량 Q2 사용량 [저장: varh 정수]
  • reactive_acc_q3 — bigint(20) — 무효 전력량 Q3 [저장: varh 정수]
  • reactive_usage_q3 — int(11) — 무효 전력량 Q3 사용량 [저장: varh 정수]
  • reactive_acc_q4 — bigint(20) — 무효 전력량 Q4 [저장: varh 정수]
  • reactive_usage_q4 — int(11) — 무효 전력량 Q4 사용량 [저장: varh 정수]
  • net_metering_acc — bigint(20) — net_metering 누적값, DR이랑 관계 X [저장: Wh 정수]
  • net_metering_usage — int(11) — net_metering 사용량 [저장: Wh 정수]
  • water_acc — decimal(15,5) — 수도 누적 (m3) =========설비 누적(acc) & 설비 사용량(usage)
  • water_usage — decimal(15,5) — 수도 사용량
  • hot_water_acc — decimal(15,5) — 온수 누적 (m3)
  • hot_water_usage — decimal(15,5) — 온수 사용량
  • gas_acc — decimal(15,5) — 가스 누적 (m3)
  • gas_usage — decimal(15,5) — 가스 사용량
  • heating_acc — decimal(15,5) — 난방 누적 (열량)
  • heating_usage — decimal(15,5) — 난방 사용량
  • heating_flow_acc — decimal(15,5) — 난방 유량 누적
  • heating_flow_usage — decimal(15,5) — 난방 유량 사용량
  • etc_acc — decimal(15,5) — 기타 누적
  • etc_usage — decimal(15,5) — 기타 사용량
  • etc_flow_acc — decimal(15,5) — 기타 유량 누적
  • etc_flow_usage — decimal(15,5) — 기타 유량 사용량
  • item_substituted — tinyint(3) unsigned — NOT NULL — 항목별 대체 비트 (bit5:전기 bit4:수도 bit3:온수 bit2:가스 bit1:난방 bit0:기타, 1=이전값 대체)

data_usage_5m (5분 사용량 집계) (data_usage_5m)

  • unit_id — int(10) unsigned — 기본 키 — NOT NULL — 지점 ID
  • read_date — datetime — 기본 키 — NOT NULL — 5분 구간 시작 시각 [시작, 종료). 종료 경계 검침은 다음 구간
  • reading_date — datetime — 원본 수신 시각 (data_raw.read_date)
  • save_date — datetime — 저장 시각 (스케줄러가 저장한 시간)
  • import_acc_t0 — bigint(20) — 수전 누적값 T0 (Wh) =========전기 누적(acc) & 사용량(usage) [저장: Wh 정수]
  • import_usage_t0 — int(11) — 수전 유효 전력량 T0 사용량 [저장: Wh 정수]
  • import_acc_t1 — bigint(20) — 수전 누적값 T1 (Wh) [저장: Wh 정수]
  • import_usage_t1 — int(11) — 수전 유효 전력량 T1 사용량 [저장: Wh 정수]
  • import_acc_t2 — bigint(20) — 수전 누적값 T2 (Wh) [저장: Wh 정수]
  • import_usage_t2 — int(11) — 수전 유효 전력량 T2 사용량 [저장: Wh 정수]
  • import_acc_t3 — bigint(20) — 수전 누적값 T3 (Wh) [저장: Wh 정수]
  • import_usage_t3 — int(11) — 수전 유효 전력량 T3 사용량 [저장: Wh 정수]
  • import_acc_t4 — bigint(20) — 수전 누적값 T4 (Wh) [저장: Wh 정수]
  • import_usage_t4 — int(11) — 수전 유효 전력량 T4 사용량 [저장: Wh 정수]
  • export_acc_t0 — bigint(20) — 송전 누적값 T0 (Wh) [저장: Wh 정수]
  • export_usage_t0 — int(11) — 송전 유효 전력량 T0 사용량 [저장: Wh 정수]
  • export_acc_t1 — bigint(20) — 송전 누적값 T1 (Wh) [저장: Wh 정수]
  • export_usage_t1 — int(11) — 송전 유효 전력량 T1 사용량 [저장: Wh 정수]
  • export_acc_t2 — bigint(20) — 송전 누적값 T2 (Wh) [저장: Wh 정수]
  • export_usage_t2 — int(11) — 송전 유효 전력량 T2 사용량 [저장: Wh 정수]
  • export_acc_t3 — bigint(20) — 송전 누적값 T3 (Wh) [저장: Wh 정수]
  • export_usage_t3 — int(11) — 송전 유효 전력량 T3 사용량 [저장: Wh 정수]
  • export_acc_t4 — bigint(20) — 송전 누적값 T4 (Wh) [저장: Wh 정수]
  • export_usage_t4 — int(11) — 송전 유효 전력량 T4 사용량 [저장: Wh 정수]
  • reactive_acc_q1 — bigint(20) — 무효 전력량 Q1 [저장: varh 정수]
  • reactive_usage_q1 — int(11) — 무효 전력량 Q1 사용량 [저장: varh 정수]
  • reactive_acc_q2 — bigint(20) — 무효 전력량 Q2 [저장: varh 정수]
  • reactive_usage_q2 — int(11) — 무효 전력량 Q2 사용량 [저장: varh 정수]
  • reactive_acc_q3 — bigint(20) — 무효 전력량 Q3 [저장: varh 정수]
  • reactive_usage_q3 — int(11) — 무효 전력량 Q3 사용량 [저장: varh 정수]
  • reactive_acc_q4 — bigint(20) — 무효 전력량 Q4 [저장: varh 정수]
  • reactive_usage_q4 — int(11) — 무효 전력량 Q4 사용량 [저장: varh 정수]
  • net_metering_acc — bigint(20) — net_metering 누적값, DR이랑 관계 X [저장: Wh 정수]
  • net_metering_usage — int(11) — net_metering 사용량 [저장: Wh 정수]
  • water_acc — decimal(15,5) — 수도 누적 (m3) =========설비 누적(acc) & 설비 사용량(usage)
  • water_usage — decimal(15,5) — 수도 사용량
  • hot_water_acc — decimal(15,5) — 온수 누적 (m3)
  • hot_water_usage — decimal(15,5) — 온수 사용량
  • gas_acc — decimal(15,5) — 가스 누적 (m3)
  • gas_usage — decimal(15,5) — 가스 사용량
  • heating_acc — decimal(15,5) — 난방 누적 (열량)
  • heating_usage — decimal(15,5) — 난방 사용량
  • heating_flow_acc — decimal(15,5) — 난방 유량 누적
  • heating_flow_usage — decimal(15,5) — 난방 유량 사용량
  • etc_acc — decimal(15,5) — 기타 누적
  • etc_usage — decimal(15,5) — 기타 사용량
  • etc_flow_acc — decimal(15,5) — 기타 유량 누적
  • etc_flow_usage — decimal(15,5) — 기타 유량 사용량
  • item_substituted — tinyint(3) unsigned — NOT NULL — 항목별 대체 비트 (bit5:전기 bit4:수도 bit3:온수 bit2:가스 bit1:난방 bit0:기타, 1=이전값 대체)

data_usage_day (일 사용량 집계) (data_usage_day)

  • unit_id — int(10) unsigned — 기본 키 — NOT NULL — 지점 ID
  • read_date — date — 기본 키 — NOT NULL — 검침 일자 (일 집계)
  • save_date — datetime — 저장 시각 (스케줄러가 저장한 시간)
  • import_acc_t0 — bigint(20) — 수전 누적값 T0 (Wh) =========전기 누적(acc) & 사용량(usage) [저장: Wh 정수]
  • import_usage_t0 — int(11) — 수전 유효 전력량 T0 일사용량 [저장: Wh 정수]
  • import_acc_t1 — bigint(20) — 수전 누적값 T1 (Wh) [저장: Wh 정수]
  • import_usage_t1 — int(11) — 수전 유효 전력량 T1 일사용량 [저장: Wh 정수]
  • import_acc_t2 — bigint(20) — 수전 누적값 T2 (Wh) [저장: Wh 정수]
  • import_usage_t2 — int(11) — 수전 유효 전력량 T2 일사용량 [저장: Wh 정수]
  • import_acc_t3 — bigint(20) — 수전 누적값 T3 (Wh) [저장: Wh 정수]
  • import_usage_t3 — int(11) — 수전 유효 전력량 T3 일사용량 [저장: Wh 정수]
  • import_acc_t4 — bigint(20) — 수전 누적값 T4 (Wh) [저장: Wh 정수]
  • import_usage_t4 — int(11) — 수전 유효 전력량 T4 일사용량 [저장: Wh 정수]
  • export_acc_t0 — bigint(20) — 송전 누적값 T0 (Wh) [저장: Wh 정수]
  • export_usage_t0 — int(11) — 송전 유효 전력량 T0 일사용량 [저장: Wh 정수]
  • export_acc_t1 — bigint(20) — 송전 누적값 T1 (Wh) [저장: Wh 정수]
  • export_usage_t1 — int(11) — 송전 유효 전력량 T1 일사용량 [저장: Wh 정수]
  • export_acc_t2 — bigint(20) — 송전 누적값 T2 (Wh) [저장: Wh 정수]
  • export_usage_t2 — int(11) — 송전 유효 전력량 T2 일사용량 [저장: Wh 정수]
  • export_acc_t3 — bigint(20) — 송전 누적값 T3 (Wh) [저장: Wh 정수]
  • export_usage_t3 — int(11) — 송전 유효 전력량 T3 일사용량 [저장: Wh 정수]
  • export_acc_t4 — bigint(20) — 송전 누적값 T4 (Wh) [저장: Wh 정수]
  • export_usage_t4 — int(11) — 송전 유효 전력량 T4 일사용량 [저장: Wh 정수]
  • reactive_acc_q1 — bigint(20) — 무효 전력량 Q1 [저장: varh 정수]
  • reactive_usage_q1 — int(11) — 무효 전력량 Q1 일사용량 [저장: varh 정수]
  • reactive_acc_q2 — bigint(20) — 무효 전력량 Q2 [저장: varh 정수]
  • reactive_usage_q2 — int(11) — 무효 전력량 Q2 일사용량 [저장: varh 정수]
  • reactive_acc_q3 — bigint(20) — 무효 전력량 Q3 [저장: varh 정수]
  • reactive_usage_q3 — int(11) — 무효 전력량 Q3 일사용량 [저장: varh 정수]
  • reactive_acc_q4 — bigint(20) — 무효 전력량 Q4 [저장: varh 정수]
  • reactive_usage_q4 — int(11) — 무효 전력량 Q4 일사용량 [저장: varh 정수]
  • net_metering_acc — bigint(20) — net_metering 누적값 [저장: Wh 정수]
  • net_metering_usage — int(11) — net_metering 일 사용량 [저장: Wh 정수]
  • water_acc — decimal(15,5) — 수도 누적 (m3) =========설비 누적(acc) & 설비 사용량(usage)
  • water_usage — decimal(15,5) — 수도 일사용량
  • hot_water_acc — decimal(15,5) — 온수 누적 (m3)
  • hot_water_usage — decimal(15,5) — 온수 일사용량
  • gas_acc — decimal(15,5) — 가스 누적 (m3)
  • gas_usage — decimal(15,5) — 가스 일사용량
  • heating_acc — decimal(15,5) — 난방 누적 (열량)
  • heating_usage — decimal(15,5) — 난방 일사용량
  • heating_flow_acc — decimal(15,5) — 난방 유량 누적
  • heating_flow_usage — decimal(15,5) — 난방 유량 일사용량
  • etc_acc — decimal(15,5) — 기타 누적
  • etc_usage — decimal(15,5) — 기타 일사용량
  • etc_flow_acc — decimal(15,5) — 기타 유량 누적
  • etc_flow_usage — decimal(15,5) — 기타 유량 일사용량
  • demand_max — decimal(12,3) — 일 최대수요전력 (kW)=========전력 품질 통계
  • demand_max_date — datetime — 일 최대수요전력 발생 구간

device_history (장치별 이력 테이블) (device_history)

  • history_id — bigint(20) unsigned — 기본 키 — NOT NULL — 이력 일련번호
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 이력 발생 당시 단지코드
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — 이력당시 발생 지점 id
  • device_type — varchar(10) — NOT NULL — DEVICE_TYPE 코드: DCU/SCU/EM(전력량계)/METER(설비미터)
  • device_id — int(10) unsigned — NOT NULL — 이력 대상 장비 아이디 (device_type에 따라 dcu_id/scu_id/em_id/meter_id)
  • event_date — datetime — NOT NULL — 이력 발생 일시
  • event_kind — varchar(20) — NOT NULL — 설치/교체/검교정/철거
  • prev_meter_value — decimal(17,5) — 교체된 계기의 마지막 지침 값
  • new_meter_value — decimal(17,5) — 교체 후 시작 지침 값 -> 없으면 교체 당일 사용량 상이할 수 있음
  • content — varchar(500) — 조치내용 (폐기사유, 교체사유 등)
  • is_active — char(1) — 이력 표시 여부(Y/N) => 관리자가 이력 만들었다가 삭제 및 수정할 수 있음
  • created_dt — datetime — 등록일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(30) — 수정자 아이디

device_info_dcu (dcu 정보) (device_info_dcu)

  • dcu_id — int(10) unsigned — 기본 키 — NOT NULL — dcu 아이디
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드
  • installed_location — varchar(50) — 설치위치
  • dcu_address — char(12) — NOT NULL — dcu 주소
  • model_name — varchar(255) — 모델명 (제품 모델 식별, 자유 텍스트)
  • spec — varchar(255) — 상세 스펙 (자유 텍스트)
  • version — varchar(50) — 펌웨어 버전 (최대 50자)
  • comm_type — varchar(10) — 장비별 관리용 상위 통신 구분 (COMM_TYPE 코드)
  • kind — enum('DCU','IF') — NOT NULL — 장비 종류: DCU 또는 IF(인터페이스). CK_DCU_KIND 허용값 제약
  • local_ip — varchar(100) — 로컬 IP
  • server_ip — varchar(40) — 서버 IP
  • port — varchar(255) — 포트번호
  • installed_dt — datetime — 설치일시
  • uninstalled_dt — datetime — 철거일시 (default: NULL-> 현재 운용중)
  • created_dt — datetime — 등록일시
  • created_by — varchar(30) — 등록자아이디
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(30) — 수정자아이디
  • remark — text — 비고

device_info_em (em 정보) (device_info_em)

  • em_id — int(10) unsigned — 기본 키 — NOT NULL — 전력량계 아이디
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 설치 지점 id
  • model_name — varchar(255) — 모델명 (제품 모델 식별, 자유 텍스트)
  • product_code — varchar(20) — 전력량계 품목코드 (code_details PRODUCT_METER의 code_detail_id)
  • version — varchar(50) — 펌웨어 버전 (최대 50자)
  • con — int(10) unsigned — 계기정수
  • ct — decimal(10,4) — CT 비율
  • pt — decimal(10,4) — PT 비율
  • lp_interval — smallint(5) unsigned — LP 주기
  • cal_dt — date — 검교정일
  • cal_expected_dt — date — 검교정 유효기간
  • installed_dt — datetime — 설치일시
  • meter_phase — varchar(10) — 상 구분 (품목코드(product_code)를 통해 반영)
  • spec — varchar(255) — 상세 스펙 (자유 텍스트)
  • meter_role — char(1) — 계측 구분 (C:소비 P:생산)
  • gen_type — varchar(10) — 발전 종류 (code_details GENERATION_TYPE). meter_role=P만
  • uninstalled_dt — datetime — 철거일시 (default: NULL-> 현재 운용중)
  • cal_dismissed_at — datetime — 검교정 알림 해제 일시
  • cal_dismissed_by — varchar(30) — 검교정 알림 해제자 ID
  • created_dt — datetime — 등록일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(30) — 수정자 아이디
  • remark — varchar(255) — 비고

device_info_meter (설미미터 정보) (device_info_meter)

  • meter_id — int(10) unsigned — 기본 키 — NOT NULL — 계량기 아이디 (전력량계 제외)
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 설치 지점 id
  • model_name — varchar(255) — 모델명 (제품 모델 식별, 자유 텍스트)
  • spec — varchar(255) — 상세 스펙 (자유 텍스트)
  • version — varchar(50) — 펌웨어 버전 (최대 50자)
  • meter_type — varchar(5) — NOT NULL — 계량기 종류 (WM:수도 HM:온수 GM:가스 CM:난방 SP:기타)
  • cal_dt — date — 검교정일
  • cal_expected_dt — date — 검교정 유효기간
  • installed_dt — datetime — 설치일시
  • pulse_const — decimal(12,4) — 펄스 단위 (1:1L 2:10L 3:100L 4:1000L)
  • uninstalled_dt — datetime — 철거일시 (default: NULL-> 현재 운용중)
  • cal_dismissed_at — datetime — 검교정 알림 해제 일시
  • cal_dismissed_by — varchar(30) — 검교정 알림 해제자 ID
  • created_dt — datetime — 등록일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(30) — 수정자 아이디
  • remark — varchar(255) — 비고

device_info_scu (scu 정보) (device_info_scu)

  • scu_id — int(10) unsigned — 기본 키 — NOT NULL — SCU 아이디
  • unit_id — int(10) unsigned — 외래 키 → unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X.unit_id — NOT NULL — 설치 지점 id
  • model_name — varchar(255) — 모델명 (제품 모델 식별, 자유 텍스트)
  • spec — varchar(255) — 상세 스펙 (자유 텍스트)
  • version — varchar(50) — 펌웨어 버전 (최대 50자)
  • installed_dt — datetime — 설치일시
  • uninstalled_dt — datetime — 철거일시 (default: NULL-> 현재 운용중)
  • created_dt — datetime — 등록일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정일시
  • updated_by — varchar(30) — 수정자 아이디
  • remark — varchar(255) — 비고

unit_info (에너지를 재는 위치 + 그 자리에 도달하는 통신 경로), 장비 교체해도 변경X (unit_info)

  • unit_id — int(10) unsigned — 기본 키 — NOT NULL — 지점 ID
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드
  • scope — varchar(20) — NOT NULL — 지점 구분: HOUSEHOLD(세대) | COMMON(공용) | GENERATE(발전)
  • meter_channel — tinyint(3) unsigned — NOT NULL — 계측 채널 비트 (32:전기 16:수도 8:온수 4:가스 2:난방 1:기타) => ex. 전기/수도/온수 =56
  • dong — varchar(50) — NOT NULL — 동·건물 (ex. 101동, 휘트니스센터, 관리동)
  • floor — varchar(50) — 층 (현재 명칭)
  • ho — varchar(50) — 호 · 실 -> dong/floor/ho = 어디에 있는가 (주소)
  • parent_name — varchar(50) — 하위 계측명 (예: 에어컨, 전열, 전등). 위치 표시용 명칭이며 상위 지점 ID가 아님
  • dcu_address — char(12) — DCU 주소
  • dcu_index — int(10) unsigned — DCU 내부 인덱스
  • comm_device_type — char(20) — 단말 구분: WIRED(유선), WIRELESS(무선), EM(전력량계)
  • comm_address — char(12) — 이 지점의 통신 주소 (SCU의 주소 or EM의 주소)
  • comm_em_address — char(12) — 전력량계 주소. 직결은 comm_address와 동일, SCU 경유도 별도 주소 저장. 전기 미사용은 NULL
  • repeater1 — tinyint(3) unsigned — NOT NULL — repeater1 index (default, 255=미사용). 무선 구간에서만 사용
  • repeater2 — tinyint(3) unsigned — NOT NULL — repeater2 index
  • repeater3 — tinyint(3) unsigned — NOT NULL — repeater3 index
  • repeater4 — tinyint(3) unsigned — NOT NULL — repeater4 index
  • repeater5 — tinyint(3) unsigned — NOT NULL — repeater5 index
  • repeater6 — tinyint(3) unsigned — NOT NULL — repeater6 index
  • exclusive_area — decimal(8,2) — 전용면적(㎡) -> 단위면적당 에너지 사용량 산출. HOUSEHOLD(세대)만
  • occupants — int(10) unsigned — 재실인원 -> 1인당 에너지 사용량 산출. HOUSEHOLD(세대)만
  • is_active — char(1) — NOT NULL — 지점 사용 여부 (Y: 사용, N: 중지)
  • created_dt — datetime — NOT NULL — 등록 일시
  • created_by — varchar(30) — 등록자 아이디
  • updated_dt — datetime — 수정 일시
  • updated_by — varchar(30) — 수정자 아이디

user_action_log (유저 조치 이력) (user_action_log)

  • action_log_id — bigint(20) unsigned — 기본 키 — NOT NULL — 로그 일련번호
  • apt_no — varchar(30) — 조치 대상의 단지코드
  • user_id — int(10) unsigned — 외래 키 → user_info (프로그램 로그인 유저).user_id — NOT NULL — 조치자 사용자 ID (프로그램 로그인 유저)
  • acted_dt — datetime — NOT NULL — 조치 일시
  • action_type — varchar(20) — NOT NULL — 조치 구분 조회(READ)는 기록하지 않음
  • content — varchar(500) — NOT NULL — 프로그램이 자동 생성하는 조치 내용. 대상·위치·변경 전후 등의 내용 보존
  • remark — varchar(255) — 선택적인 자유 텍스트 비고

user_info (프로그램 로그인 유저) (user_info)

  • user_id — int(10) unsigned — 기본 키 — NOT NULL — 사용자 ID
  • apt_no — varchar(30) — 외래 키 → apt_info (단지 or 건물정보).apt_no — NOT NULL — 단지코드
  • login_id — varchar(50) — NOT NULL — 로그인 아이디
  • password — varchar(200) — NOT NULL — 비밀번호 (BCrypt)
  • user_name — varchar(100) — NOT NULL — 사용자 이름
  • role — varchar(20) — NOT NULL — 권한 3종: USER(유저), ADMIN(관리자), SUPER_ADMIN(최고 관리자)
  • email — varchar(200) — 이메일
  • phone — varchar(30) — 연락처
  • status — varchar(20) — NOT NULL — 상태: ACTIVE, INACTIVE, LOCKED, DELETED
  • created_dt — datetime — NOT NULL — 등록 일시
  • created_by — varchar(50) — 등록자 아이디