// 自动评分的结果：服务器给学生程序逐项检查后返回，学生提交后立即能看到。

export interface CheckResult {
  /** 检查项名称，对应书上评价表的功能项，如"能实时显示入侵数据" */
  title: string
  passed: boolean
  /** 不通过的原因：期望看到什么、实际是什么 */
  message?: string
}

export interface GradeResult {
  /** 编译没通过时所有项都不通过 */
  compiled: boolean
  results: CheckResult[]
  /** 评分用时（毫秒） */
  ms: number
}

/** 自测（提交前自己跑一遍评分，不计分、不留记录）：每人同时一次，结果保留到下一次自测 */
export interface SelfCheck {
  status: 'running' | 'done' | 'error'
  /** 检查的是哪个实验或作业（结果只对同一个显示） */
  target: string
  result: GradeResult | null
  startedAt: number
}

// ---------- 作业 ----------

/** 学生的起点：blank 空白工程（从界面做起），ui 界面已做好（只写代码） */
export type StartMode = 'blank' | 'ui'

/** 分值：自动评分项按规则顺序各自的分值；老师评分项（界面、注释、命名等）由老师打分 */
export interface Scoring {
  auto: number[]
  manual: { title: string; points: number }[]
}

export interface Assignment {
  id: number
  classId: number
  className: string
  sampleId: string
  title: string
  startMode: StartMode
  /** 截止时间（毫秒时间戳），null 表示不限 */
  deadline: number | null
  createdAt: number
  /** 自动评分项的名称，和 scoring.auto 一一对应 */
  checkTitles: string[]
  scoring: Scoring
  /**
   * 任务说明（Markdown，见 web/src/grading/markdown.ts）：布置时从实验的 task.md 复制，老师可以改写。
   * null 是加这个功能之前布置的作业，学生看到的是实验现在的说明
   */
  task: string | null
}

export interface Submission {
  id: number
  status: 'pending' | 'done' | 'error'
  result: GradeResult | null
  /** 自动评分得分（通过的项的分值之和） */
  autoScore: number | null
  createdAt: number
  /** 排队评分时前面还有几份 */
  queueAhead?: number
}

/** 老师评阅：老师评分项各自的得分（null 表示还没打分，和 scoring.manual 一一对应）和评语 */
export interface Review {
  scores: (number | null)[]
  comment: string
  updatedAt: number
}

/** 提交时浏览器截的窗体图（PNG 的 base64，不含 data: 前缀） */
export interface Screenshot {
  form: string
  png: string
}

/**
 * AI 评阅：老师评分项的建议分（和 scoring.manual 一一对应）、理由和给学生的评语。
 * 只是建议，老师采纳（或修改后保存）才成为老师评分。
 * status：pending 排队中；done 已评；error 出错；skipped 学生又交了新的，这份不评了
 */
export interface AiReview {
  status: 'pending' | 'done' | 'error' | 'skipped'
  scores: { score: number; reason: string }[]
  comment: string
  error?: string
  model?: string
  at?: number
}