/**
 * UI_DTO.ts
 * 前端数据传输对象(DTO)定义文件
 * 包含所有前端与后端交互的接口定义
 */

// ============================================================
// 0. Common / 通用
// ============================================================

export interface ResultDto {
    success: boolean;
    message: string;
    data?: any;
}

export interface PagedResult<T> {
    items: T[];
    totalCount: number;
    pageIndex: number;
    pageSize: number;
}

// ============================================================
// 1. Auth & User / 认证与用户
// ============================================================

export interface UserProfileDto {
    id: string;
    realName: string;
    studentId: string;
    avatarUrl: string;
    gender: string;
    schoolId: string;
    role: 'Admin' | 'Teacher' | 'Student';
    email?: string;
    phone?: string;
    bio?: string;
}

export interface RegisterDto {
    realName: string;
    studentId: string; // 学号/工号
    password: string;
    role: 'Teacher' | 'Student';
}

export interface UpdateProfileDto {
    realName?: string;
    email?: string;
    phone?: string;
    bio?: string;
}

export interface ChangePasswordDto {
    oldPassword: string;
    newPassword: string;
}

export interface LoginResultDto {
    token: string;
    user: UserProfileDto;
}

// ============================================================
// 2. Org / 组织架构
// ============================================================

export interface SchoolDto {
    id: string;
    name: string;
    regionCode: string;
    address: string;
}

/**
 * 年级DTO
 */
export interface GradeDto {
    id: string;
    schoolId: string;  // 所属学校ID
    name: string;  // 年级名称（如"2024级"或"初一"）
    sortOrder: number;  // 排序序号（1=初一，2=初二）
    enrollmentYear: number;  // 入学年份
}


export interface ClassDto {
    id: string;
    name: string;
    inviteCode: string;
    gradeName: string;
    teacherName: string;
    studentCount: number;
}

export interface CreateClassDto {
    name: string;
    gradeName: string;
}

export interface ClassMemberDto {
    id: string;
    studentId: string;
    realName: string;
    avatarUrl: string;
    gender: 'Male' | 'Female';
    role: 'Student' | 'Monitor' | 'Committee'; // 班长/委员等
    recentTrend: number[]; // Last 5 scores/performances
    status: 'Active' | 'AtRisk' | 'Excellent';
    attendanceRate: number;
}

export interface SchoolStructureDto {
    school: SchoolDto;
    grades: GradeNodeDto[];
}

export interface GradeNodeDto {
    id: string;
    name: string;
    classes: ClassDto[];
}

// ============================================================
// 3. Curriculum / 课程体系
// ============================================================

export interface SubjectDto {
    id: string;
    name: string;
    code: string;
    icon?: string;
}

export interface TextbookDto {
    id: string;
    name: string;
    publisher: string;
    versionYear: string;
    coverUrl: string;
}

/**
 * 教材单元DTO
 */
export interface TextbookUnitDto {
    id: string;
    textbookId: string;  // 所属教材ID
    name: string;  // 单元名称（如"第十一章 三角形"）
    sortOrder: number;  // 排序序号
}

/**
 * 课/小节DTO
 */
export interface TextbookLessonDto {
    id: string;
    unitId: string;  // 所属单元ID
    name: string;  // 课名称（如"11.1 全等三角形"）
    sortOrder: number;  // 排序序号
}

/**
 * 知识点DTO（可嵌套）
 */
export interface KnowledgePointDto {
    id: string;
    lessonId: string;  // 挂载课节ID
    parentKnowledgePointId?: string;  // 父知识点ID（支持大点套小点）
    name: string;  // 知识点名称
    difficulty: number;  // 难度系数（1-5星）
    description?: string;  // 描述/口诀
    children?: KnowledgePointDto[];  // 子知识点
}

/**
 * 课程树DTO（用于前端展示完整层级）
 */
export interface CurriculumTreeDto {
    textbook: TextbookDto;
    units: (TextbookUnitDto & {
        lessons: (TextbookLessonDto & {
            knowledgePoints: KnowledgePointDto[];
        })[];
    })[];
}

/**
 * @deprecated 旧的通用节点定义，保留用于向后兼容
 */
export interface UnitNodeDto {
    id: string;
    name: string;
    type: 'unit' | 'lesson' | 'point';
    children?: UnitNodeDto[];
    difficulty?: number;
}

// ============================================================
// 4. Question / 题库
// ============================================================

export interface QuestionSummaryDto {
    id: string;
    content: string; // HTML
    type: string;
    difficulty: number;
    knowledgePoints: string[];
}

export interface ParsedQuestionDto {
    content: string;
    type: string;
    options?: string[];
    answer?: string;
    parse?: string;
}

export interface QuestionFilterDto {
    subjectId?: string;
    type?: number;
    difficulty?: number;
    keyword?: string;
}

/**
 * 题目-知识点关联DTO
 */
export interface QuestionKnowledgeDto {
    id: string;
    questionId: string;  // 关联题目ID
    knowledgePointId: string;  // 关联知识点ID
    weight: number;  // 考察权重（0-100）
}


