补充注解

amos-boot-system-jxiop/amos-boot-module-hygf-biz/src/main/java/com/yeejoin/amos/boot/module/hygf/biz/controller/AcceptanceCheckController.java

@@ -5,6 +5,7 @@ import com.yeejoin.amos.boot.module.hygf.api.config.UserLimits;
 import com.yeejoin.amos.boot.module.hygf.api.dto.BasicGridRecordDto;
 import com.yeejoin.amos.boot.module.hygf.api.entity.AcceptanceCheck;
 import com.yeejoin.amos.boot.module.hygf.api.entity.HygfRectificationOrder;
+import io.swagger.annotations.ApiParam;
 import org.springframework.beans.factory.annotation.Value;
 import org.springframework.transaction.annotation.Transactional;
 
@@ -80,7 +81,7 @@ public class AcceptanceCheckController extends BaseController {
 	@TycloudOperation(ApiLevel = UserType.AGENCY)
 	@PutMapping(value = "/{sequenceNbr}")
 	@ApiOperation(httpMethod = "PUT", value = "根据sequenceNbr更新并网验收节点", notes = "根据sequenceNbr更新并网验收节点")
-	public ResponseModel<AcceptanceCheckDto> updateBySequenceNbrAcceptanceCheck(@RequestBody AcceptanceCheckDto model,@PathVariable(value = "sequenceNbr") Long sequenceNbr) {
+	public ResponseModel<AcceptanceCheckDto> updateBySequenceNbrAcceptanceCheck(@RequestBody AcceptanceCheckDto model,@ApiParam(value = "主键",example = "1805040753609568257")@PathVariable(value = "sequenceNbr") Long sequenceNbr) {
 	    model.setSequenceNbr(sequenceNbr);
 	    return ResponseHelper.buildResponse(acceptanceCheckServiceImpl.updateWithModel(model));
 	}
@@ -94,7 +95,7 @@ public class AcceptanceCheckController extends BaseController {
     @TycloudOperation(ApiLevel = UserType.AGENCY)
     @DeleteMapping(value = "/{sequenceNbr}")
     @ApiOperation(httpMethod = "DELETE", value = "根据sequenceNbr删除并网验收节点", notes = "根据sequenceNbr删除并网验收节点")
-    public ResponseModel<Boolean> deleteBySequenceNbr(HttpServletRequest request, @PathVariable(value = "sequenceNbr") Long sequenceNbr){
+    public ResponseModel<Boolean> deleteBySequenceNbr(HttpServletRequest request, @ApiParam(value = "主键",example = "1805040753609568257")@PathVariable(value = "sequenceNbr") Long sequenceNbr){
         return ResponseHelper.buildResponse(acceptanceCheckServiceImpl.removeById(sequenceNbr));
     }
 
@@ -107,7 +108,7 @@ public class AcceptanceCheckController extends BaseController {
 	@TycloudOperation(ApiLevel = UserType.AGENCY)
 	@GetMapping(value = "/{sequenceNbr}")
 	@ApiOperation(httpMethod = "GET",value = "根据sequenceNbr查询单个并网验收节点",  notes = "根据sequenceNbr查询单个并网验收节点")
-	public ResponseModel<AcceptanceCheckDto> selectOne(@PathVariable Long sequenceNbr) {
+	public ResponseModel<AcceptanceCheckDto> selectOne(@ApiParam(value = "主键",example = "1805040753609568257")@PathVariable Long sequenceNbr) {
 	    return ResponseHelper.buildResponse(acceptanceCheckServiceImpl.queryBySeq(sequenceNbr));
 	}
 
@@ -178,7 +179,7 @@ public class AcceptanceCheckController extends BaseController {
 	@ApiOperation(httpMethod = "PUT",value = "整改单作废",   notes = "整改单作废")
 	@PutMapping(value = "/rollback")
 	@Transactional
-	public ResponseModel rollback( @RequestParam(value = "sequenceNbr") Long sequenceNbr) {
+	public ResponseModel rollback(@ApiParam(value = "主键",example = "1805040753609568257") @RequestParam(value = "sequenceNbr") Long sequenceNbr) {
 
 
 		return acceptanceCheckServiceImpl.rollback(sequenceNbr);
@@ -198,19 +199,19 @@ public class AcceptanceCheckController extends BaseController {
 	@GetMapping(value = "/page")
 	@ApiOperation(httpMethod = "GET",value = "分页查询",  notes = "分页查询")
 	@UserLimits
-	public ResponseModel<Page<AcceptanceCheckDto>> queryForPage(@RequestParam(value = "current") int current,
-																@RequestParam(value = "size") int size,
-																@RequestParam(required = false,value = "projectAddress") String projectAddress,
-																@RequestParam(required = false,value = "powerStationCode") String powerStationCode,
-																@RequestParam(required = false,value = "ownersName") String ownersName,
-																@RequestParam(required = false,value = "acceptanceCheckStatus") String acceptanceCheckStatus,
-																@RequestParam(required = false,value = "type") String type,
-																@RequestParam(required = false,value = "acceptanceTime") String acceptanceTime,
-																@RequestParam(required = false, value = "province") String province,
-																@RequestParam(required = false, value = "developerName") String developerName,
-																@RequestParam(required = false, value = "regionalCompaniesName") String regionalCompaniesName,
-																@RequestParam(required = false, value = "startTime") String startTime,
-																@RequestParam(required = false, value = "endTime") String endTime) throws Exception {
+	public ResponseModel<Page<AcceptanceCheckDto>> queryForPage(@ApiParam(value = "当前页码",example = "1")@RequestParam(value = "current") int current,
+																@ApiParam(value = "分数条数",example = "20")@RequestParam(value = "size") int size,
+																@ApiParam(value = "项目区域",example = "xx市")@RequestParam(required = false,value = "projectAddress") String projectAddress,
+																@ApiParam(value = "电站编号",example = "NH057NMGZZHHHTHM202405159165")@RequestParam(required = false,value = "powerStationCode") String powerStationCode,
+																@ApiParam(value = "业主姓名",example = "曹文轩")@RequestParam(required = false,value = "ownersName") String ownersName,
+																@ApiParam(value = "验收状态",example = "1")@RequestParam(required = false,value = "acceptanceCheckStatus") String acceptanceCheckStatus,
+																@ApiParam(value = "区分经销商端或管理端 为空则为经销商端",example = "1805040753609568257")@RequestParam(required = false,value = "type") String type,
+																@ApiParam(value = "验收时间",example = "2024-03-05 00:00:00")@RequestParam(required = false,value = "acceptanceTime") String acceptanceTime,
+																@ApiParam(value = "省份",example = "xx省")@RequestParam(required = false, value = "province") String province,
+																@ApiParam(value = "经销商公司名称",example = "xxxxx公司")@RequestParam(required = false, value = "developerName") String developerName,
+																@ApiParam(value = "区域公司名称",example = "xxxxx公司")@RequestParam(required = false, value = "regionalCompaniesName") String regionalCompaniesName,
+																@ApiParam(value = "筛选用第一次提交开始时间",example = "2024-03-05 00:00:00")@RequestParam(required = false, value = "startTime") String startTime,
+																@ApiParam(value = "筛选用第一次提交结束时间",example = "2024-05-05 23:00:59")@RequestParam(required = false, value = "endTime") String endTime) throws Exception {
 		//当前登录人所属场站
 //        UserUnitInformationDto userUnitInformationDto=personnelBusinessMapper.getUserUnitInformationDto( getUserInfo().getUserId());