운영 문서 최신화: 4자리 버전 관리 체계 지침 반영

This commit is contained in:
choibk 2026-01-25 01:27:48 +09:00
parent cd61726b8e
commit dc68ccd7b9

View File

@ -6,7 +6,7 @@
## 1. 태그 메시지 작성 규칙 (Changelog 자동 생성) ## 1. 태그 메시지 작성 규칙 (Changelog 자동 생성)
플랫폼의 업데이트 엔진은 태그 메시지의 **머리말(Prefix)**과 **리스트 기호(`-`, `*`)**를 분석하여 관리 페이지의 업데이트 히스토리를 생성합니다. 플랫폼의 업데이트 엔진은 태그 메시지의 **머리말(Prefix)**과 **리스트 기호(`-`, `*`)**를 분석하여 관리 페이지의 업데이트 히스토리와 배너를 생성합니다. 상세 버전 번호 부여 방식은 `docs/version manage.md`의 규정을 따릅니다.
### 📋 메시지 구조 ### 📋 메시지 구조
```text ```text
@ -36,22 +36,22 @@
```powershell ```powershell
# [위치: d:\antigravity\smartims (루트)] # [위치: d:\antigravity\smartims (루트)]
git add . git add .
git commit -m "릴리즈 준비: v0.4.0 패치" git commit -m "릴리즈 준비: v0.4.0.0 패치"
git push origin main git push origin main
``` ```
### STEP 2: 어노테이티드 태그(Annotated Tag) 생성 ### STEP 2: 어노테이티드 태그(Annotated Tag) 생성
```powershell ```powershell
# [위치: d:\antigravity\smartims (루트)] # [위치: d:\antigravity\smartims (루트)]
git tag -a v0.4.0 -m "[PATCH] 시스템 안정화 패치 git tag -a v0.4.0.0 -m "[PATCH] 시스템 안정화 패치
- 원격 태그 동기화 로직 강화 - 4자리 버전 관리 체계(MAJOR.MINOR.PATCH.BUILD) 도입
- API 캐시 방지 타임스탬프 도입" - 원격 태그 동기화 로직 및 UI 가시성 강화"
``` ```
### STEP 3: 원격 저장소에 태그 푸시 ### STEP 3: 원격 저장소에 태그 푸시
```powershell ```powershell
# [위치: d:\antigravity\smartims (루트)] # [위치: d:\antigravity\smartims (루트)]
git push origin v0.4.0 git push origin v0.4.0.0
``` ```
--- ---
@ -94,9 +94,9 @@ git ls-remote --tags origin
# 2. 로컬 태그 정보를 원격과 완벽히 일치 (강제 동기화) # 2. 로컬 태그 정보를 원격과 완벽히 일치 (강제 동기화)
git fetch origin +refs/tags/*:refs/tags/* --force --prune --prune-tags git fetch origin +refs/tags/*:refs/tags/* --force --prune --prune-tags
# 3. 목표 버전으로 소스 코드 강제 전환 (예: v0.4.0) # 3. 목표 버전으로 소스 코드 강제 전환 (예: v0.4.0.0)
# [주의] 이 명령 실행 시 추적되지 않은 소스 수정사항은 사라집니다. # [주의] 이 명령 실행 시 추적되지 않은 소스 수정사항은 사라집니다.
git checkout -f v0.4.0 git checkout -f v0.4.0.0
``` ```
--- ---
@ -145,8 +145,8 @@ tar -xzvf /volume1/backup/smart_ims/backup_images_[날짜].tar.gz -C ./
* **원격 태그 강제 덮어쓰기 (메시지 수정 시)**: * **원격 태그 강제 덮어쓰기 (메시지 수정 시)**:
```powershell ```powershell
# [위치: 개발 PC 루트] # [위치: 개발 PC 루트]
git tag -a v0.4.0 -f -m "수정된 메시지..." git tag -a v0.4.0.0 -f -m "수정된 메시지..."
git push origin v0.4.0 -f git push origin v0.4.0.0 -f
``` ```
--- ---