schema {
    query: Query
    mutation: Mutation
}

type Query {
    login(username: String!, password: String!): String! # 登录

    meanHistory(): [MeanHistory]! # 均分历史

    # 排位信息
    # 此处为 [,5%], [6%, 15%], [16%, 35%], [36%, 60%], [60%,]
    # 的成绩区间和人数
    rankAnalysis(): RankAnalysis!

    termsInfo(): [TermInfo]! # 每个学期的信息

    termDetail(term: String): [GradeDetail]! # 某个学期的所有课程成绩详情
}

type Mutation {
    # TODO: signUp
    # TODO: changePassword
}

# 代表该学生的某学期均分
type MeanHistory {
    term: String! # 学期的名字
    score: Float! # 分数
}

# 代表某个分数段有多少人
type GradeDistribution {
    range: [Float]! # 分数区间 形如 [15.2, 98.5]
    count: Int! # 该区间总人数
}

# 该学生在本年级的总排位
type RankAnalysis {
    distribute: [GradeDistribution]! # 成绩分布状况
    rank: Float! # 排位，如果排在 50.1% 则返回 50.1
}

# 该学生某个学期的简单信息
type TermInfo {
    term: String! # 学期的名字
    rank: Float! # 排位
}

# 代表某一门课的成绩
type GradeDetail {
    name: String! # 课程名字
    credit: Float! # 课程的学分
    score: Float # 课程得分，如果未修本课程则为 -1，如果不是数字得分则为 null
    dev: Float # 课程得分与均分的差值，如果不是数字得分则为 null
    isSpecial: Boolean # 课程得分时候是特殊的文字说明
    special: String # 课程得分的特殊文字说明
    distribute: [GradeDistribution] # 该课程的成绩分布，如果不存在则为 null
}