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	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 공식 참조 기준으로 삼지 않음

즉, 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 기준

Baron SSO 소스 확인과 API 개발은 항상 최신 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

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

3.2 Baron SSO API 개발용 worktree

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

생성 경로:

/home/ubuntu/workspace/baron-sso-tdc114plus-api

생성 명령:

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

현재 생성 상태:

항목	값
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 파일 추가 작업에 사용한다.

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로 진행한다.

권장 기본안:

git push -u fork feature/tdc114plus-api

공식 저장소에 직접 feature branch를 올릴지는 팀 권한/운영 기준을 확인한 뒤 결정한다.

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

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

이유:

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

API 추가 작업은 baron-sso-tdc114plus-api worktree의 feature/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 수정은 /home/ubuntu/workspace/baron-sso-tdc114plus-api의 feature/tdc114plus-api에서 진행한다.
5. tdc114plus 앱 저장소에는 API client와 모델만 구현하고, Baron SSO backend 변경과 섞지 않는다.