feat(架构): 完善基础架构设计

internal/shared/interfaces/http.go

@@ -76,9 +76,14 @@ type ResponseBuilder interface {
 	NotFound(c *gin.Context, message ...string)
 	Conflict(c *gin.Context, message string)
 	InternalError(c *gin.Context, message ...string)
+	ValidationError(c *gin.Context, errors interface{})
+	TooManyRequests(c *gin.Context, message ...string)
 
 	// 分页响应
 	Paginated(c *gin.Context, data interface{}, pagination PaginationMeta)
+
+	// 自定义响应
+	CustomResponse(c *gin.Context, statusCode int, data interface{})
 }
 
 // RequestValidator 请求验证器接口
@@ -90,6 +95,9 @@ type RequestValidator interface {
 
 	// 绑定和验证
 	BindAndValidate(c *gin.Context, dto interface{}) error
+
+	// 直接验证结构体
+	ValidateStruct(dto interface{}) error
 }
 
 // PaginationMeta 分页元数据

internal/shared/interfaces/service.go

@@ -2,6 +2,15 @@ package interfaces
 
 import (
 	"context"
+	"errors"
+
+	"tyapi-server/internal/domains/user/dto"
+	"tyapi-server/internal/domains/user/entities"
+)
+
+// 常见错误定义
+var (
+	ErrCacheMiss = errors.New("cache miss")
 )
 
 // Service 通用服务接口
@@ -16,6 +25,22 @@ type Service interface {
 	Shutdown(ctx context.Context) error
 }
 
+// UserService 用户服务接口
+type UserService interface {
+	Service
+
+	// 用户注册
+	Register(ctx context.Context, req *dto.RegisterRequest) (*entities.User, error)
+	// 密码登录
+	LoginWithPassword(ctx context.Context, req *dto.LoginWithPasswordRequest) (*entities.User, error)
+	// 短信验证码登录
+	LoginWithSMS(ctx context.Context, req *dto.LoginWithSMSRequest) (*entities.User, error)
+	// 修改密码
+	ChangePassword(ctx context.Context, userID string, req *dto.ChangePasswordRequest) error
+	// 根据ID获取用户
+	GetByID(ctx context.Context, id string) (*entities.User, error)
+}
+
 // DomainService 领域服务接口，支持泛型
 type DomainService[T Entity] interface {
 	Service