smart_ims/docs/roadmap/INTEGRATED_ROADMAP.md

237 lines
15 KiB
Markdown

# 🚀 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`
- [ ] **라이선스 관리 오류 수정**
- [ ] **시스템 관리 기본설정 오류 수정**
- [ ] **시스템 업데이트 오류 수정**
#### 🏷️ Tag: `v0.4.3.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