🚀 SMART IMS 통합 프로젝트 로드맵 (Integrated Master Plan)

프로젝트명: SOKUREE Platform - Smart Integrated Management System 최초 작성일: 2026-01-25 최근 업데이트: 2026-01-25 버전: v0.4.1.0

📌 개요 (Overview)

본 문서는 SOKUREE 플랫폼의 핵심 성능 개선(Platform Review)과 스마트 관리 모듈(Smart Module Implementation Plan)의 구현 계획을 통합하여, 기능 구현 단계별 태그(Tag) 기반의 전체 마스터 플랜을 정의합니다.

🗺️ 구현 로드맵 (Implementation Roadmap)

🟦 Phase 1: 기반 강화 및 보안 고도화 (Platform Stability)

목표: 플랫폼의 안정성 확보 및 사용자 중심의 보안/관리 체계 구축

🏷️ Tag: `v0.4.1.0` (완료)

세션 관리 엔진 최적화
- 세션 자동 로그아웃 시간 합산 오류 수정 (시간+분 단위 정상 동작 확인)
- 활동 부재 시 자동 로그아웃 잔여 시간 추적 로그 시스템 도입
- (수정사항): 서버 요청 로그([KST])에 해당 세션의 남은 시간(m s left)을 실시간 표시하도록 개선 및 세션 연장 로직 최적화 -사용자가 마지막 활동 후 **설정된 시간(기본 10분)**이 경과하면, 30초 간격으로 돌아가는 감시 엔진에 의해 즉시 포착되어 로그아웃이 수행됩니다. 따라서 체감상 로그아웃이 발생하는 "최초 트리거 타임"은 [설정된 시간] + (0~30초) 이내입니다.
사용자별 맞춤 보안 설정
- 시스템 기본 설정의 보안/세션 을 개별 사용자의 기본설정에서 설정 가능하도록 이동
- 사용자 별 세션 만료 시간 적용가능하도록 사용자 DB에 이 설정 값을 포함하도록 재 구성
- 사용자 등록 양식 기본 값을 10분으로 설정
- 사용자 등록화면에서의 권한 명칭 수정 (최고관리자, 관리자, 사용자 로 통일)
- (수정사항): users 테이블 스키마 확장(session_timeout 추가) 및 로그인 세션 생성 시 사용자별 커스텀 타임아웃 주입 엔진 구현
CCTV 설정 추가
- 등록된 CCTV 조회 메뉴 추가하여 게시판 형으로 목록화 하고 활성(비활성)/수정/삭제 할수 있는 관리 기능 구현
- CCTV 설정 파일 DB 저장 시 username/password 필드 암호화 처리
- CCTV 설정 파일 조회 시 username/password 필드 복호화 처리
- (수정사항): CameraManagementPage 신설 및 cryptoUtil을 통한 RTSP 계정 정보의 DB 암호화 저장 로직 완성 (AES-256)

🏷️ Tag: `v0.4.2.0`

소모품 관리
- 이 기능은 자재/재고 관리 모듈 생성하여 메뉴가 아니라 속성(카테고리)으로 추가할 예정
부속설비 등록
- 자산 등록 화면에서 부속설비 등록 버튼 클릭 시 자산 등록 화면으로 이동하도록 구현
- 부속설비 등록 버튼으로 이동 시 상위설비 자동 선택되도록 구현
- 자산 등록 화면에서 상위설비 드롭다운 메뉴에서 목록이 표시되지 않고 있음
  - 상위설비 드롭다운 메뉴를 입력 텍스트 박스로 변경하고 옆에 검색 아이콘 추가
  - 검색 아이콘 클릭 시 상위설비 검색 화면으로 이동
  - 상위설비 검색 화면에서 검색어 입력 후 검색 버튼 클릭 시 검색 결과 목록 표시
  - 검색 결과 목록에서 상위설비 선택 시 자산 등록 화면으로 이동하고 입력 텍스트 박스에 상위설비 이름 표시
