APP相关接口添加swagger注释

projects-service/src/main/java/com/rtrh/projects/modules/problem/vo/QuestionQueryVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.modules.problem.vo;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -10,79 +11,96 @@ public class QuestionQueryVO {
 	/**
 	 * 项目类型
 	 */
+    @ApiModelProperty("项目类型")
 	String kind;
 	/**
 	 * 建设性质
 	 */
+    @ApiModelProperty("建设性质")
     private String propKind;
     /**
      * 所属行业
      */
+    @ApiModelProperty("所属行业")
     private String indusKind;
 
     /**
      * 资金来源
      */
+    @ApiModelProperty("资金来源")
     private String sourceId;
 
     /***
      * 监管端id
      */
+    @ApiModelProperty("监管端id")
     private String mainId;
 
     /**
      * 建设地点
      */
+    @ApiModelProperty("建设地点")
     private String subjectId;
     /**
      * 问题开始时间
      */
+    @ApiModelProperty("问题开始时间")
     private String beginDateStart;
     /**
      * 问题开始结束时间
      */
+    @ApiModelProperty("问题结束时间")
     private String beginDateEnd;
     /**
      * 项目名称
      */
+    @ApiModelProperty("项目名称")
     private String subName;
     /**
      * 问题状态
      */
+    @ApiModelProperty("问题状态")
     private String status;
 
 
     /**
      * 问题状态
      */
+    @ApiModelProperty("问题状态")
     private Boolean noStatus;
 
     /**
      * 问题描述
      */
+    @ApiModelProperty("问题描述")
     private String problemContent;
     /**
      * 是否包含隐藏
      */
+    @ApiModelProperty("是否包含隐藏")
     private Boolean containHide;
 
 
     /**
      * 项目开始日期
      */
+    @ApiModelProperty("项目开始日期")
     private String beginDate;
     /**
      * 项目结束日期
      */
+    @ApiModelProperty("项目结束日期")
     private String endDate;
 
     /**
      * 项目状态
      */
+    @ApiModelProperty("项目状态")
     private String projectsStatus;
 
     /**
      * 1-约谈企业，2-发督办函，3-专题推进会
      */
+    @ApiModelProperty("1-约谈企业，2-发督办函，3-专题推进会")
     private String closeReason;
 }

