feat(ai-character): 커뮤니티 댓글 첫 답글 작성 지원
This commit is contained in:
Yu Sung
@@ -0,0 +1,170 @@
|
||||
# 커뮤니티 댓글 직접 답글 Phase 1 리뷰
|
||||
|
||||
## 1. 리뷰 정보
|
||||
|
||||
| 항목 | 내용 |
|
||||
|---|---|
|
||||
| 리뷰 대상 | Phase 1 / `P1-T1`, `P1-R1`, `P1-GATE` |
|
||||
| 기준 commit 또는 working tree | `e82e209300d2c30843b6a2ef2c9e126ade6bba63` 기반 working tree |
|
||||
| 리뷰 일자 | 2026-08-06 |
|
||||
| 리뷰어 | Sisyphus, 독립 goal·품질·보안·컨텍스트·visual QA reviewer |
|
||||
| 기준 문서 | [prd.md](../prd.md), [api-contract.md](../api-contract.md), [plan-task.md](../plan-task.md) |
|
||||
| 리뷰 상태 | 판정 완료 |
|
||||
|
||||
## 2. 리뷰 목적과 범위
|
||||
|
||||
### 목적
|
||||
|
||||
- `CCR-001~006`과 Community 첫·추가 직접 답글 journey가 구현됐는지 확인한다.
|
||||
- API·schema·application mock·dependency 변경 없이 기존 2단계 댓글 경계와 권한을 유지하는지 확인한다.
|
||||
- TDD, 자동 Gate, 실제 Chromium과 문서 기록이 완료 조건과 일치하는지 판정한다.
|
||||
|
||||
### 포함 범위
|
||||
|
||||
- 코드: `src/features/comments/components/CommentThread.tsx`
|
||||
- 테스트: `src/features/comments/tests/comment-thread.test.tsx`, `tests/e2e/comments.spec.ts`
|
||||
- 문서: `CCR-001~006`, Community 댓글 API Contract, `P1-T1`, `P1-R1`, `P1-GATE`
|
||||
- 수동 검증: Chromium mock mode, keyboard-only, 1280px, 320px, 200% zoom, CJK·수평 overflow
|
||||
|
||||
### 제외 범위
|
||||
|
||||
- 실제 개발 API integration, 새 endpoint·schema·mock store, 답글 수정·삭제·pagination 정책 변경
|
||||
- 3단계 댓글, optimistic update, form 상시 노출
|
||||
|
||||
## 3. 판정 기준
|
||||
|
||||
### 심각도
|
||||
|
||||
| 심각도 | 기준 |
|
||||
|---|---|
|
||||
| Blocker | 보안·데이터 손실 위험, 핵심 journey 불능, 완료 판정 무효 |
|
||||
| High | 확정 요구사항·API Contract 위반 또는 주요 회귀 |
|
||||
| Medium | 제한 조건의 기능·접근성·복구 문제 |
|
||||
| Low | 비핵심 유지보수성·문서 정합성 문제 |
|
||||
|
||||
### 상태
|
||||
|
||||
| 상태 | 의미 | 후속 처리 |
|
||||
|---|---|---|
|
||||
| 후보 | 근거를 발견했지만 판정 전 | 재현 후 상태 변경 |
|
||||
| 확정 | 코드·test·문서로 문제 확인 | 회귀 Task 전환 |
|
||||
| 오탐 | 실제 실행 경로나 요구사항 위반이 아님 | 판정 근거를 보존하고 종료 |
|
||||
| 보류 | 외부 계약·환경·제품 결정 필요 | 담당·재개 조건 기록 |
|
||||
| 수정 완료 | 수정과 관련 검증 완료 | 검증 결과 누적 |
|
||||
|
||||
## 4. 검토한 근거
|
||||
|
||||
### 문서와 코드
|
||||
|
||||
- 요구사항: `CCR-001~006`
|
||||
- API Contract: 직접 답글 GET, Community 댓글 POST, 2단계 불변식
|
||||
- 계획: `P1-T1`, `P1-R1`, `P1-GATE`
|
||||
- 코드: `CommentThread.tsx`의 `replyActionLabel`, `toggleReplies()`, `createReply()`
|
||||
- 테스트: `CommentThread creates a first Community reply...`, `Community sheet comments keep two-level controls usable at 320px`
|
||||
|
||||
### 실행 환경
|
||||
|
||||
```text
|
||||
OS: macOS
|
||||
Node: v24.12.0
|
||||
npm: 11.7.0
|
||||
Browser/viewport: Playwright Chromium, 1280x900, 320x640, CSS zoom 200%
|
||||
환경 변수: VITE_API_MODE=mock
|
||||
```
|
||||
|
||||
### 실행한 검증
|
||||
|
||||
| 명령 또는 수동 검증 | 결과 | 핵심 증거 |
|
||||
|---|---|---|
|
||||
| `npm run test:run -- src/features/comments/tests/comment-thread.test.tsx` | 성공 | `8/8` |
|
||||
| `npm run test:run -- src/features/comments` | 성공 | `15/15` |
|
||||
| `npm run e2e:mock -- tests/e2e/comments.spec.ts --project=chromium` | 성공 | `3/3`; 2102 빈 reply, 첫·두 답글, payload, 2단계 경계 |
|
||||
| `npm run typecheck` | 성공 | exit 0 |
|
||||
| `npm run lint` | 성공 | exit 0 |
|
||||
| `npm run build:dev` | 성공 | Vite build exit 0; 기존 500kB chunk warning만 발생 |
|
||||
| `git diff --check` | 성공 | 출력 없음 |
|
||||
| 실제 Chromium keyboard journey | 성공 | 답글 action·textarea keyboard 진입, 첫·두 답글 표시, input 초기화, 중첩 action 0건 |
|
||||
| 1280px·320px·200% visual QA | 성공 | 수평 overflow 없음, CJK clipping·고아줄 없음, 독립 visual reviewer PASS |
|
||||
|
||||
## 5. 발견 사항 요약
|
||||
|
||||
| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
|
||||
|---|---|---|---|---|---|
|
||||
| `CCR-REV-P1-001` | High | 오탐 | E2E route fixture가 root 2102 답글을 잘못 분류한다 | `P1-R1` | 없음 |
|
||||
|
||||
확정 발견 사항 없음.
|
||||
|
||||
## 6. 발견 사항 상세
|
||||
|
||||
### CCR-REV-P1-001 — E2E route fixture root 분류 후보
|
||||
|
||||
- **심각도:** High
|
||||
- **상태:** 오탐
|
||||
- **관련 요구사항:** `CCR-002`, `CCR-004~005`
|
||||
- **관련 계약:** Community 직접 답글 GET·POST, 2단계 불변식
|
||||
- **소유 Task:** `P1-R1`
|
||||
|
||||
**관찰 내용**
|
||||
|
||||
`tests/e2e/comments-test-support.ts`는 단일 `replyRootId`만 replies로 분류하지만,
|
||||
필수 mock E2E에서는 이 Playwright route fixture가 응답을 소유하지 않는다.
|
||||
|
||||
**근거**
|
||||
|
||||
- `playwright.config.ts`는 mock E2E를 `VITE_API_MODE=mock`으로 실행한다.
|
||||
- 앱은 렌더 전에 `src/shared/mocks/browser.ts`의 `setupWorker(...)`를 시작한다.
|
||||
- Browser MSW handler·store는 `commentId`와 `parentId`로 root 2102 답글을 분리한다.
|
||||
- 기존 E2E route fixture를 변경하지 않은 상태에서 2102 초기 reply region의 root 댓글 0건, 첫·두 답글 각 1건, 중첩 action 0건과 Chromium `3/3`을 반복 확인했다.
|
||||
- 별도 브라우저 probe에서 `page.route` 호출 0회와 Community mock 요청 9회를 관찰했다.
|
||||
|
||||
**재현 또는 검증 절차**
|
||||
|
||||
1. `VITE_API_MODE=mock`으로 `comments.spec.ts` Chromium을 실행한다.
|
||||
2. root 2102의 답글 영역을 열고 다른 root 댓글이 없음을 확인한다.
|
||||
3. 같은 root에 첫·두 번째 답글을 등록하고 Sheet를 다시 연다.
|
||||
4. 두 답글이 region에 각 1건 표시되고 중첩 답글 action이 없음을 확인한다.
|
||||
|
||||
**영향**
|
||||
|
||||
필수 mock E2E와 제품 동작에는 영향이 없다. Server-mode 전용 test route helper의
|
||||
일반화는 이번 기능 범위와 실행 경로 밖이다.
|
||||
|
||||
**권장 조치**
|
||||
|
||||
없음. 실행되지 않는 fixture를 speculative하게 변경하지 않는다.
|
||||
|
||||
**판정 기록**
|
||||
|
||||
- 2026-08-06 — 코드 형태만 근거로 확정 후보로 분류했다.
|
||||
- 2026-08-06 — mock 요청 소유권, 기존 fixture 상태의 E2E, 실제 브라우저를 대조해 오탐으로 정정했다.
|
||||
|
||||
## 7. 확정 항목의 plan·goal 전환
|
||||
|
||||
전환 항목 없음. `CCR-REV-P1-001`은 `P1-R1`에서 오탐으로 판정됐다.
|
||||
|
||||
## 8. 리뷰 종료 판정
|
||||
|
||||
| 판정 항목 | 결과 | 근거 |
|
||||
|---|---|---|
|
||||
| 리뷰 범위 전체 확인 | 충족 | 요구사항·계약·코드·test·실제 Chromium·visual QA 확인 |
|
||||
| 후보 항목 판정 완료 | 충족 | `CCR-REV-P1-001` 오탐 판정 |
|
||||
| 확정 항목 plan 반영 | 해당 없음 | 확정 발견 사항 없음 |
|
||||
| 보류 항목의 담당·재개 조건 기록 | 해당 없음 | 보류 없음 |
|
||||
| 검증 명령과 결과 기록 | 충족 | 자동·수동 검증 표와 `plan-task.md` Progress 기록 |
|
||||
|
||||
**최종 결론:** 확정 발견 사항 없음
|
||||
|
||||
**남은 항목:** 실제 개발 API integration은 이번 mock 기능 Gate 범위 밖이다.
|
||||
|
||||
## 9. 수정 후 검증 기록
|
||||
|
||||
### 1차 리뷰 후보 검증 — 2026-08-06
|
||||
|
||||
- 무엇을: `CCR-REV-P1-001`의 실제 mock E2E 영향 여부를 검증했다.
|
||||
- 왜: 실행되지 않는 route fixture를 수정하면 범위를 불필요하게 확장할 수 있다.
|
||||
- 어떻게:
|
||||
- 기존 fixture 상태의 Chromium E2E — `3/3` 성공
|
||||
- Comments Vitest — `15/15` 성공
|
||||
- typecheck·lint·`git diff --check` — exit 0
|
||||
- 실제 Chromium·visual QA — 첫·추가 답글, keyboard, 1280px·320px·200% PASS
|
||||
- 남은 항목: 없음
|
||||
Reference in New Issue
Block a user