diff --git a/convert-par-to-group.sh b/convert-par-to-group.sh
deleted file mode 100755
index e0d1b0a..0000000
--- a/convert-par-to-group.sh
+++ /dev/null
@@ -1,52 +0,0 @@
-#!/bin/bash
-
-# PlantUML par/and/end를 group/end로 변환하는 스크립트
-# PlantUML 서버가 par/and 문법을 지원하지 않으므로 group으로 대체
-
-echo "Converting par/and/end blocks to group/end blocks..."
-
-# Inner sequence files
-cd design/backend/sequence/inner
-
-for file in ai-트렌드분석및추천.puml content-이미지생성.puml distribution-다중채널배포.puml event-대시보드조회.puml; do
- if [ -f "$file" ]; then
- echo "Processing: $file"
-
- # 1. Replace 'par' with 'group parallel'
- sed -i.bak6 's/^ par$/ group parallel/' "$file"
- sed -i.bak6 's/^par$/group parallel/' "$file"
-
- # 2. Remove standalone 'and' lines (they don't exist in group syntax)
- sed -i.bak6 '/^ and$/d' "$file"
- sed -i.bak6 '/^and$/d' "$file"
-
- echo " Converted: $file"
- fi
-done
-
-cd - > /dev/null
-
-# Outer sequence files
-cd design/backend/sequence/outer
-
-if [ -f "이벤트생성플로우.puml" ]; then
- echo "Processing: 이벤트생성플로우.puml"
-
- # 1. Replace 'par' with 'group parallel'
- sed -i.bak6 's/^par$/group parallel/' "이벤트생성플로우.puml"
-
- # 2. Remove standalone 'and' lines
- sed -i.bak6 '/^and$/d' "이벤트생성플로우.puml"
-
- echo " Converted: 이벤트생성플로우.puml"
-fi
-
-cd - > /dev/null
-
-echo ""
-echo "All par/and blocks converted to group blocks."
-echo "Running validation..."
-echo ""
-
-# Run validation
-./validate-puml-fixed.sh
diff --git a/design/backend/logical/logical-architecture.md b/design/backend/logical/logical-architecture.md
index f75a943..ed517f9 100644
--- a/design/backend/logical/logical-architecture.md
+++ b/design/backend/logical/logical-architecture.md
@@ -49,7 +49,7 @@
#### Kafka 통합 전략
- **Event Topics**: 도메인 이벤트 발행/구독 (EventCreated, ParticipantRegistered 등)
-- **Job Topics**: 비동기 작업 요청/처리 (ai-job, image-job)
+- **Job Topics**: 비동기 작업 요청/처리 (ai 이벤트 생성, 이미지 생성)
- **단일 메시징 플랫폼**: 운영 복잡도 감소 및 일관된 메시지 처리
#### Resilience 패턴 적용
@@ -88,12 +88,12 @@
#### Async Services (비동기 처리)
1. **AI Service**: AI 기반 이벤트 추천
- - Kafka Job 구독 (ai-job)
+ - Kafka Job 구독 (ai 이벤트 생성)
- 외부 AI API 호출 (Circuit Breaker, Timeout 30초)
- 결과 캐싱 (Redis, TTL 24시간)
2. **Content Service**: SNS 이미지 생성
- - Kafka Job 구독 (image-job)
+ - Kafka Job 구독 (이미지 생성)
- 외부 이미지 생성 API 호출 (Circuit Breaker, Timeout 20초)
- CDN 업로드 및 캐싱 (Redis, TTL 7일)
@@ -110,8 +110,8 @@
- **DistributionCompleted**: 배포 완료 시
**Job Topics** (비동기 작업):
-- **ai-job**: AI 추천 작업
-- **image-job**: 이미지 생성 작업
+- **ai 이벤트 생성**: AI 추천 작업
+- **이미지 생성**: 이미지 생성 작업
**특징**:
- At-Least-Once Delivery 보장
@@ -169,16 +169,16 @@
- 구독자: Analytics Service
**Kafka Job 발행**:
-1. **ai-job**: AI 추천 요청
-2. **image-job**: 이미지 생성 요청
+1. **ai 이벤트 생성**: AI 추천 요청
+2. **이미지 생성**: 이미지 생성 요청
**서비스 간 호출**:
- **Distribution Service**: 다중 채널 배포 (동기 호출, Circuit Breaker 적용)
**주요 플로우**:
1. 이벤트 목적 선택 → Event DB 저장 → EventCreated 발행
-2. AI 추천 요청 → ai-job 발행
-3. 이미지 생성 요청 → image-job 발행
+2. AI 추천 요청 → ai 이벤트 생성 발행
+3. 이미지 생성 요청 → 이미지 생성 발행
4. 배포 승인 → Distribution Service 동기 호출
**데이터 저장**:
@@ -248,7 +248,7 @@
**관련 유저스토리**: UFR-AI-010
**Kafka Job 구독**:
-- **ai-job**: AI 추천 작업 요청
+- **ai 이벤트 생성**: AI 추천 작업 요청
**Resilience 패턴**:
- **Circuit Breaker**: AI API 호출 시 (실패율 50% 초과 시 Open)
@@ -273,7 +273,7 @@
**관련 유저스토리**: UFR-CONT-010, 020
**Kafka Job 구독**:
-- **image-job**: 이미지 생성 작업 요청
+- **이미지 생성**: 이미지 생성 작업 요청
**Resilience 패턴**:
- **Circuit Breaker**: 이미지 생성 API 호출 시 (실패율 50% 초과 시 Open)
@@ -342,8 +342,8 @@
| 토픽명 | 발행자 | 구독자 | Payload | 용도 |
|---------|--------|--------|---------|------|
-| **ai-job** | Event Service | AI Service | eventId, objective, industry, region | AI 트렌드 분석 및 이벤트 추천 요청 |
-| **image-job** | Event Service | Content Service | eventId, content, style | SNS 이미지 생성 요청 (3가지 스타일) |
+| **ai 이벤트 생성** | Event Service | AI Service | eventId, objective, industry, region | AI 트렌드 분석 및 이벤트 추천 요청 |
+| **이미지 생성** | Event Service | Content Service | eventId, content, style | SNS 이미지 생성 요청 (3가지 스타일) |
#### 통신 패턴별 설계
@@ -489,13 +489,13 @@
┌─────────────────────────────────────────────────────────────┐
│ Client → Event Service │
│ - POST /api/events/{id}/ai-recommendations │
- │ - Kafka ai-job 토픽 발행 (AI 작업 요청) │
+ │ - Kafka ai 이벤트 생성 토픽 발행 (AI 작업 요청) │
│ - Job ID 즉시 반환 (0.1초) │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ AI Service (Background) │
- │ - Kafka ai-job 토픽 구독 │
+ │ - Kafka ai 이벤트 생성 토픽 구독 │
│ - Redis 캐시 확인 (Cache-Aside) │
│ - 캐시 MISS: Claude API 호출 (10초) [Circuit Breaker] │
│ - 결과 캐싱 (TTL 24시간) │
@@ -512,13 +512,13 @@
┌─────────────────────────────────────────────────────────────┐
│ Client → Event Service │
│ - POST /api/events/{id}/content-generation │
- │ - Kafka image-job 토픽 발행 (이미지 생성 요청) │
+ │ - Kafka 이미지 생성 토픽 발행 (이미지 생성 요청) │
│ - Job ID 즉시 반환 (0.1초) │
└─────────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────────┐
│ Content Service (Background) │
- │ - Kafka image-job 토픽 구독 │
+ │ - Kafka 이미지 생성 토픽 구독 │
│ - Redis 캐시 확인 │
│ - 캐시 MISS: Stable Diffusion API (5초) [Circuit Breaker] │
│ - 이미지 CDN 업로드 │
@@ -858,7 +858,7 @@
1. **Kafka 통합 메시징 플랫폼 채택**: Event Bus와 Job Queue를 Kafka로 통합하여 운영 복잡도 감소
2. **Event-Driven 아키텍처 채택**: Kafka를 통한 서비스 간 느슨한 결합 및 비동기 통신
3. **도메인 이벤트 정의**: 4개 Event Topics (EventCreated, ParticipantRegistered, WinnerSelected, DistributionCompleted)
-4. **Job Topics 정의**: 2개 Job Topics (ai-job, image-job)로 장시간 비동기 작업 처리
+4. **Job Topics 정의**: 2개 Job Topics (ai 이벤트 생성, 이미지 생성)로 장시간 비동기 작업 처리
5. **Resilience 패턴 전면 적용**: Circuit Breaker, Retry, Timeout, Bulkhead, Fallback
6. **At-Least-Once Delivery**: Kafka 메시지 보장 및 멱등성 설계
7. **Cache-Aside 패턴**: AI/이미지 생성 결과 캐싱으로 응답 시간 90% 개선
diff --git a/design/backend/logical/logical-architecture.mmd b/design/backend/logical/logical-architecture.mmd
index a06d446..e93b0e6 100644
--- a/design/backend/logical/logical-architecture.mmd
+++ b/design/backend/logical/logical-architecture.mmd
@@ -17,7 +17,7 @@ graph TB
end
%% Kafka (Event Bus + Job Queue)
- Kafka["Kafka
━━━━━━━━━━
• EventCreated
• ParticipantRegistered
• WinnerSelected
• DistributionCompleted
━━━━━━━━━━
• ai-job
• image-job"]
+ Kafka["Kafka
━━━━━━━━━━
• EventCreated
• ParticipantRegistered
• WinnerSelected
• DistributionCompleted
━━━━━━━━━━
• ai 이벤트 생성
• 이미지 생성"]
%% External System
External["외부시스템
[Circuit Breaker]
━━━━━━━━━━
• 국세청 API
• AI API
• 이미지 생성 API
• 배포 채널 APIs
(비동기)"]
@@ -29,8 +29,8 @@ graph TB
DistSvc ==>|"DistributionCompleted
발행"| Kafka
%% Job Publishing (비동기 작업 요청)
- EventSvc -->|"ai-job 발행"| Kafka
- EventSvc -->|"image-job 발행"| Kafka
+ EventSvc -->|"ai 이벤트 생성 발행"| Kafka
+ EventSvc -->|"이미지 생성 발행"| Kafka
%% Event Subscription
Kafka -.->|"EventCreated
구독"| AnalSvc
@@ -38,8 +38,8 @@ graph TB
Kafka -.->|"DistributionCompleted
구독"| AnalSvc
%% Job Subscription
- Kafka -.->|"ai-job 구독"| AISvc
- Kafka -.->|"image-job 구독"| ContentSvc
+ Kafka -.->|"ai 이벤트 생성 구독"| AISvc
+ Kafka -.->|"이미지 생성 구독"| ContentSvc
%% Service to Service (동기 호출)
EventSvc -->|"다중 채널 배포
[Circuit Breaker]"| DistSvc
diff --git a/fix-and-blank-lines.sh b/fix-and-blank-lines.sh
deleted file mode 100755
index 76d2c5a..0000000
--- a/fix-and-blank-lines.sh
+++ /dev/null
@@ -1,40 +0,0 @@
-#!/bin/bash
-
-# PlantUML and 키워드 앞 공백 라인 제거 스크립트
-# par/and 블록에서 and 키워드 앞의 빈 줄을 제거
-
-echo "Removing blank lines before 'and' keywords..."
-
-# Inner sequence files
-cd design/backend/sequence/inner
-
-for file in ai-트렌드분석및추천.puml content-이미지생성.puml distribution-다중채널배포.puml event-대시보드조회.puml; do
- if [ -f "$file" ]; then
- echo "Processing: $file"
- # Remove blank line immediately before 'and' keyword
- # Look for pattern: empty line + line with spaces + 'and'
- perl -i.bak5 -pe 's/^\s*\n(\s+and\s*$)/$1/g' "$file"
- echo " Fixed: $file"
- fi
-done
-
-cd - > /dev/null
-
-# Outer sequence files
-cd design/backend/sequence/outer
-
-if [ -f "이벤트생성플로우.puml" ]; then
- echo "Processing: 이벤트생성플로우.puml"
- perl -i.bak5 -pe 's/^\s*\n(\s+and\s*$)/$1/g' "이벤트생성플로우.puml"
- echo " Fixed: 이벤트생성플로우.puml"
-fi
-
-cd - > /dev/null
-
-echo ""
-echo "Blank lines before 'and' keywords removed."
-echo "Running validation..."
-echo ""
-
-# Run validation
-./validate-puml-fixed.sh
diff --git a/fix-and-labels.sh b/fix-and-labels.sh
deleted file mode 100755
index 2734946..0000000
--- a/fix-and-labels.sh
+++ /dev/null
@@ -1,51 +0,0 @@
-#!/bin/bash
-
-# PlantUML and 키워드 레이블 제거 스크립트
-# and 키워드 뒤에 오는 레이블을 제거하여 문법 오류 수정
-
-echo "Fixing 'and' keyword labels in PlantUML files..."
-
-# Inner sequence files
-cd design/backend/sequence/inner
-
-# event-대시보드조회.puml: 2개 수정
-if [ -f "event-대시보드조회.puml" ]; then
- echo "Processing: event-대시보드조회.puml"
- # 'and 예정 이벤트 조회' → 'and'
- sed -i.bak4 's/^ and 예정 이벤트 조회$/ and/' "event-대시보드조회.puml"
- # 'and 종료 이벤트 조회' → 'and'
- sed -i.bak4 's/^ and 종료 이벤트 조회$/ and/' "event-대시보드조회.puml"
- echo " Fixed: event-대시보드조회.puml"
-fi
-
-# content-이미지생성.puml: 2개 수정
-if [ -f "content-이미지생성.puml" ]; then
- echo "Processing: content-이미지생성.puml"
- # 'and 화려한 스타일' → 'and'
- sed -i.bak4 's/^ and 화려한 스타일$/ and/' "content-이미지생성.puml"
- # 'and 트렌디 스타일' → 'and'
- sed -i.bak4 's/^ and 트렌디 스타일$/ and/' "content-이미지생성.puml"
- echo " Fixed: content-이미지생성.puml"
-fi
-
-# distribution-다중채널배포.puml: 3개 수정
-if [ -f "distribution-다중채널배포.puml" ]; then
- echo "Processing: distribution-다중채널배포.puml"
- # 'and 링고비즈 배포' → 'and'
- sed -i.bak4 's/^and 링고비즈 배포$/and/' "distribution-다중채널배포.puml"
- # 'and 지니TV 배포' → 'and'
- sed -i.bak4 's/^and 지니TV 배포$/and/' "distribution-다중채널배포.puml"
- # 'and SNS 배포 (Instagram, Naver, Kakao)' → 'and'
- sed -i.bak4 's/^and SNS 배포 (Instagram, Naver, Kakao)$/and/' "distribution-다중채널배포.puml"
- echo " Fixed: distribution-다중채널배포.puml"
-fi
-
-cd - > /dev/null
-
-echo ""
-echo "All 'and' keyword labels removed."
-echo "Running validation..."
-echo ""
-
-# Run validation
-./validate-puml-fixed.sh
diff --git a/fix-par-blocks.sh b/fix-par-blocks.sh
deleted file mode 100755
index a4a5be8..0000000
--- a/fix-par-blocks.sh
+++ /dev/null
@@ -1,39 +0,0 @@
-#!/bin/bash
-
-# PlantUML par 블록 수정 스크립트
-# 한글 레이블을 note로 변경
-
-echo "Fixing par blocks in PlantUML files..."
-
-# Inner sequence files
-cd design/backend/sequence/inner
-
-for file in ai-트렌드분석및추천.puml content-이미지생성.puml distribution-다중채널배포.puml event-대시보드조회.puml; do
- if [ -f "$file" ]; then
- echo "Processing: $file"
- # note over : 패턴 제거 (par 다음 줄)
- sed -i.bak3 '/^ par$/{
- N
- s/\n note over : .*//
- }' "$file"
- echo " Fixed: $file"
- fi
-done
-
-cd - > /dev/null
-
-# Outer sequence files
-cd design/backend/sequence/outer
-
-if [ -f "이벤트생성플로우.puml" ]; then
- echo "Processing: 이벤트생성플로우.puml"
- sed -i.bak3 '/^par$/{
- N
- s/\n note over : .*//
- }' "이벤트생성플로우.puml"
- echo " Fixed: 이벤트생성플로우.puml"
-fi
-
-cd - > /dev/null
-
-echo "All par blocks fixed."
diff --git a/fix-puml-syntax.sh b/fix-puml-syntax.sh
deleted file mode 100755
index f247161..0000000
--- a/fix-puml-syntax.sh
+++ /dev/null
@@ -1,74 +0,0 @@
-#!/bin/bash
-
-# PlantUML 문법 오류 수정 스크립트
-# [ 문법을 Client participant로 변경
-
-echo "====================================="
-echo "PlantUML 파일 문법 수정 시작"
-echo "====================================="
-echo ""
-
-# 수정할 파일 목록
-FILES=(
- "design/backend/sequence/inner/user-로그인.puml"
- "design/backend/sequence/inner/user-로그아웃.puml"
- "design/backend/sequence/inner/user-프로필수정.puml"
- "design/backend/sequence/inner/ai-트렌드분석및추천.puml"
- "design/backend/sequence/inner/content-이미지생성.puml"
- "design/backend/sequence/inner/distribution-다중채널배포.puml"
- "design/backend/sequence/inner/event-대시보드조회.puml"
- "design/backend/sequence/outer/이벤트생성플로우.puml"
-)
-
-for file in "${FILES[@]}"; do
- if [ ! -f "$file" ]; then
- echo "❌ 파일이 존재하지 않음: $file"
- continue
- fi
-
- echo "수정 중: $file"
-
- # 백업 생성
- cp "$file" "${file}.bak"
-
- # 1. Client actor가 없으면 추가 (첫 번째 participant 앞에)
- if ! grep -q "^actor Client" "$file"; then
- # title 다음 줄에 빈 줄이 있고, 그 다음에 participant가 나오는 경우
- sed -i.tmp '/^title /a\
-\
-actor Client' "$file"
- rm "${file}.tmp" 2>/dev/null
- echo " - Client actor 추가됨"
- fi
-
- # 2. [-> 패턴을 Client -> 로 변경
- if grep -q "\[-> " "$file"; then
- sed -i.tmp 's/\[-> /Client -> /g' "$file"
- rm "${file}.tmp" 2>/dev/null
- echo " - [-> 패턴 수정됨"
- fi
-
- # 3. -->[ 패턴을 --> Client 로 변경
- if grep -q " -->\[" "$file"; then
- sed -i.tmp 's/ -->\[/ --> Client/g' "$file"
- rm "${file}.tmp" 2>/dev/null
- echo " - -->[ 패턴 수정됨"
- fi
-
- # 4. --> [: 패턴을 --> Client: 로 변경
- if grep -q " --> \[:" "$file"; then
- sed -i.tmp 's/ --> \[:/ --> Client:/g' "$file"
- rm "${file}.tmp" 2>/dev/null
- echo " - --> [: 패턴 수정됨"
- fi
-
- echo " ✅ 완료: $file"
- echo ""
-done
-
-echo "====================================="
-echo "모든 파일 수정 완료"
-echo "====================================="
-echo ""
-echo "백업 파일: *.puml.bak"
-echo "백업 삭제: find design/backend/sequence -name '*.bak' -delete"
diff --git a/test-basic.png b/test-basic.png
deleted file mode 100644
index ceca439..0000000
Binary files a/test-basic.png and /dev/null differ
diff --git a/test-basic.puml b/test-basic.puml
deleted file mode 100644
index 52fdf74..0000000
--- a/test-basic.puml
+++ /dev/null
@@ -1,7 +0,0 @@
-@startuml test-basic
-!theme mono
-
-Alice -> Bob: test message
-Bob --> Alice: response
-
-@enduml
diff --git a/test-group.png b/test-group.png
deleted file mode 100644
index 6436397..0000000
Binary files a/test-group.png and /dev/null differ
diff --git a/test-group.puml b/test-group.puml
deleted file mode 100644
index 84b4cb1..0000000
--- a/test-group.puml
+++ /dev/null
@@ -1,11 +0,0 @@
-@startuml test-group
-!theme mono
-
-Alice -> Bob: msg1
-group parallel
-Alice -> Bob: msg2
-Alice -> Bob: msg3
-end
-Alice -> Bob: msg4
-
-@enduml
diff --git a/test-par-correct.png b/test-par-correct.png
deleted file mode 100644
index b257c77..0000000
Binary files a/test-par-correct.png and /dev/null differ
diff --git a/test-par-correct.puml b/test-par-correct.puml
deleted file mode 100644
index 9e15171..0000000
--- a/test-par-correct.puml
+++ /dev/null
@@ -1,28 +0,0 @@
-@startuml test-par-correct
-!theme mono
-
-participant "Service" as Service
-participant "Repo" as Repo
-database "DB" as DB
-
-par
- Service -> Repo: query1
- activate Repo
- Repo -> DB: SELECT 1
- activate DB
- DB --> Repo: result1
- deactivate DB
- Repo --> Service: data1
- deactivate Repo
- and
- Service -> Repo: query2
- activate Repo
- Repo -> DB: SELECT 2
- activate DB
- DB --> Repo: result2
- deactivate DB
- Repo --> Service: data2
- deactivate Repo
-end
-
-@enduml
diff --git a/test-par-no-activate.png b/test-par-no-activate.png
deleted file mode 100644
index 4fe325d..0000000
Binary files a/test-par-no-activate.png and /dev/null differ
diff --git a/test-par-no-activate.puml b/test-par-no-activate.puml
deleted file mode 100644
index 6c738ec..0000000
--- a/test-par-no-activate.puml
+++ /dev/null
@@ -1,28 +0,0 @@
-@startuml test-par-no-activate
-!theme mono
-
-participant "Service" as Service
-participant "Repo" as Repo
-database "DB" as DB
-
-par
- Service -> Repo: query1
- activate Repo
- Repo -> DB: SELECT 1
- activate DB
- DB --> Repo: result1
- deactivate DB
- Repo --> Service: data1
- deactivate Repo
-and
- Service -> Repo: query2
- activate Repo
- Repo -> DB: SELECT 2
- activate DB
- DB --> Repo: result2
- deactivate DB
- Repo --> Service: data2
- deactivate Repo
-end
-
-@enduml
diff --git a/test-par.png b/test-par.png
deleted file mode 100644
index 28f3916..0000000
Binary files a/test-par.png and /dev/null differ
diff --git a/test-par.puml b/test-par.puml
deleted file mode 100644
index 64e10f8..0000000
--- a/test-par.puml
+++ /dev/null
@@ -1,34 +0,0 @@
-@startuml test-par
-!theme mono
-
-participant "Service" as Service
-participant "Repo" as Repo
-database "DB" as DB
-
-Service -> Service: test
-activate Service
-
- par
- Service -> Repo: query1
- activate Repo
- Repo -> DB: SELECT 1
- activate DB
- DB --> Repo: result1
- deactivate DB
- Repo --> Service: data1
- deactivate Repo
- and
- Service -> Repo: query2
- activate Repo
- Repo -> DB: SELECT 2
- activate DB
- DB --> Repo: result2
- deactivate DB
- Repo --> Service: data2
- deactivate Repo
- end
-
-Service --> Service: done
-deactivate Service
-
-@enduml
diff --git a/test-simple-par.puml b/test-simple-par.puml
deleted file mode 100644
index f15d700..0000000
--- a/test-simple-par.puml
+++ /dev/null
@@ -1,12 +0,0 @@
-@startuml test-simple
-!theme mono
-
-Alice -> Bob: msg1
-par
-Alice -> Bob: msg2
-and
-Alice -> Bob: msg3
-end
-Alice -> Bob: msg4
-
-@enduml
diff --git a/test-simple.png b/test-simple.png
deleted file mode 100644
index 58cf15a..0000000
Binary files a/test-simple.png and /dev/null differ
diff --git a/validate-puml-fixed.sh b/validate-puml-fixed.sh
deleted file mode 100755
index d4f0932..0000000
--- a/validate-puml-fixed.sh
+++ /dev/null
@@ -1,93 +0,0 @@
-#!/bin/bash
-
-# PlantUML 파일 검증 스크립트 (UTF-8 인코딩 수정 버전)
-# localhost:38080 서버를 사용하여 문법 검사
-
-echo "====================================="
-echo "PlantUML 파일 검증 시작 (UTF-8)"
-echo "====================================="
-echo ""
-
-SUCCESS_COUNT=0
-FAIL_COUNT=0
-TOTAL_COUNT=0
-
-# 검증 결과 저장 디렉토리
-RESULT_DIR="debug/puml-validation"
-mkdir -p "$RESULT_DIR"
-
-# 결과 파일 초기화
-RESULT_FILE="$RESULT_DIR/validation-result.txt"
-ERROR_FILE="$RESULT_DIR/validation-errors.txt"
-> "$RESULT_FILE"
-> "$ERROR_FILE"
-
-# design/backend/sequence 하위의 모든 .puml 파일 검증
-while IFS= read -r file; do
- TOTAL_COUNT=$((TOTAL_COUNT + 1))
- filename=$(basename "$file")
-
- echo "[$TOTAL_COUNT] 검증 중: $file"
-
- # PlantUML 서버로 POST 요청 (UTF-8 charset 명시)
- HTTP_CODE=$(curl -s -w "%{http_code}" -X POST \
- http://localhost:38080/png \
- -H "Content-Type: text/plain; charset=UTF-8" \
- --data-binary "@$file" \
- -o "$RESULT_DIR/${filename}.png" 2>&1 | tail -1)
-
- if [ "$HTTP_CODE" = "200" ]; then
- # PNG 파일이 정상적으로 생성되었는지 확인
- if [ -f "$RESULT_DIR/${filename}.png" ] && [ -s "$RESULT_DIR/${filename}.png" ]; then
- # 이미지가 실제 유효한지 확인 (파일 매직 넘버 확인)
- if file "$RESULT_DIR/${filename}.png" | grep -q "PNG image data"; then
- echo " ✅ 성공: $filename"
- echo "✅ $file - HTTP $HTTP_CODE" >> "$RESULT_FILE"
- SUCCESS_COUNT=$((SUCCESS_COUNT + 1))
- else
- echo " ❌ 실패: $filename (유효하지 않은 PNG)"
- echo "❌ $file - 유효하지 않은 PNG 파일" >> "$ERROR_FILE"
- FAIL_COUNT=$((FAIL_COUNT + 1))
- fi
- else
- echo " ❌ 실패: $filename (빈 파일)"
- echo "❌ $file - 빈 PNG 파일" >> "$ERROR_FILE"
- FAIL_COUNT=$((FAIL_COUNT + 1))
- fi
- else
- echo " ❌ 실패: $filename (HTTP $HTTP_CODE)"
- echo "❌ $file - HTTP $HTTP_CODE" >> "$ERROR_FILE"
-
- # 오류 내용 저장 (txt 엔드포인트로 오류 메시지 확인)
- curl -s -X POST \
- http://localhost:38080/txt \
- -H "Content-Type: text/plain; charset=UTF-8" \
- --data-binary "@$file" \
- -o "$RESULT_DIR/${filename}.error.txt" 2>&1
-
- echo " 오류 상세: $RESULT_DIR/${filename}.error.txt" >> "$ERROR_FILE"
- FAIL_COUNT=$((FAIL_COUNT + 1))
- fi
-
- echo ""
-done < <(find design/backend/sequence -name "*.puml" -type f | sort)
-
-echo "====================================="
-echo "검증 완료"
-echo "====================================="
-echo "총 파일 수: $TOTAL_COUNT"
-echo "성공: $SUCCESS_COUNT"
-echo "실패: $FAIL_COUNT"
-echo ""
-echo "상세 결과: $RESULT_FILE"
-if [ $FAIL_COUNT -gt 0 ]; then
- echo "오류 상세: $ERROR_FILE"
-fi
-echo "====================================="
-
-# 실패한 파일이 있으면 종료 코드 1 반환
-if [ $FAIL_COUNT -gt 0 ]; then
- exit 1
-else
- exit 0
-fi
diff --git a/validate-puml.sh b/validate-puml.sh
deleted file mode 100755
index db5a942..0000000
--- a/validate-puml.sh
+++ /dev/null
@@ -1,86 +0,0 @@
-#!/bin/bash
-
-# PlantUML 파일 검증 스크립트
-# localhost:38080 서버를 사용하여 문법 검사
-
-echo "====================================="
-echo "PlantUML 파일 검증 시작"
-echo "====================================="
-echo ""
-
-SUCCESS_COUNT=0
-FAIL_COUNT=0
-TOTAL_COUNT=0
-
-# 검증 결과 저장 디렉토리
-RESULT_DIR="debug/puml-validation"
-mkdir -p "$RESULT_DIR"
-
-# 결과 파일 초기화
-RESULT_FILE="$RESULT_DIR/validation-result.txt"
-ERROR_FILE="$RESULT_DIR/validation-errors.txt"
-> "$RESULT_FILE"
-> "$ERROR_FILE"
-
-# design/backend/sequence 하위의 모든 .puml 파일 검증
-while IFS= read -r file; do
- TOTAL_COUNT=$((TOTAL_COUNT + 1))
- filename=$(basename "$file")
-
- echo "[$TOTAL_COUNT] 검증 중: $file"
-
- # PlantUML 서버로 POST 요청
- HTTP_CODE=$(curl -s -w "%{http_code}" -X POST \
- http://localhost:38080/png \
- -H "Content-Type: text/plain" \
- --data-binary "@$file" \
- -o "$RESULT_DIR/${filename}.png" 2>&1 | tail -1)
-
- if [ "$HTTP_CODE" = "200" ]; then
- # PNG 파일이 정상적으로 생성되었는지 확인
- if [ -f "$RESULT_DIR/${filename}.png" ] && [ -s "$RESULT_DIR/${filename}.png" ]; then
- echo " ✅ 성공: $filename"
- echo "✅ $file - HTTP $HTTP_CODE" >> "$RESULT_FILE"
- SUCCESS_COUNT=$((SUCCESS_COUNT + 1))
- else
- echo " ❌ 실패: $filename (빈 파일)"
- echo "❌ $file - 빈 PNG 파일" >> "$ERROR_FILE"
- FAIL_COUNT=$((FAIL_COUNT + 1))
- fi
- else
- echo " ❌ 실패: $filename (HTTP $HTTP_CODE)"
- echo "❌ $file - HTTP $HTTP_CODE" >> "$ERROR_FILE"
-
- # 오류 내용 저장
- curl -s -X POST \
- http://localhost:38080/png \
- -H "Content-Type: text/plain" \
- --data-binary "@$file" \
- -o "$RESULT_DIR/${filename}.error.txt" 2>&1
-
- echo " 오류 상세: $RESULT_DIR/${filename}.error.txt" >> "$ERROR_FILE"
- FAIL_COUNT=$((FAIL_COUNT + 1))
- fi
-
- echo ""
-done < <(find design/backend/sequence -name "*.puml" -type f | sort)
-
-echo "====================================="
-echo "검증 완료"
-echo "====================================="
-echo "총 파일 수: $TOTAL_COUNT"
-echo "성공: $SUCCESS_COUNT"
-echo "실패: $FAIL_COUNT"
-echo ""
-echo "상세 결과: $RESULT_FILE"
-if [ $FAIL_COUNT -gt 0 ]; then
- echo "오류 상세: $ERROR_FILE"
-fi
-echo "====================================="
-
-# 실패한 파일이 있으면 종료 코드 1 반환
-if [ $FAIL_COUNT -gt 0 ]; then
- exit 1
-else
- exit 0
-fi