# tdc114plus 작업진행 절차 및 타임테이블

작성일: 2026-07-02
관리 원칙: 신규 작업이 발생하면 본 문서의 작업 목록과 타임테이블을 수정/추가하여 최신 상태로 유지한다.

## 1. 현재 기준

`tdc114plus`는 Baron SSO 등록 사용자를 대상으로 하는 직원검색/조직도 모바일 앱이다.

1차 개발은 아래 기본 기능에 집중한다.

- Baron SSO 전화번호 로그인
- Baron SSO 등록 사용자만 앱 사용 허용
- Baron SSO `orgFront` 기반 개인/조직 정보 연계
- 직원검색
- 전화번호검색
- 가족사 필터
- 조직도
- 직원목록
- 전화걸기
- 문자보내기
- 즐겨찾기

1차 보류 기능은 아래와 같다.

- 공지사항
- 전자결재
- 수신전화식별
- 수신팝업

## 2. 작업진행 절차

| 순서 | 단계 | 상태 | 작업 내용 | 산출물 |
| --- | --- | --- | --- | --- |
| 1 | 저장소 초기화 | 완료 | Gitea `tdc114plus` 저장소 clone, `main` 브랜치 생성, 초기 문서/스크립트 구성 | 초기 커밋 |
| 2 | 문서 이관 | 완료 | Baron SSO에 보관한 신규 앱 판단 문서와 개발환경 구성 문서를 `tdc114plus/docs/`로 이관 | `docs/*.md` |
| 3 | Flutter 앱 골격 생성 | 완료 | `app/` 하위에 Android/iOS Flutter 프로젝트 생성 | Flutter 기본 프로젝트 |
| 4 | Baron Safe식 기본 구조 반영 | 완료 | `core`, `features`, `shared` 방향의 기본 구조와 라우팅/상태관리 의존성 추가 | 앱 구조 초안 |
| 5 | 기본 화면 뼈대 구성 | 완료 | Baron SSO 전화번호 로그인 화면, 직원검색 홈 화면 초안 구성 | 로그인/직원검색 화면 |
| 6 | Docker Flutter 실행환경 구성 | 완료 | 로컬 Flutter 부재 대응용 Docker Flutter 스크립트 구성 | `scripts/flutter-docker.sh` |
| 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 API 개발 worktree 생성 | 완료 | `origin/dev` 기준 `feature/tdc114plus-api` worktree를 생성해 orgFront/backend 확인 및 API 개발 준비 | `/home/ubuntu/workspace/baron-sso-tdc114plus-api` |
| 11 | tdc114plus 개발 정책 정리 | 완료 | Baron SSO API 생성 우선 원칙, VS Code 기반 AI 개발 방식, Flutter/플랫폼 구현 원칙 정리 | `docs/tdc114plus-development-policy-2026-07-02.md` |
| 12 | API 계약 정리 | 완료 | Baron SSO 로그인 API, orgFront 직원/조직 API 계약 정리 | `docs/tdc114plus-api-contract-2026-07-02.md` |
| 13 | API 계약 검토 및 확정 | 완료 | API 계약 초안의 추가 확인사항 검토 후 1차 구현 기준 확정 | `docs/tdc114plus-api-contract-2026-07-02.md` |
| 14 | 데이터 모델 설계 | 완료 | 직원, 조직, 가족사, 즐겨찾기 모델 정의 | Dart model 및 model test |
| 15 | 테스트 정책 정식화 | 완료 | AI testing 참고 초안을 tdc114plus Flutter 앱/API/보안 중심 테스트 정책으로 재해석 | `docs/tdc114plus-testing-policy-2026-07-02.md` |
| 16 | Mock 데이터 기반 화면 확장 | 다음 작업 | 직원목록, 검색, 가족사 필터, 조직도 화면을 mock 데이터로 우선 구현 | 동작 가능한 UI |
| 17 | Baron SSO 로그인 연동 | 대기 | 전화번호 입력 후 SSO 등록 인원 여부 확인 연동 | 로그인 client/repository |
| 18 | orgFront 데이터 연동 | 대기 | 직원/조직 데이터 API 연동 | directory/organization client |
| 19 | 전화/문자 액션 구현 | 대기 | `url_launcher` 기반 전화걸기/문자보내기 구현 | 연락 액션 |
| 20 | 즐겨찾기 구현 | 대기 | 1차 로컬 저장 기반 즐겨찾기 구현 | favorites feature |
| 21 | Android APK 빌드 확인 | 대기 | debug APK 빌드 및 실행 확인 | APK 산출물 |

## 3. 단계별 타임테이블

