handlers

type ChangePasswordReq struct {
	ID       string `path:"id" description:"用户ID"`
	Password string `query:"password" validate:"required,min=8" description:"新密码"`
}

type CreateUserReq struct {
	// 姓名(注释)
	Name string `json:"name" binding:"required"`
	// 邮箱(注释)
	Email string `json:"email" binding:"required" description:"邮箱"`
}

type DeleteUserReq struct {
	ID string `path:"id" description:"用户ID"`
}

type DownloadSampleReq struct {
	Name string `path:"name" description:"文件名（示例：sample.txt）"`
}

type Empty = contract.Empty

type FileStream = contract.FileStream

type GetUserReq struct {
	ID string `path:"id" description:"用户ID"`
}

type ListUsersReq struct {
	Page int `query:"page" default:"1" description:"页码"`
	Size int `query:"size" default:"10" description:"每页条数"`
}

type MaskedUser struct {
	Name  string `json:"name"`
	Email string `json:"email"`
}

type NoReq = contract.NoReq

type User struct {
	// 用户ID，全局唯一
	ID string `json:"id"`
	// 用户名
	Name string `json:"name"`
	// 邮箱，用于登录与通知
	Email     string    `json:"email"`
	CreatedAt time.Time `json:"created_at"`
}