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

backend/services/active_scheduler/rpc/handler.go

@@ -0,0 +1,155 @@
+package rpc
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+	"time"
+
+	"github.com/LoveLosita/smartflow/backend/respond"
+	"github.com/LoveLosita/smartflow/backend/services/active_scheduler/rpc/pb"
+	activeschedulersv "github.com/LoveLosita/smartflow/backend/services/active_scheduler/sv"
+	contracts "github.com/LoveLosita/smartflow/backend/shared/contracts/activescheduler"
+)
+
+type Handler struct {
+	pb.UnimplementedActiveSchedulerServer
+	svc *activeschedulersv.Service
+}
+
+func NewHandler(svc *activeschedulersv.Service) *Handler {
+	return &Handler{svc: svc}
+}
+
+// DryRun 负责把 gRPC 请求转换为主动调度 dry-run 服务调用。
+func (h *Handler) DryRun(ctx context.Context, req *pb.ActiveScheduleRequest) (*pb.JSONResponse, error) {
+	if h == nil || h.svc == nil {
+		return nil, grpcErrorFromServiceError(errors.New("active-scheduler service dependency not initialized"))
+	}
+	if req == nil {
+		return nil, grpcErrorFromServiceError(respond.MissingParam)
+	}
+	data, err := h.svc.DryRun(ctx, activeScheduleRequestFromPB(req))
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return jsonResponse(data), nil
+}
+
+func (h *Handler) Trigger(ctx context.Context, req *pb.ActiveScheduleRequest) (*pb.TriggerResponse, error) {
+	if h == nil || h.svc == nil {
+		return nil, grpcErrorFromServiceError(errors.New("active-scheduler service dependency not initialized"))
+	}
+	if req == nil {
+		return nil, grpcErrorFromServiceError(respond.MissingParam)
+	}
+	resp, err := h.svc.Trigger(ctx, activeScheduleRequestFromPB(req))
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return triggerResponseToPB(resp), nil
+}
+
+func (h *Handler) CreatePreview(ctx context.Context, req *pb.ActiveScheduleRequest) (*pb.JSONResponse, error) {
+	if h == nil || h.svc == nil {
+		return nil, grpcErrorFromServiceError(errors.New("active-scheduler service dependency not initialized"))
+	}
+	if req == nil {
+		return nil, grpcErrorFromServiceError(respond.MissingParam)
+	}
+	data, err := h.svc.CreatePreview(ctx, activeScheduleRequestFromPB(req))
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return jsonResponse(data), nil
+}
+
+func (h *Handler) GetPreview(ctx context.Context, req *pb.GetPreviewRequest) (*pb.JSONResponse, error) {
+	if h == nil || h.svc == nil {
+		return nil, grpcErrorFromServiceError(errors.New("active-scheduler service dependency not initialized"))
+	}
+	if req == nil {
+		return nil, grpcErrorFromServiceError(respond.MissingParam)
+	}
+	data, err := h.svc.GetPreview(ctx, contracts.GetPreviewRequest{
+		UserID:    int(req.UserId),
+		PreviewID: req.PreviewId,
+	})
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return jsonResponse(data), nil
+}
+
+func (h *Handler) ConfirmPreview(ctx context.Context, req *pb.ConfirmPreviewRequest) (*pb.JSONResponse, error) {
+	if h == nil || h.svc == nil {
+		return nil, grpcErrorFromServiceError(errors.New("active-scheduler service dependency not initialized"))
+	}
+	if req == nil {
+		return nil, grpcErrorFromServiceError(respond.MissingParam)
+	}
+	data, err := h.svc.ConfirmPreview(ctx, confirmRequestFromPB(req))
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return jsonResponse(data), nil
+}
+
+func activeScheduleRequestFromPB(req *pb.ActiveScheduleRequest) contracts.ActiveScheduleRequest {
+	var mockNow *time.Time
+	if req.MockNowUnixNano > 0 {
+		value := time.Unix(0, req.MockNowUnixNano)
+		mockNow = &value
+	}
+	return contracts.ActiveScheduleRequest{
+		UserID:         int(req.UserId),
+		TriggerType:    req.TriggerType,
+		TargetType:     req.TargetType,
+		TargetID:       int(req.TargetId),
+		FeedbackID:     req.FeedbackId,
+		IdempotencyKey: req.IdempotencyKey,
+		MockNow:        mockNow,
+		Payload:        json.RawMessage(req.PayloadJson),
+	}
+}
+
+func confirmRequestFromPB(req *pb.ConfirmPreviewRequest) contracts.ConfirmPreviewRequest {
+	requestedAt := time.Time{}
+	if req.RequestedAtUnixNano > 0 {
+		requestedAt = time.Unix(0, req.RequestedAtUnixNano)
+	}
+	return contracts.ConfirmPreviewRequest{
+		UserID:         int(req.UserId),
+		PreviewID:      req.PreviewId,
+		CandidateID:    req.CandidateId,
+		Action:         req.Action,
+		EditedChanges:  json.RawMessage(req.EditedChangesJson),
+		IdempotencyKey: req.IdempotencyKey,
+		RequestedAt:    requestedAt,
+		TraceID:        req.TraceId,
+	}
+}
+
+func triggerResponseToPB(resp *contracts.TriggerResponse) *pb.TriggerResponse {
+	if resp == nil {
+		return &pb.TriggerResponse{}
+	}
+	previewID := ""
+	hasPreviewID := false
+	if resp.PreviewID != nil {
+		previewID = *resp.PreviewID
+		hasPreviewID = previewID != ""
+	}
+	return &pb.TriggerResponse{
+		TriggerId:    resp.TriggerID,
+		Status:       resp.Status,
+		PreviewId:    previewID,
+		HasPreviewId: hasPreviewID,
+		DedupeHit:    resp.DedupeHit,
+		TraceId:      resp.TraceID,
+	}
+}
+
+func jsonResponse(data json.RawMessage) *pb.JSONResponse {
+	return &pb.JSONResponse{DataJson: []byte(data)}
+}