자산관리 모듈의 현재 메뉴들을 기준정보 메뉴의 하위 메뉴로 변경
설정 메뉴 추가
- IoT 센서 모니터링 메뉴 추가
- 모듈 관리 메뉴 추가
- 설비 관리 메뉴 추가
시스템 관리 - 사용자 관리
- 사용자 관리에 모듈 접근 권한을 설정할 수 있도록 구현
- 관리권한 재 검토
  - 최고관리자, 관리자, 모듈 관리자, 사용자

🏷️ Tag: `v0.5.0.x`

모듈 간 연동을 위한 API 인터페이스 정의
- 자재/재고 관리 모듈 추가
- 생산관리 모듈
  - 생산 공정 메뉴
  - 생산 라인 메뉴
  - 생산 실적 관리 메뉴
- 품질관리 모듈
- IoT 모듈
  - IoT 센서 모니터링 메뉴
  - IoT 센서 데이터 수집 및 저장
  - IoT 센서 데이터 시각화
사용자 관리 시스템 강화
- 사용자 고유 관리번호 도입 (중복 불가)
- 프로필 이미지 필드 추가 및 업로드 기능
- 사용자 목록 UI 최적화 (페이지당 10개 제한, 네비게이션 추가)
- 복합 검색 기능 (관리번호, 아이디, 이름) 및 소속 필터 적용

🟩 Phase 2: 자산관리 MVP 및 모니터링 (Core Assets & IoT)

목표: 통합 자산관리의 핵심 기능 구현 및 실시간 데이터 연동 기반 구축

🏷️ Tag: `v0.5.1.x`

자산관리 기본 모듈 (Asset CRUD)
- 6대 카테고리(FAC, TOL, INS, VEH, GEN, CSM) 기반 관리 체계 확립
- 자산 등록/수정/삭제 웹 인터페이스 구현
- QR 코드 자동 생성 및 라벨 출력 기능
에너지 미터 모니터링 (Energy Meter)
- MQTT 프로토콜 기반 실시간 데이터 수집 (qideun.com:1883)
- 전압, 전류, 전력량, 역률 시각화
- 년/월/일/시간별 누적 소비량 통계 및 차트 구현
CCTV 스트리밍 연동
- 현재의 JSMpeg 기반 스트리밍 구조 유지 및 모니터링 탭 통합

🟧 Phase 3: 지능형 통합 및 품질 관리 (Smart Integration)

목표: 모듈 간 데이터 연쇄 작용 및 생산/품질 시스템과의 연동 고도화

🏷️ Tag: `v0.6.0.x`

스마트 센서 매핑 및 확장 시스템
- 설비별 임의 센서(온도, 진동 등)를 동적으로 추가할 수 있는 Sensor Mapping 기능
- 센서 임계치 도달 시 고장 접수 자동화 및 예방정비(PM) 알림 연계
품질-생산 연동 (Accuracy Management)
- 계측기 검교정 후 발생하는 보정치(Bias/Offset) 실시간 저장
- MES 연동: 생산 공정 데이터 측정 시 자산 모듈의 보정 계수를 실시간 반영하여 정밀도 확보
예방정비-재고 자동 연동
- 예방정비 스케줄 도래 시 필요한 소모품(CSM)의 재고 확인 및 자동 할당
- 소모품 안전재고(ROP) 기반 자동 발주 알림 처리

🛠️ 기술 상세 규격 (Technical Specifications)

1. 전력 모니터링 MQTT 규격

Topic: sokuree/home/ems (실시간), sokuree/home/ems/report (통계)
Data Payload:

{
  "node_id": "PZEM004T-R4",
  "voltage": "225.20",
  "current": "2.17",
  "power": "408.40",
  "energy": "157.94"
}

2. 고도화된 데이터 모델 (Interface)

시설물 (Facility + IoT + Parts)

interface FacilityAsset extends AssetBase {
  iotConfig?: {
    nodeId: string;
    sensors: Array<{ type: string; field: string; threshold?: number }>;
  };
  linkedParts: Array<{ itemId: string; quantity: number }>; // 예방정비 소요 부품
  maintenance: { nextDate: string; intervalDays: number };
}

계측기 (Instrument + Correction)

