팁과 요령

Order (부모)
├── OrderItem (자식)
├── OrderPayment (자식)
└── OrderShipment (자식)

❌ 나쁜 예:
"사용자 만들어줘"

✅ 좋은 예:
"이커머스 사용자 Entity를 만들어줘.
필드: 이메일(unique), 이름, 전화번호(nullable),
역할(enum: admin, user, guest),
생성일, 마지막 로그인"

{
  properties: [
    // 1. Primary Key
    { name: "id", ... },

    // 2. 핵심 정보
    { name: "title", ... },
    { name: "content", ... },

    // 3. 외래키
    { name: "user_id", ... },
    { name: "category_id", ... },

    // 4. 상태/플래그
    { name: "status", ... },
    { name: "is_active", ... },

    // 5. 타임스탬프
    { name: "created_at", ... },
    { name: "updated_at", ... },
  ]
}

❌ 나쁜 예:
- 10개 Entity 한번에 수정
- 1주일에 한 번 마이그레이션

✅ 좋은 예:
- 1-2개 Entity씩 수정
- 하루에 여러 번 마이그레이션
- 각 마이그레이션 후 테스트

□ Development DB에서 테스트 완료
□ Testing DB에서 검증 완료
□ 데이터 백업 완료
□ 마이그레이션 Preview 확인
□ 롤백 계획 수립
□ 팀원에게 공지
□ Production DB 마이그레이션 실행
□ 애플리케이션 재시작 및 확인

1. 모든 Entity 정의
2. [Select All] → Model + Test 일괄 생성
3. 각 Model에 비즈니스 로직 추가

1. 새 Entity 하나만 추가
2. 해당 Entity만 선택하여 생성
3. 즉시 개발 시작

# 백업
cp src/models/User.model.ts src/models/User.model.ts.bak

# 재생성
[UI에서 Overwrite]

# 필요한 로직 복원

git add src/models/
git commit -m "Generate models for User, Post, Comment"

// 모든 Entity에 공통 적용

Subset A: 목록용
- id
- title (또는 name)
- 핵심 1-2개 필드
- created_at

Subset B: 상세용
- 모든 일반 필드
- 민감 정보 제외
- 타임스탬프 포함

Subset C: 관계 포함
- Subset B 기반
- 필요한 관계 추가

// ❌ 과도한 필드
{
  ...모든필드,
  author: "User.C",  // User의 모든 관계까지
  category: "Category.B",
  tags: "Tag.C",
}

// ✅ 최적화
{
  id: true,
  title: true,
  content: true,
  author: "User.A",  // 최소 정보만
  category_id: true,
  created_at: true,
}

user email       → User Entity의 email 필드
post migration   → Post 관련 마이그레이션
subset A         → 모든 Subset A

1. Entity 정의 (Entity 탭)
   - AI 채팅으로 빠른 생성
   - 필드와 관계 설정
   ↓
2. Subset 정의 (Entity 탭 내)
   - A, B, C 표준 Subset 생성
   ↓
3. Migration 실행 (Migration 탭)
   - Preview 확인
   - Development → Testing 순서로 실행
   ↓
4. Scaffolding (Scaffolding 탭)
   - Model + Test 생성
   ↓
5. 개발 (코드 에디터)
   - Model 메서드 추가
   - API 엔드포인트 구현
   - 테스트 작성
   ↓
6. Fixture 등록 (Fixture 탭)
   - 테스트 데이터 준비

1. Entity 수정 (Entity 탭)
   - 필드 추가/수정/삭제
   ↓
2. Migration 생성 확인 (Migration 탭)
   - 자동 생성된 마이그레이션 확인
   ↓
3. Preview 검토
   - 의도한 변경사항인지 확인
   - 데이터 손실 위험 체크
   ↓
4. Migration 실행
   - Development → Testing 순서
   ↓
5. Model 수정 (필요 시)
   - 타입 자동 동기화 확인
   - 새 필드 활용 로직 추가

F12 → Network 탭

- 마이그레이션 실행 → /api/migrate/run 확인
- Entity 저장 → /api/entity/save 확인
- 에러 발생 시 응답 내용 확인

F12 → Console 탭

- JavaScript 에러 확인
- API 응답 에러 로그
- 네트워크 요청 실패 원인