301 lines
12 KiB
Protocol Buffer
301 lines
12 KiB
Protocol Buffer
syntax = "proto3";
|
||
|
||
package runner;
|
||
|
||
option go_package = "schedule_converter/proto/runner;runner";
|
||
|
||
// ============================================================
|
||
// 服务定义
|
||
// ============================================================
|
||
|
||
// RunnerHub 服务 - 由 Backend 服务器实现
|
||
// Runner 作为客户端主动连接，建立双向流通信
|
||
service RunnerHub {
|
||
// Connect 建立双向流连接
|
||
// Runner 通过此连接注册、接收任务、返回结果
|
||
rpc Connect(stream StreamMessage) returns (stream StreamMessage);
|
||
}
|
||
|
||
// ============================================================
|
||
// 流消息包装 - 所有消息通过 oneof 包装
|
||
// ============================================================
|
||
|
||
// StreamMessage 双向流消息包装
|
||
message StreamMessage {
|
||
oneof message {
|
||
RegisterRequest register = 1; // Runner 注册请求
|
||
RegisterResponse register_response = 2; // 注册响应
|
||
Heartbeat heartbeat = 3; // 心跳请求
|
||
HeartbeatAck heartbeat_ack = 4; // 心跳响应
|
||
Task task = 5; // 下发的任务
|
||
TaskResult result = 6; // 任务结果
|
||
TaskCancel task_cancel = 7; // 取消任务
|
||
}
|
||
}
|
||
|
||
// ============================================================
|
||
// 注册相关消息
|
||
// ============================================================
|
||
|
||
// RegisterRequest Runner 注册请求
|
||
message RegisterRequest {
|
||
string runner_id = 1; // Runner 唯一标识 (UUID)
|
||
string version = 2; // Runner 版本号
|
||
map<string, string> capabilities = 3; // 能力标签
|
||
// 例如: {"login": "true", "schedule": "true", "grades": "true"}
|
||
}
|
||
|
||
// RegisterResponse 注册响应
|
||
message RegisterResponse {
|
||
bool success = 1; // 是否成功
|
||
string session_id = 2; // 会话ID，用于标识本次连接
|
||
string message = 3; // 消息说明
|
||
int32 heartbeat_interval = 4; // 心跳间隔 (秒)
|
||
int32 task_timeout = 5; // 默认任务超时时间 (秒)
|
||
}
|
||
|
||
// ============================================================
|
||
// 心跳消息
|
||
// ============================================================
|
||
|
||
// Heartbeat 心跳请求
|
||
message Heartbeat {
|
||
int64 timestamp = 1; // 客户端时间戳 (毫秒)
|
||
}
|
||
|
||
// HeartbeatAck 心跳响应
|
||
message HeartbeatAck {
|
||
int64 timestamp = 1; // 服务端时间戳 (毫秒)
|
||
int64 latency = 2; // 往返延迟 (毫秒)
|
||
}
|
||
|
||
// ============================================================
|
||
// 任务定义
|
||
// ============================================================
|
||
|
||
// TaskType 任务类型枚举
|
||
enum TaskType {
|
||
TASK_TYPE_UNKNOWN = 0; // 未知类型
|
||
TASK_TYPE_LOGIN = 1; // 登录验证
|
||
TASK_TYPE_GET_SCHEDULE = 2; // 获取课表
|
||
TASK_TYPE_GET_GRADES = 3; // 获取成绩
|
||
TASK_TYPE_GET_EXAMS = 4; // 获取考试安排
|
||
TASK_TYPE_GET_USER_INFO = 5; // 获取用户信息
|
||
TASK_TYPE_GET_EMPTY_CLASSROOM = 6; // 获取空教室
|
||
TASK_TYPE_GET_CET = 7; // 获取四六级成绩
|
||
}
|
||
|
||
// TaskStatus 任务状态枚举
|
||
enum TaskStatus {
|
||
TASK_STATUS_UNKNOWN = 0; // 未知状态
|
||
TASK_STATUS_SUCCESS = 1; // 成功
|
||
TASK_STATUS_FAILED = 2; // 失败
|
||
TASK_STATUS_TIMEOUT = 3; // 超时
|
||
TASK_STATUS_CANCELLED = 4; // 已取消
|
||
}
|
||
|
||
// Task 任务定义
|
||
message Task {
|
||
string task_id = 1; // 任务唯一ID (UUID)
|
||
TaskType type = 2; // 任务类型
|
||
int64 created_at = 3; // 创建时间戳 (毫秒)
|
||
int32 timeout_seconds = 4; // 超时时间 (秒)
|
||
bytes payload = 5; // 任务载荷 (JSON 编码)
|
||
}
|
||
|
||
// TaskCancel 取消任务
|
||
message TaskCancel {
|
||
string task_id = 1; // 要取消的任务ID
|
||
string reason = 2; // 取消原因
|
||
}
|
||
|
||
// TaskResult 任务结果
|
||
message TaskResult {
|
||
string task_id = 1; // 任务ID
|
||
TaskStatus status = 2; // 执行状态
|
||
int64 completed_at = 3; // 完成时间戳 (毫秒)
|
||
bytes data = 4; // 结果数据 (JSON 编码)
|
||
string error_code = 5; // 错误码
|
||
string error_message = 6; // 错误消息
|
||
}
|
||
|
||
// ============================================================
|
||
// 任务载荷定义 - 用于 JSON 序列化到 bytes
|
||
// ============================================================
|
||
|
||
// LoginPayload 登录任务载荷
|
||
message LoginPayload {
|
||
string username = 1; // 学号
|
||
string password = 2; // 密码
|
||
string twfid = 3; // 初始 Cookie (可选)
|
||
}
|
||
|
||
// GetSchedulePayload 获取课表任务载荷
|
||
message GetSchedulePayload {
|
||
string username = 1; // 学号
|
||
string password = 2; // 密码
|
||
string semester = 3; // 学期，如 "2025-20262"
|
||
}
|
||
|
||
// GetGradesPayload 获取成绩任务载荷
|
||
message GetGradesPayload {
|
||
string username = 1; // 学号
|
||
string password = 2; // 密码
|
||
string semester = 3; // 学期 (可选，为空则获取全部)
|
||
}
|
||
|
||
// GetExamsPayload 获取考试安排任务载荷
|
||
message GetExamsPayload {
|
||
string username = 1; // 学号
|
||
string password = 2; // 密码
|
||
string semester = 3; // 学期
|
||
}
|
||
|
||
// ============================================================
|
||
// 结果数据定义 - 用于 JSON 序列化到 bytes
|
||
// ============================================================
|
||
|
||
// ScheduleResultData 课表结果数据
|
||
message ScheduleResultData {
|
||
string semester = 1; // 学期
|
||
string student_id = 2; // 学号
|
||
string student_name = 3; // 学生姓名
|
||
repeated Course courses = 4; // 课程列表
|
||
}
|
||
|
||
// Course 课程信息
|
||
message Course {
|
||
string code = 1; // 课程代码
|
||
string name = 2; // 课程名称
|
||
string teacher = 3; // 授课教师
|
||
string room = 4; // 教室
|
||
float credit = 5; // 学分
|
||
repeated ScheduleTime schedule = 6; // 上课时间安排
|
||
}
|
||
|
||
// ScheduleTime 上课时间安排
|
||
message ScheduleTime {
|
||
string day = 1; // 星期几，"0"-"6" 表示周日到周六
|
||
repeated int32 sections = 2; // 节次，如 [1, 2, 3]
|
||
repeated int32 weeks = 3; // 周次，如 [1, 2, 3, 4, 5]
|
||
}
|
||
|
||
// GpaSummary 学分绩汇总信息
|
||
message GpaSummary {
|
||
string average_gpa = 1; // 平均学分绩
|
||
string rank = 2; // 专业排名
|
||
string exam_total_gpa = 3; // 考试课学分绩
|
||
string exam_total_credits = 4; // 考试课学分数
|
||
string fail_credits = 5; // 考查课不及格学分
|
||
string semesters = 6; // 计算学期数
|
||
}
|
||
|
||
// GradesResultData 成绩结果数据
|
||
message GradesResultData {
|
||
string semester = 1; // 学期
|
||
string student_id = 2; // 学号
|
||
repeated Grade grades = 3; // 成绩列表
|
||
GpaSummary gpa_summary = 4; // 学分绩汇总 (可选)
|
||
}
|
||
|
||
// Grade 成绩信息
|
||
message Grade {
|
||
string term = 1; // 学期
|
||
string course_code = 2; // 课程代码
|
||
string course_name = 3; // 课程名称
|
||
string nature = 4; // 课程性质
|
||
string category = 5; // 课程类别
|
||
string credit = 6; // 学分
|
||
string score = 7; // 成绩 (可能是等级或分数)
|
||
string grade_point = 8; // 绩点
|
||
string is_exam = 9; // 是否考试课
|
||
bool is_retake = 10; // 是否为补考
|
||
}
|
||
|
||
// ExamsResultData 考试安排结果数据
|
||
message ExamsResultData {
|
||
string semester = 1; // 学期
|
||
string student_id = 2; // 学号
|
||
repeated Exam exams = 3; // 考试列表
|
||
}
|
||
|
||
// Exam 考试信息
|
||
message Exam {
|
||
string course_name = 1; // 课程名称
|
||
string exam_type = 2; // 考试类型 (期末/期中/补考)
|
||
string date = 3; // 考试日期
|
||
string time = 4; // 考试时间
|
||
string week = 5; // 考试周次
|
||
string weekday = 6; // 星期几
|
||
}
|
||
|
||
// UserInfoResultData 用户信息结果数据
|
||
message UserInfoResultData {
|
||
string student_id = 1; // 学号
|
||
string name = 2; // 姓名
|
||
string gender = 3; // 性别
|
||
string college = 4; // 学院
|
||
string major = 5; // 专业
|
||
string class_name = 6; // 班级
|
||
string grade = 7; // 年级
|
||
}
|
||
|
||
// GetEmptyClassroomPayload 获取空教室任务载荷
|
||
message GetEmptyClassroomPayload {
|
||
string username = 1; // 学号
|
||
string password = 2; // 密码
|
||
string semester = 3; // 学期
|
||
string week_start = 4; // 起始周次
|
||
string week_end = 5; // 结束周次
|
||
string campus_code = 6; // 校区代码
|
||
string building_code = 7; // 楼号代码（可选）
|
||
}
|
||
|
||
// EmptyClassroomResultData 空教室结果数据
|
||
message EmptyClassroomResultData {
|
||
string semester = 1; // 学期
|
||
string student_id = 2; // 学号
|
||
repeated EmptyClassroomEntry classrooms = 3; // 空教室列表
|
||
}
|
||
|
||
// EmptyClassroomEntry 空教室条目
|
||
message EmptyClassroomEntry {
|
||
string classroom = 1; // 教室名称
|
||
string weekday = 2; // 星期几
|
||
string periods = 3; // 可用节次
|
||
string term = 4; // 学期描述
|
||
string weeks = 5; // 周次范围
|
||
}
|
||
|
||
// GetCetPayload 获取四六级成绩任务载荷
|
||
message GetCetPayload {
|
||
string username = 1; // 学号
|
||
string password = 2; // 密码
|
||
}
|
||
|
||
// CetScore 四六级成绩条目
|
||
message CetScore {
|
||
string level = 1; // 等级（英语四级/英语六级）
|
||
string exam_time = 2; // 考试时间，如 2025年06月
|
||
string ticket_num = 3; // 准考证号
|
||
string score = 4; // 成绩
|
||
}
|
||
|
||
// CetStudentInfo 四六级查询页面的学生信息
|
||
message CetStudentInfo {
|
||
string student_id = 1; // 学号
|
||
string name = 2; // 姓名
|
||
string gender = 3; // 性别
|
||
string id_card = 4; // 身份证号
|
||
string duration = 5; // 学制
|
||
string grade = 6; // 年级
|
||
string college = 7; // 学院
|
||
string major = 8; // 专业
|
||
}
|
||
|
||
// CetResultData 四六级成绩结果数据
|
||
message CetResultData {
|
||
CetStudentInfo student_info = 1; // 学生信息
|
||
repeated CetScore scores = 2; // 成绩列表
|
||
}
|