Update Baron SSO API branch workflow

docs/baron-sso-reference-source-policy-2026-07-02.md

@@ -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 추가가 필요해지면 그때 별도 작업 브랜치를 만든다.
+API 추가 작업은 `baron-sso-tdc114plus-api` worktree의 `feature/tdc114plus-api` 브랜치에서만 진행하고, 기존 개인 작업 브랜치와 섞지 않는다.
-
-예:
-
-```bash
-git switch -c feature/tdc114plus-api origin/dev
-```
-
-이 브랜치는 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 변경과 섞지 않는다.

docs/tdc114plus-work-progress-timetable-2026-07-02.md

@@ -41,8 +41,8 @@
 | 7 | 기본 검증 | 완료 | `flutter analyze`, `flutter test` 통과 확인 | 검증 결과 |
 | 8 | Baron Safe 참고 정책 이관 | 완료 | Baron Safe 진행 시 생성한 개발 정책 관련 md 파일을 참고 폴더로 복사 | `docs/references/baron-safe-policies/` |
 | 9 | Baron SSO 참조 소스 기준 정리 | 완료 | tdc114plus 개발 시 참조할 Baron SSO 원격/브랜치/업데이트 정책 정리 | `docs/baron-sso-reference-source-policy-2026-07-02.md` |
-| 10 | 최신 Baron SSO 참조 worktree 생성 | 다음 작업 | `origin/dev` 기준 읽기 전용 참조 worktree를 생성해 orgFront/backend 확인 준비 | `baron-sso-reference-dev` |
+| 10 | 최신 Baron SSO API 개발 worktree 생성 | 완료 | `origin/dev` 기준 `feature/tdc114plus-api` worktree를 생성해 orgFront/backend 확인 및 API 개발 준비 | `/home/ubuntu/workspace/baron-sso-tdc114plus-api` |
-| 11 | API 계약 정리 | 대기 | Baron SSO 로그인 API, orgFront 직원/조직 API 계약 정리 | API 계약 문서 |
+| 11 | API 계약 정리 | 다음 작업 | Baron SSO 로그인 API, orgFront 직원/조직 API 계약 정리 | API 계약 문서 |
 | 12 | 데이터 모델 설계 | 대기 | 직원, 조직, 가족사, 즐겨찾기 모델 정의 | Dart model |
 | 13 | Mock 데이터 기반 화면 확장 | 대기 | 직원목록, 검색, 가족사 필터, 조직도 화면을 mock 데이터로 우선 구현 | 동작 가능한 UI |
 | 14 | Baron SSO 로그인 연동 | 대기 | 전화번호 입력 후 SSO 등록 인원 여부 확인 연동 | 로그인 client/repository |
@@ -57,8 +57,8 @@
 | --- | --- | --- | --- | --- |
 | Phase 0 | 완료 | 저장소와 개발환경 출발점 확보 | clone, 문서 이관, README, scripts 구성 | Gitea `main` push 완료 |
 | Phase 1 | 완료 | Flutter 앱 실행 골격 확보 | Flutter create, 라우터, 로그인/직원검색 화면 초안 | analyze/test 통과 |
-| Phase 2 | 다음 | Baron SSO 참조 기준 확정 및 API 계약 준비 | 공식 `origin/dev` 기준 확인, 참조 worktree 생성, Baron Safe 참고 정책 확인 | 참조 worktree 및 API 계약 작성 준비 |
+| Phase 2 | 완료 | Baron SSO 참조 기준 확정 및 API 계약 준비 | 공식 `origin/dev` 기준 확인, API 개발 worktree 생성, Baron Safe 참고 정책 확인 | `feature/tdc114plus-api` worktree 생성 |
-| Phase 2-1 | 이후 | API 계약 확정 | SSO 로그인 API, orgFront 직원/조직 API, 응답 필드, 오류 정책 정리 | API 계약 문서 작성 |
+| Phase 2-1 | 다음 | API 계약 확정 | SSO 로그인 API, orgFront 직원/조직 API, 응답 필드, 오류 정책 정리 | API 계약 문서 작성 |
 | Phase 3 | 이후 | Mock 기반 1차 UI 완성 | 직원목록, 검색, 가족사 필터, 조직도, 상세 화면 구성 | API 없이 화면 흐름 확인 가능 |
 | Phase 4 | 이후 | 실제 API 연동 | SSO 로그인, orgFront 직원/조직 데이터 연동 | 등록 사용자 로그인 및 직원목록 조회 |
 | Phase 5 | 이후 | 핵심 액션 완성 | 전화걸기, 문자보내기, 즐겨찾기 저장 | 1차 기본 기능 수동 검증 |
@@ -66,9 +66,9 @@
 
 ## 4. 다음 작업 판단
 
-현재 다음 작업은 **Phase 2: 최신 Baron SSO 참조 worktree 생성**이다.
+현재 다음 작업은 **Phase 2-1: API 계약 확정**이다.
 
-API 계약 정리 전, 공식 Baron SSO `origin/dev` 기준의 읽기 전용 참조 worktree를 만든다. 기존 `baron-sso` 작업 브랜치는 수정/미추적 파일이 많으므로 직접 merge/rebase하지 않는다.
+공식 Baron SSO `origin/dev` 기준의 API 개발용 worktree는 `/home/ubuntu/workspace/baron-sso-tdc114plus-api`에 생성 완료했다. 기존 `baron-sso` 작업 브랜치는 수정/미추적 파일이 많으므로 직접 merge/rebase하지 않는다.
 
 API 계약 정리 시 아래 문서를 우선 참고한다.
 
@@ -103,10 +103,11 @@ API 계약 정리 시 아래 문서를 우선 참고한다.
 현재 `tdc114plus` 원격 저장소에 반영된 커밋:
 
 ```text
+334f412 Document Baron SSO reference source policy
 7486a60 Import Baron Safe policy references
 5370b55 Add work progress timetable
 86a6193 Add Flutter app skeleton
 0e26060 Initialize tdc114plus project docs
 ```
 
-Baron SSO 참조 소스 기준 문서는 다음 커밋에서 추가 반영한다.
+Baron SSO API 개발 worktree 생성 결과는 다음 커밋에서 추가 반영한다.