vpd-permission-poc/docs/design/704-smilegate-branch-isolation/README.md

설계서: Smilegate 전용 브랜치 분리

추적성

• Redmine: #704 [Release] Smilegate 전용 브랜치 분리
• 관련 이슈: #703 [Smilegate] 백오피스 잔여 UI 전환 및 운영 검증
• 작업 경로: /Users/joungminko/claude-workspace/vpd-smilegate-rebrand
• 원격: https://gittea.cloud-handson.com/joungmin/vpd-permission-poc.git
• 상태: Draft

프로젝트 개요

vpd-permission-poc은 Spring Boot VPD 관리 백오피스를 포함한다. HMM과 Smilegate 데모는 현재 같은 원격 저장소를 사용하지만, 고객별 화면·데이터 모델·배포 기준은 분리돼야 한다.

목표

Smilegate 작업본을 원격 smilegate 브랜치로 분리한다. HMM은 기존 main 브랜치를 그대로 사용하고, Smilegate 변경은 smilegate 브랜치만 기준으로 커밋·푸시·배포한다.

범위

1. detached HEAD 상태의 Smilegate worktree에서 smilegate 브랜치를 생성한다.
2. origin/smilegate를 생성하고 현재 worktree의 upstream으로 설정한다.
3. #703의 Smilegate 전용 설계서와 UI 변경만 smilegate 브랜치에 기록한다.
4. HMM 작업본, origin/main, 다른 worktree의 파일과 HEAD를 변경하지 않는다.

비범위

• HMM의 로컬 수정·브랜치·배포 변경
• 기존 main의 이력 재작성 또는 강제 푸시
• 원격 저장소를 새로 생성하거나 삭제하는 작업

검증 기준

1. git branch --show-current은 Smilegate worktree에서 smilegate를 반환한다.
2. git rev-parse --abbrev-ref @{u}는 origin/smilegate를 반환한다.
3. origin/main의 커밋 ID는 분리 전후 동일하다.
4. HMM 작업본의 status와 HEAD는 분리 작업으로 변경되지 않는다.

운영 규칙

• Smilegate 배포는 origin/smilegate의 검증된 커밋만 사용한다.
• HMM 변경은 main 또는 HMM 전용 작업 경로에서만 수행한다.
• 공통 기반을 변경해야 하면 두 고객 브랜치에 적용하기 전에 영향 범위를 별도 이슈로 검토한다.