feat: add forum and token store service skeletons

backend/services/tokenstore/sv/service.go

@@ -0,0 +1,107 @@
+package sv
+
+import (
+	"context"
+	"errors"
+
+	tokencontracts "github.com/LoveLosita/smartflow/backend/shared/contracts/tokenstore"
+	"gorm.io/gorm"
+)
+
+// ErrNotImplemented 表示 RPC 骨架已接线，但对应业务用例还在后续步骤实现。
+var ErrNotImplemented = errors.New("tokenstore service method not implemented")
+
+// TokenGrantOutlet 是 token-store 后续切到 user/auth 权威额度的内部发放出口。
+//
+// 职责边界：
+// 1. P0 只记录 token-store 自己的获取事实和账本；
+// 2. 禁止直接修改 users 表；
+// 3. 后续切 user/auth 时新增 adapter，服务编排层不重写。
+type TokenGrantOutlet interface {
+	RecordAcquisition(ctx context.Context, grant tokencontracts.TokenGrantRecord) error
+}
+
+// Options 是 token-store 服务的依赖注入参数。
+type Options struct {
+	DB          *gorm.DB
+	GrantOutlet TokenGrantOutlet
+}
+
+// Service 承载 Token 商店服务内部业务编排。
+//
+// 职责边界：
+// 1. 负责商品、订单、mock paid、grant 账本和奖励规则；
+// 2. 不负责登录鉴权，也不直接修改 user/auth 权威额度；
+// 3. 不负责真实第三方支付回调，P0 只处理 mock paid。
+type Service struct {
+	db          *gorm.DB
+	grantOutlet TokenGrantOutlet
+}
+
+func New(opts Options) *Service {
+	return &Service{
+		db:          opts.DB,
+		grantOutlet: opts.GrantOutlet,
+	}
+}
+
+// Ready 用于第二步骨架阶段的依赖检查。
+func (s *Service) Ready() error {
+	if s == nil {
+		return errors.New("tokenstore service is nil")
+	}
+	if s.db == nil {
+		return errors.New("tokenstore db is nil")
+	}
+	return nil
+}
+
+// ListProducts 是商品列表用例占位，第四步实现真实查询。
+func (s *Service) ListProducts(ctx context.Context, actorUserID uint64) ([]tokencontracts.TokenProductView, error) {
+	_ = ctx
+	_ = actorUserID
+	return nil, ErrNotImplemented
+}
+
+// GetSummary 是 Token 概览用例占位，第四步实现 grant 账本聚合。
+func (s *Service) GetSummary(ctx context.Context, actorUserID uint64) (*tokencontracts.TokenSummary, error) {
+	_ = ctx
+	_ = actorUserID
+	return nil, ErrNotImplemented
+}
+
+// CreateOrder 是创建订单用例占位，第四步实现商品读取、订单幂等和金额快照。
+func (s *Service) CreateOrder(ctx context.Context, req tokencontracts.CreateTokenOrderRequest) (*tokencontracts.TokenOrderView, error) {
+	_ = ctx
+	_ = req
+	return nil, ErrNotImplemented
+}
+
+// ListOrders 是订单列表用例占位，第四步实现用户维度分页查询。
+func (s *Service) ListOrders(ctx context.Context, req tokencontracts.ListTokenOrdersRequest) ([]tokencontracts.TokenOrderView, tokencontracts.PageResult, error) {
+	_ = ctx
+	_ = req
+	return nil, tokencontracts.PageResult{}, ErrNotImplemented
+}
+
+// GetOrder 是订单详情用例占位，第四步实现订单归属校验。
+func (s *Service) GetOrder(ctx context.Context, actorUserID uint64, orderID uint64) (*tokencontracts.TokenOrderView, error) {
+	_ = ctx
+	_ = actorUserID
+	_ = orderID
+	return nil, ErrNotImplemented
+}
+
+// MockPaidOrder 是 P0 mock paid 用例占位，第四步实现支付态流转和 grant 账本。
+func (s *Service) MockPaidOrder(ctx context.Context, req tokencontracts.MockPaidOrderRequest) (*tokencontracts.TokenOrderView, error) {
+	_ = ctx
+	_ = req
+	return nil, ErrNotImplemented
+}
+
+// ListGrants 是 Token 获取记录用例占位，第四步实现账本分页查询。
+func (s *Service) ListGrants(ctx context.Context, req tokencontracts.ListTokenGrantsRequest) ([]tokencontracts.TokenGrantView, tokencontracts.PageResult, error) {
+	_ = ctx
+	_ = req
+	return nil, tokencontracts.PageResult{}, ErrNotImplemented
+}