다크 모드
룹 검색
정보
룹 검색은 사용자가 자신의 룹 목록을 시간 관점, 텍스트 검색, 사용자 역할 필터로 조회하는 기능입니다. 지난 모임, 예정된 모임, 전체 모임을 구분하여 확인할 수 있습니다.
기능 소개
룹 검색을 통해 다음과 같은 일이 가능합니다:
- 지난 모임(HISTORY)과 예정된 모임(UPCOMING)을 구분하여 조회합니다.
- 텍스트 검색으로 룹 제목, 설명, 장소, 참여자 이름을 기준으로 룹을 찾을 수 있습니다.
- 역할 필터로 내가 만든 룹과 초대받은 룹을 구분할 수 있습니다.
- 룹 상태(대기 중, 조율 중, 조율 완료, 확정됨)로 필터링할 수 있습니다.
- 전체(ALL) 필터로 모든 룹을 한눈에 볼 수 있습니다.
동작 규칙
- 시간 관점 필터(LoopView): 룹 목록은 세 가지 시간 관점으로 필터링됩니다. 기본값은 **HISTORY(지난 모임)**입니다.
- HISTORY (지난 모임): 만남 날짜가 현재 시각보다 과거인 룹을 보여줍니다. 날짜가 없는 룹(일정 조율 중)은 포함되지 않습니다.
- UPCOMING (예정/진행 중): 만남 날짜가 아직 지나지 않은 룹과 날짜가 정해지지 않은 룹(일정 조율 중)을 보여줍니다.
- ALL (전체): 모든 룹을 보여줍니다.
- 텍스트 검색: 검색어를 입력하면 룹 제목, 설명, 장소 이름, 참여자 이름을 대소문자 무관하게 부분 일치로 검색합니다.
- 역할 필터(LoopUserFilter): 사용자의 역할에 따라 룹 목록을 필터링합니다.
- ALL: 참여한 모든 룹 (기본값)
- CREATED_BY_ME: 내가 호스트인 룹만
- INVITED_TO: 내가 초대받은 룹만 (호스트가 아닌 룹)
- 상태 필터: 룹 상태(WAITING, COLLECTING, COLLECTED, CONFIRMED)를 조합하여 필터링할 수 있습니다. 필터를 지정하지 않으면 모든 상태의 룹이 노출됩니다.
- 정렬: 만남 날짜 또는 생성 날짜 기준으로 오름차순/내림차순 정렬할 수 있습니다. 기본 정렬은 생성 날짜 내림차순입니다.
- 참여자만 조회 가능: 자신이 참여한 룹만 검색 결과에 노출됩니다. 다른 사용자의 룹은 조회할 수 없습니다.
- 룹 상태 표시: 검색 결과에서 각 룹의 현재 상태(대기 중, 조율 중, 조율 완료, 확정됨)가 함께 표시됩니다.
- 페이지네이션: 검색 결과는 오프셋 기반 페이지네이션(limit + offset)으로 제공됩니다.
사용자 흐름
지난 모임 조회
룹 목록 화면 진입
사용자가 메인 화면에서 룹 목록을 확인합니다. 기본적으로 지난 모임(HISTORY) 필터가 적용됩니다.
히스토리 탐색
만남 날짜가 지난 과거 모임들을 확인합니다. 미디어와 리캡이 있는 룹은 함께 표시됩니다.
룹 상세 이동
원하는 룹을 선택하면 룹 상세 화면으로 이동합니다.
예정된 모임 확인
필터 변경
룹 목록에서 예정/진행 중(UPCOMING) 필터를 선택합니다.
예정 룹 탐색
날짜가 확정된 룹, 일정 조율 중인 룹 등 예정된 모임들을 확인합니다. 각 룹의 상태와 날짜 정보가 함께 표시됩니다.
룹 상세 이동
원하는 룹을 선택하면 룹 상세 화면으로 이동합니다.
텍스트 검색
검색 화면 진입
룹 검색 화면에서 검색 필드에 검색어를 입력합니다. 검색 필드에 자동으로 포커스가 이동합니다.
검색어 입력
룹 제목, 설명, 장소 이름, 참여자 이름 중 일부를 입력합니다. 입력 후 잠시 대기하면 자동으로 검색이 시작됩니다.
검색 결과 확인
일치하는 룹이 목록으로 표시됩니다. 결과가 없으면 빈 상태가 표시됩니다.
룹 상세 이동
원하는 룹을 선택하면 룹 상세 화면으로 이동합니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-10 | 코드 검증 후 전면 수정: 기본 필터를 HISTORY로 정정, 텍스트 검색/역할 필터/상태 필터/정렬/페이지네이션 규칙 추가 |
| 2026-03-10 | 쿼리 실구현 재검증 (ExposedLoopAdapter.kt): HISTORY는 날짜 기준만 적용(미디어 무관)으로 정정. 페이지네이션을 오프셋 기반으로 수정 |
| 2026-03-09 | 최초 작성 |