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

tdc114plus Baron SSO 참조 소스 기준

작성일: 2026-07-02

목적: tdc114plus 개발 중 Baron SSO, orgFront, backend API, 로그인 흐름을 확인할 때 어떤 Baron SSO 저장소와 브랜치를 기준으로 삼을지 정리한다.

1. 결론

tdc114plus 개발 시 참조할 원본 Baron SSO 코드는 공식 Gitea 저장소의 dev 브랜치를 기준으로 한다.

항목	기준
공식 원격	https://gitea.hmac.kr/baron/baron-sso.git
로컬 remote 이름	origin
기준 브랜치	origin/dev
현재 fetch 기준 최신 commit	77b1a573 admin 계정 화면 누락 수정
개인 fork remote	fork=https://kevin@gitea.hmac.kr/kevin/baron-sso.git
개인 fork 용도	개인 작업/실험/PR 준비용. tdc114plus 공식 참조 기준으로 삼지 않음

즉, tdc114plus가 바로 바라볼 기준은 Gitea의 공식 Baron SSO 저장소이며, 그중 origin/dev를 최신 기준으로 본다.

2. 현재 로컬 Baron SSO 상태

현재 /home/ubuntu/workspace/baron-sso는 아래 상태이다.

항목	상태
현재 브랜치	feature/baron-sso-local-moon
tracking	fork/feature/baron-sso-local-moon
공식 최신 브랜치	origin/dev
로컬 dev 상태	origin/dev 대비 ahead/behind가 있어 직접 참조 기준으로 쓰기 애매함
작업트리 상태	수정/미추적 파일이 많음

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

3. 권장 참조 방식

3.1 읽기 전용 참조 기준

Baron SSO 소스 확인은 항상 최신 origin/dev 기준으로 한다.

권장 명령:

cd /home/ubuntu/workspace/baron-sso
git fetch origin --prune
git log --oneline -5 origin/dev

특정 파일 확인:

git show origin/dev:orgfront/README.md
git show origin/dev:backend/internal/handler/auth_handler.go

특정 디렉터리 검색이 필요하면 별도 worktree를 만들어 확인한다.

3.2 별도 참조 worktree 권장

현재 baron-sso 작업트리가 더럽기 때문에, 최신 소스 확인용으로 별도 worktree를 만든다.

권장 경로:

/home/ubuntu/workspace/baron-sso-reference-dev

권장 명령:

cd /home/ubuntu/workspace/baron-sso
git fetch origin --prune
git worktree add ../baron-sso-reference-dev origin/dev

이 worktree는 읽기 전용 참조용으로 사용한다.

cd /home/ubuntu/workspace/baron-sso-reference-dev
rg "orgFront|orgfront|phone|login" backend orgfront userfront

4. 기존 브랜치 업데이트 여부

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

이유:

• 현재 feature/baron-sso-local-moon에는 수정 파일과 미추적 파일이 많다.
• tdc114plus 개발은 Baron SSO 코드를 직접 수정하는 단계가 아니라 참조/API 계약 정리 단계이다.
• 기존 브랜치를 merge/rebase하면 tdc114plus와 무관한 충돌 또는 회귀 위험이 생길 수 있다.
• 참조 목적이라면 origin/dev worktree가 더 안전하다.

단, 추후 Baron SSO backend 또는 orgFront에 실제 API 추가가 필요해지면 그때 별도 작업 브랜치를 만든다.

예:

git switch -c feature/tdc114plus-api origin/dev

이 브랜치는 tdc114plus API 추가 작업용으로만 사용하고, 기존 개인 작업 브랜치와 섞지 않는다.

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

우선 확인할 영역:

영역	확인 목적
backend	전화번호 로그인 API, 사용자 조회, 인증 응답 정책
orgfront	조직/직원 데이터 흐름, orgFront API 또는 데이터 구조
userfront	기존 전화번호 로그인 UX, runtime env, auth proxy 호출 방식
docs	API 설계 정책, org chart 정책, 전화번호 로그인 관련 검토 문서

우선 검색 키워드:

orgFront
orgfront
organization
orgchart
phone
phone_number
mobile
login
auth
employee

6. tdc114plus 다음 작업에 미치는 영향

다음 작업인 API 계약 정리는 아래 기준으로 진행한다.

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