Version: 0.9.69.dev.260504
后端: 1. 阶段 4 active-scheduler 服务边界落地,新增 `cmd/active-scheduler`、`services/active_scheduler`、`shared/contracts/activescheduler` 和 active-scheduler port,迁移 dry-run、trigger、preview、confirm zrpc 能力 2. active-scheduler outbox consumer、relay、retry loop 和 due job scanner 迁入独立服务入口,gateway `/active-schedule/*` 改为通过 zrpc client 调用 3. gateway 目录收口为 `gateway/api` + `gateway/client`,统一归档 userauth、notification、active-scheduler 的 HTTP 门面和 zrpc client 4. 将旧 `backend/active_scheduler` 领域核心下沉到 `services/active_scheduler/core`,清退旧根目录活跃实现,并补充 active-scheduler 启动期跨域依赖表检查 5. 调整单体启动与 outbox 归属,`cmd/all` 不再启动 active-scheduler workflow、scanner 或 handler 文档: 1. 更新微服务迁移计划,将阶段 4 active-scheduler 标记为首轮收口完成,并明确下一阶段进入 schedule / task / course / task-class
This commit is contained in:
103
backend/services/active_scheduler/core/trigger/types.go
Normal file
103
backend/services/active_scheduler/core/trigger/types.go
Normal file
@@ -0,0 +1,103 @@
|
||||
package trigger
|
||||
|
||||
import (
|
||||
"errors"
|
||||
"time"
|
||||
)
|
||||
|
||||
// TriggerType 是主动调度第一版允许进入 dry-run 主链路的触发类型。
|
||||
//
|
||||
// 职责边界:
|
||||
// 1. 只表达触发信号分类;
|
||||
// 2. 不负责判断任务是否真的需要调度;
|
||||
// 3. 不承载 preview、notification 或 apply 状态。
|
||||
type TriggerType string
|
||||
|
||||
const (
|
||||
TriggerTypeImportantUrgentTask TriggerType = "important_urgent_task"
|
||||
TriggerTypeUnfinishedFeedback TriggerType = "unfinished_feedback"
|
||||
)
|
||||
|
||||
// Source 表示触发信号来源;dry-run 第一版只消费该字段用于审计和 mock_now 校验。
|
||||
type Source string
|
||||
|
||||
const (
|
||||
SourceWorkerDueJob Source = "worker_due_job"
|
||||
SourceAPITrigger Source = "api_trigger"
|
||||
SourceAPIDryRun Source = "api_dry_run"
|
||||
SourceUserFeedback Source = "user_feedback"
|
||||
)
|
||||
|
||||
// TargetType 表示触发信号指向的业务对象类型。
|
||||
type TargetType string
|
||||
|
||||
const (
|
||||
TargetTypeTaskPool TargetType = "task_pool"
|
||||
TargetTypeScheduleEvent TargetType = "schedule_event"
|
||||
TargetTypeTaskItem TargetType = "task_item"
|
||||
)
|
||||
|
||||
// ActiveScheduleTrigger 是主动调度主链路的统一输入。
|
||||
//
|
||||
// 职责边界:
|
||||
// 1. 负责承载 API dry-run、正式 trigger、worker 与用户反馈归一后的输入;
|
||||
// 2. 不负责读取任务、日程或反馈事实;
|
||||
// 3. TargetID 在 unfinished_feedback 且反馈目标未知时允许为 0,由观察链路转成 ask_user。
|
||||
type ActiveScheduleTrigger struct {
|
||||
TriggerID string
|
||||
UserID int
|
||||
TriggerType TriggerType
|
||||
Source Source
|
||||
TargetType TargetType
|
||||
TargetID int
|
||||
FeedbackID string
|
||||
IdempotencyKey string
|
||||
MockNow *time.Time
|
||||
IsMockTime bool
|
||||
RequestedAt time.Time
|
||||
TraceID string
|
||||
}
|
||||
|
||||
// Validate 校验触发信号是否能进入主动调度 dry-run 主链路。
|
||||
//
|
||||
// 职责边界:
|
||||
// 1. 只做枚举、归属与 mock_now 入口级校验;
|
||||
// 2. 不判断目标是否存在,也不判断是否应生成候选;
|
||||
// 3. 返回 nil 表示可以继续构造上下文,error 表示调用方应直接拒绝请求。
|
||||
func (t ActiveScheduleTrigger) Validate() error {
|
||||
if t.UserID <= 0 {
|
||||
return errors.New("user_id 必须大于 0")
|
||||
}
|
||||
if t.TriggerType != TriggerTypeImportantUrgentTask && t.TriggerType != TriggerTypeUnfinishedFeedback {
|
||||
return errors.New("trigger_type 不受支持")
|
||||
}
|
||||
if t.Source != SourceWorkerDueJob && t.Source != SourceAPITrigger && t.Source != SourceAPIDryRun && t.Source != SourceUserFeedback {
|
||||
return errors.New("source 不受支持")
|
||||
}
|
||||
if t.TargetType != TargetTypeTaskPool && t.TargetType != TargetTypeScheduleEvent && t.TargetType != TargetTypeTaskItem {
|
||||
return errors.New("target_type 不受支持")
|
||||
}
|
||||
if t.TargetID <= 0 && t.TriggerType != TriggerTypeUnfinishedFeedback {
|
||||
return errors.New("target_id 必须大于 0")
|
||||
}
|
||||
if t.MockNow != nil && t.Source != SourceAPIDryRun && t.Source != SourceAPITrigger {
|
||||
return errors.New("mock_now 只允许 API dry-run 或 API trigger 使用")
|
||||
}
|
||||
if t.MockNow != nil && !t.IsMockTime {
|
||||
return errors.New("传入 mock_now 时必须显式标记 is_mock_time")
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// EffectiveNow 返回主动调度本次运行应使用的业务当前时间。
|
||||
//
|
||||
// 职责边界:
|
||||
// 1. dry-run / 测试 trigger 可使用 MockNow;
|
||||
// 2. 后台 worker 使用调用方传入的真实 now;
|
||||
// 3. 不负责时区转换,调用方应保证 now 与用户时区语义一致。
|
||||
func (t ActiveScheduleTrigger) EffectiveNow(realNow time.Time) time.Time {
|
||||
if t.MockNow != nil {
|
||||
return *t.MockNow
|
||||
}
|
||||
return realNow
|
||||
}
|
||||
Reference in New Issue
Block a user