kt-event-marketing-fe/API_CHANGES.md

Content API 변경사항

📋 주요 변경사항 요약

1. eventDraftId → eventId 타입 변경

항목	기존 (Old)	변경 (New)
필드명	eventDraftId	eventId
타입	number	string
예시	7777	"7777"

---

🔄 영향을 받는 인터페이스

GenerateImagesRequest

Before:

interface GenerateImagesRequest {
  eventDraftId: number;
  eventTitle: string;
  eventDescription: string;
  industry?: string;
  location?: string;
  trends?: string[];
  styles: ('SIMPLE' | 'FANCY' | 'TRENDY')[];
  platforms: ('INSTAGRAM' | 'NAVER' | 'KAKAO')[];
}

After:

interface GenerateImagesRequest {
  eventId: string;  // Changed from eventDraftId: number
  eventTitle: string;
  eventDescription: string;
  industry?: string;
  location?: string;
  trends?: string[];
  styles: ('SIMPLE' | 'FANCY' | 'TRENDY')[];
  platforms: ('INSTAGRAM' | 'NAVER' | 'KAKAO')[];
}

JobInfo

Before:

interface JobInfo {
  id: string;
  eventDraftId: number;
  jobType: string;
  status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED';
  progress: number;
  resultMessage?: string;
  errorMessage?: string;
  createdAt: string;
  updatedAt: string;
}

After:

interface JobInfo {
  id: string;
  eventId: string;  // Changed from eventDraftId: number
  jobType: string;
  status: 'PENDING' | 'PROCESSING' | 'COMPLETED' | 'FAILED';
  progress: number;
  resultMessage?: string;
  errorMessage?: string;
  createdAt: string;
  updatedAt: string;
}

ImageInfo

Before:

interface ImageInfo {
  id: number;
  eventDraftId: number;
  style: 'SIMPLE' | 'FANCY' | 'TRENDY';
  platform: 'INSTAGRAM' | 'NAVER' | 'KAKAO';
  cdnUrl: string;
  prompt: string;
  selected: boolean;
  createdAt: string;
  updatedAt: string;
}

After:

interface ImageInfo {
  id: number;
  eventId: string;  // Changed from eventDraftId: number
  style: 'SIMPLE' | 'FANCY' | 'TRENDY';
  platform: 'INSTAGRAM' | 'NAVER' | 'KAKAO';
  cdnUrl: string;
  prompt: string;
  selected: boolean;
  createdAt: string;
  updatedAt: string;
}

ContentInfo

Before:

interface ContentInfo {
  id: number;
  eventDraftId: number;
  eventTitle: string;
  eventDescription: string;
  images: ImageInfo[];
  createdAt: string;
  updatedAt: string;
}

After:

interface ContentInfo {
  id: number;
  eventId: string;  // Changed from eventDraftId: number
  eventTitle: string;
  eventDescription: string;
  images: ImageInfo[];
  createdAt: string;
  updatedAt: string;
}

---

📝 수정된 파일 목록

1. Type Definitions

• ✅ src/shared/api/contentApi.ts
  • GenerateImagesRequest interface updated
  • JobInfo interface updated
  • ImageInfo interface updated
  • ContentInfo interface updated
  • API function signatures updated

2. Components

• ✅ src/app/(main)/events/create/steps/ContentPreviewStep.tsx
  • EventCreationData interface: eventDraftId: number → eventDraftId: string
  • Mock data updated to use string type
  • API call updated: eventDraftId → eventId

3. Mock Data Files

• ✅ public/init-mock-data.html

  • eventDraftId: 7777 → eventDraftId: "7777"

• ✅ MOCK_DATA_SETUP.md

  • All mock data examples updated to string type
  • Documentation notes added about type change

4. API Routes (Next.js Proxy)

• ✅ src/app/api/content/images/generate/route.ts (no changes needed)
• ✅ src/app/api/content/images/jobs/[jobId]/route.ts (no changes needed)
• ✅ src/app/api/content/events/[eventDraftId]/images/route.ts
  • Comment added about eventId parameter

---

🧪 테스트 예시

API 요청 예시

Before:

POST /api/v1/content/images/generate
{
  "eventDraftId": 7777,
  "eventTitle": "맥주 파티 이벤트",
  "eventDescription": "강남에서 열리는 신나는 맥주 파티",
  "industry": "음식점",
  "location": "강남",
  "trends": ["파티", "맥주", "생맥주"],
  "styles": ["SIMPLE", "FANCY", "TRENDY"],
  "platforms": ["INSTAGRAM"]
}

After:

POST /api/v1/content/images/generate
{
  "eventId": "7777",
  "eventTitle": "맥주 파티 이벤트",
  "eventDescription": "강남에서 열리는 신나는 맥주 파티",
  "industry": "음식점",
  "location": "강남",
  "trends": ["파티", "맥주", "생맥주"],
  "styles": ["SIMPLE", "FANCY", "TRENDY"],
  "platforms": ["INSTAGRAM"]
}

localStorage Mock 데이터

Before:

localStorage.setItem('eventCreationData', JSON.stringify({
  eventDraftId: 7777,
  eventTitle: "맥주 파티 이벤트",
  // ...
}));

After:

localStorage.setItem('eventCreationData', JSON.stringify({
  eventDraftId: "7777",  // String type now
  eventTitle: "맥주 파티 이벤트",
  // ...
}));

---

✅ 마이그레이션 체크리스트

• TypeScript 인터페이스 업데이트
• API 호출 코드 수정
• Mock 데이터 타입 변경
• 문서 업데이트
• 빌드 성공 확인
• 개발 서버 테스트
• 실제 API 연동 테스트

---

🔗 관련 API 문서

• Swagger UI: http://localhost:8084/swagger-ui/index.html
• OpenAPI Spec: http://localhost:8084/v3/api-docs

---

📌 주의사항

1. 타입 주의: eventId는 이제 string 타입입니다. 숫자로 사용하지 마세요.
2. Mock 데이터: localStorage에 저장할 때 문자열 타입으로 저장해야 합니다.
3. API 호출: 프론트엔드에서 백엔드로 전송 시 string으로 전송됩니다.
4. 하위 호환성: 기존 number 타입 데이터는 작동하지 않으므로 localStorage를 초기화해야 합니다.

---

🔄 롤백 방법

만약 이전 버전으로 돌아가야 한다면:

1. git revert 또는 특정 커밋으로 복원
2. localStorage 초기화: localStorage.removeItem('eventCreationData')
3. 개발 서버 재시작