projects-service/src/main/java/com/rtrh/projects/modules/projects/vo/PreWarnDataQueryVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.modules.projects.vo;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -12,73 +13,82 @@ public class PreWarnDataQueryVO {
     /**
      * 项目名称
      */
+    @ApiModelProperty("项目名称")
     String subName;
 
     /**
      * 项目ID
      */
+    @ApiModelProperty("项目ID")
     private String subId;
 
     /**
      * 查询年月
      */
+    @ApiModelProperty("查询年月")
     private String month;
 
-
+    @ApiModelProperty("年")
     private String year;
 
-
+    @ApiModelProperty("开始时间")
     private String beginDate;
 
-
+    @ApiModelProperty("结束时间")
     private String endDate;
 
-
+    @ApiModelProperty("月")
     private Date monthMonth;
 
 
     /**
      * 开工逾期  1   竣工逾期 2
      */
+    @ApiModelProperty("开工逾期  1   竣工逾期 2")
     private String openAndEndStatus;
     /**
      * 未办理红灯  1   未办理黄灯 2    超期办理 3
      */
+    @ApiModelProperty("未办理红灯  1   未办理黄灯 2    超期办理 3")
     private String lightType;
 
 
     /**
      * 建设地点
      */
+    @ApiModelProperty("建设地点")
     private String subjectId;
 
     /***
      * 监管id
      */
-
+    @ApiModelProperty("监管id")
     private String mainId;
 
     /**
      * 所属行业
      */
-
+    @ApiModelProperty("所属行业")
     private String hyfl;
 
 
     /**
      * 项目类型
      */
+    @ApiModelProperty("项目类型")
     private String  kind;
 
     /***
      * 建设性质
      */
+    @ApiModelProperty("建设性质")
     private String propKind;
 
 
     /**
      * 资金来源
      */
+    @ApiModelProperty("资金来源")
     private String sourceId;
 
 
@@ -86,8 +96,9 @@ public class PreWarnDataQueryVO {
     /**
      * 只看审批部门  1:查看审批部门  0:查看所有部门
      */
+    @ApiModelProperty("只看审批部门  1:查看审批部门  0:查看所有部门")
     private String checkDepart;
-
+    @ApiModelProperty("code")
     private String code;
 
 }

projects-service/src/main/java/com/rtrh/projects/modules/projects/vo/SubInfoQueryTzVO.java

@@ -3,6 +3,7 @@ package com.rtrh.projects.modules.projects.vo;
 import java.math.BigDecimal;
 import java.util.List;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -18,353 +19,431 @@ public class SubInfoQueryTzVO {
     /**
      * 项目名称
      */
+    @ApiModelProperty("项目名称")
     private String subName;
     /**
      * 项目类型
      */
+    @ApiModelProperty("项目类型")
     private String kind;
     /**
      * 建设地址
      */
+    @ApiModelProperty("建设地址")
     private String subjectId;
 
     /**
      * 项目编号
      */
+    @ApiModelProperty("项目编号")
     private String amtTo;
     /**
      * 申请投向
      */
+    @ApiModelProperty("申请投向")
     private String applyCode;
     /**
      * 建设性质
      */
+    @ApiModelProperty("建设性质")
     private String propKind;
     /**
      * 所属行业
      */
+    @ApiModelProperty("所属行业")
     private String indusKind;
     /**
      * 项目状态
      */
+    @ApiModelProperty("项目状态")
     private String status;
     private List<String> statusList;
     /**
      * 查询时间类型
      */
+    @ApiModelProperty("查询时间类型")
     private String queryTimeType;
     /**
      * 开始时间
      */
+    @ApiModelProperty("开始时间")
     private String beginDate;
     /**
      * 结束时间
      */
+    @ApiModelProperty("结束时间")
     private String endDate;
     /**
      * 最小金额
      */
+    @ApiModelProperty("最小金额")
     private String startAmt;
     /**
      * 最大金额
      */
+    @ApiModelProperty("最大金额")
     private String endAmt;
     /**
      * 行业单位
      */
+    @ApiModelProperty("行业单位")
     private String hydw;
     /**
      * 项目单位
      */
+    @ApiModelProperty("项目单位")
     private String sbdw;
     /**
      * 是否去除临存项目
      */
+    @ApiModelProperty("是否去除临存项目")
     private Boolean neTemp;
     /**
      * 是否在建
      */
+    @ApiModelProperty("是否在建")
     private String isZj;
     /**
      * 其他项目状态
      */
+    @ApiModelProperty("其他项目状态")
     private String otherStatus;
     /**
      * 完成金额占比起始
      */
+    @ApiModelProperty("完成金额占比起始")
     private BigDecimal endBl;
     /**
      * 完成金额占比结束
      */
+    @ApiModelProperty("完成金额占比结束")
     private BigDecimal endBlPlus;
     /**
      * 年份
      */
+    @ApiModelProperty("年份")
     private String year;
 
     /**
      * 年固定投资类型
      */
+    @ApiModelProperty("年固定投资类型")
     private String fixCat;
 
     /**
      * 资金申报年份
      */
+    @ApiModelProperty("资金申报年份")
     private String zjYear;
 
     /**
      * 资金来源
      */
+    @ApiModelProperty("资金来源")
     private String zjly;
     /**
      * 灯色
      */
+    @ApiModelProperty("灯色")
     private String light;
     /**
      * 建设内容
      */
+    @ApiModelProperty("建设内容")
     private String content;
 
     /**
      * 是否分管项目
      */
+    @ApiModelProperty("是否分管项目")
     private Boolean blSub;
 
     /**
      * 投资类型
      */
+    @ApiModelProperty("投资类型")
     private String kindNature;
 
     /**
      * 是否是app查询
      */
+    @ApiModelProperty("是否是app查询")
     private Boolean app;
 
     /**
      * 是否关注
      */
+    @ApiModelProperty("是否关注")
     private Boolean attention;
 
     /**
      * 查询类型
      * 0-全部项目 1-重点项目 2-在建项目 3-储备项目 4-竣工项目
      */
+    @ApiModelProperty("查询类型0-全部项目 1-重点项目 2-在建项目 3-储备项目 4-竣工项目")
     private String queryType;
     /**
      * 是否隐藏   1隐藏  0不隐藏
      */
+    @ApiModelProperty("是否隐藏   1隐藏  0不隐藏")
     private String isHide;
 
 
     /**
      * 排序类型
      */
+    @ApiModelProperty("排序类型")
     private String sortField;
 
 
     /**
      * 排序方式
      */
+    @ApiModelProperty("排序方式")
     private String sortType;
 
 
     /**
      * 领导姓名
      */
+    @ApiModelProperty("领导姓名")
     private String leaderName;
 
 
     /**
      * abc
      */
+    @ApiModelProperty("abc")
     private String abc;
 
 
     /**
      * 项 目进度范围 最小
      */
+    @ApiModelProperty("项 目进度范围 最小")
     private BigDecimal numBlMin;
 
 
     /**
      * 项 目进度范围 最大
      */
+    @ApiModelProperty("项 目进度范围 最大")
     private BigDecimal numBlMax;
 
     /**
      * 不是本年度内的项目
      */
+    @ApiModelProperty("不是本年度内的项目")
     private Boolean notTargetYear;
 
 
     /**
      * 最小偏离度 判断红黄灯
      */
+    @ApiModelProperty("最小偏离度 判断红黄灯")
     private BigDecimal offsetMin;
 
     /**
      * 最大偏离度 判断红黄灯
      */
+    @ApiModelProperty("最大偏离度 判断红黄灯")
     private BigDecimal offsetMax;
 
 
     /**
      * 开工红黄灯  判断是否 判断开工红黄灯
      */
+    @ApiModelProperty("开工红黄灯  判断是否 判断开工红黄灯")
     private Boolean openDate;
 
 
     /***
      * 开始月
      */
+    @ApiModelProperty("开始月")
     private String beginMonth;
 
     /**
      * 结束月
      */
+    @ApiModelProperty("结束月")
     private String endMonth;
 
     /***
      * 是否逾期
      */
+    @ApiModelProperty("是否逾期")
     private String isYq;
 
     /**
      * 查询资金类型 amtType 1资金来源  2总金额 3 计划投资 4 实际投资
      */
+    @ApiModelProperty("查询资金类型 amtType 1资金来源  2总金额 3 计划投资 4 实际投资")
     private String amtType;
 
     /***
      * 问题关闭原因 1-约谈企业，2-发督办函，3-专题推进会
      */
+    @ApiModelProperty("问题关闭原因 1-约谈企业，2-发督办函，3-专题推进会")
     private String closeReason;
 
     /***
      * 问题状态 是否关闭
      */
+    @ApiModelProperty("问题状态")
     private String problemStatus;
 
 
     /***
      * 问题类型  项目单位，监管单位
      */
+    @ApiModelProperty("问题类型")
     private String problemType;
 
     /**
      * 大屏查询   储备项目
      */
+    @ApiModelProperty("储备项目")
     private Boolean isCb;
 
     /**
      * 项目id  专项查询
      */
+    @ApiModelProperty("项目id")
     private String subId;
 
 
     /***
      * 月份  在建项目库
      */
+    @ApiModelProperty("月份")
     private String month;
 
 
     /***
      * zjlyid  //资金来源id
      */
+    @ApiModelProperty("资金来源id")
     private String zjlyId;
 
 
     /***
      * zjlyid  //资金来源id
      */
+    @ApiModelProperty("")
     private Integer dateCat;
 
     /***
      * isPay  //资金下达情况
      */
+    @ApiModelProperty("资金下达情况")
     private Integer isPay;
 
     /***
      * isMajor  //1重点项目  2非重点项目  0或者null 查询全部
      */
+    @ApiModelProperty("1重点项目  2非重点项目  0或者null 查询全部")
     private String isMajor;
 
     /***
      * 完成投资
      */
+    @ApiModelProperty("完成投资")
     private String finishRate;
 
 
     /***
      * 项目库  1 储备项目 2 新建项目  3在建项目  4竣工项目
      */
+    @ApiModelProperty("项目库  1 储备项目 2 新建项目  3在建项目  4竣工项目")
     private String subType;
 
 
     /***
      *  投资查询开始月
      */
+    @ApiModelProperty("投资查询开始月")
     private String startMonthTz;
 
     /***
      * 投资查询结束月
      */
+    @ApiModelProperty("投资查询结束月")
     private String endMonthTz;
 
     /***
      *  任务查询开始月
      */
+    @ApiModelProperty("任务查询开始月")
     private String startMonthTask;
 
     /***
      * 任务查询结束月
      */
+    @ApiModelProperty("任务查询结束月")
     private String endMonthTask;
 
     /***
      * 申报状态 1未申报 2已申报 3已下达
      */
+    @ApiModelProperty("申报状态 1未申报 2已申报 3已下达")
     private String statusSource;
 
     /***
      * 申报状态 1申报状态以上的
      */
+    @ApiModelProperty("申报状态 1申报状态以上的")
     private String stateZj;
 
     /**
      * 年度固定资产项目库项目性质 1新建  2续建 3 储备
      */
+    @ApiModelProperty("年度固定资产项目库项目性质 1新建  2续建 3 储备")
     private String stateFix;
 
+    @ApiModelProperty("")
     private String isFix;
 
+    @ApiModelProperty("")
     private String subLabel;
 
+    @ApiModelProperty("")
     private String subCat;
 
+    @ApiModelProperty("")
     private String subYear;
 
     //穿透数据查询字段
 
     //abc类
+    @ApiModelProperty("abc类")
     private String abcs;
 
 
     //投资类型
+    @ApiModelProperty("投资类型")
     private String kindNatures;
     // 储备项目状态
+    @ApiModelProperty("储备项目状态")
     private String cbStatus;
 
 
     //所属行业
+    @ApiModelProperty("所属行业")
     private String indusKinds;
+    @ApiModelProperty("iks")
     private List<String> iks;
 
     //建设地点
+    @ApiModelProperty("建设地点")
     private String subjects;
     // 年度投资查询
+    @ApiModelProperty("年度投资查询Min")
     private String yearMixAmt;
+    @ApiModelProperty("年度投资查询Max")
     private String yearMaxAmt;
 
+    @ApiModelProperty("数据权限")
     // 数据权限
     private List<String> subjectAuthIds;
 }

projects-service/src/main/java/com/rtrh/projects/outapi/vo/ContactQueryVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.outapi.vo;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -7,8 +8,9 @@ import lombok.Setter;
 @Getter
 public class ContactQueryVO {
 
+	@ApiModelProperty("行业单位")
 	private	String unitName;
-	
+	@ApiModelProperty("所在科室")
 	private String departName;
 	
 	private String name;

projects-service/src/main/java/com/rtrh/projects/outapi/vo/OverStatusVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.outapi.vo;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -7,12 +8,19 @@ import lombok.Setter;
 @Getter
 public class OverStatusVO {
 
+	@ApiModelProperty("")
 	private String overStatus;
+	@ApiModelProperty("")
 	private Boolean containHide;
+	@ApiModelProperty("")
 	private Boolean blSub;
+	@ApiModelProperty("年")
 	private String year;
+	@ApiModelProperty("行业类别")
 	private String indusKind;
+	@ApiModelProperty("责任主体")
 	private String subjectId;
+	@ApiModelProperty("资金来源")
 	private String zjly;
 
 

projects-service/src/main/java/com/rtrh/projects/outapi/vo/projects/BeginDateVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.outapi.vo.projects;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -7,7 +8,9 @@ import lombok.Setter;
 @Getter
 public class BeginDateVO {
 
+	@ApiModelProperty("开始时间")
 	private String beginDateStart;
-	
+
+	@ApiModelProperty("结束时间")
 	private String beginDateEnd;
 }

projects-service/src/main/java/com/rtrh/projects/outapi/vo/projects/ListAmtUseQueryVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.outapi.vo.projects;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -7,23 +8,33 @@ import lombok.Setter;
 @Getter
 public class ListAmtUseQueryVO {
 
+	@ApiModelProperty("项目名称")
 	private String subName;
 
+	@ApiModelProperty("项目类型")
 	private String kind;
 
+	@ApiModelProperty("行业类别")
 	private String propKind;
 
+	@ApiModelProperty("建设性质")
 	private String indusKind;
 
+	@ApiModelProperty("责任主体")
 	private String subjectId;
 
+	@ApiModelProperty("状态")
 	private String status;
 
+	@ApiModelProperty("年")
 	private String year;
 
+	@ApiModelProperty("隐藏")
 	private Boolean containHide;
 
+	@ApiModelProperty("资金来源")
 	private String zjly;
 
+	@ApiModelProperty("查询类型")
 	private String queryType;
 }

projects-service/src/main/java/com/rtrh/projects/outapi/vo/projects/ProjectProcessQueryVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.outapi.vo.projects;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -7,17 +8,24 @@ import lombok.Setter;
 @Getter
 public class ProjectProcessQueryVO {
 
+	@ApiModelProperty("项目名称")
 	private String subName;
-	
+
+	@ApiModelProperty("项目类型")
 	private String kind;
-	
+
+	@ApiModelProperty("建设性质")
 	private String propKind;
-	
+
+	@ApiModelProperty("行业类别")
 	private String indusKind;
-	
+
+	@ApiModelProperty("状态")
 	private String status;
-	
+
+	@ApiModelProperty("年")
 	private String year;
-	
+
+	@ApiModelProperty("")
 	private Boolean containHide;
 }

projects-service/src/main/java/com/rtrh/projects/outapi/vo/projects/StaticsQueryVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.outapi.vo.projects;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -7,14 +8,15 @@ import lombok.Setter;
 @Getter
 public class StaticsQueryVO {
 
+	@ApiModelProperty("年")
 	private String year;
 
-
+	@ApiModelProperty("月")
 	private String month;
-
+	@ApiModelProperty("行业类别")
 	private String indusKind;
-
+	@ApiModelProperty("建设地点")
 	private String buildAddre;
-
+	@ApiModelProperty("资金来源")
 	private String zjly;
 }

projects-service/src/main/java/com/rtrh/projects/outapi/vo/report/ListQueryVO.java

@@ -2,6 +2,7 @@ package com.rtrh.projects.outapi.vo.report;
 
 import java.util.Date;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -9,13 +10,14 @@ import lombok.Setter;
 @Getter
 public class ListQueryVO {
 
+	@ApiModelProperty("开始月份")
 	private Date startMonth;
-	
+	@ApiModelProperty("结束月份")
 	private Date endMonth;
-	
+	@ApiModelProperty("项目名称")
 	private String subName;
-	
+	@ApiModelProperty("状态")
 	private String status;
-	
+	@ApiModelProperty("行业")
 	private String hyfl;
 }

projects-service/src/main/java/com/rtrh/projects/vo/SubIdVO.java

@@ -1,5 +1,6 @@
 package com.rtrh.projects.vo;
 
+import io.swagger.annotations.ApiModelProperty;
 import lombok.Getter;
 import lombok.Setter;
 
@@ -8,17 +9,28 @@ import lombok.Setter;
 public class SubIdVO {
 
 
+	@ApiModelProperty("项目ID")
 	private String subId;
+	@ApiModelProperty("前期流程id")
 	private String flowId;
+	@ApiModelProperty("1重点项目  2非重点项目  0或者null 查询全部")
 	private String isMajor;
+	@ApiModelProperty("年")
 	private String year;
+	@ApiModelProperty("电话")
 	private String phone;
+	@ApiModelProperty("")
 	private int cat;
+	@ApiModelProperty("项目类型")
 	private String kind;
+	@ApiModelProperty("")
 	private String item;
+	@ApiModelProperty("申报状态 1未申报 2 已申报  3已下达")
 	private String state;
+	@ApiModelProperty("资金来源ID")
 	private String zjlyId;
-
+	@ApiModelProperty("是否纳入年度固定资产项目库    1纳入  0不纳入")
 	private String isFix;
+	@ApiModelProperty("年度固定资产项目库项目性质 1新建  2续建 3 储备")
 	private String stateFix;
 }

projects/src/main/java/com/rtrh/projects/outapi/controller/AnnualPlanApiController.java

@@ -9,6 +9,8 @@ import com.rtrh.projects.modules.projects.enums.RptContKindEnum;
 import com.rtrh.projects.modules.projects.po.RptCont;
 import com.rtrh.projects.modules.projects.service.SubRptContService;
 import com.rtrh.projects.web.log.Log;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -42,6 +44,7 @@ import cn.hutool.core.date.DateUtil;
  */
 @RestController
 @RequestMapping("outApi/annualPlan")
+@Api(value = "年度计划",tags = "年度计划-API")
 public class AnnualPlanApiController extends BaseOutApiController {
 
 
@@ -80,6 +83,7 @@ public class AnnualPlanApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getList")
+    @ApiOperation("获取年度计划列表")
     public JsonResult getAnnualPlanList(@RequestBody AnnualPlanListQueryVO queryVO) {
         JsonResult jsonResult = new JsonResult();
         try {
@@ -126,6 +130,7 @@ public class AnnualPlanApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getById")
+    @ApiOperation("获取年度计划信息")
     public JsonResult getById(@RequestBody GetAnnualPlanVO planVO) {
         JsonResult result = new JsonResult();
         try {
@@ -157,6 +162,7 @@ public class AnnualPlanApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("queryBySudId")
+    @ApiOperation("获取信息")
     public JsonResult queryBySudId(@RequestBody GetAnnualPlanVO planVO) {
         JsonResult result = new JsonResult();
         try {
@@ -212,6 +218,7 @@ public class AnnualPlanApiController extends BaseOutApiController {
     @TokenAuthenticate
     @PostMapping("save")
 //    @Log("年度计划保存")
+    @ApiOperation("年度计划保存")
     public JsonResult save(@RequestBody SubAmtPlanVO vo) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());

projects/src/main/java/com/rtrh/projects/outapi/controller/CameraQueryApiController.java

@@ -6,6 +6,8 @@ import java.util.Map;
 
 import com.rtrh.core.vo.Message;
 import com.rtrh.projects.modules.hik.service.IHikApiService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -29,6 +31,7 @@ import com.rtrh.projects.vo.SubIdVO;
 
 @RestController
 @RequestMapping("outApi/camera")
+@Api(tags = "智联工地")
 public class CameraQueryApiController extends BaseOutApiController {
 
 
@@ -48,6 +51,7 @@ public class CameraQueryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("queryCameraSubInfo")
+    @ApiOperation("查询存在摄像头的项目")
     public JsonResult queryCameraSubInfo(@RequestBody SubNameQueryVO vo) {
         JsonResult jsonResult = new JsonResult();
         try {
@@ -67,6 +71,7 @@ public class CameraQueryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("pageCameraSubInfo")
+    @ApiOperation("分页查询 app 智慧工地 带摄像头项目")
     public JsonResult pageCameraSubInfo(Page page, @RequestBody SubInfoQueryTzVO queryVO) {
         JsonResult jsonResult = new JsonResult();
         try {
@@ -87,6 +92,7 @@ public class CameraQueryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("queryCameraBysubId")
+    @ApiOperation("通过项目id  查询摄像头列表")
     public JsonResult queryCameraBysubId(@RequestBody SubIdVO vo) {
         JsonResult jsonResult = new JsonResult();
         try {
@@ -105,6 +111,7 @@ public class CameraQueryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getVideo")
+    @ApiOperation("获取视频")
     public JsonResult getVideo(@RequestBody SubIdCameraIdVO vo) {
         JsonResult jsonResult = new JsonResult();
         try {
@@ -122,6 +129,7 @@ public class CameraQueryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getVideoList")
+    @ApiOperation("获取视频 list")
     public JsonResult getVideoList(@RequestBody SubIdCameraIdVO vo) {
         JsonResult jsonResult = new JsonResult();
         try {
@@ -140,6 +148,7 @@ public class CameraQueryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getNewVideoList")
+    @ApiOperation("获取最新的四个视频")
     public JsonResult getNewVideoList() {
         JsonResult jsonResult = new JsonResult();
         try {
@@ -160,6 +169,7 @@ public class CameraQueryApiController extends BaseOutApiController {
      * @return
      */
     @PostMapping("getCameraListBySudId")
+    @ApiOperation("工地摄像头获取")
     public Message getCameraListBySubId(@RequestBody SubIdVO subIdVO) {
         Message message = new Message();
         try {

projects/src/main/java/com/rtrh/projects/outapi/controller/ContactInfoQueryApiController.java

@@ -5,6 +5,8 @@ import java.util.List;
 import java.util.Map;
 import java.util.stream.Collectors;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.BeanUtils;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
@@ -37,6 +39,7 @@ import cn.hutool.core.collection.CollectionUtil;
  */
 @RestController
 @RequestMapping("outApi/contact")
+@Api(value = "联系人", tags = "联系人-API")
 public class ContactInfoQueryApiController extends BaseOutApiController {
 
 	@Autowired
@@ -49,6 +52,7 @@ public class ContactInfoQueryApiController extends BaseOutApiController {
 
 	@TokenAuthenticate
 	@PostMapping("query")
+	@ApiOperation("联系人列表")
 	public JsonResult query(@RequestBody ContactQueryVO queryVO) {
 		JsonResult result = new JsonResult();
 		try {

projects/src/main/java/com/rtrh/projects/outapi/controller/FileApiController.java

@@ -46,7 +46,7 @@ import net.coobird.thumbnailator.Thumbnails;
 
 @RestController
 @RequestMapping("outApi/file")
-@Api( description = "文件操作-API")
+@Api(value = "文件操作-API", tags = "文件操作-API")
 public class FileApiController extends BaseOutApiController {
 
     @Autowired

projects/src/main/java/com/rtrh/projects/outapi/controller/IntermediaryApiController.java

@@ -1,6 +1,8 @@
 package com.rtrh.projects.outapi.controller;
 
 import com.rtrh.projects.modules.system.vo.LoginUserVO;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -24,6 +26,7 @@ import com.rtrh.projects.vo.IdDTO;
 
 @RestController
 @RequestMapping("outApi/intermediary")
+@Api(value = "产业链服务库-API",tags = "产业链服务库-API")
 public class IntermediaryApiController extends BaseOutApiController {
 
     @Autowired
@@ -37,6 +40,7 @@ public class IntermediaryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getIntermediaryType")
+    @ApiOperation("获取产业链服务库分类")
     public JsonResult getIntermediaryType(){
         JsonResult jsonResult = new JsonResult();
         try {
@@ -55,6 +59,7 @@ public class IntermediaryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getIntermediaryListByType")
+    @ApiOperation("获取产业链服务库-按分类")
     public JsonResult getIntermediaryListByType(@RequestBody Page page, @RequestBody IntermediatryQueryVO queryVO){
         JsonResult jsonResult = new JsonResult();
         try {
@@ -85,6 +90,7 @@ public class IntermediaryApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getById")
+    @ApiOperation("获取产业链服务库-信息")
     public JsonResult getById(@RequestBody IdDTO idDTO) {
         JsonResult result = new JsonResult();
         try {

projects/src/main/java/com/rtrh/projects/outapi/controller/JunitApiController.java

@@ -2,6 +2,8 @@ package com.rtrh.projects.outapi.controller;
 
 import java.util.Map;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -26,6 +28,7 @@ import com.rtrh.projects.vo.IdDTO;
 
 @RestController
 @RequestMapping("outApi/junit")
+@Api(value = "企业",tags = "企业-API")
 public class JunitApiController extends BaseOutApiController {
 
     @Autowired
@@ -40,6 +43,7 @@ public class JunitApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getList")
+    @ApiOperation("企业信息列表")
     public JsonResult getList(@RequestBody Page page,@RequestBody JunitQueryVO queryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -86,6 +90,7 @@ public class JunitApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("junitInfo")
+    @ApiOperation("查看企业信息")
     public JsonResult getJunitInfo(@RequestBody IdDTO idDTO) {
         JsonResult result = new JsonResult();
         try{

projects/src/main/java/com/rtrh/projects/outapi/controller/LogApiController.java

@@ -11,6 +11,8 @@ import com.rtrh.projects.outapi.result.JsonResult;
 import com.rtrh.projects.vo.subject.DataLogQueryVO;
 import com.rtrh.projects.vo.system.LoginlogQueryVO;
 import com.rtrh.projects.web.controller.BaseController;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -24,6 +26,7 @@ import org.springframework.web.bind.annotation.RestController;
  */
 @RestController
 @RequestMapping("outApi/log")
+@Api(value = "日志",tags = "日志-API")
 public class LogApiController extends BaseOutApiController {
 
 	@Autowired
@@ -34,6 +37,7 @@ public class LogApiController extends BaseOutApiController {
 
 	@TokenAuthenticate
 	@PostMapping(value = "/login/list")
+	@ApiOperation("登录日志")
 	public JsonResult list(@RequestBody Page page, @RequestBody LoginlogQueryVO queryVO) {
 		JsonResult jsonResult = new JsonResult();
 		Page pageData = commLoginDao.pageQueryCommLogin(page,queryVO);
@@ -57,6 +61,7 @@ public class LogApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping(value = "/data/list")
+	@ApiOperation("行为日志")
 	public JsonResult queryList(@RequestBody Page page, @RequestBody DataLogQueryVO queryVO) {
 		JsonResult jsonResult = new JsonResult();
 		JsonResult result = new JsonResult();

projects/src/main/java/com/rtrh/projects/outapi/controller/MeetingRecordsAppApiController.java

@@ -2,6 +2,8 @@ package com.rtrh.projects.outapi.controller;
 
 import java.util.List;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -28,6 +30,7 @@ import com.rtrh.projects.vo.IdDTO;
  */
 @RestController
 @RequestMapping("outApi/meetingRecords")
+@Api(value = "重大事项接口",tags = "重大事项接口")
 public class MeetingRecordsAppApiController extends BaseOutApiController {
 
 	@Autowired
@@ -61,6 +64,7 @@ public class MeetingRecordsAppApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("list")
+	@ApiOperation("重大事项/专题推进会/现场调研")
 	public JsonResult list(@RequestBody Page page, @RequestBody MeetingRecordsQueryVO queryVO) {
 		JsonResult result = new JsonResult();
 		try {
@@ -81,6 +85,7 @@ public class MeetingRecordsAppApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("detail")
+	@ApiOperation("重大事项明细")
 	public JsonResult detail(@RequestBody IdDTO idDTO) {
 		JsonResult result = new JsonResult();
 		try {

projects/src/main/java/com/rtrh/projects/outapi/controller/MessageInfoApiController.java

@@ -1,6 +1,8 @@
 package com.rtrh.projects.outapi.controller;
 
 import com.rtrh.projects.web.log.Log;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -27,6 +29,7 @@ import com.rtrh.projects.vo.IdDTO;
  */
 @RestController
 @RequestMapping("/outApi/msg")
+@Api(value = "消息管理",tags = "消息管理")
 public class MessageInfoApiController extends BaseOutApiController {
 
 	@Autowired
@@ -124,6 +127,7 @@ public class MessageInfoApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("unReadCount")
+	@ApiOperation("获取未读消息数量")
 	public JsonResult unReadCount() {
 		JsonResult result = new JsonResult();
 		try {

projects/src/main/java/com/rtrh/projects/outapi/controller/MonthReportApiController.java

@@ -10,6 +10,8 @@ import java.util.Map;
 
 import com.rtrh.projects.modules.projects.vo.SubInfoQueryTzVO;
 import com.rtrh.projects.modules.utils.DateUtils;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -51,6 +53,7 @@ import cn.hutool.core.date.DateUtil;
  */
 @RestController
 @RequestMapping("outApi/monthReport")
+@Api(value = "月报",tags = "月报-API")
 public class MonthReportApiController extends BaseOutApiController {
 
 
@@ -78,6 +81,7 @@ public class MonthReportApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getList")
+    @ApiOperation("月报列表")
     public JsonResult queryReport(@RequestBody Page page, @RequestBody ListQueryVO vo) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());
@@ -145,6 +149,7 @@ public class MonthReportApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("queryReportMonth")
+    @ApiOperation("查询指定项目的指定月份月报")
     public JsonResult queryReportMonth(@RequestBody ReportMonthVO monthVO) {
         JsonResult result = new JsonResult();
         try {
@@ -170,6 +175,7 @@ public class MonthReportApiController extends BaseOutApiController {
     @TokenAuthenticate
     @PostMapping("save")
 //    @Log("月报保存")
+    @ApiOperation("月报录入")
     public JsonResult saveReport(@RequestBody WeekContentVO vo) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());
@@ -188,6 +194,7 @@ public class MonthReportApiController extends BaseOutApiController {
     @TokenAuthenticate
     @PostMapping("del")
 //    @Log("月报删除")
+    @ApiOperation("月报删除")
     public JsonResult del(@RequestBody DelReportVO delVO) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());
@@ -212,6 +219,7 @@ public class MonthReportApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getById")
+    @ApiOperation("获取月报信息")
     public JsonResult getById(@RequestBody ReportGetVO getVO) {
         JsonResult result = new JsonResult();
         LoginUserVO vo = jwtUtils.getUserInfo(getToken());

projects/src/main/java/com/rtrh/projects/outapi/controller/NoticeOutApiController.java

@@ -2,6 +2,8 @@ package com.rtrh.projects.outapi.controller;
 
 import java.util.List;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -25,6 +27,7 @@ import com.rtrh.projects.vo.IdDTO;
  */
 @RestController
 @RequestMapping("outApi/notice")
+@Api(value = "通知公告",tags = "通知公告-API")
 public class NoticeOutApiController extends BaseOutApiController {
 
 	@Autowired
@@ -36,6 +39,7 @@ public class NoticeOutApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate(AuthenticateType.NONE)
 	@PostMapping("count")
+	@ApiOperation("通知公告的数量")
 	public JsonResult count() {
 		JsonResult result = new JsonResult();
 		try {
@@ -57,6 +61,7 @@ public class NoticeOutApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate(AuthenticateType.NONE)
 	@PostMapping("list")
+	@ApiOperation("通知公告列表")
 	public JsonResult page(@RequestBody Page page) {
 		JsonResult result = new JsonResult();
 		try {
@@ -80,6 +85,7 @@ public class NoticeOutApiController extends BaseOutApiController {
 	 */
 	@PostMapping("getById")
 	@TokenAuthenticate(AuthenticateType.NONE)
+	@ApiOperation("通知公告详细内容")
 	public JsonResult getById(@RequestBody IdDTO idDTO) {
 		JsonResult result = new JsonResult();
 		try {

projects/src/main/java/com/rtrh/projects/outapi/controller/OverdueApiController.java

@@ -4,6 +4,8 @@ import java.util.Map;
 import java.util.Objects;
 
 import com.rtrh.projects.modules.projects.service.WorkBenchService;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -26,6 +28,7 @@ import com.rtrh.projects.outapi.vo.OverStatusVO;
  */
 @RestController
 @RequestMapping("outApi/overdue")
+@Api(value = "逾期-API",tags = "逾期-API")
 public class OverdueApiController extends BaseOutApiController {
 
 	@Autowired
@@ -41,6 +44,7 @@ public class OverdueApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("getNum")
+	@ApiOperation("获取逾期数量")
 	public JsonResult getNum() {
 		JsonResult result = new JsonResult();
 		try {
@@ -70,6 +74,7 @@ public class OverdueApiController extends BaseOutApiController {
 	@SuppressWarnings("unchecked")
 	@TokenAuthenticate
 	@PostMapping("getList")
+	@ApiOperation("逾期列表")
 	public JsonResult getList(@RequestBody Page page, @RequestBody OverStatusVO statusVO) {
 		JsonResult result = new JsonResult();
 		try {

projects/src/main/java/com/rtrh/projects/outapi/controller/PictureApiController.java

@@ -2,6 +2,8 @@ package com.rtrh.projects.outapi.controller;
 
 import java.util.List;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -22,6 +24,8 @@ import com.rtrh.projects.outapi.result.ResultCode;
  */
 @RestController
 @RequestMapping("outApi/picture")
+@Api(value = "banner图-API",tags = "banner图-API")
+
 public class PictureApiController extends BaseOutApiController {
 
     /*@Autowired
@@ -35,6 +39,7 @@ public class PictureApiController extends BaseOutApiController {
      */
     @PostMapping("list")
     @TokenAuthenticate(AuthenticateType.NONE)
+    @ApiOperation("获取可用的图片列表")
     public JsonResult getListByIsDisable(){
         JsonResult result=new JsonResult();
         try{

projects/src/main/java/com/rtrh/projects/outapi/controller/PolicyDoumentApiController.java

@@ -2,6 +2,8 @@ package com.rtrh.projects.outapi.controller;
 
 import java.util.List;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -28,6 +30,7 @@ import com.rtrh.projects.vo.IdDTO;
  */
 @RestController
 @RequestMapping("outApi/policy/document")
+@Api(value = "政策文件",tags = "政策文件-API")
 public class PolicyDoumentApiController extends BaseOutApiController {
 
 	@Autowired
@@ -41,6 +44,7 @@ public class PolicyDoumentApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate(AuthenticateType.NONE)
 	@PostMapping("getType")
+	@ApiOperation("政策文件分类")
 	public JsonResult getType(@RequestBody PolicyDocumetQueryVO vo) {
 		JsonResult result = new JsonResult();
 		try {
@@ -61,6 +65,7 @@ public class PolicyDoumentApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate(AuthenticateType.NONE)
 	@PostMapping("list")
+	@ApiOperation("政策文件列表/四季大讲堂")
 	public JsonResult page(@RequestBody Page page, @RequestBody PolicyDocumetQueryVO queryVO) {
 		JsonResult result = new JsonResult();
 		try {
@@ -86,6 +91,7 @@ public class PolicyDoumentApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("getById")
+	@ApiOperation("政策文件明细")
 	public JsonResult getById(@RequestBody IdDTO idDTO) {
 		JsonResult result = new JsonResult();
 		try {

projects/src/main/java/com/rtrh/projects/outapi/controller/ProblemTracingApiController.java

@@ -7,6 +7,8 @@ import java.util.Map;
 
 import com.rtrh.projects.vo.problemreport.QuestionIdVO;
 import com.rtrh.projects.web.log.Log;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -35,6 +37,7 @@ import com.rtrh.projects.vo.IdDTO;
 
 @RestController
 @RequestMapping("outApi/problemTracing")
+@Api(value = "问题跟踪",tags = "问题跟踪操作")
 public class ProblemTracingApiController  extends BaseOutApiController {
 
     @Autowired
@@ -99,6 +102,7 @@ public class ProblemTracingApiController  extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping(value = "getById")
+    @ApiOperation("问题跟踪填报")
     public JsonResult getBySubId(@RequestBody IdDTO idDTO) {
         JsonResult result = new JsonResult();
         try {
@@ -126,6 +130,7 @@ public class ProblemTracingApiController  extends BaseOutApiController {
     @TokenAuthenticate
     @PostMapping("/save")
 //    @Log("问题保存")
+    @ApiOperation("问题填报保存")
     public JsonResult save(@RequestBody SubquestionConsum consum) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());

projects/src/main/java/com/rtrh/projects/outapi/controller/ProblemTrackApiController.java

@@ -3,6 +3,8 @@ package com.rtrh.projects.outapi.controller;
 import java.util.List;
 import java.util.Map;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -35,6 +37,7 @@ import com.rtrh.projects.vo.SubIdVO;
  */
 @RestController
 @RequestMapping("outApi/problemTrack")
+@Api(value = "问题跟踪",tags = "问题跟踪查询")
 public class ProblemTrackApiController extends BaseOutApiController {
 
     @Autowired
@@ -51,6 +54,7 @@ public class ProblemTrackApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getList")
+    @ApiOperation("问题清单列表/问题督办")
     public JsonResult pageQuertReportData(@RequestBody Page page, @RequestBody QuestionQueryVO queryVO) {
         JsonResult result = new JsonResult();
         Page  pageData=null;
@@ -107,6 +111,7 @@ public class ProblemTrackApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping(value = "getById")
+    @ApiOperation("通过ID获取问题填报信息")
     public JsonResult getById(@RequestBody IdDTO idDTO) {
         JsonResult result = new JsonResult();
         try {

projects/src/main/java/com/rtrh/projects/outapi/controller/QueryPasramApiController.java

@@ -4,6 +4,8 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.stream.Collectors;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestMapping;
@@ -26,6 +28,7 @@ import cn.hutool.core.collection.CollectionUtil;
  */
 @RestController
 @RequestMapping("/outApi/queryParam")
+@Api(value = "查询条件获取-API",tags = "查询条件获取")
 public class QueryPasramApiController extends BaseOutApiController {
 
 	@Autowired
@@ -36,6 +39,7 @@ public class QueryPasramApiController extends BaseOutApiController {
 	 * @return
 	 */
 	@PostMapping("jsdd")
+	@ApiOperation("建设地点")
 	public JsonResult jsdd() {
 		JsonResult result = new JsonResult();
 		try {
@@ -59,6 +63,7 @@ public class QueryPasramApiController extends BaseOutApiController {
 	 * @return
 	 */
 	@PostMapping("hyfl")
+	@ApiOperation("所属行业")
 	public JsonResult hyfl() {
 		JsonResult result = new JsonResult();
 		try {
@@ -82,6 +87,7 @@ public class QueryPasramApiController extends BaseOutApiController {
 	 * @return
 	 */
 	@PostMapping("jsxz")
+	@ApiOperation("建设性质")
 	public JsonResult jsxz() {
 		JsonResult result = new JsonResult();
 		try {
@@ -105,6 +111,7 @@ public class QueryPasramApiController extends BaseOutApiController {
 	 * @return
 	 */
 	@PostMapping("xmlx")
+	@ApiOperation("项目类型")
 	public JsonResult xmlx() {
 		JsonResult result = new JsonResult();
 		try {
@@ -128,6 +135,7 @@ public class QueryPasramApiController extends BaseOutApiController {
 	 * @return
 	 */
 	@PostMapping("xmxz")
+	@ApiOperation("项目性质")
 	public JsonResult xmxz() {
 		JsonResult result = new JsonResult();
 		try {
@@ -151,6 +159,7 @@ public class QueryPasramApiController extends BaseOutApiController {
 	 * @return
 	 */
 	@PostMapping("zjly")
+	@ApiOperation("资金来源")
 	public JsonResult zjly() {
 		JsonResult result = new JsonResult();
 		try {

projects/src/main/java/com/rtrh/projects/outapi/controller/TodoApiController.java

@@ -49,7 +49,7 @@ import com.rtrh.projects.vo.subject.SubPassVO;
  */
 @RestController
 @RequestMapping("/outApi/todo")
-@Api( description = "待办-API")
+@Api(value = "待办-API", tags = "待办-API")
 public class TodoApiController extends BaseOutApiController {
 
 	@Autowired

projects/src/main/java/com/rtrh/projects/outapi/controller/WeekReportApiController.java

@@ -5,6 +5,8 @@ import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -50,6 +52,7 @@ import cn.hutool.core.date.DateUtil;
  */
 @RestController
 @RequestMapping("outApi/weekReport")
+@Api(value = "周报",tags = "周报-API")
 public class WeekReportApiController extends BaseOutApiController {
 
 
@@ -87,6 +90,7 @@ public class WeekReportApiController extends BaseOutApiController {
 
     @TokenAuthenticate
     @PostMapping("getList")
+    @ApiOperation("项目周报列表")
     public JsonResult queryReport( @RequestBody ListQueryVO vo) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());
@@ -144,6 +148,7 @@ public class WeekReportApiController extends BaseOutApiController {
     @TokenAuthenticate
     @PostMapping("save")
 //    @Log("周报保存")
+    @ApiOperation("周报录入")
     public JsonResult saveReport(@RequestBody WeekContentVO vo) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());
@@ -162,6 +167,7 @@ public class WeekReportApiController extends BaseOutApiController {
     @TokenAuthenticate
     @PostMapping("del")
 //    @Log("周报删除")
+    @ApiOperation("周报删除")
     public JsonResult del(@RequestBody DelReportVO delVO) {
         JsonResult result = new JsonResult();
         LoginUserVO loginUserVO = jwtUtils.getUserInfo(getToken());
@@ -187,6 +193,7 @@ public class WeekReportApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getBySubId")
+    @ApiOperation("获取周报信息")
     public JsonResult getById(@RequestBody ReportGetVO getVO) {
         JsonResult result = new JsonResult();
         LoginUserVO vo = jwtUtils.getUserInfo(getToken());

projects/src/main/java/com/rtrh/projects/outapi/controller/projects/ProjectStaticsApiController.java

@@ -10,6 +10,8 @@ import javax.servlet.http.HttpServletRequest;
 
 import com.rtrh.core.vo.Message;
 import com.rtrh.projects.vo.statics.OtherQueryVO;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.ui.ModelMap;
 import org.springframework.web.bind.annotation.GetMapping;
@@ -32,6 +34,7 @@ import cn.hutool.core.date.DateUtil;
 
 @RestController
 @RequestMapping("/outApi/projects/statics")
+@Api(value = "分析报告-API",tags = "分析报告-API")
 public class ProjectStaticsApiController extends BaseOutApiController {
 
 	@Autowired
@@ -49,6 +52,7 @@ public class ProjectStaticsApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("qxzb")
+	@ApiOperation("区县占比")
 	public JsonResult qxzb(@RequestBody StaticsQueryVO queryVo) {
 		JsonResult result = new JsonResult();
 		if(StringUtil.isEmpty(queryVo.getYear())) {
@@ -87,6 +91,7 @@ public class ProjectStaticsApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("hyfl")
+	@ApiOperation("行业占比分析")
 	public JsonResult hyfl(@RequestBody StaticsQueryVO queryVo){
 
 		JsonResult result = new JsonResult();
@@ -151,6 +156,7 @@ public class ProjectStaticsApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("ndtzfx")
+	@ApiOperation("年度投资分析")
 	public JsonResult nftzfx(@RequestBody StaticsQueryVO queryVo) {
 		JsonResult result = new JsonResult();
 		if(StringUtil.isEmpty(queryVo.getYear())) {

projects/src/main/java/com/rtrh/projects/outapi/controller/projects/ProjectsAmtApiController.java

@@ -6,6 +6,8 @@ import java.util.List;
 import java.util.Map;
 import java.util.Objects;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.springframework.beans.factory.annotation.Autowired;
 import org.springframework.web.bind.annotation.PostMapping;
 import org.springframework.web.bind.annotation.RequestBody;
@@ -35,6 +37,7 @@ import cn.hutool.core.date.DateUtil;
 
 @RestController
 @RequestMapping("/outApi/projects")
+@Api(value = "资金-API",tags = "资金-API")
 public class ProjectsAmtApiController extends BaseOutApiController {
 
     @Autowired
@@ -116,6 +119,7 @@ public class ProjectsAmtApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getListAmt")
+    @ApiOperation("资金计划统计分析")
     public JsonResult pageQueryAmt(@RequestBody ListAmtUseQueryVO queryVO) {
         JsonResult result = new JsonResult();
         //项目前期

projects/src/main/java/com/rtrh/projects/outapi/controller/projects/ProjectsApiController.java

@@ -73,7 +73,7 @@ import cn.hutool.core.date.DateUtil;
  */
 @RestController
 @RequestMapping("outApi/projects")
-@Api( description = "项目相关-API")
+@Api( value = "项目相关-API",tags = "项目相关-API")
 public class ProjectsApiController extends BaseOutApiController {
 
     @Autowired
@@ -699,6 +699,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("staticsManage")
+    @ApiOperation("获取监管单位  首页数据 其他数据")
     public JsonResult staticsManage(@RequestBody StaticsQueryVO staticsQueryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -727,6 +728,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("staticsManageTz")
+    @ApiOperation("获取监管单位  首页数据 投资信息")
     public JsonResult staticsManageTz(@RequestBody StaticsQueryVO staticsQueryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -756,6 +758,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("staticsManageYdfx")
+    @ApiOperation("获取监管单位 投资月度分析")
     public JsonResult staticsManageYdfx(@RequestBody StaticsQueryVO staticsQueryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -784,6 +787,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("staticsManageHyfl")
+    @ApiOperation("获取监管单位 首页数据")
     public JsonResult staticsManageHyfl(@RequestBody StaticsQueryVO queryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -823,6 +827,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("staticsPerson")
+    @ApiOperation("获取项目统计信息")
     public JsonResult staticsPerson(@RequestBody StaticsQueryVO staticsQueryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -911,6 +916,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getProjecsProcess")
+    @ApiOperation("项目进度分析")
     public JsonResult getProjecsProcess(@RequestBody ProjectProcessQueryVO queryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -964,6 +970,7 @@ public class ProjectsApiController extends BaseOutApiController {
      * @return
      */
     @PostMapping("projectLead")
+    @ApiOperation("项目牵头领导")
     public JsonResult projectLead(@RequestBody SubIdVO subIdVO) {
         JsonResult result = new JsonResult();
         try {
@@ -982,6 +989,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @TokenAuthenticate
     @PostMapping("getGraphicProgressList")
+    @ApiOperation("形象进度")
     public JsonResult getGraphicProgressList(@RequestBody Page page, @RequestBody BeginDateVO dateVO, @RequestBody SubInfoQueryTzVO queryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -1455,6 +1463,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @PostMapping(value = "/pre/sum")
     @TokenAuthenticate
+    @ApiOperation("前期手续办理情况")
     public JsonResult sumDepartment(@RequestBody SubinfoPreQueryVo queryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -1936,6 +1945,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @PostMapping("/pre/num")
     @TokenAuthenticate
+    @ApiOperation("查询项目前期预期信息  红黄灯数量")
     public JsonResult pageQueryPreWarnDataRedYellow(@RequestBody PreWarnDataQueryVO queryVO) {
         JsonResult result = new JsonResult();
         try {
@@ -2008,6 +2018,7 @@ public class ProjectsApiController extends BaseOutApiController {
      */
     @PostMapping(value = "/pre/list")
     @TokenAuthenticate
+    @ApiOperation("查询项目前期预期信息")
     public JsonResult pageQueryPreWarnData(@RequestBody Page page, @RequestBody PreWarnDataQueryVO queryVO) {
         JsonResult result = new JsonResult();
         try {

projects/src/main/java/com/rtrh/projects/outapi/controller/projects/ProjectsConcernApiController.java

@@ -36,7 +36,7 @@ import com.rtrh.projects.vo.SubIdVO;
  */
 @RestController
 @RequestMapping("/outApi/concern")
-@Api( description = "项目关注-API")
+@Api( value = "项目关注-API",tags = "项目关注-API")
 public class ProjectsConcernApiController extends BaseOutApiController {
 
 	@Autowired

projects/src/main/java/com/rtrh/projects/outapi/controller/projects/SubPreFlowApiController.java

@@ -6,6 +6,8 @@ import java.util.List;
 
 import javax.servlet.http.HttpServletResponse;
 
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.slf4j.Logger;
 import org.slf4j.LoggerFactory;
 import org.springframework.beans.factory.annotation.Autowired;
@@ -35,6 +37,7 @@ import com.rtrh.projects.vo.SubIdVO;
 
 @RestController
 @RequestMapping("outApi/preFlow")
+@Api(value = "办事流程",tags = "办事流程")
 public class SubPreFlowApiController extends BaseOutApiController {
 
 	private Logger logger = LoggerFactory.getLogger(this.getClass());
@@ -50,6 +53,7 @@ public class SubPreFlowApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("list")
+	@ApiOperation("办事流程列表")
 	public JsonResult list() {
 		JsonResult result = new JsonResult();
 		try {
@@ -114,6 +118,7 @@ public class SubPreFlowApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate
 	@PostMapping("staticsDetail")
+	@ApiOperation("项目前期情况统计穿透数据")
 	public JsonResult staticsDetail(@RequestBody Page page, @RequestBody PreFlowStaticsDetailQueryVO queryVO) {
 		JsonResult result = new JsonResult();
 		
@@ -134,6 +139,7 @@ public class SubPreFlowApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate(AuthenticateType.NONE)
 	@GetMapping("vedio")
+	@ApiOperation("项目前期视频")
 	public void video(HttpServletResponse response) {
 		FileInputStream in = null;
 		try {
@@ -157,6 +163,7 @@ public class SubPreFlowApiController extends BaseOutApiController {
 	 * @return
 	 */
 	@PostMapping("getNamePleBySubPreId")
+	@ApiOperation("获取办事流程联系人，联系电话")
 	public JsonResult getNamePleBySubPreId(@RequestBody IdDTO idDTO) {
 		JsonResult result = new JsonResult();
 		try {
@@ -177,6 +184,7 @@ public class SubPreFlowApiController extends BaseOutApiController {
 	 */
 	@TokenAuthenticate(AuthenticateType.NONE)
 	@GetMapping("img")
+	@ApiOperation("项目流程图")
 	public void img(HttpServletResponse response) {
 		FileInputStream in = null;
 		try {

projects/src/main/java/com/rtrh/projects/web/controller/fileSystem/FileGetController.java

@@ -18,6 +18,8 @@ import com.alibaba.fastjson.JSON;
 import com.alibaba.fastjson.JSONArray;
 import com.alibaba.fastjson.JSONObject;
 import com.rtrh.projects.outapi.result.JsonResult;
+import io.swagger.annotations.Api;
+import io.swagger.annotations.ApiOperation;
 import org.apache.http.HttpEntity;
 import org.apache.http.client.methods.CloseableHttpResponse;
 import org.apache.http.client.methods.HttpGet;
@@ -51,6 +53,7 @@ import net.coobird.thumbnailator.Thumbnails;
  *
  */
 @Controller
+@Api(value = "查看文件-API",tags = "查看文件-API")
 public class FileGetController {
 
 	private Logger logger = LoggerFactory.getLogger(this.getClass());
@@ -67,6 +70,7 @@ public class FileGetController {
 	 * @throws Exception
 	 */
 	@RequestMapping(value = "static/file/{fileId}.{fftype}", method = RequestMethod.GET)
+	@ApiOperation("查看文件")
 	public ModelAndView showFile(@PathVariable("fileId") String fileId, @PathVariable("fftype") String fftype, Integer width, Integer height,
 			HttpServletRequest arg0, HttpServletResponse arg1) {
 		return showFile(fileId, width, height, arg0, arg1);
@@ -82,6 +86,7 @@ public class FileGetController {
 	 * @throws Exception
 	 */
 	@RequestMapping(value = "static/file/{fileId}/showfile", method = RequestMethod.GET)
+	@ApiOperation("查看文件")
 	public ModelAndView showFile(@PathVariable("fileId") String fileId, Integer width, Integer height,
 			HttpServletRequest arg0, HttpServletResponse arg1) {
 		handleCrossDomain(arg0, arg1);
@@ -152,6 +157,7 @@ public class FileGetController {
 	 * @throws Exception
 	 */
 	@RequestMapping(value = "static/file/{fileId}/showfileFgw", method = RequestMethod.GET)
+	@ApiOperation("查看文件-发改委")
 	public ModelAndView showFileFgw(@PathVariable("fileId") String fileId, Integer width, Integer height,
 								 HttpServletRequest arg0, HttpServletResponse arg1) {
 		handleCrossDomain(arg0, arg1);
@@ -241,6 +247,7 @@ public class FileGetController {
 	 * @throws Exception
 	 */
 	@RequestMapping(value = {"static/file/{fileId}/watch", "/{fileId}.mp4"}, method = RequestMethod.GET)
+	@ApiOperation("查看文件 断点续传方式，用于视频播放")
 	public ModelAndView watchFile(@PathVariable("fileId") String fileId, HttpServletRequest arg0,
 			HttpServletResponse arg1) {
 		handleCrossDomain(arg0, arg1);