From 586e09c8afef1739952a3dcd851e61620d336571 Mon Sep 17 00:00:00 2001
From: choibk <choibk350@gmail.com>
Date: Sun, 25 Jan 2026 01:18:42 +0900
Subject: [PATCH] =?UTF-8?q?=EB=B2=84=EC=A0=84=20=EA=B4=80=EB=A6=AC=20?=
 =?UTF-8?q?=EC=8B=9C=EC=8A=A4=ED=85=9C=20=ED=98=81=EC=8B=A0:=204=EC=9E=90?=
 =?UTF-8?q?=EB=A6=AC=20=EB=B2=84=EC=A0=84=20=EC=B2=B4=EA=B3=84(MAJOR.MINOR?=
 =?UTF-8?q?.PATCH.BUILD)=20=EB=8F=84=EC=9E=85,=20=EA=B7=9C=EC=A0=95=20?=
 =?UTF-8?q?=EB=AC=B8=EC=84=9C=20=EC=9E=91=EC=84=B1=20=EB=B0=8F=20=EC=84=9C?=
 =?UTF-8?q?=EB=B2=84=20=EC=8B=9C=EA=B0=81=20KST=20=EC=A0=81=EC=9A=A9?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 docs/version manage.md  | 54 +++++++++++++++++++++++++++++++++++++++++
 package.json            |  2 +-
 server/index.js         |  6 ++++-
 server/package.json     |  2 +-
 server/routes/system.js | 20 +++++++++------
 5 files changed, 73 insertions(+), 11 deletions(-)
 create mode 100644 docs/version manage.md

