04. 생성기 고급 옵션

python -m src.cli.generate --size small     # 학습용 (추천)
python -m src.cli.generate --size medium    # 성능 테스트
python -m src.cli.generate --size large     # 대용량 벤치마크

# 특정 1년만 생성
python -m src.cli.generate --start-date 2024-01-01 --end-date 2024-12-31

# 특정 분기만
python -m src.cli.generate --start-date 2024-07-01 --end-date 2024-09-30

python -m src.cli.generate --locale ko    # 한국어 (기본)
python -m src.cli.generate --locale en    # 영어

{
  "faker_locale": "ja_JP",
  "phone": {
    "format": "090-{0:04d}-{1:04d}",
    "description": "日本の仮想携帯番号"
  },
  "email": {
    "customer_domains": [
      ["testmail.jp", 0.30],
      ["fakemail.jp", 0.20],
      ["example.co.jp", 0.15]
    ],
    "staff_domain": "techshop-staff.jp",
    "supplier_domain": "test.jp"
  },
  "categories": {
    "desktop-prebuilt": "デスクトップPC",
    "laptop-general": "ノートパソコン",
    "monitor-general": "モニター",
    "keyboard-mechanical": "メカニカルキーボード"
  },
  "shipping": {
    "carriers": {
      "ヤマト運輸": 0.40,
      "佐川急便": 0.30,
      "日本郵便": 0.20,
      "西濃運輸": 0.10
    }
  },
  "holidays": {
    "01-01": "元日",
    "01-13": "成人の日",
    "02-11": "建国記念の日",
    "03-21": "春分の日",
    "05-03": "憲法記念日"
  },
  "coupon": {
    "names": [
      "新規登録クーポン",
      "お誕生日クーポン",
      "リピーター限定割引"
    ]
  }
}

python -m src.cli.generate --dirty-data

python -m src.cli.generate --seed 42     # 항상 동일한 데이터
python -m src.cli.generate --seed 42     # 위와 바이트 단위까지 동일
python -m src.cli.generate --seed 100    # 완전히 다른 데이터

seed: 42                          # 랜덤 시드
locale: ko_KR                     # 데이터 로케일
shop_name: "테크샵(TechShop)"     # 쇼핑몰 이름
start_date: "2016-01-01"          # 데이터 시작일
end_date: "2025-12-31"            # 데이터 종료일
size: medium                      # 기본 규모

yearly_growth:
  2016: { new_customers: 1000,  orders_per_day: [15, 25],   active_products: 300 }
  2020: { new_customers: 4500,  orders_per_day: [80, 120],  active_products: 1500 }
  2025: { new_customers: 7500,  orders_per_day: [150, 200], active_products: 2800 }

monthly_seasonality:
  1: 0.85     # 1월 비수기
  3: 1.15     # 신학기
  7: 0.85     # 여름 비수기
  11: 1.25    # 블랙프라이데이
  12: 1.20    # 연말 세일

order:
  free_shipping_threshold: 50000   # 무료배송 기준 (5만원)
  default_shipping_fee: 3000       # 기본 배송비
  cancellation_rate: 0.05          # 취소율 5%
  return_rate: 0.03                # 반품율 3%
  points_earn_rate: 0.01           # 결제금액 1% 적립

payment_methods:
  card: 0.45            # 신용카드 45%
  kakao_pay: 0.20       # 카카오페이 20%
  naver_pay: 0.15       # 네이버페이 15%
  bank_transfer: 0.10   # 계좌이체 10%
  virtual_account: 0.05 # 가상계좌 5%
  point: 0.05           # 포인트 5%

review:
  write_rate: 0.25               # 구매 확정의 25%가 리뷰 작성
  rating_distribution:           # 별점 분포 (현실적 J자 커브)
    5: 0.40
    4: 0.30
    3: 0.15
    2: 0.10
    1: 0.05

customer_grades:
  BRONZE: 0          # 기본
  SILVER: 500000     # 최근 1년 50만원 이상
  GOLD: 2000000      # 최근 1년 200만원 이상
  VIP: 5000000       # 최근 1년 500만원 이상

edge_cases:
  null_birth_date: 0.15          # 생년월일 NULL 15%
  null_gender: 0.10              # 성별 NULL 10%
  long_product_name: 0.01        # 200자 이상 상품명 1%
  zero_payment: 0.01             # 포인트 전액 결제 1%
  no_review_products: 0.20       # 리뷰 없는 상품 20%

generate.py                 ← 메인 실행 스크립트
verify.py                   ← 환경 검증 스크립트
config.yaml                 ← 기본 설정 파일
config_detailed.yaml        ← 세부 파라미터 (120+)
data/
├── categories.json         ← 상품 카테고리 마스터 (수동 큐레이션)
├── products.json           ← 상품 마스터 (브랜드, 모델명, 가격대)
├── suppliers.json          ← 공급업체 마스터
└── locale/
    ├── ko.json             ← 한국어 로케일 데이터
    └── en.json             ← 영어 로케일 데이터
src/
├── generators/             ← 데이터 생성 모듈
│   ├── base.py             ← 공통 생성 로직 (BaseGenerator)
│   ├── customers.py        ← 고객 + 주소
│   ├── products.py         ← 상품 + 카테고리 + 공급업체
│   ├── orders.py           ← 주문 + 주문상세
│   ├── payments.py         ← 결제
│   ├── shipping.py         ← 배송
│   ├── reviews.py          ← 리뷰
│   ├── inventory.py        ← 재고 입출고
│   ├── staff.py            ← 직원
│   ├── images.py           ← 상품 이미지 + Pexels 다운로드
│   ├── carts.py            ← 장바구니
│   ├── coupons.py          ← 쿠폰 + 사용 내역
│   ├── complaints.py       ← 문의/불만
│   ├── returns.py          ← 반품/교환
│   ├── calendar.py         ← 날짜 차원 테이블
│   ├── grade_history.py    ← 고객 등급 이력
│   ├── tags.py             ← 상품 태그
│   ├── views.py            ← 상품 조회 로그
│   ├── points.py           ← 포인트 거래
│   ├── promotions.py       ← 프로모션
│   ├── qna.py              ← 상품 Q&A
│   ├── wishlists.py        ← 위시리스트
│   └── dirty.py            ← 더티 데이터 노이즈 주입
├── exporters/              ← DB별 출력 모듈
│   ├── sqlite_exporter.py  ← SQLite DDL + 뷰 + 트리거
│   ├── mysql_exporter.py   ← MySQL DDL + 뷰 + SP
│   └── postgresql_exporter.py ← PostgreSQL DDL + MV + SP
└── utils/                  ← 유틸리티
    ├── fake_phone.py       ← 가상 전화번호 생성
    ├── growth.py           ← 성장 곡선 계산
    └── seasonality.py      ← 계절성 패턴

output/
├── ecommerce-ko.db                 # SQLite 데이터베이스 (기본)
├── mysql/
│   ├── schema.sql               # 테이블/인덱스/뷰 DDL
│   ├── data.sql                 # INSERT 문 (모든 데이터)
│   └── procedures.sql           # 저장 프로시저
└── postgresql/
    ├── schema.sql               # 테이블/인덱스/뷰 DDL
    ├── data.sql                 # INSERT 문 (모든 데이터)
    └── procedures.sql           # 함수/프로시저

python -m src.verify.verify                    # SQLite 검증
python -m src.verify.verify --target mysql     # MySQL 검증
python -m src.verify.verify --target postgresql  # PostgreSQL 검증
python -m src.verify.verify --all              # 전체 검증