interface InstrumentAsset extends AssetBase {
  calibration: {
    nextDate: string;
    correction: { bias: number; slope: number }; // 생산관리 연동용 보정치
  };
}

📋 자산 분류 및 관리 전략

코드	분류명	핵심 연동 항목
FAC	시설물	PM(예방정비), IoT 가동률, 소모품 재고
INS	계측기	검교정 이력, MES 보정값 반영
CSM	소모품	정비 부품 할당, 안전재고 알림
TOL	공구	불출/반납 이력, 금형 수명 관리

💡 참고 사항

모든 기능 구현 시 플랫폼의 디자인 시스템(CSS Variables)을 준수해야 함.
모듈 독립성 유지를 위해 모듈 간 통신은 정의된 API 인터페이스를 통해서만 수행함.

아키텍처 상세 도식

┌─────────────────────────────────────────────────────────────────────────┐ │ Layer 5: 지능형 분석 및 시각화 (The Brain) │ │ ┌───────────────────────┐ ┌──────────────────────────────┐ │ │ │ AI 분석 엔진 │◀──────────▶│ 통합 관제 대시보드 (BI) │ │ │ │ (예지보전, 품질최적화) │ 인사이트 │ (KPI, 가동률 실시간 모니터링)│ │ │ └───────────▲───────────┘ └──────────────▲───────────────┘ │ └──────────────┼───────────────────────────────────────┼──────────────────┘ │ 분석 결과 피드백 │ 실시간 현황 ▼ ▼ ┌──────────────┼───────────────────────────────────────┼──────────────────┐ │ │ Layer 4: 애플리케이션 계층 (IT System) │ │ │ ┌───────────▼──┐ ┌──────────────┐ ┌─────────────┐ ┌──────────┐ │ │ │ MES │◀─▶│ ERP │◀─▶│ WMS │◀─▶│ QMS │ │ │ │ (생산 실행) │ │ (전사적 자원) │ │ (창고관리) │ │(품질관리) │ │ │ └───────▲──────┘ └───────▲──────┘ └──────▲──────┘ └─────▲────┘ │ └──────────┼──────────────────┼─────────────────┼────────────────┼────────┘ │ │ │ │ ▼ ▼ ▼ ▼ ┌─────────────────────────────────────────────────────────────────────────┐ │ ⭐ Layer 3: 통합 데이터 플랫폼 (CORE HUB & Data Lake) │ │ ┌───────────────────────────────────────────────────────────────────┐ │ │ │ 통합 데이터 허브 (Data Broker) │ │ │ │ "모든 데이터가 모이고, 필요한 곳으로 분배된다" │ │ │ └─────────────────────────────────▲─────────────────────────────────┘ │ │ │ ↕ 양방향 데이터 동기화 │ │ ┌──────────▼──────────┐ │ │ │ 실시간 / 이력 DB │ │ │ └─────────────────────┘ │ └────────────────────────────────────▲────────────────────────────────────┘ │ 표준 프로토콜 (MQTT/OPC-UA) ┌────────────────────────────────────┼────────────────────────────────────┐ │ Layer 2: 엣지 컴퓨팅 계층 (Translator) │ │ ┌────────────────────────┴───────────────────────┐ │ │ │ 엣지 게이트웨이 (Edge GW) │ │ │ │ (데이터 수집, 프로토콜 변환, 1차 필터링) │ │ │ └──────▲─────────────────▲────────────────▲──────┘ │ └──────────────────┼─────────────────┼────────────────┼───────────────────┘ │ │ │ ┌──────────────────┼─────────────────┼────────────────┼───────────────────┐ │ ┌─────────┴──────┐ ┌──────┴───────┐ ┌────┴─────┐ │ │ │ P1. 기존 설비 │ │ P2. 최신설비 │ │ P3. 센서 │ │ │ │ (PLC/Legacy) │ │ (Robot/CNC) │ │ (환경) │ │ │ └────────────────┘ └──────────────┘ └──────────┘ │ │ Layer 1: 현장 물리 계층 (Data Source) │ └─────────────────────────────────────────────────────────────────────────┘