签入脚本

internal/controller/user.go

@@ -0,0 +1,86 @@
+package controller
+
+import (
+	"context"
+
+	"easygoadmin/api/v1"
+	"easygoadmin/internal/service"
+)
+
+// ============================== 用户控制器 ==============================
+
+// CUser 用户控制器
+// 薄层控制器，仅负责参数透传，业务逻辑由 service.User() 处理
+type CUser struct{}
+
+// Page 用户分页
+// 按查询条件分页返回用户列表
+func (c *CUser) Page(ctx context.Context, req *v1.UserPageReq) (res *v1.UserPageRes, err error) {
+	return service.User().Page(ctx, req)
+}
+
+// List 用户列表
+// 按关键词、状态等条件返回用户精简列表，供下拉选择使用
+func (c *CUser) List(ctx context.Context, req *v1.UserListReq) (res v1.UserListRes, err error) {
+	return service.User().List(ctx, req)
+}
+
+// Detail 用户详情
+// 按用户ID查询详情，含角色ID数组与四级区划编码
+func (c *CUser) Detail(ctx context.Context, req *v1.UserDetailReq) (res *v1.UserDetailRes, err error) {
+	return service.User().Detail(ctx, req)
+}
+
+// Add 新增用户
+// 新增成功后返回新记录ID
+func (c *CUser) Add(ctx context.Context, req *v1.UserAddReq) (res *v1.IdRes, err error) {
+	return service.User().Add(ctx, req)
+}
+
+// Update 修改用户
+// 按用户ID更新记录，密码留空时不做修改
+func (c *CUser) Update(ctx context.Context, req *v1.UserUpdateReq) (res *v1.UserUpdateRes, err error) {
+	return service.User().Update(ctx, req)
+}
+
+// Status 用户状态
+// 设置用户的正常或禁用状态
+func (c *CUser) Status(ctx context.Context, req *v1.UserStatusReq) (res *v1.UserStatusRes, err error) {
+	return service.User().Status(ctx, req)
+}
+
+// ResetPwd 重置用户密码
+// 密码为空时重置为系统默认密码
+func (c *CUser) ResetPwd(ctx context.Context, req *v1.UserResetPwdReq) (res *v1.UserResetPwdRes, err error) {
+	return service.User().ResetPwd(ctx, req)
+}
+
+// Delete 删除用户
+// 按用户ID删除单条记录
+func (c *CUser) Delete(ctx context.Context, req *v1.UserDeleteReq) (res *v1.UserDeleteRes, err error) {
+	return service.User().Delete(ctx, req)
+}
+
+// BatchDelete 批量删除用户
+// 按用户ID列表批量删除记录
+func (c *CUser) BatchDelete(ctx context.Context, req *v1.UserBatchDeleteReq) (res *v1.UserBatchDeleteRes, err error) {
+	return service.User().BatchDelete(ctx, req)
+}
+
+// Import 导入用户
+// 接收上传的 xls/xlsx 文件并批量导入数据
+func (c *CUser) Import(ctx context.Context, req *v1.UserImportReq) (res *v1.UserImportRes, err error) {
+	return service.User().Import(ctx, req)
+}
+
+// Export 导出用户
+// 按查询条件导出用户数据并返回文件访问地址
+func (c *CUser) Export(ctx context.Context, req *v1.UserExportReq) (res *v1.UserExportRes, err error) {
+	return service.User().Export(ctx, req)
+}
+
+// Document 用户打印信息
+// 返回用户详情及关联的角色、部门、职级、岗位名称
+func (c *CUser) Document(ctx context.Context, req *v1.UserDocumentReq) (res *v1.UserDocumentRes, err error) {
+	return service.User().Document(ctx, req)
+}