mirror of
https://github.com/ktds-dg0501/kt-event-marketing.git
synced 2025-12-06 09:26:24 +00:00
3075a5d49f
✨ 주요 기능 - Azure 기반 물리아키텍처 설계 (개발환경/운영환경) - 7개 마이크로서비스 물리 구조 설계 - 네트워크 아키텍처 다이어그램 작성 (Mermaid) - 환경별 비교 분석 및 마스터 인덱스 문서 📁 생성 파일 - design/backend/physical/physical-architecture.md (마스터) - design/backend/physical/physical-architecture-dev.md (개발환경) - design/backend/physical/physical-architecture-prod.md (운영환경) - design/backend/physical/*.mmd (4개 Mermaid 다이어그램) 🎯 핵심 성과 - 비용 최적화: 개발환경 월 $143, 운영환경 월 $2,860 - 확장성: 개발환경 100명 → 운영환경 10,000명 (100배) - 가용성: 개발환경 95% → 운영환경 99.9% - 보안: 다층 보안 아키텍처 (L1~L4) 🛠️ 기술 스택 - Azure Kubernetes Service (AKS) - Azure Database for PostgreSQL Flexible - Azure Cache for Redis Premium - Azure Service Bus Premium - Application Gateway + WAF 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
133 lines
3.2 KiB
Plaintext
133 lines
3.2 KiB
Plaintext
@startuml
|
|
!theme mono
|
|
|
|
title Participation Service ERD
|
|
|
|
' 스타일 정의
|
|
skinparam linetype ortho
|
|
skinparam roundcorner 10
|
|
skinparam class {
|
|
BackgroundColor White
|
|
BorderColor Black
|
|
ArrowColor Black
|
|
}
|
|
|
|
' 참여자 테이블
|
|
entity "participants" as participants {
|
|
**id : BIGSERIAL <<PK>>**
|
|
--
|
|
participant_id : VARCHAR(50) <<UK>>
|
|
event_id : VARCHAR(50) <<FK>>
|
|
name : VARCHAR(100)
|
|
phone_number : VARCHAR(20)
|
|
email : VARCHAR(100)
|
|
channel : VARCHAR(50)
|
|
store_visited : BOOLEAN
|
|
bonus_entries : INTEGER
|
|
agree_marketing : BOOLEAN
|
|
agree_privacy : BOOLEAN
|
|
is_winner : BOOLEAN
|
|
winner_rank : INTEGER
|
|
won_at : TIMESTAMP
|
|
created_at : TIMESTAMP
|
|
updated_at : TIMESTAMP
|
|
--
|
|
**Indexes:**
|
|
idx_participants_event_created
|
|
idx_participants_event_winner
|
|
idx_participants_event_store
|
|
--
|
|
**Constraints:**
|
|
uk_participant_id UNIQUE
|
|
uk_event_phone UNIQUE (event_id, phone_number)
|
|
chk_bonus_entries (1 <= bonus_entries <= 3)
|
|
chk_channel IN ('WEB', 'MOBILE', 'INSTORE')
|
|
chk_winner_rank (winner_rank IS NULL OR > 0)
|
|
}
|
|
|
|
' 추첨 이력 테이블
|
|
entity "draw_logs" as draw_logs {
|
|
**id : BIGSERIAL <<PK>>**
|
|
--
|
|
event_id : VARCHAR(50) <<UK>>
|
|
total_participants : INTEGER
|
|
winner_count : INTEGER
|
|
apply_store_visit_bonus : BOOLEAN
|
|
algorithm : VARCHAR(50)
|
|
drawn_at : TIMESTAMP
|
|
drawn_by : VARCHAR(100)
|
|
created_at : TIMESTAMP
|
|
updated_at : TIMESTAMP
|
|
--
|
|
**Indexes:**
|
|
idx_draw_logs_event
|
|
idx_draw_logs_drawn_at
|
|
--
|
|
**Constraints:**
|
|
uk_draw_event UNIQUE (event_id)
|
|
chk_winner_count (winner_count > 0)
|
|
chk_total_participants (total_participants >= winner_count)
|
|
chk_algorithm IN ('RANDOM', 'WEIGHTED')
|
|
}
|
|
|
|
' 관계 정의
|
|
participants "N" -- "1" draw_logs : event_id
|
|
|
|
' 노트
|
|
note right of participants
|
|
**참여자 관리**
|
|
- 중복 참여 방지 (event_id + phone_number)
|
|
- 매장 방문 보너스 응모권 관리
|
|
- 당첨자 상태 관리
|
|
|
|
**보너스 응모권 계산**
|
|
- 기본: 1개
|
|
- 매장 방문 시: 3개 (+2 보너스)
|
|
|
|
**participant_id 형식**
|
|
EVT{eventId}-{YYYYMMDD}-{SEQ}
|
|
예시: EVT123-20251029-001
|
|
end note
|
|
|
|
note right of draw_logs
|
|
**추첨 이력 관리**
|
|
- 이벤트당 1회만 추첨 가능
|
|
- 재추첨 방지
|
|
- 감사 추적 (drawn_by, drawn_at)
|
|
|
|
**추첨 알고리즘**
|
|
- RANDOM: 단순 무작위 추첨
|
|
- WEIGHTED: 보너스 응모권 적용 추첨
|
|
end note
|
|
|
|
' 캐시 정보 노트
|
|
note bottom of participants
|
|
**Redis 캐시 키 구조**
|
|
|
|
1. 참여 세션 정보
|
|
Key: participation:session:{eventId}:{phoneNumber}
|
|
TTL: 10분
|
|
용도: 중복 참여 방지
|
|
|
|
2. 추첨 결과 임시 저장
|
|
Key: participation:draw:{eventId}
|
|
TTL: 1시간
|
|
용도: 빠른 조회
|
|
|
|
3. 이벤트별 참여자 카운트
|
|
Key: participation:count:{eventId}
|
|
TTL: 5분
|
|
용도: 실시간 집계
|
|
end note
|
|
|
|
' 외부 참조 노트
|
|
note top of participants
|
|
**외부 서비스 참조 (캐시 기반)**
|
|
|
|
- event_id: Event Service 이벤트 ID
|
|
- 직접 FK 관계 없음 (마이크로서비스 독립성)
|
|
- Redis 캐시로 이벤트 정보 참조
|
|
end note
|
|
|
|
@enduml
|