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

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

#### 시설물 (Facility + IoT + Parts)
```typescript
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)
```typescript
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)                       │
└─────────────────────────────────────────────────────────────────────────┘

![alt text](image.png)
![alt text](image-1.png)

![alt text](image-2.png)

![alt text](image-3.png)

https://www.bulums.io/smartfactory-cmms

![alt text](image-4.png)
https://blog.naver.com/8pmcorp/224146369431