docs(community): 이미지 원본비율 요구를 기록한다

This commit is contained in:
2026-07-12 20:51:22 +09:00
parent c389d1945d
commit 79eadbd39d
2 changed files with 169 additions and 0 deletions

View File

@@ -0,0 +1,91 @@
# PRD: v2 크리에이터 커뮤니티 게시글 이미지 원본비율
## 1. Overview
v2 크리에이터 커뮤니티 게시글 이미지가 고정 높이로 잘리지 않고 원본 이미지 비율대로 표시되도록 조정한다.
---
## 2. Problem
- 현재 크리에이터 커뮤니티 게시물 상세, 메인 홈 추천 탭 인기 커뮤니티 게시물, 메인 홈 팔로잉 탭 최근 소식 커뮤니티 게시물의 이미지는 `236dp` 고정 높이와 `centerCrop`으로 표시된다.
- 크리에이터 채널 커뮤니티 리스트형 아이템도 별도 레이아웃/어댑터를 사용해 동일한 고정 높이와 crop 정책이 남아 있다.
- 원본 이미지 비율과 다른 이미지가 잘려 보일 수 있다.
- 이전 최대 높이 제한 구현 후 일부 화면에서 이미지가 사라지거나 둥근 모서리가 사라지는 회귀가 발생했다.
---
## 3. Goals
- 요청된 커뮤니티 게시글 이미지를 특정 최대 높이로 제한하지 않고 원본 이미지 비율대로 표시한다.
- 이미지 로드 전에는 기존 기본 높이를 임시로 유지해 이미지 영역이 사라지지 않도록 한다.
- 기존 유료 잠금 overlay, 오디오 재생 버튼, 댓글/좋아요 영역 동작은 유지한다.
---
## 4. Non-Goals
- 레거시 커뮤니티 목록/상세 화면은 변경하지 않는다.
- API/DTO/model 필드는 변경하지 않는다.
- 이미지 업로드/크롭 정책은 변경하지 않는다.
- 별도 최소 높이, placeholder 비율 정책은 추가하지 않는다.
---
## 5. Target Users
- 크리에이터 커뮤니티 게시글을 보는 사용자
- 메인 홈 추천/팔로잉 탭에서 커뮤니티 게시글을 탐색하는 사용자
---
## 6. User Stories
- 사용자는 커뮤니티 게시글 이미지를 원본 비율대로 확인하고 싶다.
- 사용자는 이미지 로드 전후에도 커뮤니티 이미지 영역과 둥근 모서리가 안정적으로 유지되기를 원한다.
---
## 7. Core Features
### Feature A: 커뮤니티 이미지 원본비율 표시
#### Requirements
- 크리에이터 게시물 상세 이미지는 원본 이미지 비율로 표시한다.
- 메인 홈 추천 탭 인기 커뮤니티 게시물 이미지는 원본 이미지 비율로 표시한다.
- 메인 홈 팔로잉 탭 최근 소식 커뮤니티 게시물 이미지는 원본 이미지 비율로 표시한다.
- 크리에이터 채널 커뮤니티 리스트형 아이템 이미지는 원본 이미지 비율로 표시한다.
- 계산된 이미지 높이를 특정 최대 높이로 제한하지 않는다.
#### Edge Cases
- 원본 이미지 크기 정보가 없으면 기존 화면이 깨지지 않도록 높이를 강제로 계산하지 않는다.
- 유료 미구매 overlay는 계산된 이미지 영역 전체를 덮는다.
- 이미지가 없는 게시글은 기존처럼 이미지 영역을 숨긴다.
---
## 8. UX / UI Expectations
- 이미지는 잘리지 않고 원본 비율 기준으로 표시된다.
- `236dp` 고정 높이로 인한 crop은 제거된다.
- 로드 성공 전 임시 기본 높이는 유지하되, 로드 성공 후 원본 비율 높이로 교체된다.
- 이미지 컨테이너의 둥근 모서리는 홈/상세/리스트 화면에서 유지된다.
---
## 9. Technical Constraints
- 신규 코드는 `kr.co.vividnext.sodalive.v2` 하위에 둔다.
- 레거시 파일은 직접 수정하지 않는다.
- 홈 추천/팔로잉 커뮤니티 카드는 공통 `FeedCommunityView``view_feed_community.xml` 변경으로 처리한다.
- 상세 화면은 `CreatorChannelCommunityDetailActivity`와 해당 layout에서 최소 변경한다.
---
## 10. Metrics
- 순수 로직 테스트에서 특정 최대 높이 제한 없는 원본 비율 계산이 통과한다.
- 관련 Gradle 테스트/빌드가 통과한다.
---
## 11. Open Questions
- 현재 추가 확인이 필요한 사항은 없다.
---
## Verification Log
- 2026-07-12: 사용자 요청과 기존 조사 결과를 기준으로 PRD를 작성했다. 구현 전 문서 작성 단계이므로 빌드/테스트는 아직 실행하지 않았다.
- 2026-07-12: 구현 결과로 요청된 3개 위치의 커뮤니티 게시글 이미지 고정 `236dp`/`centerCrop` 표시를 제거하고, 이미지 로드 성공 시 원본 비율 기반 높이를 적용하되 기기 높이의 1/2로 제한하도록 반영했다. 이미지 URL이 없는 유료 잠금/paywall-only 영역은 원본 비율 계산 대상이 아니므로 기존 기본 높이를 유지한다.
- 2026-07-12: 후속 버그 수정 요청에 따라 특정 최대 높이 제한 요구사항을 제거하고, 이미지 로드 전 기본 높이 유지, 컨테이너 clipping 기반 둥근 모서리 유지, 크리에이터 채널 커뮤니티 리스트형 아이템 원본 비율 표시를 추가 범위로 반영했다.