diff --git a/docs/baron-sso-reference-source-policy-2026-07-02.md b/docs/baron-sso-reference-source-policy-2026-07-02.md index 74d7493..b8d78d8 100644 --- a/docs/baron-sso-reference-source-policy-2026-07-02.md +++ b/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 추가가 필요해지면 그때 별도 작업 브랜치를 만든다. - -예: - -```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 변경과 섞지 않는다. diff --git a/docs/tdc114plus-work-progress-timetable-2026-07-02.md b/docs/tdc114plus-work-progress-timetable-2026-07-02.md index 0eec7d7..e256237 100644 --- a/docs/tdc114plus-work-progress-timetable-2026-07-02.md +++ b/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` | -| 11 | API 계약 정리 | 대기 | Baron SSO 로그인 API, orgFront 직원/조직 API 계약 정리 | API 계약 문서 | +| 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 계약 문서 | | 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-1 | 이후 | API 계약 확정 | SSO 로그인 API, orgFront 직원/조직 API, 응답 필드, 오류 정책 정리 | 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 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 생성 결과는 다음 커밋에서 추가 반영한다.