feat: add forum and token store service skeletons

backend/services/taskclassforum/sv/service.go

@@ -0,0 +1,179 @@
+package sv
+
+import (
+	"context"
+	"errors"
+
+	forumcontracts "github.com/LoveLosita/smartflow/backend/shared/contracts/taskclassforum"
+	"gorm.io/gorm"
+)
+
+// ErrNotImplemented 表示 RPC 骨架已接线，但对应业务用例还在后续步骤实现。
+var ErrNotImplemented = errors.New("taskclassforum service method not implemented")
+
+// TaskClassSnapshotPort 是计划广场读取和写入 TaskClass 的端口。
+//
+// 职责边界：
+// 1. P0 由 legacy adapter 适配旧 TaskClass DAO / Service；
+// 2. 业务层只依赖快照语义，不关心底层是旧表、旧服务还是后续 RPC；
+// 3. 不负责写 schedule，一键导入只创建当前用户自己的 TaskClass 副本。
+type TaskClassSnapshotPort interface {
+	GetOwnedTaskClassSnapshot(ctx context.Context, userID uint64, taskClassID uint64) (*TaskClassSnapshot, error)
+	CreateTaskClassFromSnapshot(ctx context.Context, userID uint64, snapshot TaskClassSnapshot, targetTitle string) (*CreatedTaskClass, error)
+}
+
+// TaskClassSnapshot 是可分享的 TaskClass 白名单快照。
+//
+// 注意：这里刻意不包含 embedded_time、schedule 绑定和用户私有排程状态。
+type TaskClassSnapshot struct {
+	TaskClassID        uint64
+	Title              string
+	Mode               string
+	StartDate          string
+	EndDate            string
+	SubjectType        string
+	DifficultyLevel    string
+	CognitiveIntensity string
+	TotalSlots         int
+	AllowFillerCourse  bool
+	Strategy           string
+	ExcludedSlots      []int
+	ExcludedDaysOfWeek []int
+	StrategyLabels     []string
+	Items              []TaskClassSnapshotItem
+	ConfigSnapshotJSON string
+}
+
+// TaskClassSnapshotItem 是 TaskClassItem 的可分享条目快照。
+type TaskClassSnapshotItem struct {
+	TaskItemID uint64
+	Order      int
+	Content    string
+}
+
+// CreatedTaskClass 是导入后创建出的当前用户 TaskClass。
+type CreatedTaskClass struct {
+	TaskClassID uint64
+	Title       string
+}
+
+// Options 是计划广场服务的依赖注入参数。
+type Options struct {
+	DB            *gorm.DB
+	TaskClassPort TaskClassSnapshotPort
+}
+
+// Service 承载计划广场服务内部业务编排。
+//
+// 职责边界：
+// 1. 负责帖子、模板快照、点赞、评论、导入记录的事务编排；
+// 2. 不负责 HTTP 参数绑定，也不直接返回 respond.Response；
+// 3. 不拥有 TaskClass 原表，只通过 TaskClassSnapshotPort 读取和创建副本。
+type Service struct {
+	db            *gorm.DB
+	taskClassPort TaskClassSnapshotPort
+}
+
+func New(opts Options) *Service {
+	return &Service{
+		db:            opts.DB,
+		taskClassPort: opts.TaskClassPort,
+	}
+}
+
+// Ready 用于第二步骨架阶段的依赖检查。
+//
+// 后续实现真实用例时，具体方法会做更细的参数校验；这里先帮助 cmd / 测试快速发现依赖未注入。
+func (s *Service) Ready() error {
+	if s == nil {
+		return errors.New("taskclassforum service is nil")
+	}
+	if s.db == nil {
+		return errors.New("taskclassforum db is nil")
+	}
+	return nil
+}
+
+// ListPosts 是计划列表用例占位，第三步实现真实查询。
+func (s *Service) ListPosts(ctx context.Context, actorUserID uint64, page int, pageSize int, sort string, keyword string, tag string) ([]forumcontracts.ForumPostBrief, forumcontracts.PageResult, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = page
+	_ = pageSize
+	_ = sort
+	_ = keyword
+	_ = tag
+	return nil, forumcontracts.PageResult{}, ErrNotImplemented
+}
+
+// ListTags 是标签列表用例占位，第三步实现真实聚合查询。
+func (s *Service) ListTags(ctx context.Context, actorUserID uint64, limit int) ([]forumcontracts.ForumTagItem, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = limit
+	return nil, ErrNotImplemented
+}
+
+// CreatePost 是发布计划用例占位，第三步会通过 TaskClassSnapshotPort 读取旧计划快照。
+func (s *Service) CreatePost(ctx context.Context, req forumcontracts.CreateForumPostRequest) (*forumcontracts.ForumPostBrief, error) {
+	_ = ctx
+	_ = req
+	return nil, ErrNotImplemented
+}
+
+// GetPost 是计划详情用例占位，第三步实现帖子和模板快照读取。
+func (s *Service) GetPost(ctx context.Context, actorUserID uint64, postID uint64) (*forumcontracts.ForumPostDetail, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = postID
+	return nil, ErrNotImplemented
+}
+
+// LikePost 是点赞用例占位，第三步实现唯一约束和计数更新。
+func (s *Service) LikePost(ctx context.Context, actorUserID uint64, postID uint64) (forumcontracts.ForumPostCounters, forumcontracts.ForumPostViewerState, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = postID
+	return forumcontracts.ForumPostCounters{}, forumcontracts.ForumPostViewerState{}, ErrNotImplemented
+}
+
+// UnlikePost 是取消点赞用例占位，第三步实现幂等撤销。
+func (s *Service) UnlikePost(ctx context.Context, actorUserID uint64, postID uint64) (forumcontracts.ForumPostCounters, forumcontracts.ForumPostViewerState, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = postID
+	return forumcontracts.ForumPostCounters{}, forumcontracts.ForumPostViewerState{}, ErrNotImplemented
+}
+
+// ListComments 是评论树查询用例占位，第三步实现根评论分页和服务层组树。
+func (s *Service) ListComments(ctx context.Context, actorUserID uint64, postID uint64, page int, pageSize int, sort string) ([]forumcontracts.ForumCommentNode, forumcontracts.PageResult, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = postID
+	_ = page
+	_ = pageSize
+	_ = sort
+	return nil, forumcontracts.PageResult{}, ErrNotImplemented
+}
+
+// CreateComment 是发表评论或回复用例占位，第三步实现父子评论校验和幂等。
+func (s *Service) CreateComment(ctx context.Context, req forumcontracts.CreateForumCommentRequest) (*forumcontracts.ForumCommentNode, error) {
+	_ = ctx
+	_ = req
+	return nil, ErrNotImplemented
+}
+
+// DeleteComment 是删除自己评论用例占位，第三步实现软删除和权限判断。
+func (s *Service) DeleteComment(ctx context.Context, actorUserID uint64, commentID uint64) (*forumcontracts.DeleteForumCommentResult, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = commentID
+	return nil, ErrNotImplemented
+}
+
+// ImportPost 是一键导入用例占位，第三步会保证同一用户同一帖子只导入一次。
+func (s *Service) ImportPost(ctx context.Context, req forumcontracts.ImportForumPostRequest) (*forumcontracts.ImportForumPostResult, error) {
+	_ = ctx
+	_ = req
+	return nil, ErrNotImplemented
+}