Version: 0.9.70.dev.260504

后端： 1. 阶段 5 schedule 首刀服务化落地，新增 `cmd/schedule`、`services/schedule/{dao,rpc,sv,core}`、`gateway/client/schedule`、`shared/contracts/schedule` 和 schedule port 2. gateway `/api/v1/schedule/*` 切到 schedule zrpc client，HTTP 门面只保留鉴权、参数绑定、超时和轻量转发 3. active-scheduler 的 schedule facts、feedback 和 confirm apply 改为调用 schedule RPC adapter，减少对 `schedule_events`、`schedules`、`task_classes`、`task_items` 的跨域 DB 依赖 4. 单体聊天主动调度 rerun 的 schedule 读写链路切到 schedule RPC，迁移期仅保留 task facts 直读 Gorm 5. 为 schedule zrpc 补充 `Ping` 启动健康检查，并在 gateway client 与 active-scheduler adapter 初始化时校验服务可用 6. `cmd/schedule` 独立初始化 DB / Redis，只 AutoMigrate schedule 自有表，并显式检查迁移期 task / task-class 依赖表 7. 更新 active-scheduler 依赖表检查和 preview confirm apply 抽象，保留旧 Gorm 实现作为迁移期回退路径 8. 补充 `schedule.rpc` 示例配置和 schedule HTTP RPC 超时配置文档： 1. 更新微服务迁移计划，将阶段 5 schedule 首刀进展、当前切流点、旧实现保留范围和 active-scheduler DB 依赖收缩情况写入基线
2026-05-04 22:33:38 +08:00
parent 4d9a5c4d30
commit 29b8cf0ada
27 changed files with 4456 additions and 51 deletions
--- a/backend/services/schedule/rpc/errors.go
+++ b/backend/services/schedule/rpc/errors.go
@@ -0,0 +1,113 @@
+package rpc
+
+import (
+	"errors"
+	"log"
+	"strings"
+
+	"github.com/LoveLosita/smartflow/backend/respond"
+	"github.com/LoveLosita/smartflow/backend/services/schedule/core/applyadapter"
+	"google.golang.org/genproto/googleapis/rpc/errdetails"
+	"google.golang.org/grpc/codes"
+	"google.golang.org/grpc/status"
+)
+
+const (
+	scheduleErrorDomain      = "smartflow.schedule"
+	scheduleApplyErrorDomain = "smartflow.schedule.apply"
+)
+
+// grpcErrorFromServiceError 负责把 schedule 内部错误转换为 gRPC status。
+//
+// 职责边界：
+// 1. apply 业务错误保留错误码，供 active-scheduler 反解后继续按原 confirm 语义处理；
+// 2. respond.Response 继续传输项目内部 status/info；
+// 3. 未分类错误只暴露通用内部错误，详细信息留在服务日志。
+func grpcErrorFromServiceError(err error) error {
+	if err == nil {
+		return nil
+	}
+	var applyErr *applyadapter.ApplyError
+	if errors.As(err, &applyErr) {
+		return grpcErrorFromApplyError(applyErr)
+	}
+	var resp respond.Response
+	if errors.As(err, &resp) {
+		return grpcErrorFromResponse(resp)
+	}
+	log.Printf("schedule rpc internal error: %v", err)
+	return status.Error(codes.Internal, "schedule service internal error")
+}
+
+func grpcErrorFromApplyError(applyErr *applyadapter.ApplyError) error {
+	if applyErr == nil {
+		return status.Error(codes.Internal, "schedule apply error")
+	}
+	message := strings.TrimSpace(applyErr.Message)
+	if message == "" {
+		message = strings.TrimSpace(applyErr.Code)
+	}
+	st := status.New(grpcCodeFromApplyErrorCode(applyErr.Code), message)
+	detail := &errdetails.ErrorInfo{
+		Domain: scheduleApplyErrorDomain,
+		Reason: applyErr.Code,
+		Metadata: map[string]string{
+			"info": message,
+		},
+	}
+	withDetails, err := st.WithDetails(detail)
+	if err != nil {
+		return st.Err()
+	}
+	return withDetails.Err()
+}
+
+func grpcErrorFromResponse(resp respond.Response) error {
+	code := grpcCodeFromRespondStatus(resp.Status)
+	message := strings.TrimSpace(resp.Info)
+	if message == "" {
+		message = strings.TrimSpace(resp.Status)
+	}
+	st := status.New(code, message)
+	detail := &errdetails.ErrorInfo{
+		Domain: scheduleErrorDomain,
+		Reason: resp.Status,
+		Metadata: map[string]string{
+			"info": resp.Info,
+		},
+	}
+	withDetails, err := st.WithDetails(detail)
+	if err != nil {
+		return st.Err()
+	}
+	return withDetails.Err()
+}
+
+func grpcCodeFromApplyErrorCode(code string) codes.Code {
+	switch strings.TrimSpace(code) {
+	case applyadapter.ErrorCodeTargetNotFound:
+		return codes.NotFound
+	case applyadapter.ErrorCodeDBError:
+		return codes.Internal
+	case applyadapter.ErrorCodeTargetCompleted,
+		applyadapter.ErrorCodeTargetAlreadyScheduled,
+		applyadapter.ErrorCodeSlotConflict:
+		return codes.FailedPrecondition
+	default:
+		return codes.InvalidArgument
+	}
+}
+
+func grpcCodeFromRespondStatus(statusValue string) codes.Code {
+	switch strings.TrimSpace(statusValue) {
+	case respond.MissingToken.Status, respond.InvalidToken.Status, respond.InvalidClaims.Status,
+		respond.ErrUnauthorized.Status, respond.WrongTokenType.Status, respond.UserLoggedOut.Status:
+		return codes.Unauthenticated
+	case respond.MissingParam.Status, respond.WrongParamType.Status, respond.ParamTooLong.Status:
+		return codes.InvalidArgument
+	}
+	if strings.HasPrefix(strings.TrimSpace(statusValue), "5") {
+		return codes.Internal
+	}
+	return codes.InvalidArgument
+}
--- a/backend/services/schedule/rpc/handler.go
+++ b/backend/services/schedule/rpc/handler.go
@@ -0,0 +1,166 @@
+package rpc
+
+import (
+	"context"
+	"encoding/json"
+	"errors"
+
+	"github.com/LoveLosita/smartflow/backend/respond"
+	"github.com/LoveLosita/smartflow/backend/services/schedule/rpc/pb"
+	schedulesv "github.com/LoveLosita/smartflow/backend/services/schedule/sv"
+	schedulecontracts "github.com/LoveLosita/smartflow/backend/shared/contracts/schedule"
+)
+
+type Handler struct {
+	pb.UnimplementedScheduleServer
+	svc *schedulesv.ScheduleService
+}
+
+func NewHandler(svc *schedulesv.ScheduleService) *Handler {
+	return &Handler{svc: svc}
+}
+
+// Ping 供调用方在启动期确认 schedule zrpc 已可用。
+func (h *Handler) Ping(ctx context.Context, req *pb.StatusResponse) (*pb.StatusResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	return &pb.StatusResponse{}, nil
+}
+
+func (h *Handler) GetToday(ctx context.Context, req *pb.UserRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	data, err := h.svc.GetUserTodaySchedule(ctx, int(req.UserId))
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) GetWeek(ctx context.Context, req *pb.WeekRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	data, err := h.svc.GetUserWeeklySchedule(ctx, int(req.UserId), int(req.Week))
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) DeleteEvents(ctx context.Context, req *pb.DeleteEventsRequest) (*pb.StatusResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	var events []schedulecontracts.UserDeleteScheduleEvent
+	if err := json.Unmarshal(req.EventsJson, &events); err != nil {
+		return nil, grpcErrorFromServiceError(respond.WrongParamType)
+	}
+	err := h.svc.DeleteScheduleEventByContract(ctx, schedulecontracts.DeleteScheduleEventsRequest{
+		UserID: int(req.UserId),
+		Events: events,
+	})
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return &pb.StatusResponse{}, nil
+}
+
+func (h *Handler) GetRecentCompleted(ctx context.Context, req *pb.RecentCompletedRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	data, err := h.svc.GetUserRecentCompletedSchedules(ctx, int(req.UserId), int(req.Index), int(req.Limit))
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) GetCurrent(ctx context.Context, req *pb.UserRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	data, err := h.svc.GetUserOngoingSchedule(ctx, int(req.UserId))
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) RevokeTaskItem(ctx context.Context, req *pb.RevokeTaskItemRequest) (*pb.StatusResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	if err := h.svc.RevocateUserTaskClassItem(ctx, int(req.UserId), int(req.EventId)); err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return &pb.StatusResponse{}, nil
+}
+
+func (h *Handler) SmartPlanning(ctx context.Context, req *pb.SmartPlanningRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	data, err := h.svc.SmartPlanning(ctx, int(req.UserId), int(req.TaskClassId))
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) SmartPlanningMulti(ctx context.Context, req *pb.SmartPlanningMultiRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	taskClassIDs := make([]int, 0, len(req.TaskClassIds))
+	for _, id := range req.TaskClassIds {
+		taskClassIDs = append(taskClassIDs, int(id))
+	}
+	data, err := h.svc.SmartPlanningMulti(ctx, int(req.UserId), taskClassIDs)
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) GetScheduleFactsByWindow(ctx context.Context, req *pb.JSONRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	var contractReq schedulecontracts.ScheduleWindowRequest
+	if err := json.Unmarshal(req.PayloadJson, &contractReq); err != nil {
+		return nil, grpcErrorFromServiceError(respond.WrongParamType)
+	}
+	data, err := h.svc.GetScheduleFactsByWindow(ctx, contractReq)
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) GetFeedbackSignal(ctx context.Context, req *pb.JSONRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	var contractReq schedulecontracts.FeedbackRequest
+	if err := json.Unmarshal(req.PayloadJson, &contractReq); err != nil {
+		return nil, grpcErrorFromServiceError(respond.WrongParamType)
+	}
+	feedback, found, err := h.svc.GetFeedbackSignal(ctx, contractReq)
+	return jsonResponse(schedulecontracts.FeedbackResponse{Feedback: feedback, Found: found}, err)
+}
+
+func (h *Handler) ApplyActiveScheduleChanges(ctx context.Context, req *pb.JSONRequest) (*pb.JSONResponse, error) {
+	if err := h.ensureReady(req); err != nil {
+		return nil, err
+	}
+	var contractReq schedulecontracts.ApplyActiveScheduleRequest
+	if err := json.Unmarshal(req.PayloadJson, &contractReq); err != nil {
+		return nil, grpcErrorFromServiceError(respond.WrongParamType)
+	}
+	data, err := h.svc.ApplyActiveScheduleChanges(ctx, contractReq)
+	return jsonResponse(data, err)
+}
+
+func (h *Handler) ensureReady(req any) error {
+	if h == nil || h.svc == nil {
+		return grpcErrorFromServiceError(errors.New("schedule service dependency not initialized"))
+	}
+	if req == nil {
+		return grpcErrorFromServiceError(respond.MissingParam)
+	}
+	return nil
+}
+
+func jsonResponse(value any, err error) (*pb.JSONResponse, error) {
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	raw, err := json.Marshal(value)
+	if err != nil {
+		return nil, grpcErrorFromServiceError(err)
+	}
+	return &pb.JSONResponse{DataJson: raw}, nil
+}
--- a/backend/services/schedule/rpc/pb/schedule.pb.go
+++ b/backend/services/schedule/rpc/pb/schedule.pb.go
@@ -0,0 +1,123 @@
+package pb
+
+import proto "github.com/golang/protobuf/proto"
+
+var _ = proto.Marshal
+
+const _ = proto.ProtoPackageIsVersion3
+
+type UserRequest struct {
+	UserId               int64    `protobuf:"varint,1,opt,name=user_id,json=userId,proto3" json:"user_id,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *UserRequest) Reset()         { *m = UserRequest{} }
+func (m *UserRequest) String() string { return proto.CompactTextString(m) }
+func (*UserRequest) ProtoMessage()    {}
+
+type WeekRequest struct {
+	UserId               int64    `protobuf:"varint,1,opt,name=user_id,json=userId,proto3" json:"user_id,omitempty"`
+	Week                 int64    `protobuf:"varint,2,opt,name=week,proto3" json:"week,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *WeekRequest) Reset()         { *m = WeekRequest{} }
+func (m *WeekRequest) String() string { return proto.CompactTextString(m) }
+func (*WeekRequest) ProtoMessage()    {}
+
+type DeleteEventsRequest struct {
+	UserId               int64    `protobuf:"varint,1,opt,name=user_id,json=userId,proto3" json:"user_id,omitempty"`
+	EventsJson           []byte   `protobuf:"bytes,2,opt,name=events_json,json=eventsJson,proto3" json:"events_json,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *DeleteEventsRequest) Reset()         { *m = DeleteEventsRequest{} }
+func (m *DeleteEventsRequest) String() string { return proto.CompactTextString(m) }
+func (*DeleteEventsRequest) ProtoMessage()    {}
+
+type RecentCompletedRequest struct {
+	UserId               int64    `protobuf:"varint,1,opt,name=user_id,json=userId,proto3" json:"user_id,omitempty"`
+	Index                int64    `protobuf:"varint,2,opt,name=index,proto3" json:"index,omitempty"`
+	Limit                int64    `protobuf:"varint,3,opt,name=limit,proto3" json:"limit,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *RecentCompletedRequest) Reset()         { *m = RecentCompletedRequest{} }
+func (m *RecentCompletedRequest) String() string { return proto.CompactTextString(m) }
+func (*RecentCompletedRequest) ProtoMessage()    {}
+
+type RevokeTaskItemRequest struct {
+	UserId               int64    `protobuf:"varint,1,opt,name=user_id,json=userId,proto3" json:"user_id,omitempty"`
+	EventId              int64    `protobuf:"varint,2,opt,name=event_id,json=eventId,proto3" json:"event_id,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *RevokeTaskItemRequest) Reset()         { *m = RevokeTaskItemRequest{} }
+func (m *RevokeTaskItemRequest) String() string { return proto.CompactTextString(m) }
+func (*RevokeTaskItemRequest) ProtoMessage()    {}
+
+type SmartPlanningRequest struct {
+	UserId               int64    `protobuf:"varint,1,opt,name=user_id,json=userId,proto3" json:"user_id,omitempty"`
+	TaskClassId          int64    `protobuf:"varint,2,opt,name=task_class_id,json=taskClassId,proto3" json:"task_class_id,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *SmartPlanningRequest) Reset()         { *m = SmartPlanningRequest{} }
+func (m *SmartPlanningRequest) String() string { return proto.CompactTextString(m) }
+func (*SmartPlanningRequest) ProtoMessage()    {}
+
+type SmartPlanningMultiRequest struct {
+	UserId               int64    `protobuf:"varint,1,opt,name=user_id,json=userId,proto3" json:"user_id,omitempty"`
+	TaskClassIds         []int64  `protobuf:"varint,2,rep,packed,name=task_class_ids,json=taskClassIds,proto3" json:"task_class_ids,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *SmartPlanningMultiRequest) Reset()         { *m = SmartPlanningMultiRequest{} }
+func (m *SmartPlanningMultiRequest) String() string { return proto.CompactTextString(m) }
+func (*SmartPlanningMultiRequest) ProtoMessage()    {}
+
+type JSONRequest struct {
+	PayloadJson          []byte   `protobuf:"bytes,1,opt,name=payload_json,json=payloadJson,proto3" json:"payload_json,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *JSONRequest) Reset()         { *m = JSONRequest{} }
+func (m *JSONRequest) String() string { return proto.CompactTextString(m) }
+func (*JSONRequest) ProtoMessage()    {}
+
+type JSONResponse struct {
+	DataJson             []byte   `protobuf:"bytes,1,opt,name=data_json,json=dataJson,proto3" json:"data_json,omitempty"`
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *JSONResponse) Reset()         { *m = JSONResponse{} }
+func (m *JSONResponse) String() string { return proto.CompactTextString(m) }
+func (*JSONResponse) ProtoMessage()    {}
+
+type StatusResponse struct {
+	XXX_NoUnkeyedLiteral struct{} `json:"-"`
+	XXX_unrecognized     []byte   `json:"-"`
+	XXX_sizecache        int32    `json:"-"`
+}
+
+func (m *StatusResponse) Reset()         { *m = StatusResponse{} }
+func (m *StatusResponse) String() string { return proto.CompactTextString(m) }
+func (*StatusResponse) ProtoMessage()    {}
--- a/backend/services/schedule/rpc/pb/schedule_grpc.pb.go
+++ b/backend/services/schedule/rpc/pb/schedule_grpc.pb.go
@@ -0,0 +1,379 @@
+package pb
+
+import (
+	context "context"
+
+	grpc "google.golang.org/grpc"
+	codes "google.golang.org/grpc/codes"
+	status "google.golang.org/grpc/status"
+)
+
+const (
+	Schedule_Ping_FullMethodName                       = "/smartflow.schedule.Schedule/Ping"
+	Schedule_GetToday_FullMethodName                   = "/smartflow.schedule.Schedule/GetToday"
+	Schedule_GetWeek_FullMethodName                    = "/smartflow.schedule.Schedule/GetWeek"
+	Schedule_DeleteEvents_FullMethodName               = "/smartflow.schedule.Schedule/DeleteEvents"
+	Schedule_GetRecentCompleted_FullMethodName         = "/smartflow.schedule.Schedule/GetRecentCompleted"
+	Schedule_GetCurrent_FullMethodName                 = "/smartflow.schedule.Schedule/GetCurrent"
+	Schedule_RevokeTaskItem_FullMethodName             = "/smartflow.schedule.Schedule/RevokeTaskItem"
+	Schedule_SmartPlanning_FullMethodName              = "/smartflow.schedule.Schedule/SmartPlanning"
+	Schedule_SmartPlanningMulti_FullMethodName         = "/smartflow.schedule.Schedule/SmartPlanningMulti"
+	Schedule_GetScheduleFactsByWindow_FullMethodName   = "/smartflow.schedule.Schedule/GetScheduleFactsByWindow"
+	Schedule_GetFeedbackSignal_FullMethodName          = "/smartflow.schedule.Schedule/GetFeedbackSignal"
+	Schedule_ApplyActiveScheduleChanges_FullMethodName = "/smartflow.schedule.Schedule/ApplyActiveScheduleChanges"
+)
+
+type ScheduleClient interface {
+	Ping(ctx context.Context, in *StatusResponse, opts ...grpc.CallOption) (*StatusResponse, error)
+	GetToday(ctx context.Context, in *UserRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	GetWeek(ctx context.Context, in *WeekRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	DeleteEvents(ctx context.Context, in *DeleteEventsRequest, opts ...grpc.CallOption) (*StatusResponse, error)
+	GetRecentCompleted(ctx context.Context, in *RecentCompletedRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	GetCurrent(ctx context.Context, in *UserRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	RevokeTaskItem(ctx context.Context, in *RevokeTaskItemRequest, opts ...grpc.CallOption) (*StatusResponse, error)
+	SmartPlanning(ctx context.Context, in *SmartPlanningRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	SmartPlanningMulti(ctx context.Context, in *SmartPlanningMultiRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	GetScheduleFactsByWindow(ctx context.Context, in *JSONRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	GetFeedbackSignal(ctx context.Context, in *JSONRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+	ApplyActiveScheduleChanges(ctx context.Context, in *JSONRequest, opts ...grpc.CallOption) (*JSONResponse, error)
+}
+
+type scheduleClient struct {
+	cc grpc.ClientConnInterface
+}
+
+func NewScheduleClient(cc grpc.ClientConnInterface) ScheduleClient {
+	return &scheduleClient{cc}
+}
+
+func (c *scheduleClient) Ping(ctx context.Context, in *StatusResponse, opts ...grpc.CallOption) (*StatusResponse, error) {
+	out := new(StatusResponse)
+	err := c.cc.Invoke(ctx, Schedule_Ping_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) GetToday(ctx context.Context, in *UserRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_GetToday_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) GetWeek(ctx context.Context, in *WeekRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_GetWeek_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) DeleteEvents(ctx context.Context, in *DeleteEventsRequest, opts ...grpc.CallOption) (*StatusResponse, error) {
+	out := new(StatusResponse)
+	err := c.cc.Invoke(ctx, Schedule_DeleteEvents_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) GetRecentCompleted(ctx context.Context, in *RecentCompletedRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_GetRecentCompleted_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) GetCurrent(ctx context.Context, in *UserRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_GetCurrent_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) RevokeTaskItem(ctx context.Context, in *RevokeTaskItemRequest, opts ...grpc.CallOption) (*StatusResponse, error) {
+	out := new(StatusResponse)
+	err := c.cc.Invoke(ctx, Schedule_RevokeTaskItem_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) SmartPlanning(ctx context.Context, in *SmartPlanningRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_SmartPlanning_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) SmartPlanningMulti(ctx context.Context, in *SmartPlanningMultiRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_SmartPlanningMulti_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) GetScheduleFactsByWindow(ctx context.Context, in *JSONRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_GetScheduleFactsByWindow_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) GetFeedbackSignal(ctx context.Context, in *JSONRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_GetFeedbackSignal_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+func (c *scheduleClient) ApplyActiveScheduleChanges(ctx context.Context, in *JSONRequest, opts ...grpc.CallOption) (*JSONResponse, error) {
+	out := new(JSONResponse)
+	err := c.cc.Invoke(ctx, Schedule_ApplyActiveScheduleChanges_FullMethodName, in, out, opts...)
+	return out, err
+}
+
+type ScheduleServer interface {
+	Ping(context.Context, *StatusResponse) (*StatusResponse, error)
+	GetToday(context.Context, *UserRequest) (*JSONResponse, error)
+	GetWeek(context.Context, *WeekRequest) (*JSONResponse, error)
+	DeleteEvents(context.Context, *DeleteEventsRequest) (*StatusResponse, error)
+	GetRecentCompleted(context.Context, *RecentCompletedRequest) (*JSONResponse, error)
+	GetCurrent(context.Context, *UserRequest) (*JSONResponse, error)
+	RevokeTaskItem(context.Context, *RevokeTaskItemRequest) (*StatusResponse, error)
+	SmartPlanning(context.Context, *SmartPlanningRequest) (*JSONResponse, error)
+	SmartPlanningMulti(context.Context, *SmartPlanningMultiRequest) (*JSONResponse, error)
+	GetScheduleFactsByWindow(context.Context, *JSONRequest) (*JSONResponse, error)
+	GetFeedbackSignal(context.Context, *JSONRequest) (*JSONResponse, error)
+	ApplyActiveScheduleChanges(context.Context, *JSONRequest) (*JSONResponse, error)
+}
+
+type UnimplementedScheduleServer struct{}
+
+func (UnimplementedScheduleServer) Ping(context.Context, *StatusResponse) (*StatusResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method Ping not implemented")
+}
+
+func (UnimplementedScheduleServer) GetToday(context.Context, *UserRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method GetToday not implemented")
+}
+func (UnimplementedScheduleServer) GetWeek(context.Context, *WeekRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method GetWeek not implemented")
+}
+func (UnimplementedScheduleServer) DeleteEvents(context.Context, *DeleteEventsRequest) (*StatusResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method DeleteEvents not implemented")
+}
+func (UnimplementedScheduleServer) GetRecentCompleted(context.Context, *RecentCompletedRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method GetRecentCompleted not implemented")
+}
+func (UnimplementedScheduleServer) GetCurrent(context.Context, *UserRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method GetCurrent not implemented")
+}
+func (UnimplementedScheduleServer) RevokeTaskItem(context.Context, *RevokeTaskItemRequest) (*StatusResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method RevokeTaskItem not implemented")
+}
+func (UnimplementedScheduleServer) SmartPlanning(context.Context, *SmartPlanningRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method SmartPlanning not implemented")
+}
+func (UnimplementedScheduleServer) SmartPlanningMulti(context.Context, *SmartPlanningMultiRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method SmartPlanningMulti not implemented")
+}
+func (UnimplementedScheduleServer) GetScheduleFactsByWindow(context.Context, *JSONRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method GetScheduleFactsByWindow not implemented")
+}
+func (UnimplementedScheduleServer) GetFeedbackSignal(context.Context, *JSONRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method GetFeedbackSignal not implemented")
+}
+func (UnimplementedScheduleServer) ApplyActiveScheduleChanges(context.Context, *JSONRequest) (*JSONResponse, error) {
+	return nil, status.Errorf(codes.Unimplemented, "method ApplyActiveScheduleChanges not implemented")
+}
+
+func RegisterScheduleServer(s grpc.ServiceRegistrar, srv ScheduleServer) {
+	s.RegisterService(&Schedule_ServiceDesc, srv)
+}
+
+func _Schedule_Ping_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(StatusResponse)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).Ping(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_Ping_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).Ping(ctx, req.(*StatusResponse))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_GetToday_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(UserRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).GetToday(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_GetToday_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).GetToday(ctx, req.(*UserRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_GetWeek_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(WeekRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).GetWeek(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_GetWeek_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).GetWeek(ctx, req.(*WeekRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_DeleteEvents_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(DeleteEventsRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).DeleteEvents(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_DeleteEvents_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).DeleteEvents(ctx, req.(*DeleteEventsRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_GetRecentCompleted_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(RecentCompletedRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).GetRecentCompleted(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_GetRecentCompleted_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).GetRecentCompleted(ctx, req.(*RecentCompletedRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_GetCurrent_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(UserRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).GetCurrent(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_GetCurrent_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).GetCurrent(ctx, req.(*UserRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_RevokeTaskItem_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(RevokeTaskItemRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).RevokeTaskItem(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_RevokeTaskItem_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).RevokeTaskItem(ctx, req.(*RevokeTaskItemRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_SmartPlanning_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(SmartPlanningRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).SmartPlanning(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_SmartPlanning_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).SmartPlanning(ctx, req.(*SmartPlanningRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_SmartPlanningMulti_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(SmartPlanningMultiRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).SmartPlanningMulti(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_SmartPlanningMulti_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).SmartPlanningMulti(ctx, req.(*SmartPlanningMultiRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_GetScheduleFactsByWindow_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(JSONRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).GetScheduleFactsByWindow(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_GetScheduleFactsByWindow_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).GetScheduleFactsByWindow(ctx, req.(*JSONRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_GetFeedbackSignal_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(JSONRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).GetFeedbackSignal(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_GetFeedbackSignal_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).GetFeedbackSignal(ctx, req.(*JSONRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+func _Schedule_ApplyActiveScheduleChanges_Handler(srv interface{}, ctx context.Context, dec func(interface{}) error, interceptor grpc.UnaryServerInterceptor) (interface{}, error) {
+	in := new(JSONRequest)
+	if err := dec(in); err != nil {
+		return nil, err
+	}
+	if interceptor == nil {
+		return srv.(ScheduleServer).ApplyActiveScheduleChanges(ctx, in)
+	}
+	info := &grpc.UnaryServerInfo{Server: srv, FullMethod: Schedule_ApplyActiveScheduleChanges_FullMethodName}
+	handler := func(ctx context.Context, req interface{}) (interface{}, error) {
+		return srv.(ScheduleServer).ApplyActiveScheduleChanges(ctx, req.(*JSONRequest))
+	}
+	return interceptor(ctx, in, info, handler)
+}
+
+var Schedule_ServiceDesc = grpc.ServiceDesc{
+	ServiceName: "smartflow.schedule.Schedule",
+	HandlerType: (*ScheduleServer)(nil),
+	Methods: []grpc.MethodDesc{
+		{MethodName: "Ping", Handler: _Schedule_Ping_Handler},
+		{MethodName: "GetToday", Handler: _Schedule_GetToday_Handler},
+		{MethodName: "GetWeek", Handler: _Schedule_GetWeek_Handler},
+		{MethodName: "DeleteEvents", Handler: _Schedule_DeleteEvents_Handler},
+		{MethodName: "GetRecentCompleted", Handler: _Schedule_GetRecentCompleted_Handler},
+		{MethodName: "GetCurrent", Handler: _Schedule_GetCurrent_Handler},
+		{MethodName: "RevokeTaskItem", Handler: _Schedule_RevokeTaskItem_Handler},
+		{MethodName: "SmartPlanning", Handler: _Schedule_SmartPlanning_Handler},
+		{MethodName: "SmartPlanningMulti", Handler: _Schedule_SmartPlanningMulti_Handler},
+		{MethodName: "GetScheduleFactsByWindow", Handler: _Schedule_GetScheduleFactsByWindow_Handler},
+		{MethodName: "GetFeedbackSignal", Handler: _Schedule_GetFeedbackSignal_Handler},
+		{MethodName: "ApplyActiveScheduleChanges", Handler: _Schedule_ApplyActiveScheduleChanges_Handler},
+	},
+	Streams:  []grpc.StreamDesc{},
+	Metadata: "schedule.proto",
+}
--- a/backend/services/schedule/rpc/schedule.proto
+++ b/backend/services/schedule/rpc/schedule.proto
@@ -0,0 +1,66 @@
+syntax = "proto3";
+
+package smartflow.schedule;
+
+option go_package = "github.com/LoveLosita/smartflow/backend/services/schedule/rpc/pb";
+
+service Schedule {
+  rpc Ping(StatusResponse) returns (StatusResponse);
+  rpc GetToday(UserRequest) returns (JSONResponse);
+  rpc GetWeek(WeekRequest) returns (JSONResponse);
+  rpc DeleteEvents(DeleteEventsRequest) returns (StatusResponse);
+  rpc GetRecentCompleted(RecentCompletedRequest) returns (JSONResponse);
+  rpc GetCurrent(UserRequest) returns (JSONResponse);
+  rpc RevokeTaskItem(RevokeTaskItemRequest) returns (StatusResponse);
+  rpc SmartPlanning(SmartPlanningRequest) returns (JSONResponse);
+  rpc SmartPlanningMulti(SmartPlanningMultiRequest) returns (JSONResponse);
+  rpc GetScheduleFactsByWindow(JSONRequest) returns (JSONResponse);
+  rpc GetFeedbackSignal(JSONRequest) returns (JSONResponse);
+  rpc ApplyActiveScheduleChanges(JSONRequest) returns (JSONResponse);
+}
+
+message UserRequest {
+  int64 user_id = 1;
+}
+
+message WeekRequest {
+  int64 user_id = 1;
+  int64 week = 2;
+}
+
+message DeleteEventsRequest {
+  int64 user_id = 1;
+  bytes events_json = 2;
+}
+
+message RecentCompletedRequest {
+  int64 user_id = 1;
+  int64 index = 2;
+  int64 limit = 3;
+}
+
+message RevokeTaskItemRequest {
+  int64 user_id = 1;
+  int64 event_id = 2;
+}
+
+message SmartPlanningRequest {
+  int64 user_id = 1;
+  int64 task_class_id = 2;
+}
+
+message SmartPlanningMultiRequest {
+  int64 user_id = 1;
+  repeated int64 task_class_ids = 2;
+}
+
+message JSONRequest {
+  bytes payload_json = 1;
+}
+
+message JSONResponse {
+  bytes data_json = 1;
+}
+
+message StatusResponse {
+}
--- a/backend/services/schedule/rpc/server.go
+++ b/backend/services/schedule/rpc/server.go
@@ -0,0 +1,60 @@
+package rpc
+
+import (
+	"errors"
+	"strings"
+	"time"
+
+	"github.com/LoveLosita/smartflow/backend/services/schedule/rpc/pb"
+	schedulesv "github.com/LoveLosita/smartflow/backend/services/schedule/sv"
+	"github.com/zeromicro/go-zero/core/service"
+	"github.com/zeromicro/go-zero/zrpc"
+	"google.golang.org/grpc"
+)
+
+const (
+	defaultListenOn = "0.0.0.0:9084"
+	defaultTimeout  = 6 * time.Second
+)
+
+type ServerOptions struct {
+	ListenOn string
+	Timeout  time.Duration
+	Service  *schedulesv.ScheduleService
+}
+
+// NewServer 创建 schedule zrpc 服务端。
+//
+// 职责边界：
+// 1. 只负责 zrpc server 配置与 gRPC handler 注册；
+// 2. 不创建数据库、Redis 或业务服务，它们由 cmd/schedule 管理；
+// 3. 返回 listenOn 供进程入口打印启动日志。
+func NewServer(opts ServerOptions) (*zrpc.RpcServer, string, error) {
+	if opts.Service == nil {
+		return nil, "", errors.New("schedule service dependency not initialized")
+	}
+
+	listenOn := strings.TrimSpace(opts.ListenOn)
+	if listenOn == "" {
+		listenOn = defaultListenOn
+	}
+	timeout := opts.Timeout
+	if timeout <= 0 {
+		timeout = defaultTimeout
+	}
+
+	server, err := zrpc.NewServer(zrpc.RpcServerConf{
+		ServiceConf: service.ServiceConf{
+			Name: "schedule.rpc",
+			Mode: service.DevMode,
+		},
+		ListenOn: listenOn,
+		Timeout:  int64(timeout / time.Millisecond),
+	}, func(grpcServer *grpc.Server) {
+		pb.RegisterScheduleServer(grpcServer, NewHandler(opts.Service))
+	})
+	if err != nil {
+		return nil, "", err
+	}
+	return server, listenOn, nil
+}