mirror of
https://github.com/ktds-dg0501/kt-event-marketing.git
synced 2025-12-06 10:46:23 +00:00
44011cd73a
- 4개 주요 비즈니스 플로우 외부 시퀀스 다이어그램 작성 * 사용자인증플로우: 회원가입, 로그인, 로그아웃 * 이벤트생성플로우: AI 추천, 이미지 생성, 다중 채널 배포 * 고객참여플로우: 이벤트 참여, 당첨자 추첨 * 성과분석플로우: 실시간 대시보드 조회 - Event-Driven 아키텍처 반영 (Kafka Event Topics + Job Topics) - Resilience 패턴 전면 적용 (Circuit Breaker, Retry, Timeout, Fallback) - Cache-Aside 패턴 적용 (Redis 캐싱) - 논리 아키텍처 및 유저스토리 기반 설계 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
151 lines
5.2 KiB
Plaintext
151 lines
5.2 KiB
Plaintext
@startuml 고객참여플로우
|
|
!theme mono
|
|
|
|
title 고객 참여 플로우 - 외부 시퀀스 다이어그램
|
|
|
|
actor "고객" as Customer
|
|
participant "Frontend\n(고객용)" as CustomerFE
|
|
participant "API Gateway" as Gateway
|
|
participant "Participation\nService" as PartService
|
|
participant "Kafka\n(Event Topics)" as Kafka
|
|
database "Participation\nDB" as PartDB
|
|
participant "Analytics\nService" as Analytics
|
|
|
|
actor "사장님" as Owner
|
|
participant "Frontend\n(사장님용)" as OwnerFE
|
|
|
|
== UFR-PART-010: 이벤트 참여 ==
|
|
|
|
Customer -> CustomerFE: 이벤트 참여 화면 접근\n(우리동네TV/SNS/링고비즈)
|
|
activate CustomerFE
|
|
|
|
CustomerFE -> Customer: 참여 정보 입력 폼 표시\n(이름, 전화번호, 참여경로)
|
|
|
|
Customer -> CustomerFE: 참여 정보 입력 및\n참여 버튼 클릭
|
|
CustomerFE -> CustomerFE: 클라이언트 유효성 검증\n(이름 2자 이상, 전화번호 형식)
|
|
|
|
CustomerFE -> Gateway: POST /api/v1/participations\n{이름, 전화번호, 참여경로, 개인정보동의}
|
|
activate Gateway
|
|
|
|
Gateway -> PartService: POST /participations/register\n{이름, 전화번호, 참여경로, 개인정보동의}
|
|
activate PartService
|
|
|
|
PartService -> PartDB: SELECT * FROM participants\nWHERE phone_number = ? AND event_id = ?
|
|
activate PartDB
|
|
PartDB --> PartService: 중복 참여 여부 반환
|
|
deactivate PartDB
|
|
|
|
alt 중복 참여인 경우
|
|
PartService --> Gateway: 409 Conflict\n{message: "이미 참여하신 이벤트입니다"}
|
|
Gateway --> CustomerFE: 409 Conflict
|
|
CustomerFE -> Customer: 중복 참여 오류 메시지 표시
|
|
deactivate PartService
|
|
deactivate Gateway
|
|
deactivate CustomerFE
|
|
else 신규 참여인 경우
|
|
PartService -> PartService: 응모 번호 생성\n(UUID 또는 시퀀스 기반)
|
|
|
|
PartService -> PartDB: INSERT INTO participants\n(name, phone_number, entry_path,\napplication_number, participated_at)
|
|
activate PartDB
|
|
PartDB --> PartService: 저장 완료
|
|
deactivate PartDB
|
|
|
|
PartService -> Kafka: Publish Event\n"ParticipantRegistered"\n{participantId, eventId,\nentryPath, timestamp}
|
|
activate Kafka
|
|
note right of Kafka
|
|
Topic: participant-events
|
|
Event: ParticipantRegistered
|
|
Data: {
|
|
participantId: UUID,
|
|
eventId: UUID,
|
|
entryPath: string,
|
|
timestamp: datetime
|
|
}
|
|
end note
|
|
|
|
Kafka --> Analytics: Subscribe Event\n"ParticipantRegistered"
|
|
activate Analytics
|
|
Analytics -> Analytics: 참여자 데이터 집계\n- 채널별 참여자 수\n- 시간대별 참여 추이\n- 실시간 통계 업데이트
|
|
deactivate Analytics
|
|
deactivate Kafka
|
|
|
|
PartService --> Gateway: 201 Created\n{응모번호, 당첨발표일, 참여완료메시지}
|
|
deactivate PartService
|
|
|
|
Gateway --> CustomerFE: 201 Created
|
|
deactivate Gateway
|
|
|
|
CustomerFE -> Customer: 참여 완료 화면 표시\n- 응모번호\n- 당첨 발표일\n- "참여해주셔서 감사합니다"
|
|
deactivate CustomerFE
|
|
end
|
|
|
|
== UFR-PART-030: 당첨자 추첨 ==
|
|
|
|
Owner -> OwnerFE: 이벤트 상세 화면에서\n"당첨자 추첨" 버튼 클릭
|
|
activate OwnerFE
|
|
|
|
OwnerFE -> Owner: 추첨 확인 다이얼로그 표시\n"당첨자를 추첨하시겠습니까?"
|
|
|
|
Owner -> OwnerFE: 확인 버튼 클릭
|
|
|
|
OwnerFE -> Gateway: POST /api/v1/participations/draw\n{eventId, 당첨인원, 매장방문가산점옵션}
|
|
activate Gateway
|
|
|
|
Gateway -> PartService: POST /participations/draw-winners\n{eventId, winnerCount, visitBonus}
|
|
activate PartService
|
|
|
|
PartService -> PartDB: SELECT * FROM participants\nWHERE event_id = ? AND is_winner = false
|
|
activate PartDB
|
|
PartDB --> PartService: 전체 참여자 목록 반환
|
|
deactivate PartDB
|
|
|
|
PartService -> PartService: 당첨자 추첨 알고리즘 실행\n1. 난수 생성 (Crypto.randomBytes)\n2. 매장방문 가산점 적용 (옵션)\n3. Fisher-Yates Shuffle\n4. 당첨인원만큼 선정
|
|
|
|
PartService -> PartDB: UPDATE participants\nSET is_winner = true, won_at = NOW()\nWHERE participant_id IN (당첨자IDs)
|
|
activate PartDB
|
|
PartDB --> PartService: 업데이트 완료
|
|
deactivate PartDB
|
|
|
|
PartService -> PartDB: INSERT INTO draw_logs\n(event_id, draw_method, winner_count,\nalgorithm, drawn_at)
|
|
activate PartDB
|
|
note right of PartDB
|
|
추첨 로그 저장:
|
|
- 추첨 일시
|
|
- 추첨 방법
|
|
- 알고리즘 버전
|
|
- 가산점 적용 여부
|
|
end note
|
|
PartDB --> PartService: 로그 저장 완료
|
|
deactivate PartDB
|
|
|
|
PartService -> Kafka: Publish Event\n"WinnerSelected"\n{eventId, winners[], timestamp}
|
|
activate Kafka
|
|
note right of Kafka
|
|
Topic: participant-events
|
|
Event: WinnerSelected
|
|
Data: {
|
|
eventId: UUID,
|
|
winners: [
|
|
{participantId, name, phone}
|
|
],
|
|
timestamp: datetime
|
|
}
|
|
end note
|
|
|
|
Kafka --> Analytics: Subscribe Event\n"WinnerSelected"
|
|
activate Analytics
|
|
Analytics -> Analytics: 당첨자 통계 업데이트\n- 당첨자 수 집계\n- 채널별 당첨 분포
|
|
deactivate Analytics
|
|
deactivate Kafka
|
|
|
|
PartService --> Gateway: 200 OK\n{당첨자목록, 추첨로그ID}
|
|
deactivate PartService
|
|
|
|
Gateway --> OwnerFE: 200 OK
|
|
deactivate Gateway
|
|
|
|
OwnerFE -> Owner: 당첨자 목록 화면 표시\n- 당첨자 정보 (이름, 전화번호, 응모번호)\n- "재추첨" 버튼\n- 추첨 완료 메시지
|
|
deactivate OwnerFE
|
|
|
|
@enduml
|