Files

Yu Sung 55ba0df77a docs(ai-character): 리소스 관리 문서 정리

2026-08-01 01:30:10 +09:00

7.4 KiB

Raw Blame History

Phase 8 코드 리뷰·QA — 2026-07-29

1. 리뷰 정보

항목	내용
리뷰 대상	Phase 8 / Comments vertical slice와 `P10-T6`
기준 commit 또는 working tree	`dd30e36323543e8f60e9983326503653e8001f12`; 리뷰 시작 시 tracked diff 36개, 전체 변경 169개
리뷰 일자	2026-07-29
리뷰어	Codex
기준 문서	`prd.md`, `api-contract.openapi.json`, `plan-task.md`
리뷰 상태	판정 완료

2. 리뷰 목적과 범위

목적

COMMENT-001~008, root/direct reply CRUD·권한·pagination과 screen state를 대조한다.

포함 범위

코드: src/features/comments, Audio detail/Community Sheet 소비 경로
테스트: comment contract/thread와 mock E2E
문서: Phase 8 과거 이력, P10-T6, comment OpenAPI operations
수동 검증: 20개 초과 reply와 empty state 정적 재현

제외 범위

inactive workspace의 쓰기 차단은 Phase 9에서 교차 판정

3. 판정 기준

심각도는 Blocker/High/Medium/Low, 상태는 확정/오탐/보류/수정 완료를 사용했다.

4. 검토한 근거

문서와 코드

요구사항: COMMENT-001~008, PRD 10.5
계약: root/reply GET page, size, totalCount, items
코드: CommentThread.tsx:43, CommentThread.tsx:46, CommentThread.tsx:127, CommentThread.tsx:144, CommentThread.tsx:155
테스트: comment-contract.test.ts, comment-thread.test.tsx, tests/e2e/comments.spec.ts

실행 환경

OS: macOS 26.0
Node: v24.12.0
npm: 11.7.0
API mode: injected client/MSW/mock E2E

실행한 검증

명령 또는 검증	결과	핵심 증거
`npm run test:run -- src/features/community-posts src/features/fan-talks src/features/comments`	성공	합계 9 files / 52 tests passed
reply pagination code 대조	실패 재현	reply GET은 항상 `page=0,size=20`; reply pagination control 0건
empty response code 대조	실패 재현	total 0에서 empty `PageState` 없이 `총 0개`만 표시
mock E2E 통합 실행	실패	7개 spec 병렬 실행 중 WebKit comments flow 1건 30초 timeout
WebKit 실패 4건 단일 worker 재실행	성공	4 passed / 28.4초; comments flow 포함, 단독 재현 실패

5. 발견 사항 요약

ID	심각도	상태	제목	소유 Task	후속 goal
`REV-P8-001`	High	수정 완료	루트별 답글은 첫 20개만 관리할 수 있다	`P10-T6`	`P8-R1`
`REV-P8-002`	Medium	수정 완료	댓글 0건에서 명시적 empty state가 없다	`P10-T6`	`P8-R1`

6. 발견 사항 상세

REV-P8-001 — reply pagination이 없어 21번째 이후 답글에 접근할 수 없다

심각도: High
상태: 수정 완료
관련 요구사항: COMMENT-001, COMMENT-006~007
관련 계약: replies GET page, size, response totalCount
소유 Task: 신규 P8-R1

관찰 내용

loadReplies는 항상 page:0,size:20으로 호출하고 받은 items만 표시한다. root 목록에만 ResourcePagination이 있고 reply section에는 page state/control이 없다.

재현 또는 검증 절차

하나의 root에 활성 답글 21개 이상인 응답을 준비한다.
답글 보기를 연다.
첫 20개만 보이고 다음 page 요청/버튼이 없다.
요구 결과는 서버 pagination으로 모든 직접 답글에 접근하는 것이다.

영향

관리자가 21번째 이후 팬·AI 답글을 조회·수정·삭제할 수 없다.

권장 조치

root별 {page,state}를 관리하고 reply ResourcePagination을 추가한다. page 이동, mutation 후 현재 page refetch, 마지막 item 삭제 경계를 test한다.

판정 기록

2026-07-29 — reply query와 렌더 경로 전체 대조로 확정.
2026-07-30 — CommentThread에 root별 reply page state와 reply ResourcePagination을 추가하고, 21번째 reply 접근 및 마지막 item 삭제 후 유효 page 복귀 회귀 test로 확인했다.

REV-P8-002 — 댓글 0건 empty state가 없다

심각도: Medium
상태: 수정 완료
관련 요구사항: PRD 10.5
관련 계약: comment page totalCount=0,items=[]
소유 Task: 신규 P8-R1

관찰 내용

root load가 성공하면 item 수와 무관하게 총 0개와 빈 container, pagination만 렌더한다.

영향

운영자가 정상 빈 결과인지 렌더 누락인지 명확히 구분하기 어렵다.