package com.tourguide.api.admin;

import com.tourguide.common.api.ApiResponse;
import com.tourguide.common.api.PageResponse;
import com.tourguide.modules.order.dto.AdminOrderRefundRequest;
import com.tourguide.modules.order.dto.TourOrderResponse;
import com.tourguide.modules.order.service.TourOrderService;
import org.springframework.format.annotation.DateTimeFormat;
import org.springframework.web.bind.annotation.*;
import javax.validation.Valid;
import java.time.LocalDate;
import java.util.List;

/**
 * 管理后台旅游订单管理接口。
 * 提供订单筛选、详情查看、景区筛选项和后台退款处理能力。
 */
@RestController
@RequestMapping("/api/admin/orders")
public class AdminTourOrderController {
    private final TourOrderService orderService;

    public AdminTourOrderController(TourOrderService orderService) {
        this.orderService = orderService;
    }

    /**
     * 分页查询订单，支持按订单或用户关键字、游客、景区、状态和下单日期筛选。
     *
     * @param page 页码，从 1 开始
     * @param size 每页记录数
     * @param keyword 订单号、游客、导游等关键字
     * @param visitorId 指定游客账号主键
     * @param scenicName 景区名称
     * @param status 订单状态
     * @param startDate 下单日期起始值，包含当天
     * @param endDate 下单日期结束值，包含当天
     * @return 订单分页结果
     */
    @GetMapping
    public ApiResponse<PageResponse<TourOrderResponse>> page(@RequestParam(defaultValue = "1") long page,
                                                            @RequestParam(defaultValue = "10") long size,
                                                            @RequestParam(required = false) String keyword,
                                                            @RequestParam(required = false) Long visitorId,
                                                            @RequestParam(required = false) String scenicName,
                                                            @RequestParam(required = false) String status,
                                                            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate startDate,
                                                            @RequestParam(required = false) @DateTimeFormat(iso = DateTimeFormat.ISO.DATE) LocalDate endDate) {
        return ApiResponse.success(orderService.page(page, size, keyword, visitorId, scenicName, status, startDate, endDate));
    }

    /**
     * 查询已有订单中的景区名称，供订单列表筛选条件使用。
     *
     * @return 去重后的景区名称列表
     */
    @GetMapping("/scenic-options")
    public ApiResponse<List<String>> scenicOptions() {
        return ApiResponse.success(orderService.scenicOptions());
    }

    /**
     * 查询指定订单的商品快照、支付、服务、退款和评价信息。
     *
     * @param id 订单主键
     * @return 订单完整详情
     */
    @GetMapping("/{id}")
    public ApiResponse<TourOrderResponse> detail(@PathVariable Long id) {
        return ApiResponse.success(orderService.detail(id));
    }

    /**
     * 对指定可退款订单执行指定金额退款登记，并生成退款单号和退款时间。
     * 已取消、已退款或当前状态不可退款的订单会被业务层拒绝。
     *
     * @param id 订单主键
     * @return 退款后的订单详情
     */
    @PutMapping("/{id}/refund")
    public ApiResponse<TourOrderResponse> refund(@PathVariable Long id,
                                                 @Valid @RequestBody AdminOrderRefundRequest request) {
        return ApiResponse.success(orderService.refund(id, request.getRefundAmount()));
    }
}