package com.tourguide.api.admin;

import com.tourguide.common.api.ApiResponse;
import com.tourguide.common.api.PageResponse;
import com.tourguide.modules.system.dto.PermissionModuleResponse;
import com.tourguide.modules.system.dto.RoleDetailResponse;
import com.tourguide.modules.system.dto.RoleResponse;
import com.tourguide.modules.system.dto.RoleSaveRequest;
import com.tourguide.modules.system.service.SystemRoleService;
import org.springframework.web.bind.annotation.DeleteMapping;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PathVariable;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.PutMapping;
import org.springframework.web.bind.annotation.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import javax.validation.Valid;
import java.util.List;

/**
 * 管理后台角色与菜单权限管理接口。
 * 维护角色资料及菜单授权关系，并保护内置超级管理员角色不被误删除。
 */
@RestController
@RequestMapping("/api/admin/roles")
public class AdminSystemRoleController {
    private final SystemRoleService roleService;

    public AdminSystemRoleController(SystemRoleService roleService) {
        this.roleService = roleService;
    }

    /**
     * 分页查询后台角色，支持按角色名称或编码关键字筛选。
     *
     * @param page 页码，从 1 开始
     * @param size 每页记录数
     * @param keyword 角色名称或角色编码关键字
     * @return 角色分页结果及关联账号数量
     */
    @GetMapping
    public ApiResponse<PageResponse<RoleResponse>> page(@RequestParam(defaultValue = "1") long page,
                                                        @RequestParam(defaultValue = "10") long size,
                                                        @RequestParam(required = false) String keyword) {
        return ApiResponse.success(roleService.page(page, size, keyword));
    }

    /**
     * 查询可分配给角色的菜单权限树，供新增和编辑角色页面选择。
     *
     * @return 按模块组织的菜单权限列表
     */
    @GetMapping("/permissions")
    public ApiResponse<List<PermissionModuleResponse>> permissions() {
        return ApiResponse.success(roleService.permissions());
    }

    /**
     * 查询指定角色资料及已授权菜单标识。
     *
     * @param id 角色主键
     * @return 角色完整详情
     */
    @GetMapping("/{id}")
    public ApiResponse<RoleDetailResponse> detail(@PathVariable Long id) {
        return ApiResponse.success(roleService.detail(id));
    }

    /**
     * 新增自定义角色并建立菜单授权关系，角色编码由系统自动生成。
     *
     * @param request 角色名称、备注和菜单主键集合
     * @return 新建后的角色详情
     */
    @PostMapping
    public ApiResponse<RoleDetailResponse> create(@Valid @RequestBody RoleSaveRequest request) {
        return ApiResponse.success(roleService.create(request));
    }

    /**
     * 更新指定角色资料并整体替换菜单授权关系。
     *
     * @param id 角色主键
     * @param request 最新角色名称、备注和菜单主键集合
     * @return 更新后的角色详情
     */
    @PutMapping("/{id}")
    public ApiResponse<RoleDetailResponse> update(@PathVariable Long id,
                                                  @Valid @RequestBody RoleSaveRequest request) {
        return ApiResponse.success(roleService.update(id, request));
    }

    /**
     * 删除未被后台账号使用的自定义角色及其菜单关系。
     * 内置 ADMIN 角色或仍有关联账号的角色不能删除。
     *
     * @param id 角色主键
     * @return 无业务数据的成功响应
     */
    @DeleteMapping("/{id}")
    public ApiResponse<Void> delete(@PathVariable Long id) {
        roleService.delete(id);
        return ApiResponse.success();
    }
}