| 단계 | 예상 순서 | 목표 | 주요 작업 | 완료 기준 |
| --- | --- | --- | --- | --- |
| Phase 0 | 완료 | 저장소와 개발환경 출발점 확보 | clone, 문서 이관, README, scripts 구성 | Gitea `main` push 완료 |
| Phase 1 | 완료 | Flutter 앱 실행 골격 확보 | Flutter create, 라우터, 로그인/직원검색 화면 초안 | analyze/test 통과 |
| 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-2 | 완료 | API 계약 검토 및 확정 | token 종류, 전화번호 로그인 보안 수준, 개인정보 마스킹 범위, 즐겨찾기 동기화 여부 확인 | API 계약 확정본 |
| Phase 2-3 | 완료 | Dart 데이터 모델 설계 | 확정된 API 계약 기준으로 직원, 조직, 로그인, 즐겨찾기 model 정의 | analyze/test 통과 |
| Phase 2-4 | 완료 | 테스트 정책 정식화 | AI testing 참고 초안을 tdc114plus 적용 기준으로 정리 | `docs/tdc114plus-testing-policy-2026-07-02.md` |
| Phase 3 | 다음 | Mock 기반 1차 UI 완성 | 직원목록, 검색, 가족사 필터, 조직도, 상세 화면 구성 | API 없이 화면 흐름 확인 가능 |
| Phase 4 | 이후 | 실제 API 연동 | SSO 로그인, orgFront 직원/조직 데이터 연동 | 등록 사용자 로그인 및 직원목록 조회 |
| Phase 5 | 이후 | 핵심 액션 완성 | 전화걸기, 문자보내기, 즐겨찾기 저장 | 1차 기본 기능 수동 검증 |
| Phase 6 | 이후 | 빌드/배포 준비 | Android debug APK, README 실행법, 잔여 이슈 정리 | APK 빌드 성공 |

## 4. 다음 작업 판단

현재 다음 작업은 **Phase 3: Mock 기반 1차 UI 완성**이다.

공식 Baron SSO `origin/dev` 기준의 API 개발용 worktree는 `/home/ubuntu/workspace/baron-sso-tdc114plus-api`에 생성 완료했다. 기존 `baron-sso` 작업 브랜치는 수정/미추적 파일이 많으므로 직접 merge/rebase하지 않는다.

API 계약 정리 시 아래 문서를 우선 참고한다.

- `docs/tdc114plus-development-policy-2026-07-02.md`
- `docs/tdc114plus-testing-policy-2026-07-02.md`
- `docs/baron-sso-reference-source-policy-2026-07-02.md`
- `docs/references/baron-safe-policies/api-contract.md`
- `docs/references/baron-safe-policies/runtime-config.md`
- `docs/references/baron-safe-policies/nonstandard-phone-only-login-technical-review-2026-06-23.md`

우선 정리할 내용:

1. Baron SSO 전화번호 로그인 요청/응답 형식
2. SSO 미등록 사용자 응답 정책
3. 로그인 성공 후 앱이 저장하거나 유지해야 할 값
4. orgFront 직원 목록 API 경로와 응답 필드
5. orgFront 조직도 API 경로와 응답 필드
6. 가족사 필터 기준 필드
7. 개인정보 마스킹 또는 권한 필드 필요 여부
8. API 실패/네트워크 오류 시 앱 표시 정책

API 계약 확정본:

- `docs/tdc114plus-api-contract-2026-07-02.md`

1차 구현 기준 확정사항:

1. 전화번호 로그인은 등록자 확인, rate limit, 감사 로그, generic error message 기준으로 구현한다.
2. token은 기존 Baron SSO session token을 1차 재사용한다.
3. 개인정보는 Baron SSO 등록 사용자에게 기본 필드를 노출한다.
4. 즐겨찾기는 1차 앱 로컬 저장으로 구현한다.

## 5. 신규 작업 추가 규칙

새 작업이 발생하면 아래 기준으로 본 문서를 갱신한다.

- 바로 진행할 작업이면 `작업진행 절차`에 상태 `다음 작업`으로 추가한다.
- 후속 검토 작업이면 상태 `대기`로 추가한다.
- 보류 결정된 작업은 1차 범위와 섞지 않고 별도 보류 목록에 추가한다.
- 완료된 작업은 상태를 `완료`로 바꾸고 산출물 위치를 기록한다.
- 일정 또는 우선순위가 바뀌면 `단계별 타임테이블`의 Phase를 수정한다.

## 6. 질문 및 확인 발생 시 처리 순서

작업 진행 중 확인사항이나 질문이 발생하면 아래 순서로 처리한다.

1. 관련 정책/결정/참고 md 파일을 먼저 확인한다.
2. 문서 기준으로 판단 가능한 내용은 문서 기준에 따라 진행한다.
3. 문서 확인 후에도 결정이 필요하거나 정책 충돌이 있으면 사용자에게 질문한다.
4. 질문 시에는 확인한 문서, 판단 지점, 가능한 선택지, 권장안을 함께 제시한다.
5. 사용자 답변으로 새 결정이 생기면 관련 md 파일과 본 타임테이블을 갱신한다.

## 7. 현재 원격 반영 상태 확인

`tdc114plus` 원격 저장소 반영 상태는 아래 명령으로 확인한다.

```bash
git -C /home/ubuntu/workspace/tdc114plus log --oneline origin/main -n 10
git -C /home/ubuntu/workspace/tdc114plus status --short --branch
```

현재 문서 기준 다음 작업은 `Phase 3: Mock 기반 1차 UI 완성`이다.