Update Baron SSO API branch workflow

2026-07-02 11:22:29 +09:00
parent 334f4120e6
commit 9cdc311d16
2 changed files with 47 additions and 33 deletions
@@ -13,7 +13,7 @@
 | 공식 원격 | `https://gitea.hmac.kr/baron/baron-sso.git` |
 | 로컬 remote 이름 | `origin` |
 | 기준 브랜치 | `origin/dev` |
-| 현재 fetch 기준 최신 commit | `77b1a573 admin 계정 화면 누락 수정` |
+| 현재 fetch 기준 최신 commit | `3b253e05 Merge pull request 'feature/connect-ui' (#1374) from feature/connect-ui into dev` |
 | 개인 fork remote | `fork=https://kevin@gitea.hmac.kr/kevin/baron-sso.git` |
 | 개인 fork 용도 | 개인 작업/실험/PR 준비용. tdc114plus 공식 참조 기준으로 삼지 않음 |

@@ -33,11 +33,11 @@

 따라서 현재 작업 중인 `feature/baron-sso-local-moon` 브랜치를 직접 최신화해서 참조용으로 쓰는 것은 권장하지 않는다.

-## 3. 권장 참조 방식
+## 3. 권장 개발 방식

-### 3.1 읽기 전용 참조 기준
+### 3.1 최신 Baron SSO 기준

-Baron SSO 소스 확인은 항상 최신 `origin/dev` 기준으로 한다.
+Baron SSO 소스 확인과 API 개발은 항상 최신 `origin/dev` 기준에서 시작한다.

 권장 명령:

@@ -54,53 +54,66 @@ git show origin/dev:orgfront/README.md
 git show origin/dev:backend/internal/handler/auth_handler.go
 ```

-특정 디렉터리 검색이 필요하면 별도 worktree를 만들어 확인한다.
+특정 파일을 간단히 확인할 때는 위 방식으로 충분하다. 다만 `tdc114plus` 개발 중 Baron SSO backend 또는 orgFront에 실제 API 파일을 생성해야 할 가능성이 있으므로, 단순 읽기 전용 참조보다 별도 개발 worktree를 사용하는 것을 기본안으로 둔다.

-### 3.2 별도 참조 worktree 권장
+### 3.2 Baron SSO API 개발용 worktree

-현재 `baron-sso` 작업트리가 더럽기 때문에, 최신 소스 확인용으로 별도 worktree를 만든다.
+현재 `baron-sso` 작업트리가 더럽기 때문에, 기존 브랜치를 최신화하지 않고 최신 `origin/dev`에서 별도 API 개발용 worktree를 만든다.

-권장 경로:
+생성 경로:

 ```text
-/home/ubuntu/workspace/baron-sso-reference-dev
+/home/ubuntu/workspace/baron-sso-tdc114plus-api
 ```

-권장 명령:
+생성 명령:

 ```bash
 cd /home/ubuntu/workspace/baron-sso
 git fetch origin --prune
-git worktree add ../baron-sso-reference-dev origin/dev
+git worktree add -b feature/tdc114plus-api ../baron-sso-tdc114plus-api origin/dev
 ```

-이 worktree는 읽기 전용 참조용으로 사용한다.
+현재 생성 상태:
+
+| 항목 | 값 |
+| --- | --- |
+| worktree 경로 | `/home/ubuntu/workspace/baron-sso-tdc114plus-api` |
+| 브랜치 | `feature/tdc114plus-api` |
+| 시작 기준 | `origin/dev` |
+| 시작 commit | `3b253e05 Merge pull request 'feature/connect-ui' (#1374) from feature/connect-ui into dev` |
+
+이 worktree는 `tdc114plus` 연동을 위한 Baron SSO API 계약 확인, backend/orgFront 코드 분석, 필요한 API 파일 추가 작업에 사용한다.

 ```bash
-cd /home/ubuntu/workspace/baron-sso-reference-dev
+cd /home/ubuntu/workspace/baron-sso-tdc114plus-api
 rg "orgFront|orgfront|phone|login" backend orgfront userfront
 ```

+### 3.3 push 기준
+
+Baron SSO API 개발 브랜치는 공식 `origin/dev`에서 시작하되, 최초 push는 개인 fork 또는 팀이 지정한 feature remote로 진행한다.
+
+권장 기본안:
+
+```bash
+git push -u fork feature/tdc114plus-api
+```
+
+공식 저장소에 직접 feature branch를 올릴지는 팀 권한/운영 기준을 확인한 뒤 결정한다.
+
 ## 4. 기존 브랜치 업데이트 여부

-기존 작업 브랜치를 최신 Baron SSO 소스로 업데이트하는 것은 지금 단계에서는 비권장이다.
+기존 작업 브랜치를 최신 Baron SSO 소스로 업데이트하는 것은 비권장이다.

 이유:

 - 현재 `feature/baron-sso-local-moon`에는 수정 파일과 미추적 파일이 많다.
- tdc114plus 개발은 Baron SSO 코드를 직접 수정하는 단계가 아니라 참조/API 계약 정리 단계이다.
+- tdc114plus 개발은 Baron SSO 코드 확인과 API 추가가 필요할 수 있으나, 그 작업은 별도 `feature/tdc114plus-api` 브랜치에서 진행하는 것이 안전하다.
 - 기존 브랜치를 merge/rebase하면 tdc114plus와 무관한 충돌 또는 회귀 위험이 생길 수 있다.
- 참조 목적이라면 `origin/dev` worktree가 더 안전하다.
+- 참조 및 API 추가 목적이라면 `origin/dev` 기반 별도 worktree가 더 안전하다.

-단, 추후 Baron SSO backend 또는 orgFront에 실제 API 추가가 필요해지면 그때 별도 작업 브랜치를 만든다.
-
-예:
-
-```bash
-git switch -c feature/tdc114plus-api origin/dev
-```
-
-이 브랜치는 tdc114plus API 추가 작업용으로만 사용하고, 기존 개인 작업 브랜치와 섞지 않는다.
+API 추가 작업은 `baron-sso-tdc114plus-api` worktree의 `feature/tdc114plus-api` 브랜치에서만 진행하고, 기존 개인 작업 브랜치와 섞지 않는다.

 ## 5. tdc114plus 개발 중 Baron SSO 확인 대상

@@ -135,5 +148,5 @@ employee
 1. 최신 `origin/dev` Baron SSO를 참조한다.
 2. 기존 작업 브랜치는 건드리지 않는다.
 3. Baron SSO 소스 수정이 필요한 경우에는 먼저 API 계약 문서에 필요성을 적는다.
-4. 실제 Baron SSO 수정은 별도 브랜치 `feature/tdc114plus-api` 등으로 분리한다.
+4. 실제 Baron SSO 수정은 `/home/ubuntu/workspace/baron-sso-tdc114plus-api`의 `feature/tdc114plus-api`에서 진행한다.
 5. tdc114plus 앱 저장소에는 API client와 모델만 구현하고, Baron SSO backend 변경과 섞지 않는다.