📊 장애 보고서 뷰어 (Failure Report Viewer)

▲ 대구교통공사 3호선 전력관제 장애 관리 통합 플랫폼 메인화면

장애 이력 조회 및 관리 대시보드

이 프로그램은 시스템에 기록된 모든 장애 보고서를 웹 인터페이스를 통해 손쉽게 조회하고 검색할 수 있는 뷰어입니다.

👤 개발자

• 강동우 (대구교통공사 3호선 경전철관제팀 전력관제)
• 본 프로젝트는 개발자 개인의 연구 결과물입니다.

📜 개발 배경 및 히스토리

• 2025.04 ~ 06: 프로젝트 초기, 수작업으로 관리되던 HWP 장애 보고서를 DB화하는 과정에서 데이터 검증 및 조회를 위해 가장 먼저 개발된 모듈입니다.
• 초도품 완성: 2025년 6월 15일, 장애 예측기와 함께 완성되어 시스템의 기초를 다졌습니다.

💰 개발 성과 (Value)

• 저사양 최적화: i3-13100 등 저사양 환경에서도 즉각적인 반응 속도를 보장하도록 경량화했습니다.
• 예산 절감: 1인 개발로 전체 플랫폼의 기반을 마련하여 예산을 절감했습니다.

🌟 주요 기능

• 보고서 조회: 날짜별, 유형별 장애 이력 리스트 조회.
• 상세 보기: 각 장애의 원인, 조치 내용, 분석 결과 상세 확인.
• 경량화: Node.js 기반의 가볍고 빠른 웹 서버.

⚙️ 설치 및 실행 방법

1. 필수 요구 사항

• Node.js (LTS 버전 권장)

2. 최소 하드웨어 사양 (Minimum Specs)

• CPU: Intel Core i3-13100 이상
• RAM: 16GB 이상
• GPU: 불필요

3. 패키지 설치

이 명령어를 실행하면 node_modules 폴더가 생성되고 필요한 라이브러리가 설치됩니다.

npm install

3. 실행

# Windows
run_viewer.bat

# 또는
node app.js

실행 후 브라우저에서 http://localhost:3000 (또는 설정된 포트)로 접속하세요.

🎨 커스터마이징 가이드

이 프로그램은 누구나 수정해서 사용할 수 있습니다.

• 제목 변경: public/index.html (또는 index.html) 파일을 열어 수정하세요.
• 로고 변경: public 폴더 내의 로고 이미지를 본인의 로고로 교체(덮어쓰기)하면 됩니다.
• 데이터 교체: incident_reports.db 파일을 본인의 데이터로 교체하면, 별도의 코드 수정 없이 즉시 해당 조직의 장애 보고서 뷰어로 사용할 수 있습니다.

📢 통합 플랫폼 안내

본 프로그램은 독립적으로 실행되지만, 추후 공개될 **'장애 관리 통합 플랫폼'**의 일부 모듈입니다. 사용자는 이 모듈들을 결합하여 통합 시스템으로 구축할 수 있으며, 통합된 전체 버전 또한 추후 오픈소스로 공개될 예정입니다.

📂 파일 구조

• app.js: Node.js Express 서버.
• public/: 정적 리소스 파일.
• incident_reports.db: 조회 대상 데이터베이스.

⚠️ 참고 사항

• 이 뷰어는 incident_reports.db 파일을 읽기 전용으로 참조합니다.