feat(shared-ts): 同步 3 个 BFF GraphQL schema + downstream-client/logger/outbox 增强
This commit is contained in:
SpecialX
@@ -10,10 +10,13 @@
|
||||
# - C1：错误码前缀 BFF_PARENT_
|
||||
# - U4：BFF 豁免 @RequirePermission，仅校验 x-user-id + ChildGuard
|
||||
# - 02 §9 #5：depth ≤ 7 / cost ≤ 1000
|
||||
#
|
||||
# 版本：v2（32 Query + 6 Mutation，对齐 parent-portal 全部 operations）
|
||||
|
||||
scalar DateTime
|
||||
scalar JSON
|
||||
|
||||
# ============ Types ============
|
||||
# ============ Legacy Types ============
|
||||
|
||||
type Parent {
|
||||
id: ID!
|
||||
@@ -21,7 +24,9 @@ type Parent {
|
||||
name: String!
|
||||
avatar: String
|
||||
roles: [String!]!
|
||||
permissions: [String!]
|
||||
dataScope: DataScope!
|
||||
schoolId: ID
|
||||
}
|
||||
|
||||
enum DataScope {
|
||||
@@ -184,9 +189,413 @@ type DashboardData {
|
||||
degraded: Boolean!
|
||||
}
|
||||
|
||||
# ============ Query ============
|
||||
# ============ Extended Types（v2 新增） ============
|
||||
|
||||
type ChildBrief {
|
||||
id: ID!
|
||||
name: String!
|
||||
grade: String!
|
||||
classId: ID
|
||||
className: String
|
||||
avatar: String
|
||||
}
|
||||
|
||||
type ChildSummary {
|
||||
childId: ID!
|
||||
avgScore: Float
|
||||
classRank: Int
|
||||
classSize: Int
|
||||
attendanceRate: Float
|
||||
pendingHomeworkCount: Int!
|
||||
recentGradeTrend: Float
|
||||
recentScores: [ChildGrade!]!
|
||||
upcomingEvents: [UpcomingEvent!]!
|
||||
}
|
||||
|
||||
type UpcomingEvent {
|
||||
id: ID!
|
||||
type: String!
|
||||
title: String!
|
||||
dueDate: DateTime!
|
||||
}
|
||||
|
||||
type ChildDetail {
|
||||
childId: ID!
|
||||
basicInfo: ChildBasicInfo!
|
||||
todaySchedule: [JSON!]!
|
||||
weeklySchedule: [JSON!]!
|
||||
homeworkSummary: HomeworkSummary!
|
||||
gradeSummary: GradeSummary!
|
||||
examResults: ExamResultSummary!
|
||||
}
|
||||
|
||||
type ChildBasicInfo {
|
||||
name: String!
|
||||
avatar: String
|
||||
grade: String!
|
||||
className: String!
|
||||
schoolName: String!
|
||||
relation: String!
|
||||
}
|
||||
|
||||
type HomeworkSummary {
|
||||
pendingCount: Int!
|
||||
overdueCount: Int!
|
||||
submittedCount: Int!
|
||||
gradedCount: Int!
|
||||
}
|
||||
|
||||
type GradeSummary {
|
||||
avgScore: Float!
|
||||
classRank: Int
|
||||
classSize: Int
|
||||
trend: Float
|
||||
}
|
||||
|
||||
type ExamResultSummary {
|
||||
upcoming: Int!
|
||||
completed: Int!
|
||||
avgScore: Float
|
||||
}
|
||||
|
||||
type ChildGrade {
|
||||
examId: ID!
|
||||
examName: String!
|
||||
examDate: DateTime!
|
||||
subject: String!
|
||||
studentScore: Float!
|
||||
classAverage: Float
|
||||
classMax: Float
|
||||
classMin: Float
|
||||
gradeLevel: String
|
||||
}
|
||||
|
||||
type ChildHomework {
|
||||
id: ID!
|
||||
title: String!
|
||||
subject: String!
|
||||
className: String!
|
||||
assignedDate: DateTime!
|
||||
dueDate: DateTime!
|
||||
status: String!
|
||||
score: Float
|
||||
maxScore: Float
|
||||
feedback: String
|
||||
}
|
||||
|
||||
type ChildExam {
|
||||
id: ID!
|
||||
name: String!
|
||||
subject: String!
|
||||
status: String!
|
||||
startsAt: DateTime!
|
||||
expiresAt: DateTime
|
||||
durationSeconds: Int
|
||||
questionCount: Int
|
||||
totalScore: Float
|
||||
submittedAt: DateTime
|
||||
}
|
||||
|
||||
type AttendanceRecord {
|
||||
id: ID!
|
||||
date: DateTime!
|
||||
status: String!
|
||||
checkInTime: DateTime
|
||||
checkOutTime: DateTime
|
||||
note: String
|
||||
}
|
||||
|
||||
type ExamResult {
|
||||
examId: ID!
|
||||
childId: ID!
|
||||
score: Float
|
||||
rank: Int
|
||||
subjectScores: [SubjectScore!]!
|
||||
feedback: String
|
||||
}
|
||||
|
||||
type SubjectScore {
|
||||
subject: String!
|
||||
score: Float!
|
||||
fullScore: Float!
|
||||
}
|
||||
|
||||
type ChildClass {
|
||||
id: ID!
|
||||
name: String!
|
||||
homeroomTeacher: String
|
||||
studentCount: Int
|
||||
grade: String!
|
||||
year: String
|
||||
}
|
||||
|
||||
type ReportCard {
|
||||
childId: ID!
|
||||
academicYearId: ID!
|
||||
semester: Int!
|
||||
subjects: [ReportCardSubject!]!
|
||||
overallComment: String
|
||||
classRank: Int
|
||||
}
|
||||
|
||||
type ReportCardSubject {
|
||||
subject: String!
|
||||
score: Float!
|
||||
grade: String!
|
||||
teacherComment: String
|
||||
}
|
||||
|
||||
type GrowthArchive {
|
||||
childId: ID!
|
||||
subject: String
|
||||
dataPoints: [GrowthDataPoint!]!
|
||||
}
|
||||
|
||||
type GrowthDataPoint {
|
||||
date: DateTime!
|
||||
category: String!
|
||||
title: String!
|
||||
description: String!
|
||||
evidence: String
|
||||
}
|
||||
|
||||
type WeaknessItem {
|
||||
id: ID!
|
||||
knowledgePoint: String!
|
||||
masteryLevel: Float!
|
||||
subject: String!
|
||||
recommendation: String
|
||||
}
|
||||
|
||||
type ChildTrend {
|
||||
childId: ID!
|
||||
period: TrendPeriod!
|
||||
dataPoints: [TrendDataPoint!]!
|
||||
}
|
||||
|
||||
type TrendDataPoint {
|
||||
date: DateTime!
|
||||
score: Float!
|
||||
subject: String
|
||||
}
|
||||
|
||||
type LearningPathItem {
|
||||
id: ID!
|
||||
title: String!
|
||||
subject: String!
|
||||
order: Int!
|
||||
masteryLevel: Float!
|
||||
resources: [String!]!
|
||||
}
|
||||
|
||||
type ErrorBookStats {
|
||||
childId: ID!
|
||||
totalCount: Int!
|
||||
newCount: Int!
|
||||
learningCount: Int!
|
||||
masteredCount: Int!
|
||||
dueReviewCount: Int!
|
||||
masteredRate: Float!
|
||||
}
|
||||
|
||||
type WrongQuestion {
|
||||
id: ID!
|
||||
questionId: ID!
|
||||
subject: String!
|
||||
content: String!
|
||||
wrongAnswer: String!
|
||||
correctAnswer: String!
|
||||
addedAt: DateTime!
|
||||
status: String!
|
||||
}
|
||||
|
||||
type WeakKp {
|
||||
id: ID!
|
||||
knowledgePoint: String!
|
||||
subject: String!
|
||||
masteryLevel: Float!
|
||||
recommendation: String
|
||||
}
|
||||
|
||||
type MasterySummary {
|
||||
childId: ID!
|
||||
overallMastery: Float!
|
||||
subjectMastery: [SubjectMastery!]!
|
||||
totalKps: Int!
|
||||
masteredKps: Int!
|
||||
}
|
||||
|
||||
type SubjectMastery {
|
||||
subject: String!
|
||||
mastery: Float!
|
||||
totalKps: Int!
|
||||
masteredKps: Int!
|
||||
}
|
||||
|
||||
type DiagnosticReport {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
subject: String!
|
||||
reportDate: DateTime!
|
||||
summary: String!
|
||||
recommendations: [String!]!
|
||||
}
|
||||
|
||||
type PracticeStats {
|
||||
childId: ID!
|
||||
totalSessions: Int!
|
||||
completedSessions: Int!
|
||||
totalQuestionsAnswered: Int!
|
||||
overallAccuracy: Float!
|
||||
}
|
||||
|
||||
type PracticeSession {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
subject: String!
|
||||
startedAt: DateTime!
|
||||
completedAt: DateTime
|
||||
questionCount: Int!
|
||||
correctCount: Int!
|
||||
accuracy: Float!
|
||||
}
|
||||
|
||||
type CoursePlan {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
subject: String!
|
||||
title: String!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
progress: Float!
|
||||
}
|
||||
|
||||
type CoursePlanDetail {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
subject: String!
|
||||
title: String!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
progress: Float!
|
||||
lessons: [CoursePlanLesson!]!
|
||||
}
|
||||
|
||||
type CoursePlanLesson {
|
||||
id: ID!
|
||||
title: String!
|
||||
date: DateTime!
|
||||
completed: Boolean!
|
||||
}
|
||||
|
||||
type LessonPlan {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
subject: String!
|
||||
title: String!
|
||||
date: DateTime!
|
||||
teacherName: String!
|
||||
}
|
||||
|
||||
type LessonPlanDetail {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
subject: String!
|
||||
title: String!
|
||||
date: DateTime!
|
||||
teacherName: String!
|
||||
objectives: [String!]!
|
||||
content: String!
|
||||
homework: String
|
||||
}
|
||||
|
||||
type ElectiveCourse {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
name: String!
|
||||
subject: String!
|
||||
teacher: String!
|
||||
schedule: String!
|
||||
selected: Boolean!
|
||||
}
|
||||
|
||||
type LeaveRequestItem {
|
||||
id: ID!
|
||||
childId: ID!
|
||||
childName: String
|
||||
className: String
|
||||
type: String!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
reason: String!
|
||||
status: String!
|
||||
submittedAt: DateTime!
|
||||
reviewedAt: DateTime
|
||||
reviewerName: String
|
||||
reviewComment: String
|
||||
}
|
||||
|
||||
type AcademicYear {
|
||||
id: ID!
|
||||
name: String!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
isCurrent: Boolean!
|
||||
}
|
||||
|
||||
type MyNotification {
|
||||
id: ID!
|
||||
childId: ID
|
||||
eventType: String!
|
||||
title: String!
|
||||
body: String!
|
||||
read: Boolean!
|
||||
createdAt: DateTime!
|
||||
actionUrl: String
|
||||
pinned: Boolean!
|
||||
}
|
||||
|
||||
type MyNotificationPreferences {
|
||||
parentId: ID!
|
||||
preferences: JSON!
|
||||
defaults: NotificationPreferencesDefaults!
|
||||
updatedAt: DateTime
|
||||
}
|
||||
|
||||
type NotificationPreferencesDefaults {
|
||||
channels: [NotificationChannel!]!
|
||||
eventTypes: NotificationEventTypes!
|
||||
}
|
||||
|
||||
type MarkAsReadResult {
|
||||
id: ID!
|
||||
read: Boolean!
|
||||
}
|
||||
|
||||
type MarkAllAsReadResult {
|
||||
count: Int!
|
||||
}
|
||||
|
||||
type SwitchChildResult {
|
||||
childId: ID!
|
||||
childName: String!
|
||||
selectedAt: DateTime!
|
||||
}
|
||||
|
||||
type ExportChildGradesResult {
|
||||
downloadUrl: String!
|
||||
expiresAt: DateTime!
|
||||
}
|
||||
|
||||
type UpdateNotificationPreferencesResult {
|
||||
parentId: ID!
|
||||
updatedAt: DateTime!
|
||||
}
|
||||
|
||||
# ============ Query（32 个） ============
|
||||
|
||||
type Query {
|
||||
# Legacy（11 个）
|
||||
dashboard: DashboardData!
|
||||
viewports: [ViewportItem!]!
|
||||
me: Parent!
|
||||
@@ -207,27 +616,81 @@ type Query {
|
||||
pageSize: Int = 20
|
||||
): [Notification!]!
|
||||
notificationPreferences: NotificationPreferences!
|
||||
|
||||
# Extended（21 个）
|
||||
currentUser: Parent!
|
||||
myChildren: [ChildBrief!]!
|
||||
childSummary(childId: ID!): ChildSummary
|
||||
childDetail(childId: ID!): ChildDetail
|
||||
childAttendance(
|
||||
childId: ID!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
): [AttendanceRecord!]!
|
||||
childExamResult(childId: ID!, examId: ID!): ExamResult
|
||||
childClasses(childId: ID!): [ChildClass!]!
|
||||
childReportCard(
|
||||
childId: ID!
|
||||
academicYearId: ID!
|
||||
semester: Int!
|
||||
): ReportCard
|
||||
childGrowthArchive(childId: ID!, subject: String): GrowthArchive!
|
||||
childWeakness(childId: ID!): [WeaknessItem!]!
|
||||
childTrend(childId: ID!, period: TrendPeriod!): ChildTrend!
|
||||
childLearningPath(childId: ID!): [LearningPathItem!]!
|
||||
childErrorBookStats(childId: ID!): ErrorBookStats!
|
||||
childTopWrongQuestions(childId: ID!, limit: Int): [WrongQuestion!]!
|
||||
childWeakKps(childId: ID!, limit: Int): [WeakKp!]!
|
||||
childMasterySummary(childId: ID!): MasterySummary!
|
||||
childDiagnosticReports(childId: ID!): [DiagnosticReport!]!
|
||||
childPracticeStats(childId: ID!): PracticeStats!
|
||||
childPracticeSessions(childId: ID!, limit: Int): [PracticeSession!]!
|
||||
childCoursePlans(childId: ID!): [CoursePlan!]!
|
||||
childCoursePlanDetail(childId: ID!, planId: ID!): CoursePlanDetail
|
||||
childLessonPlans(childId: ID!, subject: String): [LessonPlan!]!
|
||||
childLessonPlanDetail(childId: ID!, planId: ID!): LessonPlanDetail
|
||||
childElective(childId: ID!): [ElectiveCourse!]!
|
||||
childLeaveRequests(childId: ID!): [LeaveRequestItem!]!
|
||||
academicYears: [AcademicYear!]!
|
||||
myNotifications(unreadOnly: Boolean, limit: Int): [MyNotification!]!
|
||||
myNotificationPreferences: MyNotificationPreferences!
|
||||
}
|
||||
|
||||
# ============ Mutation（6 个） ============
|
||||
|
||||
type Mutation {
|
||||
# Legacy（3 个）
|
||||
selectChild(childId: ID!): SelectChildResult!
|
||||
markNotificationRead(notificationId: ID!): Notification!
|
||||
updateNotificationPreferences(
|
||||
input: UpdateNotificationPreferencesInput!
|
||||
): NotificationPreferences!
|
||||
|
||||
# Extended（6 个新 mutation，覆盖前端全部操作）
|
||||
markAsRead(notificationId: ID!): MarkAsReadResult!
|
||||
markAllAsRead: MarkAllAsReadResult!
|
||||
switchChild(childId: ID!): SwitchChildResult!
|
||||
updateMyNotificationPreferences(
|
||||
parentId: ID!
|
||||
preferences: JSON!
|
||||
defaults: JSON
|
||||
): UpdateNotificationPreferencesResult!
|
||||
createLeaveRequest(input: LeaveRequestInput!): LeaveRequestItem!
|
||||
exportChildGrades(childId: ID!, subject: String): ExportChildGradesResult!
|
||||
}
|
||||
|
||||
# ============ Inputs ============
|
||||
|
||||
input DateRangeInput {
|
||||
start: DateTime!
|
||||
end: DateTime!
|
||||
}
|
||||
|
||||
# ============ Mutation ============
|
||||
|
||||
type Mutation {
|
||||
selectChild(childId: ID!): SelectChildResult!
|
||||
markNotificationRead(notificationId: ID!): Notification!
|
||||
updateNotificationPreferences(
|
||||
input: UpdateNotificationPreferencesInput!
|
||||
): NotificationPreferences!
|
||||
}
|
||||
|
||||
type SelectChildResult {
|
||||
childId: ID!
|
||||
selectedAt: DateTime!
|
||||
audited: Boolean!
|
||||
enum TrendPeriod {
|
||||
WEEK
|
||||
MONTH
|
||||
SEMESTER
|
||||
YEAR
|
||||
}
|
||||
|
||||
input UpdateNotificationPreferencesInput {
|
||||
@@ -242,3 +705,17 @@ input NotificationEventTypesInput {
|
||||
attendanceAlert: Boolean
|
||||
schoolAnnouncement: Boolean
|
||||
}
|
||||
|
||||
input LeaveRequestInput {
|
||||
childId: ID!
|
||||
type: String!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
reason: String!
|
||||
}
|
||||
|
||||
type SelectChildResult {
|
||||
childId: ID!
|
||||
selectedAt: DateTime!
|
||||
audited: Boolean!
|
||||
}
|
||||
|
||||
@@ -1,9 +1,8 @@
|
||||
# student-bff GraphQL Schema (v1)
|
||||
# student-bff GraphQL Schema (v2)
|
||||
#
|
||||
# 负责人: ai04
|
||||
# 仲裁依据: coord-final-decisions §2 B1-B8 + president-final-rulings §2.2
|
||||
# 存放路径: packages/shared-ts/contracts/graphql/student-bff.schema.graphql (president §2.2.1)
|
||||
# 起草与仲裁流程: ai04 起草 → coord 在批次 2 启动前仲裁第一版 → ai14 (student-portal) 消费
|
||||
#
|
||||
# 设计规范 (president §2.2.5):
|
||||
# - Query/Mutation 用 camelCase
|
||||
@@ -17,6 +16,12 @@
|
||||
# 降级模式 (president §2.6 方案 B):
|
||||
# - 下游不可用时 success=true + error=null + data 内 degraded=true
|
||||
# - 降级字段返回 null, 父对象加 degraded/degradedReason/degradedFields
|
||||
#
|
||||
# v2 变更:
|
||||
# - 补全 22 个扩展 Query (examDetail/homeworkDetail/serverTime/mySchedule/...)
|
||||
# - 补全 21 个扩展 Mutation (submitExam/saveExamDraft/updateProfile/...)
|
||||
# - startPracticeSession 从 Query 移到 Mutation (语义为创建会话)
|
||||
# - 总计 36 Query + 23 Mutation + 1 Subscription = 60 operations
|
||||
|
||||
scalar DateTime
|
||||
scalar JSON
|
||||
@@ -197,6 +202,16 @@ type ExamListPayload implements Degradable {
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 考试详情 (含题目与学生提交)
|
||||
type ExamDetailPayload implements Degradable {
|
||||
exam: JSON
|
||||
questions: [JSON!]
|
||||
mySubmission: JSON
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# 作业 (下游: core-edu HomeworkService)
|
||||
# ============================================================================
|
||||
@@ -251,6 +266,14 @@ type HomeworkListPayload implements Degradable {
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 作业详情
|
||||
type HomeworkDetailPayload implements Degradable {
|
||||
homework: JSON
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# 成绩 (下游: core-edu GradeService)
|
||||
# ============================================================================
|
||||
@@ -292,8 +315,16 @@ type GradeListPayload implements Degradable {
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 成绩报告卡
|
||||
type ReportCardPayload implements Degradable {
|
||||
reportCard: JSON
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# 考勤 (下游: core-edu AttendanceService, P3 预留)
|
||||
# 考勤 (下游: core-edu AttendanceService)
|
||||
# ============================================================================
|
||||
|
||||
enum AttendanceStatus {
|
||||
@@ -337,6 +368,155 @@ type AttendanceListPayload implements Degradable {
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# 课表 / 请假 / 选课 / 课案 / 课程计划 (下游: core-edu + content)
|
||||
# ============================================================================
|
||||
|
||||
# 服务器时间
|
||||
type ServerTimePayload {
|
||||
serverTime: String!
|
||||
timezone: String!
|
||||
timestamp: Int!
|
||||
}
|
||||
|
||||
# 课表
|
||||
type ScheduleItem {
|
||||
id: ID!
|
||||
classId: ID!
|
||||
className: String
|
||||
subject: String!
|
||||
date: DateTime!
|
||||
startTime: DateTime!
|
||||
endTime: DateTime!
|
||||
teacher: TeacherBrief
|
||||
room: String
|
||||
}
|
||||
|
||||
type SchedulePayload implements Degradable {
|
||||
items: [ScheduleItem!]!
|
||||
weekStart: String
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 请假记录
|
||||
type LeaveRequest {
|
||||
id: ID!
|
||||
studentId: ID!
|
||||
type: String!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
reason: String!
|
||||
status: String!
|
||||
attachments: [String!]
|
||||
createdAt: DateTime!
|
||||
updatedAt: DateTime!
|
||||
}
|
||||
|
||||
type LeaveRequestsPayload implements Degradable {
|
||||
requests: [LeaveRequest!]!
|
||||
totalCount: Int!
|
||||
pendingCount: Int!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 选课记录
|
||||
type ElectiveSelection {
|
||||
id: ID!
|
||||
studentId: ID!
|
||||
courseId: ID!
|
||||
courseName: String!
|
||||
status: String!
|
||||
selectedAt: DateTime!
|
||||
}
|
||||
|
||||
type ElectiveSelectionsPayload implements Degradable {
|
||||
selections: [ElectiveSelection!]!
|
||||
totalCount: Int!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 可选课程
|
||||
type ElectiveCourse {
|
||||
id: ID!
|
||||
title: String!
|
||||
subject: String!
|
||||
description: String
|
||||
capacity: Int!
|
||||
enrolledCount: Int!
|
||||
teacher: TeacherBrief
|
||||
}
|
||||
|
||||
type AvailableElectiveCoursesPayload implements Degradable {
|
||||
courses: [ElectiveCourse!]!
|
||||
totalCount: Int!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 课案
|
||||
type LessonPlan {
|
||||
id: ID!
|
||||
title: String!
|
||||
subject: String!
|
||||
description: String
|
||||
objectives: [String!]
|
||||
content: JSON
|
||||
createdBy: ID!
|
||||
createdAt: DateTime!
|
||||
updatedAt: DateTime!
|
||||
}
|
||||
|
||||
type LessonPlansPayload implements Degradable {
|
||||
plans: [LessonPlan!]!
|
||||
totalCount: Int!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
type LessonPlanDetailPayload implements Degradable {
|
||||
plan: LessonPlan
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 课程计划
|
||||
type CoursePlan {
|
||||
id: ID!
|
||||
title: String!
|
||||
subject: String!
|
||||
description: String
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
objectives: [String!]
|
||||
createdBy: ID!
|
||||
createdAt: DateTime!
|
||||
updatedAt: DateTime!
|
||||
}
|
||||
|
||||
type CoursePlansPayload implements Degradable {
|
||||
plans: [CoursePlan!]!
|
||||
totalCount: Int!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
type CoursePlanDetailPayload implements Degradable {
|
||||
plan: CoursePlan
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# 教材与章节 (下游: content, P4)
|
||||
# ============================================================================
|
||||
@@ -491,8 +671,98 @@ type TrendPayload implements Degradable {
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 学生成长曲线
|
||||
type StudentGrowthPayload implements Degradable {
|
||||
studentId: ID!
|
||||
subjectId: ID
|
||||
points: [TrendPoint!]!
|
||||
averageScore: Float
|
||||
classAverage: Float
|
||||
growthRate: Float
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 作业分析
|
||||
type AssignmentAnalysisPayload implements Degradable {
|
||||
analysis: JSON
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 个人资料
|
||||
type MyProfilePayload implements Degradable {
|
||||
profile: JSON
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 掌握度概览
|
||||
type MasterySummaryPayload implements Degradable {
|
||||
summary: JSON
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 诊断报告
|
||||
type DiagnosticReportsPayload implements Degradable {
|
||||
reports: [JSON!]!
|
||||
totalCount: Int!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 错题本
|
||||
type ErrorBookItem {
|
||||
id: ID!
|
||||
questionId: ID!
|
||||
subjectId: ID!
|
||||
knowledgePointId: ID!
|
||||
myAnswer: String
|
||||
correctAnswer: String!
|
||||
note: String
|
||||
tags: [String!]
|
||||
mastered: Boolean!
|
||||
createdAt: DateTime!
|
||||
updatedAt: DateTime!
|
||||
}
|
||||
|
||||
type ErrorBookPayload implements Degradable {
|
||||
items: [ErrorBookItem!]!
|
||||
totalCount: Int!
|
||||
subjectStats: [JSON!]!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 练习会话
|
||||
type PracticeSession {
|
||||
id: ID!
|
||||
studentId: ID!
|
||||
subjectId: ID!
|
||||
status: String!
|
||||
totalQuestions: Int!
|
||||
answeredCount: Int!
|
||||
startedAt: DateTime!
|
||||
completedAt: DateTime
|
||||
}
|
||||
|
||||
type PracticeSessionsPayload implements Degradable {
|
||||
sessions: [PracticeSession!]!
|
||||
totalCount: Int!
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# 通知 (下游: msg, P5)
|
||||
# 通知 / 公告 (下游: msg, P5)
|
||||
# ============================================================================
|
||||
|
||||
enum NotificationType {
|
||||
@@ -550,6 +820,38 @@ type UnreadCountPayload implements Degradable {
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# 公告
|
||||
type Announcement {
|
||||
id: ID!
|
||||
title: String!
|
||||
content: String!
|
||||
authorId: ID!
|
||||
status: String!
|
||||
category: String
|
||||
targetAudience: String
|
||||
publishedAt: DateTime
|
||||
createdAt: DateTime!
|
||||
updatedAt: DateTime!
|
||||
}
|
||||
|
||||
type AnnouncementConnection {
|
||||
edges: [AnnouncementEdge!]!
|
||||
pageInfo: PageInfo!
|
||||
totalCount: Int!
|
||||
}
|
||||
|
||||
type AnnouncementEdge {
|
||||
node: Announcement!
|
||||
cursor: String!
|
||||
}
|
||||
|
||||
type AnnouncementDetailPayload implements Degradable {
|
||||
announcement: Announcement
|
||||
degraded: Boolean!
|
||||
degradedReason: String
|
||||
degradedFields: [String!]
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# AI 答疑 (下游: ai, P5)
|
||||
# ============================================================================
|
||||
@@ -583,6 +885,13 @@ input AIChatInput {
|
||||
# Mutation 结果
|
||||
# ============================================================================
|
||||
|
||||
type MutationError {
|
||||
code: String! # BFF_STUDENT_* 前缀
|
||||
message: String!
|
||||
traceId: String
|
||||
i18nKey: String
|
||||
}
|
||||
|
||||
type SubmitHomeworkResult {
|
||||
success: Boolean!
|
||||
submissionId: ID
|
||||
@@ -599,15 +908,121 @@ type MarkNotificationReadResult {
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
type MutationError {
|
||||
code: String! # BFF_STUDENT_* 前缀
|
||||
message: String!
|
||||
traceId: String
|
||||
i18nKey: String
|
||||
# 通用 Mutation 结果
|
||||
type GenericMutationResult {
|
||||
success: Boolean!
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 通知相关 Mutation 结果
|
||||
type MarkAllAsReadResult {
|
||||
success: Boolean!
|
||||
markedCount: Int!
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 考试相关 Mutation 结果
|
||||
type SubmitExamResult {
|
||||
success: Boolean!
|
||||
submissionId: ID
|
||||
examId: ID!
|
||||
submittedAt: DateTime
|
||||
score: Float
|
||||
status: String
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
type SaveExamDraftResult {
|
||||
success: Boolean!
|
||||
draftId: ID
|
||||
examId: ID!
|
||||
savedAt: DateTime
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
type RecordExamViolationResult {
|
||||
success: Boolean!
|
||||
violationId: ID
|
||||
examId: ID!
|
||||
violationType: String!
|
||||
recordedAt: DateTime
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 个人资料相关 Mutation 结果
|
||||
type UpdateProfileResult {
|
||||
success: Boolean!
|
||||
profile: JSON
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 作业延期申请
|
||||
type RequestExtensionResult {
|
||||
success: Boolean!
|
||||
requestId: ID
|
||||
homeworkId: ID!
|
||||
status: String!
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 班级相关 Mutation 结果
|
||||
type JoinClassResult {
|
||||
success: Boolean!
|
||||
classId: ID!
|
||||
joinedAt: DateTime
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
type LeaveClassResult {
|
||||
success: Boolean!
|
||||
classId: ID!
|
||||
leftAt: DateTime
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 错题相关 Mutation 结果
|
||||
type ErrorBookItemResult {
|
||||
success: Boolean!
|
||||
itemId: ID
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 请假相关 Mutation 结果
|
||||
type CreateLeaveRequestResult {
|
||||
success: Boolean!
|
||||
requestId: ID
|
||||
status: String!
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 选课相关 Mutation 结果
|
||||
type SelectElectiveResult {
|
||||
success: Boolean!
|
||||
selectionId: ID
|
||||
courseId: ID!
|
||||
status: String!
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# 练习相关 Mutation 结果
|
||||
type SubmitPracticeAnswerResult {
|
||||
success: Boolean!
|
||||
questionId: ID!
|
||||
isCorrect: Boolean
|
||||
correctAnswer: String
|
||||
explanation: String
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
type StartPracticeSessionResult {
|
||||
success: Boolean!
|
||||
session: JSON
|
||||
questions: [JSON!]!
|
||||
error: MutationError
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# Query 根类型
|
||||
# Query 根类型 (36 Queries)
|
||||
# ============================================================================
|
||||
|
||||
type Query {
|
||||
@@ -740,10 +1155,131 @@ type Query {
|
||||
# @permission: STUDENT_AI_CHAT
|
||||
# @dataScope: OWN
|
||||
aiChat(input: AIChatInput!): AIChatPayload!
|
||||
|
||||
# ===== 扩展 Query (v2 新增, P3-P5) =====
|
||||
|
||||
"""考试详情 (含题目与学生提交, core-edu.ExamService.GetExam)"""
|
||||
# @permission: EXAM_READ
|
||||
# @dataScope: OWN
|
||||
examDetail(examId: ID!): ExamDetailPayload!
|
||||
|
||||
"""作业详情 (core-edu.HomeworkService.GetHomework)"""
|
||||
# @permission: HOMEWORK_READ
|
||||
# @dataScope: OWN
|
||||
homeworkDetail(homeworkId: ID!): HomeworkDetailPayload!
|
||||
|
||||
"""服务器时间 (BFF 本地, 无下游)"""
|
||||
serverTime: ServerTimePayload!
|
||||
|
||||
"""我的课表 (周视图, core-edu.ScheduleService.GetScheduleByStudent)"""
|
||||
# @permission: SCHEDULE_READ
|
||||
# @dataScope: OWN
|
||||
mySchedule(weekStart: DateTime): SchedulePayload!
|
||||
|
||||
"""学生成长曲线 (data-ana.GetStudentGrowth)"""
|
||||
# @permission: ANALYTICS_READ
|
||||
# @dataScope: OWN
|
||||
studentGrowth(
|
||||
subjectId: ID
|
||||
startDate: DateTime
|
||||
endDate: DateTime
|
||||
): StudentGrowthPayload!
|
||||
|
||||
"""作业分析 (data-ana.GetAssignmentAnalysis)"""
|
||||
# @permission: ANALYTICS_READ
|
||||
# @dataScope: OWN
|
||||
assignmentAnalysis(homeworkId: ID): AssignmentAnalysisPayload!
|
||||
|
||||
"""个人资料 (iam.GetUserProfile)"""
|
||||
# @permission: AUTH_READ
|
||||
# @dataScope: OWN
|
||||
myProfile: MyProfilePayload!
|
||||
|
||||
"""掌握度概览 (data-ana.GetMasterySummary)"""
|
||||
# @permission: ANALYTICS_READ
|
||||
# @dataScope: OWN
|
||||
myMasterySummary(subjectId: ID): MasterySummaryPayload!
|
||||
|
||||
"""诊断报告列表 (data-ana.ListDiagnosticReports)"""
|
||||
# @permission: ANALYTICS_READ
|
||||
# @dataScope: OWN
|
||||
myDiagnosticReports: DiagnosticReportsPayload!
|
||||
|
||||
"""错题本 (data-ana.ListErrorBookItems)"""
|
||||
# @permission: ANALYTICS_READ
|
||||
# @dataScope: OWN
|
||||
myErrorBook(
|
||||
subjectId: ID
|
||||
mastered: Boolean
|
||||
page: Int = 1
|
||||
pageSize: Int = 20
|
||||
): ErrorBookPayload!
|
||||
|
||||
"""公告列表 (msg.ListAnnouncements)"""
|
||||
# @permission: ANNOUNCEMENT_READ
|
||||
# @dataScope: OWN
|
||||
announcements(
|
||||
first: Int = 20
|
||||
category: String
|
||||
): AnnouncementConnection!
|
||||
|
||||
"""公告详情 (msg.GetAnnouncement)"""
|
||||
# @permission: ANNOUNCEMENT_READ
|
||||
# @dataScope: OWN
|
||||
announcementDetail(announcementId: ID!): AnnouncementDetailPayload!
|
||||
|
||||
"""我的请假记录 (core-edu.ListLeaveRequestsByStudent)"""
|
||||
# @permission: LEAVE_REQUEST_READ
|
||||
# @dataScope: OWN
|
||||
myLeaveRequests: LeaveRequestsPayload!
|
||||
|
||||
"""我的选课记录 (content.ListElectiveSelectionsByStudent)"""
|
||||
# @permission: ELECTIVE_READ
|
||||
# @dataScope: OWN
|
||||
myElectiveSelections: ElectiveSelectionsPayload!
|
||||
|
||||
"""可选课程 (content.ListAvailableElectiveCourses)"""
|
||||
# @permission: ELECTIVE_READ
|
||||
# @dataScope: OWN
|
||||
availableElectiveCourses: AvailableElectiveCoursesPayload!
|
||||
|
||||
"""我的课案 (content.ListLessonPlansByStudent)"""
|
||||
# @permission: LESSON_PLAN_READ
|
||||
# @dataScope: OWN
|
||||
myLessonPlans: LessonPlansPayload!
|
||||
|
||||
"""课案详情 (content.GetLessonPlan)"""
|
||||
# @permission: LESSON_PLAN_READ
|
||||
# @dataScope: OWN
|
||||
lessonPlanDetail(lessonPlanId: ID!): LessonPlanDetailPayload!
|
||||
|
||||
"""我的课程计划 (content.ListCoursePlansByStudent)"""
|
||||
# @permission: COURSE_PLAN_READ
|
||||
# @dataScope: OWN
|
||||
myCoursePlans: CoursePlansPayload!
|
||||
|
||||
"""课程计划详情 (content.GetCoursePlan)"""
|
||||
# @permission: COURSE_PLAN_READ
|
||||
# @dataScope: OWN
|
||||
coursePlanDetail(coursePlanId: ID!): CoursePlanDetailPayload!
|
||||
|
||||
"""成绩报告卡 (core-edu.GradeService.GetReportCard)"""
|
||||
# @permission: GRADE_READ
|
||||
# @dataScope: OWN
|
||||
myReportCard(
|
||||
examId: ID
|
||||
term: String
|
||||
academicYear: String
|
||||
): ReportCardPayload!
|
||||
|
||||
"""我的练习会话列表 (data-ana.ListPracticeSessionsByStudent)"""
|
||||
# @permission: ANALYTICS_READ
|
||||
# @dataScope: OWN
|
||||
myPracticeSessions: PracticeSessionsPayload!
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# Mutation 根类型
|
||||
# Mutation 根类型 (23 Mutations)
|
||||
# ============================================================================
|
||||
|
||||
type Mutation {
|
||||
@@ -760,6 +1296,120 @@ type Mutation {
|
||||
markNotificationAsRead(
|
||||
input: MarkNotificationReadInput!
|
||||
): MarkNotificationReadResult!
|
||||
|
||||
# ===== 扩展 Mutation (v2 新增, P3-P5) =====
|
||||
|
||||
"""标记通知已读 (别名, msg.MarkAsRead)"""
|
||||
# @permission: NOTIFICATION_UPDATE
|
||||
# @dataScope: OWN
|
||||
markAsRead(input: MarkAsReadInput!): MarkNotificationReadResult!
|
||||
|
||||
"""全部通知标记已读 (msg.MarkAllNotificationsAsRead)"""
|
||||
# @permission: NOTIFICATION_UPDATE
|
||||
# @dataScope: OWN
|
||||
markAllAsRead(input: MarkAllAsReadInput!): MarkAllAsReadResult!
|
||||
|
||||
"""更新通知偏好 (msg.UpdateNotificationPreferences)"""
|
||||
# @permission: NOTIFICATION_UPDATE
|
||||
# @dataScope: OWN
|
||||
updateNotificationPreference(
|
||||
input: UpdateNotificationPreferenceInput!
|
||||
): GenericMutationResult!
|
||||
|
||||
"""提交考试 (含幂等键, core-edu.ExamService.SubmitExam)"""
|
||||
# @permission: EXAM_SUBMIT
|
||||
# @dataScope: OWN
|
||||
submitExam(input: SubmitExamInput!): SubmitExamResult!
|
||||
|
||||
"""保存考试草稿 (core-edu.ExamService.SaveExamDraft)"""
|
||||
# @permission: EXAM_SUBMIT
|
||||
# @dataScope: OWN
|
||||
saveExamDraft(input: SaveExamDraftInput!): SaveExamDraftResult!
|
||||
|
||||
"""记录考试违规 (防作弊, core-edu.ExamService.RecordExamViolation)"""
|
||||
# @permission: EXAM_RECORD_VIOLATION
|
||||
# @dataScope: OWN
|
||||
recordExamViolation(input: RecordViolationInput!): RecordExamViolationResult!
|
||||
|
||||
"""记录粘贴事件 (防作弊, core-edu.ExamService.RecordPasteEvent)"""
|
||||
# @permission: EXAM_SUBMIT
|
||||
# @dataScope: OWN
|
||||
recordPasteEvent(input: RecordPasteEventInput!): RecordExamViolationResult!
|
||||
|
||||
"""更新个人资料 (iam.UpdateUserProfile)"""
|
||||
# @permission: AUTH_UPDATE
|
||||
# @dataScope: OWN
|
||||
updateProfile(input: UpdateProfileInput!): UpdateProfileResult!
|
||||
|
||||
"""修改密码 (iam.ChangePassword)"""
|
||||
# @permission: AUTH_UPDATE
|
||||
# @dataScope: OWN
|
||||
changePassword(input: ChangePasswordInput!): GenericMutationResult!
|
||||
|
||||
"""作业延期申请 (core-edu.RequestHomeworkExtension)"""
|
||||
# @permission: HOMEWORK_UPDATE
|
||||
# @dataScope: OWN
|
||||
requestExtension(input: RequestExtensionInput!): RequestExtensionResult!
|
||||
|
||||
"""加入班级 (core-edu.JoinClass)"""
|
||||
# @permission: CLASS_JOIN
|
||||
# @dataScope: OWN
|
||||
joinClass(input: JoinClassInput!): JoinClassResult!
|
||||
|
||||
"""退出班级 (core-edu.LeaveClass)"""
|
||||
# @permission: CLASS_LEAVE
|
||||
# @dataScope: OWN
|
||||
leaveClass(input: LeaveClassInput!): LeaveClassResult!
|
||||
|
||||
"""添加错题 (data-ana.AddErrorBookItem)"""
|
||||
# @permission: ANALYTICS_UPDATE
|
||||
# @dataScope: OWN
|
||||
addErrorBookItem(input: AddErrorBookItemInput!): ErrorBookItemResult!
|
||||
|
||||
"""更新错题 (data-ana.UpdateErrorBookItem)"""
|
||||
# @permission: ANALYTICS_UPDATE
|
||||
# @dataScope: OWN
|
||||
updateErrorBookItem(input: UpdateErrorBookItemInput!): ErrorBookItemResult!
|
||||
|
||||
"""删除错题 (data-ana.DeleteErrorBookItem)"""
|
||||
# @permission: ANALYTICS_UPDATE
|
||||
# @dataScope: OWN
|
||||
deleteErrorBookItem(input: DeleteErrorBookItemInput!): ErrorBookItemResult!
|
||||
|
||||
"""标记公告已读 (msg.MarkAnnouncementAsRead)"""
|
||||
# @permission: ANNOUNCEMENT_READ
|
||||
# @dataScope: OWN
|
||||
markAnnouncementRead(input: MarkAnnouncementReadInput!): GenericMutationResult!
|
||||
|
||||
"""创建请假申请 (core-edu.CreateLeaveRequest)"""
|
||||
# @permission: LEAVE_REQUEST_CREATE
|
||||
# @dataScope: OWN
|
||||
createLeaveRequest(input: CreateLeaveRequestInput!): CreateLeaveRequestResult!
|
||||
|
||||
"""取消请假申请 (core-edu.CancelLeaveRequest)"""
|
||||
# @permission: LEAVE_REQUEST_UPDATE
|
||||
# @dataScope: OWN
|
||||
cancelLeaveRequest(input: CancelLeaveRequestInput!): CreateLeaveRequestResult!
|
||||
|
||||
"""选择课程 (content.SelectElectiveCourse)"""
|
||||
# @permission: ELECTIVE_SELECT
|
||||
# @dataScope: OWN
|
||||
selectElectiveCourse(input: SelectElectiveInput!): SelectElectiveResult!
|
||||
|
||||
"""退选课程 (content.DropElectiveCourse)"""
|
||||
# @permission: ELECTIVE_DROP
|
||||
# @dataScope: OWN
|
||||
dropElectiveCourse(input: DropElectiveInput!): SelectElectiveResult!
|
||||
|
||||
"""启动练习会话 (data-ana.StartPracticeSession, 从 Query 移到 Mutation)"""
|
||||
# @permission: ANALYTICS_UPDATE
|
||||
# @dataScope: OWN
|
||||
startPracticeSession(input: StartPracticeSessionInput!): StartPracticeSessionResult!
|
||||
|
||||
"""提交练习答案 (data-ana.SubmitPracticeAnswer)"""
|
||||
# @permission: ANALYTICS_UPDATE
|
||||
# @dataScope: OWN
|
||||
submitPracticeAnswer(input: SubmitPracticeAnswerInput!): SubmitPracticeAnswerResult!
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
@@ -783,6 +1433,182 @@ input MarkNotificationReadInput {
|
||||
userId: ID! # 必须与 x-user-id 一致 (B4 越权防御)
|
||||
}
|
||||
|
||||
input MarkAsReadInput {
|
||||
notificationId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input MarkAllAsReadInput {
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input UpdateNotificationPreferenceInput {
|
||||
channel: NotificationChannel!
|
||||
enabled: Boolean!
|
||||
categories: [String!]
|
||||
}
|
||||
|
||||
input SubmitExamInput {
|
||||
examId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
answers: [ExamAnswerInput!]!
|
||||
idempotencyKey: String!
|
||||
}
|
||||
|
||||
input ExamAnswerInput {
|
||||
questionId: ID!
|
||||
content: String!
|
||||
attachments: [String!]
|
||||
}
|
||||
|
||||
input SaveExamDraftInput {
|
||||
examId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
answers: [ExamAnswerInput!]!
|
||||
draftId: ID
|
||||
}
|
||||
|
||||
input RecordViolationInput {
|
||||
examId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
violationType: ViolationType!
|
||||
severity: ViolationSeverity!
|
||||
details: String
|
||||
timestamp: DateTime!
|
||||
}
|
||||
|
||||
enum ViolationType {
|
||||
TAB_SWITCH
|
||||
COPY_PASTE
|
||||
WINDOW_BLUR
|
||||
FULLSCREEN_EXIT
|
||||
}
|
||||
|
||||
enum ViolationSeverity {
|
||||
LOW
|
||||
MEDIUM
|
||||
HIGH
|
||||
}
|
||||
|
||||
input RecordPasteEventInput {
|
||||
examId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
questionId: ID!
|
||||
pastedContent: String!
|
||||
timestamp: DateTime!
|
||||
}
|
||||
|
||||
input UpdateProfileInput {
|
||||
name: String
|
||||
avatar: String
|
||||
phone: String
|
||||
address: String
|
||||
bio: String
|
||||
birthday: String
|
||||
gender: String
|
||||
}
|
||||
|
||||
input ChangePasswordInput {
|
||||
currentPassword: String!
|
||||
newPassword: String!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input RequestExtensionInput {
|
||||
homeworkId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
reason: String!
|
||||
requestedDays: Int!
|
||||
}
|
||||
|
||||
input JoinClassInput {
|
||||
classCode: String!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input LeaveClassInput {
|
||||
classId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
reason: String
|
||||
}
|
||||
|
||||
input AddErrorBookItemInput {
|
||||
questionId: ID!
|
||||
subjectId: ID!
|
||||
knowledgePointId: ID!
|
||||
myAnswer: String
|
||||
correctAnswer: String!
|
||||
note: String
|
||||
tags: [String!]
|
||||
}
|
||||
|
||||
input UpdateErrorBookItemInput {
|
||||
itemId: ID!
|
||||
note: String
|
||||
tags: [String!]
|
||||
mastered: Boolean
|
||||
}
|
||||
|
||||
input DeleteErrorBookItemInput {
|
||||
itemId: ID!
|
||||
}
|
||||
|
||||
input MarkAnnouncementReadInput {
|
||||
announcementId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input CreateLeaveRequestInput {
|
||||
type: LeaveRequestType!
|
||||
startDate: DateTime!
|
||||
endDate: DateTime!
|
||||
reason: String!
|
||||
attachments: [String!]
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
enum LeaveRequestType {
|
||||
SICK
|
||||
PERSONAL
|
||||
FAMILY
|
||||
OTHER
|
||||
}
|
||||
|
||||
input CancelLeaveRequestInput {
|
||||
requestId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input SelectElectiveInput {
|
||||
courseId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input DropElectiveInput {
|
||||
courseId: ID!
|
||||
studentId: ID # 可选, 若提供必须与 x-user-id 一致
|
||||
}
|
||||
|
||||
input StartPracticeSessionInput {
|
||||
subjectId: ID!
|
||||
knowledgePointIds: [ID!]
|
||||
difficulty: PracticeDifficulty
|
||||
}
|
||||
|
||||
enum PracticeDifficulty {
|
||||
EASY
|
||||
MEDIUM
|
||||
HARD
|
||||
ADAPTIVE
|
||||
}
|
||||
|
||||
input SubmitPracticeAnswerInput {
|
||||
sessionId: ID!
|
||||
questionId: ID!
|
||||
answer: String!
|
||||
timeSpent: Int
|
||||
}
|
||||
|
||||
# ============================================================================
|
||||
# AI 流式答疑 (SSE Subscription, P5)
|
||||
# ============================================================================
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -348,7 +348,7 @@ export class DownstreamClient {
|
||||
resolveWait = resolve;
|
||||
});
|
||||
if (result.done) break;
|
||||
yield result.value;
|
||||
yield (result as { done: false; value: TResponse }).value;
|
||||
}
|
||||
|
||||
if (streamError) {
|
||||
|
||||
@@ -9,7 +9,14 @@
|
||||
*
|
||||
* 该 logger 也作为 DownstreamClient 默认 logger, 避免循环依赖.
|
||||
*/
|
||||
import pino, { type Logger as PinoLogger, type LoggerOptions } from "pino";
|
||||
import * as pinoNs from "pino";
|
||||
import { type Logger as PinoLogger, type LoggerOptions } from "pino";
|
||||
|
||||
// pino 在 NodeNext + ESM 模式下 default import 丢失 callable 签名 (declaration merging 失效)
|
||||
// 通过 namespace import + 显式类型断言恢复可调用性
|
||||
type PinoFn = (options?: LoggerOptions | unknown) => PinoLogger;
|
||||
const pino = ((pinoNs as unknown as { default: PinoFn }).default ??
|
||||
(pinoNs as unknown as PinoFn)) as PinoFn;
|
||||
|
||||
/**
|
||||
* 默认日志级别 (可通过环境变量 LOG_LEVEL 覆盖).
|
||||
|
||||
@@ -1,5 +1,12 @@
|
||||
import { Module, type DynamicModule } from "@nestjs/common";
|
||||
import pino from "pino";
|
||||
import * as pinoNs from "pino";
|
||||
import type { Logger as PinoLogger, LoggerOptions } from "pino";
|
||||
|
||||
// pino 在 NodeNext + ESM 模式下 default import 丢失 callable 签名 (declaration merging 失效)
|
||||
// 通过 namespace import + 显式类型断言恢复可调用性
|
||||
type PinoFn = (options?: LoggerOptions | unknown) => PinoLogger;
|
||||
const pino = ((pinoNs as unknown as { default: PinoFn }).default ??
|
||||
(pinoNs as unknown as PinoFn)) as PinoFn;
|
||||
import { OutboxService } from "./outbox.service.js";
|
||||
import { OutboxPublisher } from "./publisher.js";
|
||||
import { createOutboxTable } from "./schema.js";
|
||||
|
||||
Reference in New Issue
Block a user