Stabilize auth flow and profile images
This commit is contained in:
Codex
@@ -0,0 +1,189 @@
|
||||
# 2026-07-15 업무 인계 메모
|
||||
|
||||
작성 시각: 2026-07-15 KST
|
||||
|
||||
## 오늘 최종 상태
|
||||
|
||||
- 실기기 직원검색 화면에서 실제 프로필 사진 노출을 확인했다.
|
||||
- 현재 프로필 이미지 정책은 아래 순서로 정리된 상태다.
|
||||
1. 네이버웍스 프로필 사진
|
||||
2. Baron SSO `members[].id` 기준 UUID 파일명 이미지
|
||||
3. 앱 기본 아바타
|
||||
- `tdc114plus-auth`의 `GET /api/v1/profile-image`는 `NAVER_WORKS -> BARON_UUID_R2 -> DEFAULT` 순서로 동작하도록 정리했다.
|
||||
- 앱은 `GET /api/v1/profile-image`를 우선 호출하고, 응답 실패 또는 미발견 시 `https://baroncs.co.kr/employee_img/{uuid}.jpg` 경로를 보조 fallback으로 사용하도록 보강했다.
|
||||
- 실기기 캡처 기준으로 직원목록의 여러 사용자가 기본 이니셜 원이 아니라 실제 사진으로 표시되는 것을 확인했다.
|
||||
|
||||
## 오늘 진행한 핵심 작업
|
||||
|
||||
### 1. 네이버웍스 1순위 경로 실검증
|
||||
|
||||
확인 내용:
|
||||
|
||||
- 서비스 계정 자격값을 최신값으로 다시 반영했다.
|
||||
- 토큰 발급이 실제로 성공하는지 재검증했다.
|
||||
- `GET /users/{userId}` 와 `GET /users/{userId}/photo`를 실제 호출해 `302`, `404` 동작을 다시 확인했다.
|
||||
|
||||
확인 결과:
|
||||
|
||||
- `thlee3@samaneng.com`
|
||||
- 프로필 조회 `HTTP 200`
|
||||
- 사진 조회 `HTTP 302`
|
||||
- `khkang@samaneng.com`
|
||||
- 프로필 조회 `HTTP 200`
|
||||
- 사진 조회 `HTTP 404`
|
||||
|
||||
의미:
|
||||
|
||||
- 네이버웍스 사진이 있는 사용자는 1순위 경로로 바로 쓸 수 있다.
|
||||
- 네이버웍스 사진이 없는 사용자는 2순위 UUID 이미지로 내려가면 된다.
|
||||
|
||||
### 2. Baron UUID 기반 2순위 경로 재확정
|
||||
|
||||
확인 내용:
|
||||
|
||||
- `org-context` 실응답의 `members[].id`가 실제 UUID 형식인지 다시 확인했다.
|
||||
- 기존 CSV와 가족사 전체 응답을 대조한 매핑 결과를 기준으로 UUID 파일명 정책을 유지하기로 정리했다.
|
||||
- 외부 공개 경로는 `https://baroncs.co.kr/employee_img/{uuid}.jpg` 규칙으로 본다.
|
||||
|
||||
현재 판단:
|
||||
|
||||
- 2순위 식별자는 이메일 local-part나 해시명이 아니라 Baron UUID로 보는 것이 가장 안정적이다.
|
||||
- 프로필 이미지 전용 DB는 운영 기본안으로 채택하지 않고 보류 대안으로만 남긴다.
|
||||
|
||||
### 3. `tdc114plus-auth` 프로필 이미지 endpoint 보강
|
||||
|
||||
오늘 반영한 내용:
|
||||
|
||||
- `GET /api/v1/profile-image`에 네이버웍스 1순위 조회를 연결했다.
|
||||
- 네이버웍스에서 사진이 없으면 Baron UUID 기준 공개 이미지 경로를 2순위로 판단하게 정리했다.
|
||||
- 기존 PostgreSQL 매핑 경로는 최후 예비안 수준으로만 남겼다.
|
||||
|
||||
실검증 결과:
|
||||
|
||||
- `GET /api/v1/profile-image?email=thlee3@samaneng.com`
|
||||
- `found=true`
|
||||
- `source=NAVER_WORKS`
|
||||
- `GET /api/v1/profile-image?email=khkang@samaneng.com`
|
||||
- `found=true`
|
||||
- `source=BARON_UUID_R2`
|
||||
|
||||
의미:
|
||||
|
||||
- 서버 레벨에서는 1순위/2순위 fallback이 실제 응답으로 이미 확인된 상태다.
|
||||
|
||||
### 4. 앱 프로필 이미지 resolver 보강
|
||||
|
||||
오늘 반영한 내용:
|
||||
|
||||
- 앱은 다시 `tdc114plus-auth /api/v1/profile-image`를 우선 호출하도록 정리했다.
|
||||
- 응답 실패, 미발견, 또는 세션 문제 상황에서는 UUID 형식 `employee.id`가 있으면 공개 UUID 이미지 경로를 직접 fallback 하도록 보강했다.
|
||||
- 관련 단위 테스트를 추가하고 통과시켰다.
|
||||
|
||||
테스트 결과:
|
||||
|
||||
- `app/test/directory/profile_image_api_client_test.dart`
|
||||
- auth endpoint 경유 성공
|
||||
- 이메일 없음 시 기본 null 처리
|
||||
- auth 미발견 시 UUID 공개 경로 fallback
|
||||
- 테스트 통과 확인
|
||||
|
||||
### 5. 실기기 반영 및 화면 확인
|
||||
|
||||
실행 내용:
|
||||
|
||||
- auth 서버 기동 상태 확인
|
||||
- APK 빌드 및 실기기 설치
|
||||
- 공기계에서 직원검색 화면 재진입
|
||||
- 실기기 화면 캡처로 실제 사진 표시 여부 확인
|
||||
|
||||
최종 확인:
|
||||
|
||||
- 직원검색 목록에서 여러 사용자 사진이 실제로 표시됨
|
||||
- 오늘 목표였던 “실기기에서 사진 뜨는지 확인”은 완료
|
||||
|
||||
## 오늘 발생한 보조 이슈
|
||||
|
||||
### 1. 실기기 재실행 중 bootstrap 일시 실패
|
||||
|
||||
현상:
|
||||
|
||||
- 일부 재실행 구간에서 `127.0.0.1:5000` bootstrap 연결 실패 메시지가 한 차례 있었다.
|
||||
|
||||
현재 판단:
|
||||
|
||||
- 이후 권한 포함 재실행에서는 정상 bootstrap 후 앱이 다시 올라왔다.
|
||||
- 오늘 최종 결과는 실기기 사진 표시 성공으로 본다.
|
||||
|
||||
### 2. Docker/ADB 권한 및 대기 시간 이슈
|
||||
|
||||
현상:
|
||||
|
||||
- 일부 재실행 또는 조회 명령은 Docker 권한/ADB 응답 지연 때문에 중간 확인이 매끄럽지 않았다.
|
||||
|
||||
현재 판단:
|
||||
|
||||
- 기능 자체의 blocker는 아니었다.
|
||||
- 최종적으로 실기기 캡처까지 확보했으므로 오늘 작업 결론에는 영향 없다.
|
||||
|
||||
## 오늘 변경 및 반영한 주요 파일
|
||||
|
||||
- `app/lib/src/features/directory/data/profile_image_api_client.dart`
|
||||
- auth endpoint 우선 호출
|
||||
- UUID 직접 fallback 추가
|
||||
- debug 로그 보강
|
||||
|
||||
- `app/test/directory/profile_image_api_client_test.dart`
|
||||
- UUID fallback 관련 테스트 추가
|
||||
|
||||
- `scripts/start-auth-server.sh`
|
||||
- 네이버웍스 env를 함께 읽어 auth 서버 기동 시 반영되도록 정리
|
||||
|
||||
- `docs/00_guide_tdc114plus_profile_image_identifier_mapping_2026-07-14.md`
|
||||
- 오늘 실검증 결과와 실기기 성공 결과 반영
|
||||
|
||||
- `docs/00_guide_tdc114plus_work_progress_timetable_2026-07-02.md`
|
||||
- 오늘 진행 상태와 다음 검증 포인트 반영
|
||||
|
||||
## 내일 바로 이어서 볼 항목
|
||||
|
||||
1. 현재 화면에 뜬 각 프로필 사진이 `NAVER_WORKS`인지 `BARON_UUID_R2`인지 source별로 구분 검증한다.
|
||||
2. 직원검색뿐 아니라 직원 상세/조직도 화면에서도 같은 규칙으로 사진이 표시되는지 확인한다.
|
||||
3. `DEFAULT` 케이스도 샘플로 잡아 기본 아바타 fallback이 자연스러운지 확인한다.
|
||||
4. 필요 시 프로필 이미지 관련 debug 로그를 더 짧게 정리하거나 제거한다.
|
||||
|
||||
## 내일 업무 시작 순서
|
||||
|
||||
1. auth 서버 상태 확인
|
||||
|
||||
```bash
|
||||
curl -fsSL --max-time 5 http://127.0.0.1:5001/health
|
||||
```
|
||||
|
||||
2. 실기기 reverse 상태 확인
|
||||
|
||||
```bash
|
||||
ADB_SERVER_SOCKET=tcp:172.21.128.1:5037 ./scripts/flutter-docker.sh adb -s R5CT42QTCNX reverse --list
|
||||
```
|
||||
|
||||
3. 필요 시 auth 서버 재기동
|
||||
|
||||
```bash
|
||||
./scripts/start-auth-server.sh --restart --env-file=/home/ubuntu/workspace/tdc114plus/scripts/.env.android-device.local
|
||||
```
|
||||
|
||||
4. 필요 시 실기기 앱 재실행
|
||||
|
||||
```bash
|
||||
ADB_SERVER_SOCKET=tcp:172.21.128.1:5037 TDC114_FLUTTER_DEVICE_ID=R5CT42QTCNX TDC114_SMOKE_ENV_FILE=scripts/.env.android-device.local ./scripts/manual-postlogin-run.sh
|
||||
```
|
||||
|
||||
5. 첫 확인 포인트
|
||||
- 직원검색 목록 진입
|
||||
- 사진이 계속 노출되는지 확인
|
||||
- source별 구분 검증 대상으로 사용자 샘플 확보
|
||||
|
||||
## 오늘 결론
|
||||
|
||||
- 오늘 작업의 핵심 목표였던 “실기기에서 프로필 사진이 실제로 뜨는지 확인”은 완료했다.
|
||||
- 현재 구조는 `네이버웍스 -> Baron UUID 이미지 -> 기본 아바타` 정책과 실제 코드/실기기 화면이 서로 맞물리는 상태다.
|
||||
- 내일은 새로운 구현보다, 오늘 붙인 구조를 source별로 더 명확히 검증하고 화면 범위를 넓히는 단계로 이어가면 된다.
|
||||
Reference in New Issue
Block a user