package com.talentcard.server.business.admin;
|
|
import com.talentcard.server.business.PageResult;
|
import com.talentcard.server.business.admin.auth.AdminAuthInterceptor;
|
import com.talentcard.server.common.ApiResponse;
|
import com.talentcard.server.request.CarWashBenefitRuleRequest;
|
import com.talentcard.server.request.CarWashCredentialAuditRequest;
|
import com.talentcard.server.request.CarWashCredentialRollbackRequest;
|
import com.talentcard.server.service.CarWashBenefitManagementService;
|
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.web.bind.annotation.*;
|
|
import java.time.LocalDate;
|
import java.util.Map;
|
|
@RestController
|
@RequestMapping("/api/admin/car-wash-benefits")
|
@Tag(name = "后台-洗车权益管理", description = "洗车服务配置、凭证人工审核、权益次数扣减与回滚")
|
public class CarWashBenefitAdminController {
|
private final CarWashBenefitManagementService service;
|
public CarWashBenefitAdminController(CarWashBenefitManagementService service) { this.service = service; }
|
|
@GetMapping("/merchants/{merchantId}/rules")
|
@Operation(summary = "查询洗车权益次数配置")
|
public ApiResponse<Map<String, Object>> rules(@PathVariable Long merchantId) { return ApiResponse.success(service.rules(merchantId)); }
|
|
@PutMapping("/merchants/{merchantId}/rules")
|
@Operation(summary = "保存洗车权益次数配置", description = "按人才卡等级配置总次数、重置周期和亲属附属卡共享")
|
public ApiResponse<Map<String, Object>> saveRules(@PathVariable Long merchantId, @Valid @RequestBody CarWashBenefitRuleRequest request) { return ApiResponse.success(service.saveRules(merchantId, request)); }
|
|
@GetMapping("/credentials")
|
@Operation(summary = "查询洗车凭证列表")
|
public ApiResponse<PageResult<Map<String, Object>>> credentials(
|
@RequestParam(required = false) Long merchantId,
|
@Parameter(description = "状态：0待审核、1已通过、2已驳回、3已回滚") @RequestParam(required = false) Integer status,
|
@Parameter(description = "凭证编号/姓名/手机号/卡号") @RequestParam(required = false) String keyword,
|
@RequestParam(required = false) LocalDate startDate,
|
@RequestParam(required = false) LocalDate endDate,
|
@RequestParam(defaultValue = "1") int page,
|
@RequestParam(defaultValue = "10") int size) {
|
return ApiResponse.success(service.page(merchantId, status, keyword, startDate, endDate, page, size));
|
}
|
|
@GetMapping("/credentials/{id}")
|
@Operation(summary = "查询洗车凭证详情")
|
public ApiResponse<Map<String, Object>> detail(@PathVariable Long id) { return ApiResponse.success(service.detail(id)); }
|
|
@PatchMapping("/credentials/{id}/audit")
|
@Operation(summary = "人工审核洗车凭证", description = "通过时校验权益剩余次数并生成核销扣减流水")
|
public ApiResponse<Map<String, Object>> audit(@PathVariable Long id,
|
@Valid @RequestBody CarWashCredentialAuditRequest request,
|
@RequestAttribute(AdminAuthInterceptor.OPERATOR_ID_ATTRIBUTE) Long operatorId) {
|
return ApiResponse.success(service.audit(id, request, operatorId));
|
}
|
|
@PostMapping("/credentials/{id}/rollback")
|
@Operation(summary = "回滚洗车权益扣减", description = "撤销对应核销流水，权益剩余次数自动恢复")
|
public ApiResponse<Map<String, Object>> rollback(@PathVariable Long id,
|
@Valid @RequestBody CarWashCredentialRollbackRequest request,
|
@RequestAttribute(AdminAuthInterceptor.OPERATOR_ID_ATTRIBUTE) Long operatorId) {
|
return ApiResponse.success(service.rollback(id, request, operatorId));
|
}
|
}
|
