# 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 실행
  - 실패 시 복구 순서
- 후속:
  - 실제 다음 출근 시 이 문서로 재개하면서 부족한 부분이 있으면 보완한다.