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<List<Map<String, Object>>> categories() {
|
return ApiResponse.success(service.categories());
|
}
|
|
@Operation(summary = "查询展示类服务列表", description = "分页查询展示类服务，支持按服务分类、名称/联系电话/地址关键字和上下架状态筛选，按排序值倒序返回")
|
@GetMapping
|
public ApiResponse<PageResult<Map<String, Object>>> 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<Map<String, Object>> detail(
|
@Parameter(description = "展示服务ID") @PathVariable Long serviceId
|
) {
|
return ApiResponse.success(service.detail(serviceId));
|
}
|
|
@Operation(summary = "新增展示类服务", description = "后台新增停车、体检、购房、购车、家电、公寓租赁等展示类服务，保存图文介绍、商户联系方式、办理说明、优惠政策、适用人才卡级别和前端展示状态")
|
@PostMapping
|
@ResponseStatus(HttpStatus.CREATED)
|
public ApiResponse<Map<String, Object>> create(
|
@Valid @RequestBody DisplayServiceSaveRequest request
|
) {
|
return ApiResponse.success(service.create(request));
|
}
|
|
@Operation(summary = "编辑展示类服务", description = "修改展示类服务的图文介绍、分类、联系方式、办理说明、优惠政策、适用人才卡级别、排序和上下架状态")
|
@PutMapping("/{serviceId}")
|
public ApiResponse<Map<String, Object>> 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<Map<String, Object>> 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<Map<String, Object>> 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<Map<String, Object>> updateSortBatch(
|
@Valid @RequestBody DisplayServiceSortBatchRequest request
|
) {
|
return ApiResponse.success(service.updateSortBatch(request));
|
}
|
}
|
