update

liujie

2026-08-04 e9e42b621afdf6ac94f5327ee843b32b10a401b4

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
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()));
    }
}