// ================================================================================
// Code generated and maintained by GoFrame CLI tool. DO NOT EDIT.
// You can delete these comments if you wish manually maintain this interface file.
// ================================================================================

package service

import (
	"context"
	"easygoadmin/api/v1"
)

// 按模块独立拆分（源：gf gen service 产物手工重组）。
// logic 方法签名变更时需同步维护本文件（手维护，勿整体运行 gf gen service）。

// IUser 用户服务接口
type IUser interface {
	// Page 用户分页
	// 支持关键词、状态、部门、角色、职级、岗位筛选，并批量补全行内冗余名称
	Page(ctx context.Context, req *v1.UserPageReq) (res *v1.UserPageRes, err error)
	// List 用户全量列表
	// 供下拉选择使用
	List(ctx context.Context, req *v1.UserListReq) (res v1.UserListRes, err error)
	// Detail 用户详情
	Detail(ctx context.Context, req *v1.UserDetailReq) (res *v1.UserDetailRes, err error)
	// Add 新增用户
	// 用户名与手机号租户内唯一，校验租户用户上限，并写入用户角色关联
	Add(ctx context.Context, req *v1.UserAddReq) (res *v1.IdRes, err error)
	// Update 修改用户
	// 密码留空时不做修改，角色关联全量重写
	Update(ctx context.Context, req *v1.UserUpdateReq) (res *v1.UserUpdateRes, err error)
	// Status 用户状态
	Status(ctx context.Context, req *v1.UserStatusReq) (res *v1.UserStatusRes, err error)
	// ResetPwd 重置密码
	// 未传新密码时重置为系统默认密码
	ResetPwd(ctx context.Context, req *v1.UserResetPwdReq) (res *v1.UserResetPwdRes, err error)
	// Delete 删除用户
	// 软删记录并清理用户角色关联
	Delete(ctx context.Context, req *v1.UserDeleteReq) (res *v1.UserDeleteRes, err error)
	// BatchDelete 批量删除用户
	BatchDelete(ctx context.Context, req *v1.UserBatchDeleteReq) (res *v1.UserBatchDeleteRes, err error)
	// Import 导入用户
	// 支持 xlsx 文件，列依次为用户名、姓名、密码、手机、邮箱、性别、部门、职级、岗位、状态、地址、备注；
	// 密码留空时取系统默认密码
	Import(ctx context.Context, req *v1.UserImportReq) (res *v1.UserImportRes, err error)
	// Export 导出用户
	// 每批 500 条防 OOM，写出 xlsx 并返回访问地址
	Export(ctx context.Context, req *v1.UserExportReq) (res *v1.UserExportRes, err error)
	// Document 用户打印信息
	Document(ctx context.Context, req *v1.UserDocumentReq) (res *v1.UserDocumentRes, err error)
	// AssignRoles 重写用户角色关联
	// 供新增与修改调用
	AssignRoles(ctx context.Context, userId int64, roleIds []int64) error
}

// localUser 用户服务实现实例
var localUser IUser

// User 获取用户服务实例
func User() IUser {
	if localUser == nil {
		panic("implement not found for interface IUser, forgot register?")
	}
	return localUser
}

// RegisterUser 注册用户服务实现
func RegisterUser(i IUser) {
	localUser = i
}