9.1 KiB
9.1 KiB
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.mddocs/tdc114plus-testing-policy-2026-07-02.mddocs/baron-sso-reference-source-policy-2026-07-02.mddocs/references/baron-safe-policies/api-contract.mddocs/references/baron-safe-policies/runtime-config.mddocs/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 3: Mock 기반 1차 UI 완성이다.