23246ade6d
P3 阶段交付物： - services/core-edu: 教学核心服务（DDD 限界上下文：exams/grades/homework/classes） - exams: 考试 CRUD + 事务内写 exam + outbox - grades: 成绩 CRUD - homework: 作业 CRUD - classes.module: 复用 P1 classes 模块（聚合到 core-edu 服务） - Outbox 模式实现： - outbox.schema.ts: core_edu_outbox 表（id/aggregate_id/event_type/payload/status/retry_count） - outbox.repository.ts: 支持事务参数 tx，确保业务+事件原子性 - outbox.publisher.ts: Kafka idempotent producer + transactionalId，TOPIC_MAP 路由 9 种事件，MAX_RETRY=5 - config/kafka.ts: idempotent producer + transactionalId 配置 - main.ts: 启动顺序 initTracer → connectKafka → outboxPublisher.start → app.listen - packages/shared-proto/proto/core_edu.proto: ExamService/HomeworkService/GradeService 契约 - packages/shared-proto/proto/events.proto: ClassEvent/ExamEvent/HomeworkEvent/GradeEvent 领域事件契约
61 lines
1.5 KiB
Protocol Buffer
61 lines
1.5 KiB
Protocol Buffer
syntax = "proto3";
|
|
|
|
package next_edu_cloud.events.v1;
|
|
|
|
// Cross-service event contracts published by CoreEdu via the transactional
|
|
// outbox pattern and consumed by downstream services (notifications, analytics,
|
|
// audit, etc.). Topics follow the convention edu.{domain}.events.
|
|
//
|
|
// Event routing (TOPIC_MAP in outbox.publisher.ts):
|
|
// edu.exam.events <- exam.created / exam.updated / exam.deleted
|
|
// edu.homework.events <- homework.assigned / homework.submitted / homework.graded
|
|
// edu.grade.events <- grade.recorded / grade.updated
|
|
// edu.class.events <- class.transferred
|
|
|
|
message ClassEvent {
|
|
string event_id = 1;
|
|
string aggregate_id = 2;
|
|
string event_type = 3;
|
|
int64 occurred_at = 4;
|
|
string class_id = 5;
|
|
string name = 6;
|
|
string action = 7;
|
|
map<string, string> metadata = 8;
|
|
}
|
|
|
|
message ExamEvent {
|
|
string event_id = 1;
|
|
string aggregate_id = 2;
|
|
string event_type = 3;
|
|
int64 occurred_at = 4;
|
|
string exam_id = 5;
|
|
string class_id = 6;
|
|
string title = 7;
|
|
string action = 8;
|
|
map<string, string> metadata = 9;
|
|
}
|
|
|
|
message HomeworkEvent {
|
|
string event_id = 1;
|
|
string aggregate_id = 2;
|
|
string event_type = 3;
|
|
int64 occurred_at = 4;
|
|
string homework_id = 5;
|
|
string class_id = 6;
|
|
string title = 7;
|
|
string action = 8;
|
|
map<string, string> metadata = 9;
|
|
}
|
|
|
|
message GradeEvent {
|
|
string event_id = 1;
|
|
string aggregate_id = 2;
|
|
string event_type = 3;
|
|
int64 occurred_at = 4;
|
|
string grade_id = 5;
|
|
string student_id = 6;
|
|
string score = 7;
|
|
string action = 8;
|
|
map<string, string> metadata = 9;
|
|
}
|