// ============================================================
// 5. Exam / 考试
// ============================================================

export interface ExamDto {
    id: string;
    subjectId: string;  // 所属学科
    title: string;
    totalScore: number;
    duration: number;  // 建议时长（分钟）
    questionCount: number;  // 总题数
    status: 'Draft' | 'Published';
    createdAt: string;
}

/**
 * 试卷节点DTO（可嵌套）
 * 支持树形结构，既可以是分组节点（Group），也可以是题目节点（Question）
 */
export interface ExamNodeDto {
    id: string;  // 节点ID
    nodeType: 'Group' | 'Question';  // 节点类型

    // === 如果是Group节点 ===
    title?: string;  // 分组标题（如"第一部分 选择题"）
    description?: string;  // 分组说明

    // === 如果是Question节点 ===
    questionId?: string;  // 关联的题目ID
    questionContent?: string;  // 题干内容（冗余字段，方便显示）
    questionType?: string;  // 题目类型

    // === 通用字段 ===
    score: number;  // 本节点分数（Group为子节点分数总和，Question为本题分数）
    sortOrder: number;  // 排序序号

    // === 递归子节点 ===
    children?: ExamNodeDto[];  // 子节点（支持无限嵌套）
}

/**
 * 试卷详情DTO
 * 使用树形结构代替固定的sections二层结构
 */
export interface ExamDetailDto extends ExamDto {
    rootNodes: ExamNodeDto[];  // 根节点列表（树形结构）
}

export interface WrongQuestionAnalysisDto {
    id: string;
    content: string;
    errorRate: number; // 0-100
    difficulty: number;
    type: string;
}

export interface ExamStatsDto {
    averageScore: number;
    passRate: number;
    maxScore: number;
    minScore: number;
    scoreDistribution: { range: string; count: number }[];
    wrongQuestions: WrongQuestionAnalysisDto[];
}

// ============================================================
// 6. Assignment / 作业
// ============================================================

export interface AssignmentTeacherViewDto {
    id: string;
    title: string;
    className: string;
    submittedCount: number;
    totalCount: number;
    status: 'Active' | 'Ended' | 'Scheduled';
    dueDate: string;
    examTitle: string;
}

export interface AssignmentStudentViewDto {
    id: string;
    title: string;
    examTitle: string;
    endTime: string;
    status: 'Pending' | 'Graded' | 'Submitted';
    score?: number;
}

// ============================================================
// 7. Submission / Student Exam / 提交与学生答题
// ============================================================

/**
 * 学生答题卷DTO
 * 使用ExamNode树形结构
 */
export interface StudentExamPaperDto {
    examId: string;
    title: string;
    duration: number;  // 分钟
    totalScore: number;
    rootNodes: ExamNodeDto[];  // 使用树形结构
}

/**
 * 提交答案DTO
 */
export interface SubmitExamDto {
    assignmentId: string;
    answers: Record<string, any>;  // key: examNodeId, value: 学生答案
    timeSpent?: number;  // 耗时（秒）
}

/**
 * 答题详情DTO
 * 记录学生对每个题目的作答和批改情况
 */
export interface SubmissionDetailDto {
    id: string;
    submissionId: string;  // 所属提交ID
    examNodeId: string;  // 对应试卷节点ID
    studentAnswer?: string;  // 学生答案（文本或图片URL）
    gradingData?: string;  // 批改数据（JSON格式，Canvas画板数据）
    score?: number;  // 本题得分
    judgement?: 'Correct' | 'Incorrect' | 'Partial';  // 判题结果
    teacherComment?: string;  // 老师评语
}


// ============================================================
// 8. Grading & Results / 批阅与结果
// ============================================================

export interface StudentSubmissionSummaryDto {
    id: string; // submissionId
    studentName: string;
    studentId: string;
    avatarUrl: string;
    status: 'Submitted' | 'Graded' | 'Late';
    score?: number;
    submitTime: string;
}

export interface GradingPaperDto {
    submissionId: string;
    studentName: string;
    nodes: GradingNodeDto[];
}

export interface GradingNodeDto {
    examNodeId: string;
    questionId: string;
    questionContent: string;
    questionType: string;
    score: number; // max score
    studentScore?: number; // current score
    studentAnswer?: string; // Text or Image URL
    teacherAnnotation?: string; // JSON for canvas
    autoCheckResult?: boolean;
}

export interface StudentResultDto extends GradingPaperDto {
    totalScore: number;
    rank: number;
    beatRate: number;
}

// ============================================================
// 9. Analytics / 分析统计
// ============================================================

export interface ChartDataDto {
    labels: string[];
    datasets: {
        label: string;
        data: number[];
        borderColor?: string;
        backgroundColor?: string;
        fill?: boolean;
    }[];
}

export interface RadarChartDto {
    indicators: string[];
    values: number[];
}

export interface ScoreDistributionDto {
    range: string; // e.g. "90-100"
    count: number;
}

