CREATE TABLE ns20_1_ai_manager_report (
  id INT AUTO_INCREMENT PRIMARY KEY
    COMMENT '관리자 AI 리포트 고유 ID',

  -- =================================================
  -- 리포트 메타 정보
  -- =================================================
  report_code VARCHAR(50) NOT NULL
    COMMENT '문서번호 (예: NG-AI-202602041322)',

  report_scope VARCHAR(50) NOT NULL
    COMMENT '분석 지역/범위 (예: Vietnam-DaLat)',

  period_days INT NOT NULL
    COMMENT '분석 기간 (일 단위, 예: 7)',

  generated_at DATETIME NOT NULL
    COMMENT 'AI 리포트 생성 시각 (JSON.generated_at)',

  analysis_version VARCHAR(20) DEFAULT 'v1'
    COMMENT 'AI 분석 로직 버전',

  -- =================================================
  -- 전체 판단 요약 (대시보드 / KPI용)
  -- =================================================
  overall_status ENUM('good','watch','critical') NOT NULL
    COMMENT '전체 농가 종합 상태',

  farm_count INT NOT NULL
    COMMENT '분석 대상 농가 수',

  key_alert_count INT DEFAULT 0
    COMMENT '주의/위험 경보 총 개수',

  priority_count INT DEFAULT 0
    COMMENT '오늘 우선 점검 대상 농가 수',

  -- =================================================
  -- 🆕 보고서용 서술 필드 (사람이 읽는 문장)
  -- =================================================
  narrative_executive_summary TEXT
    COMMENT '관리자용 종합 요약 서술 (3~5문장)',

  narrative_overall_analysis TEXT
    COMMENT '최근 기간 전체 농가 환경/데이터 상태에 대한 종합 해석',

  narrative_risk_context TEXT
    COMMENT '주의/위험 판정의 배경, 원인, 맥락 설명',

  narrative_admin_recommendation TEXT
    COMMENT '행정/운영 조치 권고 사항 (문장형)',

  -- =================================================
  -- 파일 및 원본 데이터 참조
  -- =================================================
  json_file VARCHAR(255) NOT NULL
    COMMENT '생성된 관리자 리포트 JSON 파일명',

  raw_file VARCHAR(255)
    COMMENT 'OpenAI 원본 응답 RAW JSON 파일',

  -- =================================================
  -- 시스템 관리용
  -- =================================================
  created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
    COMMENT 'DB 저장 시각',

  updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP
    ON UPDATE CURRENT_TIMESTAMP
    COMMENT '마지막 수정 시각'
)
COMMENT='NS20 관리자용 농가 종합 AI 분석 리포트';