package com.yunhai.userbase.controller.oapi;

import com.yunhai.platform.utils.model.BoaGroup;
import com.yunhai.userbase.common.validation.ValidationGroups;
import com.yunhai.userbase.config.Config;
import com.yunhai.userbase.model.sysgroup.SysGroupBatchRequest;
import com.yunhai.userbase.model.sysgroup.SysGroupRequest;
import com.yunhai.userbase.service.ISysGroupService;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.validation.annotation.Validated;
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.RequestBody;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;

import java.util.List;

/**
 * 组织架构开放接口：供其他业务服务经 yh-app-auth 签名调用（{@code /oapi/group/...}）。<br>
 * <br>
 * 路径复用 {@link Config#OPEN_API_PATH} 统一前缀，与基础平台 {@code DefaultUserCenterClient}
 * 硬编码的契约严格一致：
 * {@code GET /oapi/group/tree}、{@code /byId?groupId=&withSub=}、{@code /list?ids=&withSub=}。<br>
 * 接口本身不做验签——签名由 {@code OpenApiAuthEnforceConfiguration} 在过滤器层强制要求，
 * 未带 {@code X-App-Key/X-Timestamp/X-Signature} 的请求直接 401。
 */
@RestController
@RequestMapping(Config.OPEN_API_PATH + "group/")
public class GroupController {

    @Autowired
    private ISysGroupService sysGroupService;

    /**
     * 获取整个平台的组树（从根节点开始，children 递归嵌套全部后代）。
     */
    @GetMapping("tree")
    public BoaGroup tree() {
        return sysGroupService.getGroups();
    }

    /**
     * 获取单个组；withSub=true 时递归挂上全部子孙（整棵子树）。
     *
     * @param groupId 组ID（必填）
     * @param withSub 是否展开子节点，缺省 false
     * @return 组节点；不存在返回 null
     */
    @GetMapping("byId")
    public BoaGroup byId(@RequestParam("groupId") Integer groupId,
            @RequestParam(value = "withSub", required = false) Boolean withSub) {
        return sysGroupService.getGroupById(groupId, withSub);
    }

    /**
     * 批量获取组；ids 逗号/空格分隔，按入参顺序返回，不存在的跳过。
     *
     * @param ids     组ID列表（逗号/空格分隔）
     * @param withSub 是否展开子节点，缺省 false
     * @return 组节点列表（按入参顺序；不存在的跳过）
     */
    @GetMapping("list")
    public List<BoaGroup> list(@RequestParam("ids") String ids,
            @RequestParam(value = "withSub", required = false) Boolean withSub) {
        return sysGroupService.getGroupList(ids, withSub);
    }

    /**
     * 新增组：返回创建后的组节点（含 id）。<br>
     * 层级类型约束、根节点保护等复用后台逻辑；鉴权由 OpenApiAuthEnforceConfiguration 在过滤器层强制签名。
     */
    @PostMapping("add")
    public BoaGroup add(@RequestBody @Validated(ValidationGroups.Create.class) SysGroupRequest request) {
        return sysGroupService.add(request);
    }

    /**
     * 编辑组（不含移动，移动请走 group/move 后台接口）：返回更新后的组节点（含 id）。
     */
    @PostMapping("edit/{id}")
    public BoaGroup edit(@PathVariable Integer id,
            @RequestBody @Validated(ValidationGroups.Update.class) SysGroupRequest request) {
        return sysGroupService.edit(id, request);
    }

    /**
     * 删除组：组下存在子组或用户时拒绝删除（根节点不可删）。无返回值。
     */
    @PostMapping("delete/{id}")
    public void delete(@PathVariable Integer id) {
        sysGroupService.delete(id);
    }

    /**
     * 批量新增子组：请求体 { pid, type, items:[{name},...] }，返回创建后的组节点列表（均含 id）。
     */
    @PostMapping("batchAdd")
    public List<BoaGroup> batchAdd(@RequestBody @Validated SysGroupBatchRequest request) {
        return sysGroupService.batchAdd(request);
    }
}