관리자시스템 원패스 기기 목록

배경

관리자시스템의 원패스 기기 목록에서 조회 결과가 현장에서 쓰기 불편했음. 지역본부가 뒤쪽에 있어 찾기 어렵고, 원패스 아이디가 LH 부여체계 번호와 달라 현장 라벨과 대조가 안 됐음.

항목	파일	변경 내용
지역본부를 맨 앞 컬럼으로	`OpasDvcList.vue`	`grpNm`을 첫 컬럼으로 이동
LH 코드 컬럼 추가	`OpasDvcList.vue`	`opasDvcId.slice(4)`를 16진수 → 10진수로 변환한 가상 컬럼
설치 위치 컬럼 추가	`OpasDvcList.vue`	`istlFlr` 컬럼을 DB 값 그대로 표시
상태 표시 문구 변경	`useOpasDvcMng.js`	사용 → 정상, 미사용 → 고장의심

원패스 아이디 앞 4자리를 떼고 나머지를 10진수로 바꿈. 예: 000B9896E2 → 앞 4자리(000B) 제거 → 9896E2를 10진수로 변환.

상세 규격은 사내 문서 개발관리/분석/원패스 연동규격/v02를 봄.

상태 값은 최근 일주일 내 사용 여부로 계산됨(2026-09-17 확인). 그래서 별도 판정 로직 없이 표시 문구만 정상/고장의심으로 바꾼 것으로 완료.

화면 /sbd-mng/opas-dvc-mng/OpasDvcList, API GET /api/v1/complex/findOpasDvcList(OpasController.java:38). 조회 전용이고 등록·수정 API가 없음
상태 OPAS_DVC_SS_CD는 테이블 값이 아니라 최근 7일 내 사용 이력(cmn.tb_opas_us_l) 유무로 계산됨. “고장의심”은 7일간 사용 이력이 없다는 뜻이지 장애 신호가 아님
원패스 운영현황·설치현황·운용현황 전용 API 3개는 컨트롤러에서 통째로 주석 처리돼 있고 같은 지표가 대시보드 위젯(/api/v1/dsbd/findOpas*)으로 옮겨 감. 통계를 물으면 대시보드를 안내함
화면 파일 OpasList.vue는 라우트에 연결되지 않은 잔재임(실제 화면은 OpasDvcList)
코드 근거는 공개노트/개발/모듈/LMC 기능 상세

tags	스마트원패스, 관리자시스템, 단말기
aliases	원패스 기기 목록, 원패스 단말기 조회, LH 부여체계, 고장의심, OpasDvcList, 설치위치