docs(gift): 선물 UI 계약 리뷰를 기록한다
This commit is contained in:
@@ -0,0 +1,160 @@
|
||||
# Phase 6 Gift UI 계약 코드 리뷰
|
||||
|
||||
## 1. 리뷰 정보
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 리뷰 대상 | Phase 6 / `P6-T1`, `P6-T2`, `P6-R1`~`P6-R3`, `P6-GATE` |
|
||||
| 기준 commit 또는 working tree | 현재 미커밋 working tree |
|
||||
| 리뷰 일자 | `2026-10-02` |
|
||||
| 리뷰어 | Sisyphus, goal Oracle, QA executor, quality Oracle, security Oracle, context reviewer |
|
||||
| 기준 문서 | `prd.md`, `plan-task.md`의 Phase 6 전체 |
|
||||
| 리뷰 상태 | 수정 검증 완료 |
|
||||
|
||||
## 2. 리뷰 목적과 범위
|
||||
|
||||
### 목적
|
||||
|
||||
- `P6-T1` 구현이 승인된 상태·progress·행 카드 계약을 충족하는지 확인한다.
|
||||
- `P6-T2` 운송장 입력·오류·제출 계약과 `P6-GATE` 완료 증거를 확인한다.
|
||||
- 실제 Activity 상태 전이에서 Phase 1~5 동작을 회귀시키지 않는지 확인한다.
|
||||
|
||||
### 포함 범위
|
||||
|
||||
- `GiftDetailModels`, `GiftDetailPresenter`, `GiftDetailActivity`, 상세 행·progress adapter와 layout/resource.
|
||||
- `GiftTrackingPresenter`, `GiftTrackingViewModel`, `GiftTrackingActivity`, 운송장 layout/resource.
|
||||
- `GiftDetailPresenterTest`, `GiftTrackingPresenterTest`, `GiftTrackingViewModelTest`, `GiftNavigationTest`의 관련 local test.
|
||||
- PRD `DEC-013`~`DEC-016`, 9~10장과 Phase 6 Task 전체.
|
||||
|
||||
### 제외 범위
|
||||
|
||||
- 기기·에뮬레이터·`androidTest`·스크린샷·픽셀 QA.
|
||||
|
||||
## 3. 판정 기준
|
||||
|
||||
- Blocker: 보안·데이터 손실 또는 핵심 흐름 불능.
|
||||
- High: 확정 요구사항 위반 또는 주요 회귀.
|
||||
- Medium: 제한된 상태에서 발생하는 기능·복구 문제.
|
||||
- Low: 비핵심 유지보수성 또는 문서 정합성 문제.
|
||||
|
||||
## 4. 검토한 근거
|
||||
|
||||
- 명세 review: APPROVED. 5개 API 이력, 4구간 projection, 종료 상태 progress 비노출, 동적 취소 본문·7행, 84dp/72dp/12dp 행 계약을 코드와 resource에서 확인했다.
|
||||
- quality review: CHANGES REQUESTED. 하단 tracking CTA의 비-content 상태 초기화 누락 1건을 확정했다.
|
||||
- 두 review 모두 read-only 소스 검토이며 테스트 실행 결과를 새로 주장하지 않는다.
|
||||
- 최종 5-lane review: goal PASS, QA PASS, quality PASS, security 최초 INCONCLUSIVE 후 직접 소스 감사 PASS, context는 `REV-P6-REVIEW-001` 수정 전 FAIL에서 P6-R3 재검토 PASS로 전환했다.
|
||||
- 수정 후 직렬 Gate: gift/modal 149개와 전체 1,416개 failures/errors/skipped=0, resource merge·Kotlin compile·ktlint·assembleDebug 성공, diff check exit 0.
|
||||
|
||||
## 5. 발견 사항 요약
|
||||
|
||||
| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|
||||
|---|---|---|---|---|---|
|
||||
| `REV-P6-T1-001` | Medium | 수정 완료 | 상세 재조회 Loading/Error에서 이전 운송장 CTA가 남는다 | `P6-R1` | 완료 |
|
||||
| `REV-P6-REVIEW-001` | Low | 수정 완료 | stale tracking CTA 회귀 test가 View visibility를 직접 assertion한다 | `P6-R3` | 완료 |
|
||||
|
||||
## 6. 발견 사항 상세
|
||||
|
||||
### REV-P6-T1-001 - 상세 재조회 중 이전 운송장 CTA 노출
|
||||
|
||||
- **심각도:** Medium
|
||||
- **상태:** 수정 완료
|
||||
- **관련 요구사항:** `GIFT-ACTION-001`, UI/UX 9.2
|
||||
- **소유 Task:** `P6-R1`
|
||||
|
||||
**관찰 내용**
|
||||
|
||||
`P6-T1`에서 `tracking` 버튼이 `content` 밖의 하단 action bar로 이동했지만 `GiftDetailActivity.render()`는 Loading/Error에서 `content`만 숨긴다. 직전 content에서 표시된 tracking 버튼은 `bind()`가 다시 호출되기 전까지 남는다.
|
||||
|
||||
**근거**
|
||||
|
||||
- `activity_gift_detail.xml`: `tracking`은 `FrameLayout` 밖 최상위 자식이다.
|
||||
- `GiftDetailActivity.kt`: `render()`는 Loading/Error에서 tracking visibility를 초기화하지 않고, `bind()`에서만 표시 여부를 갱신한다.
|
||||
|
||||
**재현 또는 검증 절차**
|
||||
|
||||
1. `trackingRequired=true` content를 표시한다.
|
||||
2. tracking 성공 후 상세 재조회를 지연하거나 오류로 종료한다.
|
||||
3. Loading/Error에서도 이전 tracking CTA가 visible 상태로 남는지 확인한다.
|
||||
4. 요구 결과는 비-content 상태에서 CTA가 숨겨지는 것이다.
|
||||
|
||||
**영향**
|
||||
|
||||
최신 상세를 확인하지 못한 동안 사용자가 이미 처리된 운송장 화면으로 다시 진입할 수 있다.
|
||||
|
||||
**권장 조치**
|
||||
|
||||
`render()`의 비-content 상태에서 tracking CTA를 숨기고, 지연 가능한 상세 응답을 사용하는 local Robolectric 회귀 test를 추가한다.
|
||||
|
||||
**판정 기록**
|
||||
|
||||
- `2026-10-02` - P6-T1 quality review에서 P6-T1의 layout 부모 변경으로 생긴 회귀로 확정했다.
|
||||
- `2026-10-02` - RED 재현, 최소 수정, focused 회귀·compile, 원 reviewer PASS로 수정 완료 판정했다.
|
||||
|
||||
### REV-P6-REVIEW-001 - stale tracking CTA 회귀 test의 View 속성 직접 검증
|
||||
|
||||
- **심각도:** Low
|
||||
- **상태:** 수정 완료
|
||||
- **관련 요구사항:** PRD 14.4, 저장소 UI test 정책
|
||||
- **소유 Task:** `P6-R3`
|
||||
|
||||
**관찰 내용**
|
||||
|
||||
`GiftNavigationTest`가 `tracking.visibility`를 `View.VISIBLE/GONE`과 직접 비교해 화면 결정 로직만 local unit test로 검증한다는 정책을 위반했다.
|
||||
|
||||
**조치와 근거**
|
||||
|
||||
- 기존 stale CTA production 수정은 유지했다.
|
||||
- `GiftDetailPresenter.showsTrackingAction()`으로 상태별 표시 결정을 추출하고 Activity가 매 render에서 사용하게 했다.
|
||||
- presenter test가 eligible Content=true, Loading/Error/Canceled/direct CANCELED Content=false를 검증한다.
|
||||
- gift test 범위의 visibility 관련 금지 패턴 검색은 0건이며 context·quality 재검토가 PASS했다.
|
||||
|
||||
**판정 기록**
|
||||
|
||||
- `2026-10-02` - 최종 context review에서 정책 위반으로 확정했다.
|
||||
- `2026-10-02` - P6-R3 RED/GREEN, 전체 Gate, context·quality 재검토 PASS로 수정 완료 판정했다.
|
||||
|
||||
## 7. 확정 항목의 plan·goal 전환
|
||||
|
||||
- `plan-task.md`에 `P6-R1`을 추가했다. 실패 재현 test, 최소 수정, focused 회귀, resource/Kotlin compile, reviewer 재검토를 완료 조건으로 한다.
|
||||
- 최종 context review에서 `REV-P6-REVIEW-001`을 확정하고 `plan-task.md`에 `P6-R3`을 추가했다. 기존 production 수정은 보존하면서 View 속성 assertion을 순수 presentation 결정 test로 전환한다.
|
||||
|
||||
## 8. 리뷰 종료 판정
|
||||
|
||||
| 판정 항목 | 결과 | 근거 |
|
||||
|---|---|---|
|
||||
| 리뷰 범위 전체 확인 | 충족 | Phase 6 Kotlin/XML/resource/test와 5개 review lane 대조 |
|
||||
| 후보 항목 판정 완료 | 충족 | 두 review finding 모두 수정 완료 |
|
||||
| 확정 항목 plan 반영 | 충족 | `P6-R1`, `P6-R3` 등록·완료 |
|
||||
| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 보류 없음 |
|
||||
| 검증 명령과 결과 기록 | 충족 | P6-R1·P6-R3 RED→GREEN과 수정 후 전체 Gate 기록 |
|
||||
|
||||
**최종 결론:** Phase 6 수정 검증 완료
|
||||
|
||||
**남은 항목:** 없음
|
||||
|
||||
## 9. 수정 후 검증 기록
|
||||
|
||||
### 1차 수정 검증 - 2026-10-02
|
||||
|
||||
- 무엇을: `REV-P6-T1-001`의 stale tracking CTA를 비-content 상태에서 숨겼다.
|
||||
- 왜: tracking 버튼이 content 밖으로 이동한 뒤 Loading/Error가 이전 visibility를 유지했기 때문이다.
|
||||
- 어떻게:
|
||||
- 신규 단일 test production 수정 전 실행 - `GiftNavigationTest.kt:219`에서 1건 실패, `BUILD FAILED in 15s`.
|
||||
- 동일 단일 test 수정 후 실행 - `BUILD SUCCESSFUL in 22s`.
|
||||
- navigation 13개·detail 15개·cancel 12개 - 총 40개, failures/errors/skipped=0, `BUILD SUCCESSFUL in 15s`.
|
||||
- `./gradlew :app:mergeDebugResources :app:compileDebugKotlin` - `BUILD SUCCESSFUL in 1s`.
|
||||
- 대상 파일 scoped `GIT_MASTER=1 git diff --check` - exit 0.
|
||||
- 원 quality reviewer 재검토 - PASS, 필수 추가 수정 없음.
|
||||
- 남은 항목: `P6-T2`, Phase 6 통합 Gate와 최종 review.
|
||||
|
||||
### 2차 수정 검증 - 2026-10-02
|
||||
|
||||
- 무엇을: `REV-P6-REVIEW-001`의 View visibility assertion을 순수 presentation 결정 test로 전환했다.
|
||||
- 왜: 저장소 규칙은 UI의 크기·간격·constraint·visibility 직접 assertion을 금지하고 화면 표현 결정 로직 검증만 허용하기 때문이다.
|
||||
- 어떻게:
|
||||
- production 함수 부재 RED - `showsTrackingAction` unresolved reference, `BUILD FAILED in 5s`.
|
||||
- presenter 16개 GREEN - `BUILD SUCCESSFUL in 16s`.
|
||||
- navigation/detail/cancel 39개 GREEN - `BUILD SUCCESSFUL in 14s`.
|
||||
- 수정 후 전체 Gate - focused 149개, 전체 1,416개, failures/errors/skipped=0; resource/compile/ktlint·assembleDebug 성공; diff check exit 0.
|
||||
- 재검토 - context PASS, quality PASS, 직접 security PASS. 기존 goal·QA PASS와 합쳐 5개 영역 모두 PASS.
|
||||
- 남은 항목: 없음.
|
||||
Reference in New Issue
Block a user