Vibe Coding을 넘어: Product Builder 만들기

❌ LLM 바이브 코딩의 멱등성 문제
─────────────────────────────────
Day 1: "피드백 CRUD 만들어줘" → FeedbackService.create()
Day 2: "피드백 CRUD 만들어줘" → FeedbackHandler.save()   ← 다른 결과!
Day 3: "피드백 CRUD 만들어줘" → feedbackRepository.add() ← 또 다른 결과!

✅ ITDALIFE의 멱등성 보장
─────────────────────────
같은 DSL → 항상 같은 코드 (100% 재현 가능)

Day 1: feedback.core.dsl → FeedbackService.create()
Day 2: feedback.core.dsl → FeedbackService.create()  ← 항상 동일!
Day 3: feedback.core.dsl → FeedbackService.create()  ← 항상 동일!

+ 3개 플랫폼 동시 생성 (Backend/Web/Mobile)

@Entity
@Table(name = "feedbacks")
public class Feedback {
  @Id @GeneratedValue
  private UUID id;
  @Column(nullable = false)
  private String title;
  @Enumerated(EnumType.STRING)
  private FeedbackStatus status;
  private String content;
  // getter, setter, builder...
}

aggregate Feedback {
  title  : string @required
  status : FeedbackStatus
  content: text
}

당신은 ITDALIFE 프로젝트의 PRD 전문가입니다.

PRD 작성 시 EARS 5개 패턴을 모두 정의해야 합니다:

| EARS 패턴 | PRD 섹션 | DSL 블록 |
|-----------|----------|----------|
| E (Event) | 사용자 스토리 US-NNN | usecase {} |
| S (State) | 워크플로우 (상태 전이) | stateMachine {} |
| U (Ubiquitous) | 인수 조건 (항상 만족) | invariants {} |
| O (Optional) | 비기능 요구사항 | capabilities {} |
| W (Unwanted) | 에러 시나리오 | api.errors {} |

명명 규칙:
- 제품명: kebab-case (feedback, hotel-booking)
- 역할: UPPER_SNAKE_CASE (USER, ADMIN)
- 엔티티: PascalCase 단수형 (Feedback, Category)

# Feedback Manager PRD

## 1. 개요
- 목적: 사용자 피드백을 수집, 분류, 관리하고 답변을 제공
- 대상 사용자: 서비스 운영팀, 일반 사용자, 관리자

## 2. 사용자 스토리
**US-001**: 피드백 제출
> 사용자로서, 서비스에 대한 피드백을 제출하고 싶다.

**US-100**: 피드백 검토
> 관리자로서, 접수된 피드백을 검토하고 승인/거절하고 싶다.

## 3. 워크플로우
| 전이 ID | 전이 | 권한 |
|---------|------|------|
| S-001 | PENDING → APPROVED | ADMIN |
| S-002 | PENDING → REJECTED | ADMIN |

## 4. 에러 시나리오
| 에러 ID | 상황 | HTTP |
|---------|------|------|
| W-001 | 피드백 없음 | 404 |
| W-002 | 잘못된 상태 전이 | 400 |

당신은 ITDALIFE 프로젝트의 Core DSL 전문가입니다.

DSL 구조 (블록 순서 필수):
1. domain {} - 제품 메타데이터
2. enum {} - 열거형
3. aggregate {} - 엔티티 + stateMachine
4. usecase {} - 명령/쿼리
5. api {} - 엔드포인트 + 에러
6. security {} - 역할/권한

@ears() 어노테이션 필수 (PRD 추적성):
- stateMachine { @ears("S-001") transition ... }
- api.errors { @ears("W-001") ... }

domain "feedback" {
    description = "사용자 피드백 관리 서비스"
    features {
        oauth { enabled = true, providers = ["google"] }
        audit = true
    }
}

enum FeedbackStatus {
    PENDING   @label("대기") @color("yellow")
    APPROVED  @label("승인") @color("green")
    REJECTED  @label("거절") @color("red")
}

aggregate Feedback {
    id       : uuid           @pk @auto
    title    : string         @required @maxLength(200)
    content  : text           @required
    status   : FeedbackStatus @default("PENDING")

    stateMachine {
        initial = PENDING
        @ears("S-001")
        transition PENDING -> APPROVED { action = "approve" roles = ["ADMIN"] }
        @ears("S-002")
        transition PENDING -> REJECTED { action = "reject" roles = ["ADMIN"] }
    }
}

api {
    errors {
        @ears("W-001") FEEDBACK_NOT_FOUND { code = 404 }
        @ears("W-002") INVALID_STATUS_TRANSITION { code = 400 }
    }
}

extend "feedback.core.dsl"

frontend {
  template = "shadcn"
  port = 3001
}

extend aggregate Feedback {
  ui {
    menu { label = "피드백", icon = "message-square", order = 1 }

    list {
      display = ["title", "status", "category", "createdAt"]
      columns {
        status { render = "badge", width = "120px" }
      }
    }

    create {
      groups {
        basic { label = "기본 정보", fields = ["title", "category"] }
        content { label = "내용", fields = ["content"] }
      }
    }

    colorMaps {
      status { PENDING = "yellow", APPROVED = "green", REJECTED = "red" }
    }
  }
}

./scripts/itdalife-workflow.sh feedback

# 출력:
# [STEP] Building code-generator...
# [STEP] Validating DSL...
# [STEP] Generating backend... (24 files)
# [STEP] Generating frontend... (18 files)
# [STEP] Generating mobile... (15 files)
# [STEP] Verifying build...
# [INFO] ✅ All targets built successfully!

products/feedback/
├── backend/                      # Spring Boot
│   └── src/main/kotlin/
│       ├── domain/FeedbackEntity.kt
│       ├── service/FeedbackService.kt
│       └── controller/FeedbackController.kt
│
├── frontend/                     # Next.js + shadcn/ui
│   └── src/
│       ├── app/[locale]/(dashboard)/feedback/page.tsx
│       └── hooks/useFeedback.ts
│
└── mobile/                       # Flutter + Riverpod
    └── lib/features/feedback/
        ├── presentation/screens/feedback_list_screen.dart
        └── providers/feedback_provider.dart

❌ 잘못된 방법
products/feedback/backend/FeedbackService.kt 직접 수정
→ 다음 재생성 시 덮어씌워짐

✅ 올바른 방법
1. DSL 수정 → 재생성
2. 생성기 수정 → 재생성 → 모든 제품에 일관되게 적용

// Code generated by ITDALIFE Code Generator. DO NOT EDIT.

// @generated-start crud-hooks
export function useFeedbackList() { ... }
export function useFeedbackCreate() { ... }
// @generated-end crud-hooks

// @manual-start custom-hooks    ← 개발자가 추가한 영역
export function useFeedbackStatistics() {
    // 커스텀 통계 로직
}
// @manual-end

aggregate {
  title: string
  status: enum
+ priority: int  # ← 필드 추가
}

-- V1_20260205_001__alter_feedbacks.sql
ALTER TABLE feedbacks ADD COLUMN priority INTEGER;

# 개발 환경 시작 (한 줄)
./scripts/dev-env.sh start

# 출력:
# [CHECK] Checking port 5433... available
# [CHECK] Checking port 6380... available
# [START] Starting Docker containers...
# [WAIT] Waiting for PostgreSQL health check...
# [WAIT] Waiting for Redis health check...
# [INFO] ✅ Development environment ready!

# 상태 확인
./scripts/dev-env.sh status

# 종료
./scripts/dev-env.sh stop

/itda-product-test-all feedback