为各服务接口补 /// 中文注释:swagger 恢复中文说明(admin 203 / user 93 / customer 12 / fishgame 4)

This commit is contained in:
2026-10-19 00:44:00 +08:00
parent ff2b779a56
commit 466a4b1cea
39 changed files with 947 additions and 6 deletions
@@ -25,6 +25,9 @@ namespace AdminApi.System
}
/// <summary>
/// 添加系统用户
/// </summary>
[HttpPost("user/add")]
public async Task<BaseResponse<string>> AddUser(AddUserParam param)
@@ -35,6 +38,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 修改系统用户
/// </summary>
[HttpPost("user/update")]
public async Task<BaseResponse<string>> UpdateUser(UpdateUserParam param)
@@ -45,6 +51,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 修改系统用户头像
/// </summary>
[HttpGet("user/update/icon")]
public async Task<BaseResponse<string>> UpdateUserIcon(string id, string icon)
@@ -55,6 +64,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 修改系统用户状态
/// </summary>
[HttpGet("user/update/state")]
public async Task<BaseResponse<string>> UpdateUserState(string id, int state)
@@ -65,6 +77,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 删除用户
/// </summary>
[HttpGet("user/delete")]
public async Task<BaseResponse<string>> DeleteUser(string id)
@@ -75,6 +90,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 用户登陆
/// </summary>
[HttpGet("user/login")]
[AllowAnonymous]
public async Task<BaseResponse<AdminUserToken>> UserLogin(string userName, string password)
@@ -85,6 +103,9 @@ namespace AdminApi.System
else
return this.ToFailResult<AdminUserToken>(result.msg);
}
/// <summary>
/// 获取系统用户列表
/// </summary>
[HttpPost("user/list")]
public async Task<PageResponse<SystemUserDto>> GetUserList(GetUserListParam param)
@@ -94,6 +115,9 @@ namespace AdminApi.System
return this.ToPageResult(dtos, (int)result.count);
}
/// <summary>
/// 获取当前登陆用户信息
/// </summary>
[HttpGet("user/getuser")]
public async Task<BaseResponse<SystemUserDto>> GetUser()
@@ -122,6 +146,9 @@ namespace AdminApi.System
};
}
/// <summary>
/// 获取用户菜单
/// </summary>
[HttpGet("user/nav")]
public async Task<ListResponse<SystemNavigationResponse>> GetUserNav()
@@ -136,6 +163,9 @@ namespace AdminApi.System
/// <summary>
/// 添加系统角色
/// </summary>
[HttpPost("role/add")]
public async Task<BaseResponse<string>> AddRole(AddRoleParam param)
@@ -146,6 +176,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 修改角色
/// </summary>
[HttpPost("role/update")]
public async Task<BaseResponse<string>> UpdateRole(UpdateRoleParam param)
@@ -156,6 +189,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 修改角色菜单
/// </summary>
[HttpPost("role/updatenav")]
public async Task<BaseResponse<string>> UpdateRoleNav(UpdateRoleNavParam param)
@@ -167,6 +203,9 @@ namespace AdminApi.System
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 删除角色
/// </summary>
[HttpGet("role/delete")]
public async Task<BaseResponse<string>> DeleteRole(string id)
@@ -178,6 +217,9 @@ namespace AdminApi.System
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 获取系统角色列表
/// </summary>
[HttpGet("role/list")]
public async Task<ListResponse<SystemUserRoleDto>> GetRoleList(int page, int limit)
{
@@ -197,6 +239,9 @@ namespace AdminApi.System
NavIds = entity.NavIds ?? new List<string>()
};
}
/// <summary>
/// 获取角色
/// </summary>
[HttpGet("role/get")]
public async Task<BaseResponse<SystemUserRoleDto>> GetUserRole(string id)
@@ -208,6 +253,9 @@ namespace AdminApi.System
/// <summary>
/// 添加系统菜单
/// </summary>
[HttpPost("nav/add")]
public async Task<BaseResponse<string>> AddNav(AddNavParam param)
@@ -218,6 +266,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 修改菜单
/// </summary>
[HttpPost("nav/update")]
public async Task<BaseResponse<string>> UpdateNav(UpdateNavParam param)
@@ -229,6 +280,9 @@ namespace AdminApi.System
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 删除菜单
/// </summary>
[HttpGet("nav/delete")]
public async Task<BaseResponse<string>> DeleteNav(string id)
@@ -241,6 +295,9 @@ namespace AdminApi.System
}
/// <summary>
/// 获取菜单列表
/// </summary>
[HttpGet("nav/list")]
public async Task<ListResponse<SystemNavigationResponse>> GetNavList(string? id="")
@@ -272,6 +329,9 @@ namespace AdminApi.System
/// <summary>
/// 添加系统字典
/// </summary>
[HttpPost("dic/add")]
public async Task<BaseResponse<string>> AddDic(AddDicParam param)
@@ -282,6 +342,9 @@ namespace AdminApi.System
else
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 修改字典
/// </summary>
[HttpPost("dic/update")]
public async Task<BaseResponse<string>> UpdateDic(UpdateDicParam param)
@@ -293,6 +356,9 @@ namespace AdminApi.System
return this.ToFailResult<string>(result.msg);
}
/// <summary>
/// 删除字典
/// </summary>
[HttpGet("dic/delete")]
public async Task<BaseResponse<string>> DeleteDic(string id)
@@ -305,6 +371,9 @@ namespace AdminApi.System
}
/// <summary>
/// 获取字典列表
/// </summary>
[HttpGet("dic/list")]
public async Task<ListResponse<SystemDicResponse>> GetDicList(string id="")
@@ -312,6 +381,9 @@ namespace AdminApi.System
var result = await _systemService.GetDicList(id);
return this.ToListResult(result);
}
/// <summary>
/// 获取字典列表
/// </summary>
[HttpGet("dic/list/code")]
public async Task<ListResponse<SystemDicResponse>> GetDicListByCode(string code)
@@ -319,6 +391,9 @@ namespace AdminApi.System
var result = await _systemService.GetDicListByCode(code);
return this.ToListResult(result);
}
/// <summary>
/// 获取字典对象
/// </summary>
[HttpGet("dic/get/code")]
public async Task<BaseResponse<SystemDic>> GetDictByCode(string code)