add outer/inner sequence

2026-06-13 16:59:13 +00:00 · 2025-10-22 14:13:57 +09:00
parent 44011cd73a
commit 9fd060b275
127 changed files with 7527 additions and 9 deletions
@@ -0,0 +1,64 @@
+@startuml event-목록조회
+!theme mono
+
+title Event Service - 이벤트 목록 조회 (필터/검색) (UFR-EVENT-070)
+
+participant "EventController" as Controller <<C>>
+participant "EventService" as Service <<S>>
+participant "EventRepository" as Repo <<R>>
+participant "Redis Cache" as Cache <<E>>
+database "Event DB" as DB <<E>>
+
+note over Controller: GET /api/events?status={status}&keyword={keyword}\n&page={page}&size={size}
+Controller -> Service: getEventList(userId, filters, pagination)
+activate Service
+
+Service -> Cache: get("events:" + userId + ":" + filters + ":" + page)
+activate Cache
+
+alt 캐시 히트
+    Cache --> Service: Event list data
+    Service --> Controller: EventListResponse
+
+else 캐시 미스
+    Cache --> Service: null
+    deactivate Cache
+
+    Service -> Repo: findByUserIdWithFilters(userId, filters, pagination)
+    activate Repo
+
+    alt 필터 있음 (상태별)
+        Repo -> DB: SELECT e.*, COUNT(p.id) as participant_count\nFROM events e\nLEFT JOIN participants p ON e.id = p.event_id\nWHERE e.user_id = ?\nAND e.status = ?\nGROUP BY e.id\nORDER BY e.created_at DESC\nLIMIT ? OFFSET ?
+    else 검색 있음 (키워드)
+        Repo -> DB: SELECT e.*, COUNT(p.id) as participant_count\nFROM events e\nLEFT JOIN participants p ON e.id = p.event_id\nWHERE e.user_id = ?\nAND (e.title LIKE ? OR e.description LIKE ?)\nGROUP BY e.id\nORDER BY e.created_at DESC\nLIMIT ? OFFSET ?
+    else 필터 없음 (전체)
+        Repo -> DB: SELECT e.*, COUNT(p.id) as participant_count\nFROM events e\nLEFT JOIN participants p ON e.id = p.event_id\nWHERE e.user_id = ?\nGROUP BY e.id\nORDER BY e.created_at DESC\nLIMIT ? OFFSET ?
+    end
+
+    activate DB
+    note right: 인덱스 활용:\n- user_id\n- status\n- created_at
+    DB --> Repo: Event list with participant count
+    deactivate DB
+
+    Repo -> DB: SELECT COUNT(*) FROM events\nWHERE user_id = ? [AND filters]
+    activate DB
+    DB --> Repo: totalCount
+    deactivate DB
+
+    Repo --> Service: PagedResult<Event>
+    deactivate Repo
+
+    Service -> Cache: set("events:" + userId + ":" + filters + ":" + page,\npagedResult, TTL=1분)
+    activate Cache
+    Cache --> Service: OK
+    deactivate Cache
+end
+
+Service --> Controller: EventListResponse\n{events: [...], totalCount,\ntotalPages, currentPage}
+deactivate Service
+
+Controller --> Client: 200 OK\n{events: [\n  {eventId, title, period, status,\n   participantCount, roi, createdAt},\n  ...\n],\ntotalCount, totalPages, currentPage}
+
+note over Controller, DB: 필터 옵션:\n- status: DRAFT, ACTIVE, COMPLETED\n- 기간: 최근 1개월/3개월/6개월/1년\n- 정렬: 최신순, 참여자 많은 순,\n  ROI 높은 순\n\n페이지네이션:\n- 기본 20개/페이지\n- 페이지 번호 기반
+
+@enduml