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
15	Mock 데이터 기반 화면 확장	대기	직원목록, 검색, 가족사 필터, 조직도 화면을 mock 데이터로 우선 구현	동작 가능한 UI
16	Baron SSO 로그인 연동	대기	전화번호 입력 후 SSO 등록 인원 여부 확인 연동	로그인 client/repository
17	orgFront 데이터 연동	대기	직원/조직 데이터 API 연동	directory/organization client
18	전화/문자 액션 구현	대기	`url_launcher` 기반 전화걸기/문자보내기 구현	연락 액션
19	즐겨찾기 구현	대기	1차 로컬 저장 기반 즐겨찾기 구현	favorites feature
20	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 정의	model 초안
Phase 3	이후	Mock 기반 1차 UI 완성	직원목록, 검색, 가족사 필터, 조직도, 상세 화면 구성	API 없이 화면 흐름 확인 가능
Phase 4	이후	실제 API 연동	SSO 로그인, orgFront 직원/조직 데이터 연동	등록 사용자 로그인 및 직원목록 조회
Phase 5	이후	핵심 액션 완성	전화걸기, 문자보내기, 즐겨찾기 저장	1차 기본 기능 수동 검증
Phase 6	이후	빌드/배포 준비	Android debug APK, README 실행법, 잔여 이슈 정리	APK 빌드 성공

4. 다음 작업 판단

현재 다음 작업은 Phase 2-3: Dart 데이터 모델 설계이다.

공식 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/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

우선 정리할 내용:

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

API 계약 확정본:

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

1차 구현 기준 확정사항:

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

5. 신규 작업 추가 규칙

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

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

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

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

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

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

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

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

현재 문서 기준 다음 작업은 Phase 2-3: Dart 데이터 모델 설계이다.

8.7 KiB Raw Blame History