diff --git a/docs/version manage.md b/docs/version manage.md
new file mode 100644
index 0000000..e6a0150
--- /dev/null
+++ b/docs/version manage.md	
@@ -0,0 +1,54 @@
+# 📘 SMART IMS 버전 관리 규정 (Versioning Rules)
+
+SMART IMS 플랫폼의 모든 배포와 업데이트는 아래의 **MAJOR.MINOR.PATCH.BUILD** 4자리 버전 관리 체계를 엄격히 준수합니다.
+
+---
+
+## 1️⃣ MAJOR (첫 번째 자리)
+**대규모 변경, 하위 호환성 붕괴**
+
+- **의미**: 시스템의 근간이 바뀌거나 기존 데이터/연동 체계와의 호환성이 파괴될 때 증가합니다.
+- **상황**: API 구조 전면 개편, 데이터베이스 아키텍처 변경, 통신 프로토콜 교체 등.
+- **규칙**:
+    - 절대 자주 올리지 않으며, "제품의 세대 교체" 수준에서만 사용합니다.
+    - 사용자는 업데이트 전 반드시 호환성 여부를 검토해야 합니다.
+- **예시**: `1.x.x.x` → `2.0.0.0`
+
+## 2️⃣ MINOR (두 번째 자리)
+**기능 추가, 호환성 유지**
+
+- **의미**: 기존 시스템과 호환성을 유지하면서 새로운 기능이 추가되거나 UI가 대폭 개선될 때 증가합니다.
+- **상황**: 신규 모듈 추가, 기존 기능 확장, 설정 옵션 대량 추가 등.
+- **규칙**:
+    - 기능 단위의 주요 배포 시 사용합니다.
+    - 고객에게 "업데이트 권장" 수준의 변화를 의미합니다.
+- **예시**: `1.2.x.x` → `1.3.0.0`
+
+## 3️⃣ PATCH (세 번째 자리)
+**버그 수정, 품질 개선**
+
+- **의미**: 새로운 기능 추가 없이 기존 기능의 버그를 수정하거나 성능을 개선할 때 증가합니다.
+- **상황**: 보안 패치, 성능 최적화, 로직 오류 수정 등.
+- **규칙**:
+    - 기능 추가는 엄격히 금지됩니다.
+    - 긴급한 오류 수정 및 정기 유지보수 배포에 주로 사용됩니다.
+- **예시**: `1.2.3.x` → `1.2.4.0`
+
+## 4️⃣ BUILD / REVISION (네 번째 자리)
+**빌드 번호 또는 미세 변경**
+
+- **의미**: 사용자에게 기능적/시각적 변화를 거의 주지 않는 기술적 수정 시 증가합니다.
+- **상황**:
+    - **빌드 번호**: CI/CD 파이프라인의 빌드 식별자.
+    - **핫픽스**: 오타 수정, 로그 문구 변경, 주석 업데이트 등.
+- **규칙**:
+    - 사용자에게 "버전 변경 체감"을 주지 않는 수준의 작업입니다.
+    - 릴리스 노트(Changelog) 작성을 생략할 수 있습니다.
+- **예시**: `1.2.3.45` (45번째 빌드)
+
+---
+
+## 💡 버전 비교 및 업데이트 공지 원칙
+1. 플랫폼은 원격 저장소의 최신 태그 버전과 현재 설치된 버전의 **4자리를 순차적으로 비교**합니다.
+2. 상위 자리수가 더 높을 경우 즉시 시스템 업데이트 안내를 발생시킵니다.
+3. 모든 버전은 `v` 접두사를 포함하여 관리하나, 비교 시에는 숫자로 정규화하여 처리합니다.
\ No newline at end of file
diff --git a/package.json b/package.json
index 84c6481..6cccfdf 100644
--- a/package.json
+++ b/package.json
@@ -1,7 +1,7 @@
 {
   "name": "smartims",
   "private": true,
-  "version": "0.4.0",
+  "version": "0.4.0.0",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/server/index.js b/server/index.js
index 10f9050..0954089 100644
--- a/server/index.js
+++ b/server/index.js
@@ -361,13 +361,17 @@ initTables();
 const packageJson = require('./package.json');
 
 app.get('/api/health', (req, res) => {
+    // Force Korean time (UTC+9) for the timestamp
+    const kstOffset = 9 * 60 * 60 * 1000;
+    const kstDate = new Date(Date.now() + kstOffset);
+
     res.json({
         status: 'ok',
         version: packageJson.version,
         node_version: process.version,
         platform: process.platform,
         arch: process.arch,
-        timestamp: new Date().toISOString().replace('T', ' ').split('.')[0]
+        timestamp: kstDate.toISOString().replace('T', ' ').split('.')[0]
     });
 });
 
diff --git a/server/package.json b/server/package.json
index dc436c0..b7fabc2 100644
--- a/server/package.json
+++ b/server/package.json
@@ -1,6 +1,6 @@
 {
   "name": "server",
-  "version": "0.4.0",
+  "version": "0.4.0.0",
   "description": "",
   "main": "index.js",
   "scripts": {
diff --git a/server/routes/system.js b/server/routes/system.js
index 1d6fed0..51c3795 100644
--- a/server/routes/system.js
+++ b/server/routes/system.js
@@ -531,22 +531,26 @@ router.get('/version/remote', isAuthenticated, hasRole('admin'), async (req, res
                 }).filter(Boolean);
 
                 // Version Comparison Helper
-                const compareVersions = (v1, v2) => {
-                    const parts1 = v1.split('.').map(Number);
-                    const parts2 = v2.split('.').map(Number);
-                    for (let i = 0; i < 3; i++) {
-                        if (parts1[i] > parts2[i]) return 1;
-                        if (parts1[i] < parts2[i]) return -1;
+                const parseV = (v) => (v || '').replace(/^v/, '').split('.').map(n => parseInt(n) || 0);
+                const compare = (v1, v2) => {
+                    const p1 = parseV(v1);
+                    const p2 = parseV(v2);
+                    // Compare up to 4 parts (MAJOR.MINOR.PATCH.BUILD)
+                    for (let i = 0; i < 4; i++) {
+                        const n1 = p1[i] || 0;
+                        const n2 = p2[i] || 0;
+                        if (n1 > n2) return 1;
+                        if (n1 < n2) return -1;
                     }
                     return 0;
                 };
 
                 // Filter 1: History is ONLY versions <= current
-                const history = allTags.filter(t => compareVersions(t.version, currentVersion) <= 0);
+                const history = allTags.filter(t => compare(t.version, currentVersion) <= 0);
 
                 // Filter 2: Latest is the absolute newest tag available (could be > current)
                 const latestFromRemote = allTags[0] || null;
-                const needsUpdate = latestFromRemote ? (compareVersions(latestFromRemote.version, currentVersion) > 0) : false;
+                const needsUpdate = latestFromRemote ? (compare(latestFromRemote.version, currentVersion) > 0) : false;
 
                 res.json({
                     current: currentVersion,