tdc114plus/docs/daily-issues/2026-07-03.md

2026-07-03 작업 이슈 및 처리내역

목적

당일 작업 중 실제로 확인한 이슈, 처리 내용, 검증 결과, 남은 후속 작업을 기록한다.

이슈 1. 외부 org-context 직원 필터의 회사 subtree 누락

• 현상:
  • GET /api/v1/tdc114plus/directory/employees?tenantSlug=hanmac 호출 시 최초에는 1명만 반환됐다.
• 원인:
  • 외부 org-context 기준 tenantSlug 필터가 회사 하위 조직 subtree가 아니라 direct match 위주로 처리되고 있었다.
• 처리:
  • Baron backend tdc114plus_handler.go에서 외부 직원 필터를 ancestor/subtree 기준으로 보정했다.
  • 관련 handler test를 추가/보강했다.
• 검증:
  • backend rebuild 후 tenantSlug=hanmac 결과가 total=339로 증가한 것을 실제 API로 확인했다.
• 후속:
  • 실제 앱 초기 범위와 체감 성능 기준으로 추가 정합성 확인이 남아 있다.

이슈 2. 초기 범위를 회사보다 더 좁은 조직 slug로 축소 필요

• 현상:
  • 일부 가족사는 직원 수가 1000명 이상일 수 있어 회사 단위 초기 조회도 무거울 수 있다.
• 판단:
  • 조직도 예시의 name, slug 조합은 팀/부서 단위 조직 slug로 볼 수 있다.
• 처리:
  • 앱에서 로그인 사용자 회사 범위 안에서 자기 전화번호/이름으로 본인을 다시 검색해 실제 조직 slug를 식별하도록 구현했다.
• 검증:
  • 실제 smoke 로그인 사용자 문형석 / +821091365338는 tenantSlug=hanmac 범위 재검색 시 조직 slug is-3, 조직명 IS3으로 식별됐다.
  • tenantSlug=is-3 기준 실제 직원목록은 총 6명으로 확인됐다.
• 후속:
  • 초기 조직 slug 식별 실패 시 회사 slug fallback이 계속 적절한지 추가 확인이 필요하다.

이슈 3. Android emulator integration test의 NDK/CMake license blocker

• 현상:
  • Android integration test 실행 시 ndk;28.2.13676358 license 미승인으로 assembleDebug가 실패했다.
• 처리:
  • scripts/flutter-docker.sh에 Android SDK license 선행 승인 로직을 추가했다.
  • Docker cache 아래 Android SDK licenses, ndk, cmake 디렉터리가 유지되도록 재사용 경로를 활용했다.
• 검증:
  • 재실행 시 NDK/CMake license가 승인되고 실제 설치가 완료됐다.
  • 이후 Android emulator integration test가 끝까지 통과했다.
• 후속:
  • 첫 Android 빌드 시간이 여전히 길어 추가 warm-up 또는 캐시 최적화 여지는 있다.

이슈 4. 홈화면 직원목록 실제 노출 검증

• 목표:
  • 전화번호 로그인 후 홈화면에 본인 팀 소속 직원목록이 실제로 표시되는지 확인한다.
• 처리:
  • integration test에 실제 API 로그인 후 홈화면에서 검색 결과, 문형석, IS3 노출을 확인하는 검증을 추가했다.
• 검증:
  • Android emulator integration test에서 실제 API 로그인 후 직원검색, 검색 결과, 문형석, IS3가 노출되는 것을 확인했다.
  • 결과적으로 홈화면 직원목록 노출 목표를 당일 기준 달성했다.
• 후속:
  • 조직도 탭 표현과 정렬/요약 표시의 세부 UX 검토는 다음 작업 후보로 남는다.

이슈 5. 다음 출근 시 기동 확인 및 복구 절차 필요

• 배경:
  • 퇴근 시 VS Code, 터미널, Android emulator를 모두 종료하면 다음 출근 시 어떤 순서로 기동 확인과 복구를 해야 하는지 빠르게 참고할 문서가 필요하다.
• 처리:
  • docs/checklist_morning_startup_runtime_2026-07-03.md 문서를 추가했다.
• 포함 내용:
  • Baron runtime 확인
  • API smoke 확인
  • Android emulator/device 인식 확인
  • integration test 실행
  • 실패 시 복구 순서
• 후속:
  • 실제 다음 출근 시 이 문서로 재개하면서 부족한 부분이 있으면 보완한다.