package com.talentcard.server.business.admin; import java.util.List; import java.util.Map; import com.talentcard.server.business.PageResult; import com.talentcard.server.common.ApiResponse; import com.talentcard.server.request.DisplayServiceSaveRequest; import com.talentcard.server.request.DisplayServiceSortBatchRequest; import com.talentcard.server.request.DisplayServiceSortRequest; import com.talentcard.server.request.DisplayServiceStatusRequest; import com.talentcard.server.service.DisplayServiceAdminService; import io.swagger.v3.oas.annotations.Operation; import io.swagger.v3.oas.annotations.Parameter; import io.swagger.v3.oas.annotations.tags.Tag; import jakarta.validation.Valid; import org.springframework.http.HttpStatus; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.PatchMapping; 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.ResponseStatus; import org.springframework.web.bind.annotation.RestController; @Tag(name = "后台-展示类服务管理", description = "维护停车、体检、购房、购车、家电、公寓租赁等展示类服务的图文介绍、优惠政策、商户联系方式、办理说明、适用人才卡级别、排序和上下架状态") @RestController @RequestMapping("/api/admin/display-services") public class DisplayServiceAdminController { private final DisplayServiceAdminService service; public DisplayServiceAdminController(DisplayServiceAdminService service) { this.service = service; } @Operation(summary = "查询展示类服务分类列表", description = "返回后台支持的展示类服务分类:停车、体检、购房、购车、家电、公寓租赁") @GetMapping("/categories") public ApiResponse>> categories() { return ApiResponse.success(service.categories()); } @Operation(summary = "查询展示类服务列表", description = "分页查询展示类服务,支持按服务分类、名称/联系电话/地址关键字和上下架状态筛选,按排序值倒序返回") @GetMapping public ApiResponse>> page( @Parameter(description = "服务分类:parking停车、medical体检、housing购房、car购车、appliance家电、apartment公寓租赁") @RequestParam(required = false) String category, @Parameter(description = "服务名称、联系电话或地址关键字") @RequestParam(required = false) String keyword, @Parameter(description = "上下架状态:1上架 0下架") @RequestParam(required = false) Integer status, @Parameter(description = "页码") @RequestParam(defaultValue = "1") int page, @Parameter(description = "每页条数") @RequestParam(defaultValue = "10") int size ) { return ApiResponse.success(service.page(category, keyword, status, page, size)); } @Operation(summary = "查询展示类服务详情", description = "查看单个展示服务的图文介绍、联系方式、办理说明、优惠政策、适用人才卡级别政策、排序和上下架状态") @GetMapping("/{serviceId}") public ApiResponse> detail( @Parameter(description = "展示服务ID") @PathVariable Long serviceId ) { return ApiResponse.success(service.detail(serviceId)); } @Operation(summary = "新增展示类服务", description = "后台新增停车、体检、购房、购车、家电、公寓租赁等展示类服务,保存图文介绍、商户联系方式、办理说明、优惠政策、适用人才卡级别和前端展示状态") @PostMapping @ResponseStatus(HttpStatus.CREATED) public ApiResponse> create( @Valid @RequestBody DisplayServiceSaveRequest request ) { return ApiResponse.success(service.create(request)); } @Operation(summary = "编辑展示类服务", description = "修改展示类服务的图文介绍、分类、联系方式、办理说明、优惠政策、适用人才卡级别、排序和上下架状态") @PutMapping("/{serviceId}") public ApiResponse> update( @Parameter(description = "展示服务ID") @PathVariable Long serviceId, @Valid @RequestBody DisplayServiceSaveRequest request ) { return ApiResponse.success(service.update(serviceId, request)); } @Operation(summary = "修改展示类服务上下架状态", description = "修改展示类服务的前端展示状态:1上架 0下架") @PatchMapping("/{serviceId}/status") public ApiResponse> updateStatus( @Parameter(description = "展示服务ID") @PathVariable Long serviceId, @Valid @RequestBody DisplayServiceStatusRequest request ) { return ApiResponse.success(service.updateStatus(serviceId, request.status())); } @Operation(summary = "修改展示类服务排序", description = "修改单个展示类服务的排序值,值越大越靠前;购房/购车/家电服务会同步更新分类映射排序") @PatchMapping("/{serviceId}/sort") public ApiResponse> updateSort( @Parameter(description = "展示服务ID") @PathVariable Long serviceId, @Valid @RequestBody DisplayServiceSortRequest request ) { return ApiResponse.success(service.updateSort(serviceId, request.sortNo())); } @Operation(summary = "批量修改展示类服务排序", description = "一次提交多个展示服务的排序值,用于后台拖拽排序;购房/购车/家电服务会同步更新分类映射排序") @PutMapping("/sort") public ApiResponse> updateSortBatch( @Valid @RequestBody DisplayServiceSortBatchRequest request ) { return ApiResponse.success(service.updateSortBatch(request)); } }