// ============================================================
// 10. Common / Dashboard / 通用/仪表板
// ============================================================

export interface ScheduleDto {
    id: string;
    startTime: string;
    endTime: string;
    className: string;
    subject: string;
    room: string;
    isToday: boolean;
    dayOfWeek?: number; // 1 = Monday, 7 = Sunday
    period?: number; // 1-8
}

export interface CreateScheduleDto {
    subject: string;
    className: string;
    room: string;
    dayOfWeek: number;
    period: number;
    startTime: string;
    endTime: string;
}

// ============================================================
// 11. Messages / 消息
// ============================================================

export interface MessageDto {
    id: string;
    title: string;
    content: string;
    type: 'Announcement' | 'Notification' | 'Alert';
    senderName: string;
    senderAvatar?: string;
    createdAt: string;
    isRead: boolean;
}

export interface CreateMessageDto {
    title: string;
    content: string;
    type: 'Announcement' | 'Notification';
    targetClassIds?: string[]; // Optional: if empty, broadcast to all managed classes
}

// ============================================================
// 12. Services Interfaces / 服务接口定义
// ============================================================

export interface IAuthService {
    login(username: string): Promise<LoginResultDto>;
    register(data: RegisterDto): Promise<LoginResultDto>;
    me(): Promise<UserProfileDto>;
    updateProfile(data: UpdateProfileDto): Promise<UserProfileDto>;
    changePassword(data: ChangePasswordDto): Promise<void>;
}

export interface IOrgService {
    getClasses(role?: string): Promise<ClassDto[]>;
    getClassMembers(classId: string): Promise<ClassMemberDto[]>;
    joinClass(inviteCode: string): Promise<void>;
    createClass(data: CreateClassDto): Promise<ClassDto>;
}

export interface ICurriculumService {
    getSubjects(): Promise<SubjectDto[]>;
    getTree(id: string): Promise<CurriculumTreeDto>;
    getUnits(textbookId: string): Promise<TextbookUnitDto[]>;
    getLessons(unitId: string): Promise<TextbookLessonDto[]>;
    getKnowledgePoints(lessonId: string): Promise<KnowledgePointDto[]>;
}

export interface IQuestionService {
    search(filter: any): Promise<PagedResult<QuestionSummaryDto & { answer?: string, parse?: string }>>;
    parseText(rawText: string): Promise<ParsedQuestionDto[]>;
    getQuestionKnowledges(questionId: string): Promise<QuestionKnowledgeDto[]>;
}

export interface IExamService {
    getMyExams(): Promise<PagedResult<ExamDto>>;
    getExamDetail(id: string): Promise<ExamDetailDto>;
    saveExam(exam: ExamDetailDto): Promise<void>;
    getStats(id: string): Promise<ExamStatsDto>;
}

export interface IAssignmentService {
    getTeachingAssignments(): Promise<PagedResult<AssignmentTeacherViewDto>>;
    getStudentAssignments(): Promise<PagedResult<AssignmentStudentViewDto>>;
    publishAssignment(data: any): Promise<void>;
    getAssignmentStats(id: string): Promise<ExamStatsDto>;
}

export interface IAnalyticsService {
    getClassPerformance(): Promise<ChartDataDto>;
    getStudentGrowth(): Promise<ChartDataDto>;
    getRadar(): Promise<RadarChartDto>;
    getStudentRadar(): Promise<RadarChartDto>;
    getScoreDistribution(): Promise<ScoreDistributionDto[]>;
}

export interface IGradingService {
    getSubmissions(assignmentId: string): Promise<StudentSubmissionSummaryDto[]>;
    getPaper(submissionId: string): Promise<GradingPaperDto>;
    saveGrading(submissionId: string, details: SubmissionDetailDto[]): Promise<void>;
}

export interface ISubmissionService {
    getStudentPaper(assignmentId: string): Promise<StudentExamPaperDto>;
    submitExam(data: SubmitExamDto): Promise<void>;
    getSubmissionResult(assignmentId: string): Promise<StudentResultDto>;
    getSubmissionDetails(submissionId: string): Promise<SubmissionDetailDto[]>;
}


export interface ICommonService {
    getSchedule(): Promise<ScheduleDto[]>;
}

export interface IMessageService {
    getMessages(): Promise<MessageDto[]>;
    markAsRead(id: string): Promise<void>;
    createMessage(data: CreateMessageDto): Promise<void>;
}

export interface IScheduleService {
    getWeekSchedule(): Promise<ScheduleDto[]>;
    addEvent(data: CreateScheduleDto): Promise<void>;
    deleteEvent(id: string): Promise<void>;
}

// ============================================================
// 13. UI Types / UI类型定义
// ============================================================

export type ViewState = 'login' | 'dashboard' | 'curriculum' | 'questions' | 'classes' | 'exams' | 'assignments' | 'settings' | 'grading' | 'student-exam' | 'student-result' | 'messages' | 'schedule';