package com.haisen.laop.controller;

import com.haisen.laop.common.Result;
import com.haisen.laop.dto.AppBannerQueryDTO;
import com.haisen.laop.dto.AppBannerSaveDTO;
import com.haisen.laop.service.AppBannerService;
import com.haisen.laop.vo.AppBannerVO;
import jakarta.validation.Valid;
import lombok.RequiredArgsConstructor;
import org.springframework.data.domain.Page;
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 java.util.HashMap;
import java.util.Map;

/**
 * 轮播图模块 —— Web 后台管理端 Controller。
 *
 * <p><b>消费端：</b>Web 管理后台（管理员电脑端操作）。
 * <p><b>路径前缀：</b>{@code /banner/*}，与小程序端展示接口（待扩展）严格隔离。
 * <p><b>职责：</b>承载首页轮播图的维护操作（分页查询、详情、新增、编辑、排序调整、启停、删除），
 * 业务逻辑全部委托 {@link AppBannerService}，本层只做参数接收与 Result 包装。</p>
 *
 * @author duhao
 */
@RestController
@RequestMapping("/banner")
@RequiredArgsConstructor
public class AppBannerController {

    private final AppBannerService appBannerService;

    /**
     * 轮播图分页列表。
     *
     * <p>返回结构与项目其他分页约定保持一致：{list, totalElements, totalPages, pageNo, pageSize}，
     * 其中 pageNo 为 0 基页码。</p>
     *
     * @param query 筛选条件（GET 参数自动绑定，全部可选）
     * @return 轮播图 VO 分页数据
     */
    @GetMapping("/list")
    public Result<Map<String, Object>> list(AppBannerQueryDTO query) {
        Page<AppBannerVO> page = appBannerService.page(query);
        Map<String, Object> data = new HashMap<>();
        data.put("list", page.getContent());
        data.put("totalElements", page.getTotalElements());
        data.put("totalPages", page.getTotalPages());
        data.put("pageNo", page.getNumber());
        data.put("pageSize", page.getSize());
        return Result.success(data);
    }

    /**
     * 轮播图详情，用于编辑回显。
     *
     * @param id 轮播图 ID
     * @return 轮播图 VO
     */
    @GetMapping("/{id}")
    public Result<AppBannerVO> detail(@PathVariable Long id) {
        return Result.success(appBannerService.detail(id));
    }

    /**
     * 新增轮播图。
     *
     * @param dto 轮播图表单全部字段
     * @return 新增轮播图的 ID
     */
    @PostMapping
    public Result<Long> create(@Valid @RequestBody AppBannerSaveDTO dto) {
        return Result.success(appBannerService.create(dto));
    }

    /**
     * 编辑轮播图（全量更新）。
     *
     * @param id  轮播图 ID
     * @param dto 轮播图表单全部字段
     * @return 空数据成功响应
     */
    @PutMapping("/{id}")
    public Result<Void> update(@PathVariable Long id, @Valid @RequestBody AppBannerSaveDTO dto) {
        appBannerService.update(id, dto);
        return Result.success();
    }

    /**
     * 删除轮播图（软删除）。
     *
     * @param id 轮播图 ID
     * @return 空数据成功响应
     */
    @DeleteMapping("/{id}")
    public Result<Void> remove(@PathVariable Long id) {
        appBannerService.delete(id);
        return Result.success();
    }

    /**
     * 切换轮播图展示状态（显示/隐藏）。
     *
     * @param id     轮播图 ID
     * @param status 目标状态：0隐藏 1显示
     * @return 空数据成功响应
     */
    @PostMapping("/{id}/status")
    public Result<Void> updateStatus(@PathVariable Long id, @RequestParam Integer status) {
        appBannerService.updateStatus(id, status);
        return Result.success();
    }

    /**
     * 调整轮播图排序值。
     *
     * @param id        轮播图 ID
     * @param sortOrder 目标排序值
     * @return 空数据成功响应
     */
    @PostMapping("/{id}/sort")
    public Result<Void> updateSort(@PathVariable Long id, @RequestParam Integer sortOrder) {
        appBannerService.updateSort(id, sortOrder);
        return Result.success();
    }
}