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> rules(@PathVariable Long merchantId) { return ApiResponse.success(service.rules(merchantId)); } @PutMapping("/merchants/{merchantId}/rules") @Operation(summary = "保存洗车权益次数配置", description = "按人才卡等级配置总次数、重置周期和亲属附属卡共享") public ApiResponse> saveRules(@PathVariable Long merchantId, @Valid @RequestBody CarWashBenefitRuleRequest request) { return ApiResponse.success(service.saveRules(merchantId, request)); } @GetMapping("/credentials") @Operation(summary = "查询洗车凭证列表") public ApiResponse>> 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> detail(@PathVariable Long id) { return ApiResponse.success(service.detail(id)); } @PatchMapping("/credentials/{id}/audit") @Operation(summary = "人工审核洗车凭证", description = "通过时校验权益剩余次数并生成核销扣减流水") public ApiResponse> 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> rollback(@PathVariable Long id, @Valid @RequestBody CarWashCredentialRollbackRequest request, @RequestAttribute(AdminAuthInterceptor.OPERATOR_ID_ATTRIBUTE) Long operatorId) { return ApiResponse.success(service.rollback(id, request, operatorId)); } }